When a new version of OpenText eDirectory Image is available, the administrator can perform an upgrade procedure to deploy container with the latest version of OpenText eDirectory. Ensure to store all necessary application related data persistently in Docker volumes before performing an upgrade. Perform the following steps to upgrade OpenText eDirectory using Docker container:
Stop and remove the running eDirectory container. Since the running containers cannot use the new image, they should be stopped and removed before performing an upgrade.
Start a new container using the new OpenText eDirectory Docker image and the application data of the old container stored in Docker volume:
The following example shows how to start an OpenText eDirectory container with a volume mounted to it for storage purpose:
docker run -it --name eDir1-Host --stop-timeout 180 --restart on-failure:5 --memory="700M" --cpuset-cpus="1" --pids-limit="300" --volume eDir-volume1:/config --network=host <eDirectory_image> new -t docker-tree1 -n novell -S m1 -B <Host_IP_Address>@1524 -o 1028 -O 1030 -L 1389 -l 1636 --configure-eba-now yes
The following example shows how to upgrade the OpenText eDirectory container created in step 2:
docker run -it --name eDir1-Host --stop-timeout 180 --restart on-failure:5 --memory="700M" --cpuset-cpus="1" --pids-limit="300" --volume eDir-volume1:/config --network=host <Latest_eDirectory_image> upgrade
eDir-volume1 is the same volume that retains the application data of the old OpenText eDirectory container.
NOTE:
OpenText eDirectory container should only be upgraded after removing the container running the old version of the image.
It is not recommended to use the -a and -w options of the ndsconfig command. You should use the on-screen prompt to enter the administrator’s credentials for upgrading the container.
When a running OpenText eDirectory container becomes inaccessible, deleted or unusable due to unknown reasons, a container recovery should be performed. In such scenario, the impacted container should be stopped and removed. A new container should be started using the same OpenText eDirectory image and the Docker Volume of the impacted container. Perform the following steps to recover a OpenText eDirectory container:
Stop and remove the impacted container.
Start a new container with the same OpenText eDirectory image and the volume of the impacted container. The following example shows how to recover an impacted container:
docker run -it --name eDir1-Host --stop-timeout 180 --restart on-failure:5 --memory="700M" --cpuset-cpus="1" --pids-limit="150" --volume eDir-volume1:/config --network=host <same_eDirectory_image> upgrade
eDir-volume1 is the same volume that retains the application data of the impacted OpenText eDirectory container.