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 ** is the name of the NetScaler CPX container.

     The output of the command provides the details on the container configurations including the volumes. Search for the entry called “Mounts” as shown below:

localized image

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:

  1.  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
    
  2. 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
    
  3. 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
    

Upgrading NetScaler CPX Instances

In this article