Upgrading NetScaler CPX Instances
You can upgrade the NetScaler CPX instance by deleting the current instance, and re-installing the latest version of NetScaler CPX on the same mount point that you had used while installing the existing NetScaler CPX instance. A mount point is a directory on the host, where you mount the /cpx directory. For more information, see https://docs.docker.com/engine/tutorials/dockervolumes/.
For example, while installing the NetScaler CPX instance, if you had mounted the /cpx directory of the existing NetScaler CPX instance on /var/cpx directory on the host, then the mount point is /var/cpx and the NetScaler CPX mount directory is /cpx as shown below:
root@ubuntu:~# docker run -dt --privileged=true -e EULA=yes --name mycpx -v /var/cpx:/cpx --ulimit core=-1 cpx:11.1-48.xx
Make sure that you use the same mount point and NetScaler CPX directory, /var/cpx:/cpx when you install the latest version of the NetScaler CPX.
Prerequisites
Make sure that you have:
- Details of the host directory where you have mounted the existing NetScaler CPX instance’s /cpx directory. You can use the following docker inspect command to obtain the details of the host directory.
docker inspect <container_name>
Where *
The output of the command provides the details on the container configurations including the volumes. Search for the entry called “Mounts” as shown below:
The Source specifies the mount point on the host.
- Download the latest NetScaler CPX Docker image file from: https://www.microloadbalancer.com/get-it-now and then load the NetScaler CPX Docker image, to do so, navigate to the directory where you saved the Docker image file and then run the following command:
docker load -i cpx-11.1-52.xx.gz
After the NetScaler CPX Docker image is loaded, you can view the details of the image by using the following command:
docker images
For example:
root@ubuntu:~# docker images
REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE
cpx 11.1-52.xx 2e97aadf918b 43 hours ago 605.5 MB
To upgrade the NetScaler CPX Instance:
-
Stop the existing NetScaler CPX instance by using the following command:
docker stop <container_name>
Where <container_name> is the name of the NetScaler CPX instance.
For example:
root@ubuntu:~# docker stop mycpx mycpx
-
Using the docker run command, deploy the latest NetScaler CPX instance from the NetScaler CPX image that you have loaded on the host. Make sure that you deploy the instance using the same mount point (for example, /var/cpx:/cpx) that you had used in your existing NetScaler CPX instance.
docker run -dt --privileged=true -e EULA=yes --name <container_name> -v <host_dir>:/cpx--ulimit core=-1 cpx:11.1-52.x
Where:
- <container_name> is the name of the NetScaler CPX instance.
- <host_dir> is the mount point on the host.
root@ubuntu:~# docker run -dt --privileged=true -e EULA=yes --name latestcpx -v /var/cpx:/cpx --ulimit core=-1 cpx:11.1-52.xx
You can verify if the latest NetScaler CPX instance is deployed by using the docker ps command.
For example:
root@ubuntu:~# docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES ead12ec4e965 cpx:11.1-52.xx "/bin/sh -c 'bash -C " 5 seconds ago Up 5 seconds 22/tcp, 80/tcp, 443/tcp, 161/udp latestcpx
-
After you verify if the latest NetScaler CPX instance is deployed, delete the older version of the NetScaler CPX instance by using the following command:
docker rm <container_name>
For example:
root@ubuntu:~# docker rm mycpx mycpx