Version: v11.10.2

Docker Upgrade

Docker upgrade is required when you have docker version below 24.0.6 .
User needs to upgrade docker if ssh-user doesn't have root/sudo privileges in Ubuntu OS StudioWorkspaceInstance/AppDeploymentInstance and if ssh-user have or doesn't have root/sudo privileges in RHEL OS StudioWorkspaceInstance/AppDeploymentInstance.
Make sure Hibernate and passivate user containers and application containers from launchpad.
So follow the steps below when you added StudioWorkspaceInstance/AppDeploymentInstance.

Docker Upgrade in Ubuntu

Stop the current Docker.

  service docker.socket stop
  service docker stop

Update the apt package index and install packages to allow apt to use a repository over HTTPS:

     sudo apt-get update
     sudo apt-get install ca-certificates curl gnupg lsb-release

Add Docker’s official GPG key:

     sudo mkdir -p /etc/apt/keyrings
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Use the following command to set up the repository:

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

To upgrade and install the latest version of Docker, run the following command to list all the available versions:
```
  sudo apt-get update
  apt-cache madison docker-ce
  apt-cache madison docker-ce-cli
```

Run the following command to install a 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:24.0.6-1~ubuntu.20.04~focal docker-ce-cli=5:24.0.6-1~ubuntu.20.04~focal containerd.io -y

Example in ubuntu 22.x

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

Upgrade Docker using WaveMaker Script

To Upgrade Docker to the latest version, 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 
```
If the given platform user does not have privileged access, then provide the below permissions for the given user on StudioWorkspace Instance/AppDeployment Instance.

The user should be able to execute the following commands as a privileged user:

Add user to the Docker group.
Make the user an owner of the Docker systemd process.
Data directory should be owned by the user.
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>

Docker Upgrade in RHEL

Upgrade or Install the latest version of Docker.

Stop the current Docker.

  service docker.socket stop
  service docker stop

List the current Docker package version.

  yum list docker-ce

Remove the current Docker Engine.

  rpm -e <installed-package>
  example: rpm -e docker-ce.x86_64 docker-ce-rootless-extras.x86_64

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

To Upgrade 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

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 Upgrade 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

    systemctl enable docker
    systemctl start docker
    docker --version

note

You can choose to install Docker in any other way as per your company policy.
Above commands depict one of them.
Make sure to do the activities below after the Docker installation.

If the given platform user doesn't have privileged access, then provide the below permissions for the given user on StudioWorkspace Instance / AppDeployment Instance.

The user should be able to execute the following commands as a privileged user:

Add user to the Docker group.
Make the user an owner of the Docker system process.
Data directory should be owned by the user.
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>

Make sure to Run below command after installation of docker completes to have WaveMaker docker configuration to your installed docker

For Ubuntu
```
    bash docker_configure.sh
```
For RHEL
```
    bash docker_setup_rhel.sh
```

note

Excute the above configuration files only after giving the permissions if it in the case of non-root execution., which the steps are given in the next page.

Studio Workspace/AppDeploy Instances Sync and Patch using Launchpad

You can also apply the Sync or Patch using the Launchpad. To Apply, go to the Launchpad and Navigate to the Developer Workspace or App Deployements.
On the Capacity, you can see the Workspace/AppDeploy Instance details. On the Icons Shown, you can find the patch and the sync option.

Docker Upgrade​

Docker Upgrade in Ubuntu​

Upgrade Docker using WaveMaker Script​

Docker Upgrade in RHEL​

Make sure to Run below command after installation of docker completes to have WaveMaker docker configuration to your installed docker​

Studio Workspace/AppDeploy Instances Sync and Patch using Launchpad​

Go to Launchpad and see Instance status. You can start working on WaveMaker Studio once the Instances status has started.​