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

  1. Download the new Domino Docker web kit from the HCL Licensing Portal.
  2. From the Docker terminal window, load the domino-docker tar archive file provided in the web kit to Docker:
    docker load --input <tar archive file>
    
    For example:
    docker load --input Domino_1101FP1_DockerImage.tgz
  3. Remove the existing Domino container:
    docker rm <container>
    For example:
    docker rm domino1101
  4. 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
  5. 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.
    docker run --rm --name <container name> -v <docker volume name>:<data directory> 
      --hostname <hostname> <image> --update --run-design
    For example:
    docker run --rm --name dominoupgrade -v notesdata:/local/notesdata --hostname docker.renovations.com 
        domino-docker:V1101FP1 --update --run-design
  6. Quit the Domino server. The container stops and is removed.
  7. Complete the procedure Creating a container for Domino.