Install Prerequisites Softwares

---

note

Before Proceeding with installing the softwares, Check the Requirements here.

note

The following docker installation steps are for reference only, you can use your own approach.

Ubuntu

The ssh user has privileges(root/sudo) user doesn't have privileges for install/upgrade utility softwares

Platform Instance

• Install wget

sudo apt-get install wget  -y

• Install python3.

sudo apt-get install python3 -y

• Add Docker's official GPG key

    sudo apt-get update
    sudo apt-get install ca-certificates curl gnupg
    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

• Add docker repository to Apt source

    echo "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

  apt-get update  
  apt-get install iptables ca-certificates -y

• To upgrade or Install the latest version of Docker

  • Run the following command to list available versions

    apt-get update
    apt-cache madison docker-ce
    apt-cache madison docker-ce-cli
  • Run the following command to Install the specific version of Docker in ubuntu 20.04

    sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io
    example: sudo apt-get install docker-ce=5:24.0.4-1~ubuntu.20.04~focal docker-ce-cli=5:24.0.4-1~ubuntu.20.04~focal containerd.io -y
  • Example in ubuntu 22.x

    example: sudo apt-get install docker-ce=5:24.0.4-1~ubuntu.22.04~jammy docker-ce-cli=5:24.0.4-1~ubuntu.22.04~jammy containerd.io -y

Install Docker using WaveMaker Script

• For the Ubuntu users, to install Docker to the latest version that supports WaveMaker, the user need to use their own approach or WaveMaker provides a script to install.

  • Run the following command to install the Docker.

   sudo bash wme-utility.sh --docker-upgrade 

StudioWorkspace Instance / AppDeployment Instance

• No need to do any configurations. The Platform will do it automatically.

The ssh user does not have privileges install/upgrade utility software

Platform Instance

usermod -aG docker <user>
chown -R <user>:<user> /wm-data  

StudioWorkspace Instance / AppDeployment Instance

The given ssh user does not have permission to install software Then install below as per the operating system.

• If the user given to the Platform doesn't have privileged access, then provide below permission for the user given on StudioWorkspace Instance / AppDeployment Instance.
• Create a user group if not present in StudioWorkspace Instance / AppDeployment Instance .

sudo groupadd <user>

• Have to execute these commands from privileged users.

  • Add user to the docker group.
  • Make the user as an owner for the docker systemd process.
  • data directory should be owned by the user.
  • Give permission to manage docker.service, systemctl daemon-reload, iptable.

  usermod -aG docker <user>
  mkdir -p /etc/systemd/system/docker.service.d/
  chown -R <user>:<user> /etc/systemd/system/docker.service.d
  chown -R <user>:<user> /data
  echo "%<user> ALL=NOPASSWD: /bin/systemctl restart docker,/bin/systemctl daemon-reload,/sbin/iptables" >> /etc/sudoers.d/<sudoers-file-name>

RHEL

The ssh user has privileges (root/sudo) or user doesn't have privileges for install/upgrade utility softwares

Platform Instance and StudioWorkspace Instance / AppDeployment Instance

• If given ssh user has privileges (root/sudo) or the user doesn't have privileges to install/upgrade. WME Installer will automatically install the Docker software.

• Install below prerequisites in Platform

• update cache

yum update -y

• Install wget

yum install wget  -y

• Install container-selinux for RHEL 7 version only

yum install http://mirror.centos.org/centos/7/extras/x86_64/Packages/container-selinux-2.107-1.el7_6.noarch.rpm -y

