Upgrading a containerized Domino server
Upgrading a containerized Domino server is done differently than upgrading a non-containerized server.
About this task
To upgrade a containerized Domino server, you delete the container for the current
Domino version then create a new "upgrade" container. The upgrade container uses the
same volume (data directory) as the container for the previous Domino version. When
you create it you include following docker run arguments:
- --update (required) copies templates from the new Domino image to the existing volume.
- --run-design (optional) runs the Domino design process to upgrade the design of databases in the volume.
Note: In the following procedure, you create a temporary upgrade container, remove it
when the template upgrade is complete, and create a new container to run the new
version of Domino. Alternatively, you can skip creating a temporary upgrade
container and go directly to creating the Domino container to run the new version of
Domino. To use this approach, after you complete steps 1 - 3 in this procedure, go
directly to the procedure Creating a container for Domino. Follow the instructions but include the --update and
(optionally) --run-design arguments with the docker
run command. The downside to this approach is that whenever you stop
and start the container (or quit and restart Domino), the templates are copied from
the image to the volume and (optionally) the design process runs.
Procedure
- Download the new Domino Docker web kit from the HCL Licensing Portal.
-
From the Docker terminal window, load the domino-docker tar archive file
provided in the web kit to Docker:
For example:docker load --input <tar archive file>
docker load --input Domino_1101FP1_DockerImage.tgz
-
Remove the existing Domino container:
For example:docker rm <container>
docker rm domino1101
-
To determine the name of the Domino Docker image (required for the next step),
from the Docker terminal window, issue the following command to list the names
of the Docker images on your system.
docker image ls
-
Issue the following command to create a temporary upgrade container . The
--update argument copies templates from the new image to
the volume. The --run-design argument runs the design process
to upgrade databases in the volume. The --rm arguments
removes the container automatically when you quit the server.
For example:docker run --rm --name <container name> -v <docker volume name>:<data directory> --hostname <hostname> <image> --update --run-design
docker run --rm --name dominoupgrade -v notesdata:/local/notesdata --hostname docker.renovations.com domino-docker:V1101FP1 --update --run-design
- Quit the Domino server. The container stops and is removed.
- Complete the procedure Creating a container for Domino.