Installing dependencies


This topic describes how to install the following dependencies on Red Hat Enterprise Linux (RHEL) and Ubuntu.

Warning
Important

You must install the RKE2 Kubernetes cluster before you start this process.

For more information, see System requirements.

  • Python
  • Ansible
  • Docker engine
  • Helm

You must install these dependencies on the Control Plane node to preprocess the BMC AMI Platform product.

To install zip and unzip packages on RHEL

  1. Install the zip and unzip packages by using the following command:
    sudo yum install zip unzip

To install zip and unzip packages on Ubuntu

  1. Install the zip and unzip packages by using the following command:
    sudo apt install zip unzip

To install Python and Ansible on RHEL

  1. Install development tools and required dependencies by using the following command:
    sudo dnf groupinstall -y "Development Tools" sudo dnf install -y gcc openssl-devel bzip2-devel libffi-devel zlib-devel
  2. Install Python 3.12 and its associated package manager by using the following command:
    sudo dnf install -y python3.12 python3.12-pip
  3. Confirm the version by using the following command:
    python3 --version
  4. Install Ansible Core using DNF by using the following command:
    sudo dnf install -y ansible-core

To install Python and Ansible on Ubuntu

  1. Update the system and install the required libraries by using the following command:

    sudo apt-get update && sudo apt-get install -y --no-install-recommends \
    build-essential wget curl libssl-dev zlib1g-dev libncurses-dev libbz2-dev \
    libreadline-dev libsqlite3-dev libffi-dev liblzma-dev xz-utils ca-certificates
  2. Install the Python source code by using the following command:

    sudo apt install -y python3.12
  3. Verify installation by using the following command:

    python3 --version
  4. Install Ansible by using the following command:

    sudo apt-get install -y ansible

To install Docker engine on RHEL

  1. Install the Docker repository and packages, and then enable the service as follows:
    1.  Set up the Docker CE repo by using the following command:
      sudo dnf -y install yum-utils
      sudo yum-config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
  2.  Install the Docker engine by using the following command:
    sudo dnf -y install docker-ce docker-ce-cli containerd.io
  3. Enable and start the Docker service by using the following command:

    sudo systemctl enable --now docker
  4. Verify installation by using the following command:

    docker --version
    docker info
  5.  To run Docker commands without sudo, run the following command:
    sudo usermod -aG docker $USER

To apply the new group, you must log out and then log in again.

To install Docker engine on Ubuntu

Perform the following steps to add Docker’s official GPG key and repository, install packages, and start the service:

  1. Update and install prerequisites by using the following command:
    sudo apt-get update
    sudo apt-get install -y ca-certificates curl gnupg
  2. Add Docker’s official GPG key by using the following command:
    sudo install -m 0755 -d /etc/apt/keyrings
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
      | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
    sudo chmod a+r /etc/apt/keyrings/docker.gpg
  3. Set up the repository (uses your Ubuntu codename automatically) by using the following command:
    echo \
      "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
      https://download.docker.com/linux/ubuntu $(. /etc/os-release; echo $UBUNTU_CODENAME) stable" \
      | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  4. Install Docker engine by using the following command:
    sudo apt-get update
    sudo apt-get install -y docker-ce docker-ce-cli containerd.io
  5. Enable and start the Docker service by using the following command:
    sudo systemctl enable --now docker
  6.  Verify installation by using the following command:
    docker --version
    docker info
  7. To run Docker commands without sudo, run the following command: 
    sudo usermod -aG docker $USER

To apply the new group, you must log out and then log in again.

To install Helm on RHEL

  1. Add Helm repo by using the following command:

    sudo tee /etc/yum.repos.d/helm.repo >/dev/null <<'EOF'
    [helm]
    name=Helm
    baseurl=https://baltocdn.com/helm/stable/rpm
    enabled=1
    gpgcheck=1
    gpgkey=https://baltocdn.com/helm/signing.asc
    EOF
  2. Install and verify by using the following command:

    sudo dnf install -y helm
    helm version

To install Helm on Ubuntu

  1. Add Helm repo by using the following command:
    sudo apt-get update
    sudo apt-get install -y apt-transport-https ca-certificates curl gnupg
    curl -fsSL https://baltocdn.com/helm/signing.asc | gpg --dearmor | sudo tee /usr/share/keyrings/helm.gpg >/dev/null
    echo "deb [signed-by=/usr/share/keyrings/helm.gpg] https://baltocdn.com/helm/stable/debian/ all main" \
    | sudo tee /etc/apt/sources.list.d/helm-stable-debian.list >/dev/null
  2. Install and verify by using the following command:
    sudo apt-get update
    sudo apt-get install -y helm
    helm version

If you encounter issues on AWS machines, use the following command:

snap install helm --classic

To install psql on Ubuntu

  1. Install psql by using the following commands:

    sudo apt update
    sudo apt install -y postgresql-client

To install psql on RHEL

  1. Install psql by using one of the following commands:

    sudo snap install postgresql
    sudo dnf install -y postgresql

Where to go from here

After you complete the installation dependencies process, proceed to Deploying BMC AMI Platform.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Platform 2.2