• Install the latest version of Docker

  • Install prerequisites to install Docker in RHEL7

      yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
      wget http://mirror.centos.org/centos/7/extras/x86_64/Packages/slirp4netns-0.4.3-4.el7_8.x86_64.rpm
      wget http://mirror.centos.org/centos/7/extras/x86_64/Packages/fuse3-devel-3.6.1-4.el7.x86_64.rpm
      wget http://mirror.centos.org/centos/7/extras/x86_64/Packages/fuse3-libs-3.6.1-4.el7.x86_64.rpm
      wget http://mirror.centos.org/centos/7/extras/x86_64/Packages/fuse-overlayfs-0.7.2-6.el7_8.x86_64.rpm
      sudo yum install slirp4netns-0.4.3-4.el7_8.x86_64.rpm -y
      sudo yum install fuse3-devel-3.6.1-4.el7.x86_64.rpm -y
      sudo yum install fuse3-libs-3.6.1-4.el7.x86_64.rpm -y
      sudo yum install fuse-overlayfs-0.7.2-6.el7_8.x86_64.rpm -y
  • To Install Docker in RHEL 7 use the following commands

    wget https://download.docker.com/linux/centos/7/x86_64/stable/Packages/docker-ce-cli-24.0.6-1.el7.x86_64.rpm
    wget https://download.docker.com/linux/centos/7/x86_64/stable/Packages/containerd.io-1.6.18-3.1.el7.x86_64.rpm
    wget https://download.docker.com/linux/centos/7/x86_64/stable/Packages/docker-ce-24.0.6-1.el7.x86_64.rpm
    sudo yum install docker-ce-cli-24.0.6-1.el7.x86_64.rpm -y
    sudo yum install containerd.io-1.6.18-3.1.el7.x86_64.rpm -y
    sudo yum install docker-ce-24.0.6-1.el7.x86_64.rpm -y
  • To Install Docker in RHEL 8 use the following commands

    yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
    wget https://download.docker.com/linux/centos/8/x86_64/stable/Packages/docker-ce-cli-24.0.6-1.el8.x86_64.rpm
    wget https://download.docker.com/linux/centos/8/x86_64/stable/Packages/containerd.io-1.6.18-3.1.el8.x86_64.rpm
    wget https://download.docker.com/linux/centos/8/x86_64/stable/Packages/docker-ce-24.0.6-1.el8.x86_64.rpm
    sudo yum install docker-ce-cli-24.0.6-1.el8.x86_64.rpm -y
    sudo yum install containerd.io-1.6.18-3.1.el8.x86_64.rpm -y
    sudo yum install docker-ce-24.0.6-1.el8.x86_64.rpm -y
  • To Install Docker in RHEL 9 use the following commands

    yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
    wget https://download.docker.com/linux/centos/9/x86_64/stable/Packages/docker-ce-cli-24.0.6-1.el9.x86_64.rpm 
    wget https://download.docker.com/linux/centos/9/x86_64/stable/Packages/containerd.io-1.6.18-3.1.el9.x86_64.rpm 
    wget https://download.docker.com/linux/centos/9/x86_64/stable/Packages/docker-ce-24.0.6-1.el9.x86_64.rpm
    sudo yum install docker-ce-cli-24.0.6-1.el9.x86_64.rpm -y
    sudo yum install containerd.io-1.6.18-3.1.el9.x86_64.rpm -y
    sudo yum install docker-ce-24.0.6-1.el9.x86_64.rpm -y

  systemctl enable docker
  systemctl start docker
  docker --version

• Install python3

yum install python3 -y

Extra configuration on RHEL Platform Instance if ssh user doesn't have privileges(non sudo users)

• If the user doesn't have privileged access, then provide the below permissions to the user.

chown -R <user>:<user> /wm-data
usermod -aG docker <user>

Extra configurations on RHEL StudioWorkspace Instance / AppDeployment Instance if ssh user doesn't have privileges(non sudo users)

• If the user given to the Platform doesn't have privileged access, then provide below permission for the user given on StudioWorkspace Instance / AppDeployment Instance.
• Create a user group if not present in StudioWorkspace Instance / AppDeployment Instance .

sudo groupadd <user>

• Have to execute these commands as a privileged user.

  • Add user to the docker group.
  • Make a user the owner of the docker systemd process
  • data directory should be owned by the user.
  • Give permission to manage docker.service, systemctl daemon-reload, iptable.

  usermod -aG docker <user>
  chown -R <user>:<user> /usr/lib/systemd/system
  chown -R <user>:<user> /data
  echo "%<user> ALL=NOPASSWD: /bin/systemctl restart docker,/bin/systemctl daemon-reload,/usr/sbin/iptables" >> /etc/sudoers.d/<sudoers-file-name>