Skip to main content
Version: v10.15

Install Prerequisites Softwares

Ubuntu​

The ssh user has privileges(root/sudo) for install/upgrade utility softwares​

Platform Instance​

  • If given ssh user has privileges(root/sudo) to install/upgrade.
  • WME Installer will automatically install the required software.
  • Same applies for StudioWorkspace Instance / AppDeployment Instance as well.
  • Internet is not required for Installation in this case.

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​

  • No need to do install any software, WME Installer will automatically install the required software, and execute the below commands to provide required permissions to the ssh nonprivileged user.
  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.

  • Install wget
sudo apt-get install wget  -y
  • Install python3.
sudo apt-get install python3 -y

  • Install Docker repository

        apt-get install apt-transport-https
        curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
    • To add docker repository for ubuntu xenial(16.04.6)
      echo "deb [arch=amd64] https://download.docker.com/linux/ubuntu xenial stable" > /etc/apt/sources.list.d/docker.list
    • To add docker repository for ubuntu bionic(18.04.5)
      echo "deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable" > /etc/apt/sources.list.d/docker.list
    • To add docker repository for ubuntu focal(20.04.2.0)
      echo "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable" > /etc/apt/sources.list.d/docker.list
    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-cache madison docker-ce
      apt-cache madison docker-ce-cli
    • Run the following command to Install the specific version of Docker
      sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io
      example: sudo apt-get install docker-ce=5:20.10.7~3-0~ubuntu-focal docker-ce-cli=5:20.10.7~3-0~ubuntu-focal containerd.io -y

  • 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​

  • 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 python3
  yum install python3 -y

StudioWorkspace Instance / AppDeployment Instance​

Install below software on StudioWorkspace Instance / AppDeployment Instance for unprivileged ssh user's

note

Use the same version numbers as mentioned.

  • 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 prerequissites 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-20.10.7-3.el7.x86_64.rpm
      wget https://download.docker.com/linux/centos/7/x86_64/stable/Packages/containerd.io-1.4.6-3.1.el7.x86_64.rpm
      wget https://download.docker.com/linux/centos/7/x86_64/stable/Packages/docker-ce-20.10.7-3.el7.x86_64.rpm
      sudo yum install docker-ce-cli-20.10.7-3.el7.x86_64.rpm -y
      sudo yum install containerd.io-1.4.6-3.1.el7.x86_64.rpm -y
      sudo yum install docker-ce-20.10.7-3.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-20.10.7-3.el8.x86_64.rpm
      wget https://download.docker.com/linux/centos/8/x86_64/stable/Packages/containerd.io-1.4.6-3.1.el8.x86_64.rpm
      wget https://download.docker.com/linux/centos/8/x86_64/stable/Packages/docker-ce-20.10.7-3.el8.x86_64.rpm
      sudo yum install docker-ce-cli-20.10.7-3.el8.x86_64.rpm -y
      sudo yum install containerd.io-1.4.6-3.1.el8.x86_64.rpm -y
      sudo yum install docker-ce-20.10.7-3.el8.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>