Upgrading Eclipse Amlen in a Docker environment

System administrators can upgrade the Eclipse Amlen server or Web UI running in a Docker container.

Data that must persist for Eclipse Amlen in the /var/messagesight directory must be volume mapped to a directory outside the container.

When you are updating the Eclipse Amlen server or Web UI software that is running in a Docker container, it is best practice to update the container. The process of updating the container is the same as the process for building a new container, with the exception that you must remove the existing container.

Prepare the Eclipse Amlen .tz files for installation.

For more information, see Preparing the Eclipse Amlen .tz packages for installation.
Build the Eclipse Amlen Docker image.
- Build the Eclipse Amlen server image by issuing the following command:
```
docker build --force-rm=true -t imaserver:2.0 .
```
- Build the Eclipse Amlen Web UI image by issuing the following command:
```
docker build --force-rm=true -t imawebui:2.0 .
```
Stop the existing containers.
- Stop the server container by issuing the following command:
```
docker stop <server_container_name>
```
  where <server_container_name> is the name of the container in which the Eclipse Amlen server is running. For example,
```
docker stop IMA
```
- Stop the Web UI container by issuing the following command:
```
docker stop <webui_container_name>
```
  where <webui_container_name> is the name of the container in which the Eclipse Amlen Web UI is running. For example,
```
docker stop IMAWEBUI
```
Remove the containers.
- Remove the server container by issuing the following command:
```
docker rm <server_container_name>
```
  where <server_container_name> is the name of the container in which the Eclipse Amlen server was running. For example,
```
docker rm IMA
```
- Remove the Web UI container by issuing the following command:
```
docker rm <webui_container_name>
```
  where <webui_container_name> is the name of the container in which the Eclipse Amlen Web UI was running. For example,
```
docker rm IMAWEBUI
```
Remove the Docker images.
- Remove the Eclipse Amlen server image by issuing the following command:
```
docker rmi -f $(docker ps | grep imaserver | awk '{print $3}')
```
- Remove the Eclipse Amlen Web UI image by issuing the following command:
```
docker rmi -f $(docker ps | grep imawebui | awk '{print $3}')
```

Start the containers.

Use the same Docker run command that you used previously before applying the update.

For example, to start the Eclipse Amlen server container, use a command similar to the following command:

docker run --cap-add SYS_PTRACE --cap-add SYS_ADMIN --cap-add NET_ADMIN 
--security-opt apparmor:unconfined --net=host -P -it --name=IMA --env-file=imaserver-docker.env 
-m 84G -v /mnt/messagesight:/var/messagesight -v /mnt/tmp:/var/tmp -d imaserver:2.0

To start the Eclipse Amlen Web UI container, use a command similar to the following command:

docker run --cap-add SYS_PTRACE --cap-add SYS_ADMIN --cap-add NET_ADMIN 
--security-opt apparmor:unconfined --net=host -P -it --name=IMAW --env-file=imaserver-docker.env 
-m 4G -v /mnt/messagesight:/var/messagesight -v /mnt/tmp:/var/tmp -d imaserver:2.0