Upgrading a Citrix ADC CPX Instance
You can upgrade a Citrix ADC CPX instance by shutting it down, installing the latest version on the same mount point, and then deleting the old instance. A mount point is a directory into which you mount the /cpx directory on the host.
For example, to mount the /cpx directory of the existing Citrix ADC CPX instance in the host’s /var/cpx directory, the mount point is /var/cpx and the Citrix ADC CPX mount directory is /cpx as shown below:
root@ubuntu:~# docker run -dt -e EULA=yes --name mycpx -v /var/cpx:/cpx --ulimit core=-1 cpx:13.0-x.x
<!--NeedCopy-->
Prerequisites
Ensure that you have:
-
Details of the host directory in which you mounted the existing Citrix ADC CPX instance’s
/cpx
directory. You can use thedocker inspect <containerName>
command, where<containerName>
is the name of the Citrix ADC CPX container, to display information about the host directory.The output of the command provides the details of the container configurations, including the volumes. In the “Mounts” entry, the “Source” subentry shows the location of the host directory on the host.
-
Download the latest Citrix ADC CPX Docker image file and load the Citrix ADC CPX Docker image. To load the image, navigate to the directory in which you saved the Docker image file. Use the
docker load -i <image_name>
command to load the image. After the Citrix ADC CPX image is loaded, you can enter the docker images command to display information about the image:
root@ubuntu:~# docker load -i cpx-13.0-x.x.gz
root@ubuntu:~# docker images
REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE
cpx 13.0-x.x 2e97aadf918b 43 hours ago 414.5 MB
<!--NeedCopy-->
To upgrade a Citrix ADC CPX instance
-
Stop the existing Citrix ADC CPX instance by entering the
docker stop <containerName>
command, where<containerName>
is the name of the Citrix ADC CPX instance.root@ubuntu:~# docker stop mycpx mycpx <!--NeedCopy-->
-
Using the
docker run
command, deploy the latest Citrix ADC CPX instance from the Citrix ADC CPX image that you loaded onto the host. Ensure that you deploy the instance at the same mount point (for example,/var/cpx:/cpx
) that you used for the existing Citrix ADC CPX instance.root@ubuntu:~# docker run -dt -P -e CPX_CORES=1 --name latestcpx --ulimit core=-1 -e EULA=yes -v /var/cpx:/cpx --cap-add=NET_ADMIN cpx:13.0-x.x <!--NeedCopy-->
You can enter the
docker ps
command so that you can verify that the deployed Citrix ADC CPX instance is the latest version.``` root@ubuntu:~# docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES ead12ec4e965 cpx:13.0-x.x "/bin/sh -c 'bash -C " 5 seconds ago Up 5 seconds 22/tcp, 80/tcp, 443/tcp, 161/udp latestcpx <!--NeedCopy--> ```
-
After verifying that you deployed the correct Citrix ADC CPX instance, enter the docker rm <containerName> command to delete the older instance.
root@ubuntu:~# docker rm mycpx mycpx <!--NeedCopy-->