Veritas NetBackup™ CloudPoint Install and Upgrade Guide

To upgrade CloudPoint server in Docker environment

1. Download the CloudPoint upgrade installer.

   On the CloudPoint download page, click Download Now to download the CloudPoint installer.

   The CloudPoint software components are available in the form of Docker images and these images are packaged in a compressed file. The file name has the following format:

   Veritas_CloudPoint_9.x.x.x.img.gz

   The numerical sequence in the file name represents the product version.

2. Copy the downloaded compressed image file to the computer on which you want to deploy CloudPoint.
3. Load the image file using the following command:

   # sudo docker load -i <imagefilename>

   For example, if the version is 9.1.0.0.9349, the command syntax is as follows:

   # sudo docker load -i Veritas_CloudPoint_9.1.0.0.9349.img.gz

   Messages similar to the following appear on the command line:

   Load -i VRTScloudpoint-docker-9.1.0.0.9349.img.gz
   
   3b48714f4630: Loading layer [====================>]  26.62kB/26.62kB
   e2be05255641: Loading layer [====================>]  1.022GB/1.022GB
   f4019e787431: Loading layer [====================>]  71.16MB/71.16MB
   8fa41882618d: Loading layer [====================>]   2.56kB/2.56kB
   2eb7b5f07188: Loading layer [====================>]  433.6MB/433.6MB
   9a80f5e55187: Loading layer [====================>]  3.072kB/3.072kB
   Loaded image: veritas/flexsnap-policy:9.1.0.0.9349
   4610240a3245: Loading layer [====================>]   2.56kB/2.56kB
   009536fb1f1f: Loading layer [====================>]  4.096kB/4.096kB
   e281e184c054: Loading layer [====================>]  51.31MB/51.31MB
   01455a2a7aca: Loading layer [====================>]  38.89MB/38.89MB
   0cd7f5d9561b: Loading layer [====================>]  803.8kB/803.8kB
   cbe0c1de2aeb: Loading layer [====================>]  3.072kB/3.072kB
   bf3c086d3dc8: Loading layer [====================>]  99.56MB/99.56MB
   Loaded image: veritas/flexsnap-api-gateway:9.1.0.0.9349
   0c5d3de7e49e: Loading layer [====================>]  38.26MB/38.26MB
   ecc5f9d1a612: Loading layer [====================>]  57.34kB/57.34kB
   02b122e862b3: Loading layer [====================>]  4.327MB/4.327MB
   Loaded image: veritas/flexsnap-cloudpoint:9.1.0.0.9349
   Loaded image: veritas/flexsnap-fluentd:9.1.0.0.9349
   60b2acb680f6: Loading layer [====================>]  3.584kB/3.584kB
   f595300c08bc: Loading layer [====================>]  3.584kB/3.584kB
   Loaded image: veritas/flexsnap-mongodb:9.1.0.0.9349
   Loaded image: veritas/flexsnap-agent:9.1.0.0.9349
   Loaded image: veritas/flexsnap-scheduler:9.1.0.0.9349
   8df81d5ea017: Loading layer [====================>]   7.68kB/7.68kB
   7d0351be3c82: Loading layer [====================>]  3.072kB/3.072kB
   Loaded image: veritas/flexsnap-nginx:9.1.0.0.9349
   2ab7b82b7b67: Loading layer [====================>]  433.6MB/433.6MB
   cb5786a5d4da: Loading layer [====================>]  3.072kB/3.072kB
   Loaded image: veritas/flexsnap-coordinator:9.1.0.0.9349
   82845be8152d: Loading layer [====================>]   2.56kB/2.56kB
   4335a9dd8761: Loading layer [====================>]  433.6MB/433.6MB
   7726c32b0a94: Loading layer [====================>]  3.072kB/3.072kB
   Loaded image: veritas/flexsnap-onhostagent:9.1.0.0.9349
   ee9829847a2f: Loading layer [====================>]  10.12MB/10.12MB
   e821f4ed533d: Loading layer [====================>]   2.56kB/2.56kB
   b2ca6971711b: Loading layer [====================>]  17.92kB/17.92kB
   ac4489fdf0fb: Loading layer [====================>]  38.26MB/38.26MB
   7a3246be4423: Loading layer [====================>]  12.92MB/12.92MB
   663007ab9b7a: Loading layer [====================>]  31.74kB/31.74kB
   Loaded image: veritas/flexsnap-config:9.1.0.0.9349
   7eb7d2ecf33a: Loading layer [====================>]  12.92MB/12.92MB
   4cbef47218cf: Loading layer [====================>]  3.072kB/3.072kB
   Loaded image: veritas/flexsnap-certauth:9.1.0.0.9349
   44ed763d4f00: Loading layer [====================>]  38.29MB/38.29MB
   a6d54a76196f: Loading layer [====================>]  4.096kB/4.096kB
   e0340c5d3b40: Loading layer [====================>]  3.072kB/3.072kB
   Loaded image: veritas/flexsnap-rabbitmq:9.1.0.0.9349
   Loaded image: veritas/flexsnap-notification:9.1.0.0.9349
   45358ab4ca0b: Loading layer [====================>]  42.52MB/42.52MB
   31b87f996cd9: Loading layer [====================>]  3.072kB/3.072kB
   fe498c617335: Loading layer [====================>]  48.66MB/48.66MB
   Loaded image: veritas/flexsnap-idm:9.1.0.0.9349
   
   Loaded image: veritas/flexsnap-cloudpoint:9.1.0.0.9349

   Make a note of the loaded image name and version that appears towards the end of the status messages on the command prompt. This represents the new CloudPoint version that you wish to upgrade to. You will need this information in the subsequent steps.

   Note:

   The version displayed here is used for representation only. The actual version will vary depending on the product release you are installing.

4. Make a note of the current CloudPoint version that is installed. You will use the version number in the next step.
5. Verify that there are no protection policy snapshots or other operations in progress and then stop CloudPoint by running the following command:

   # sudo docker run -it --rm -v /cloudpoint:/cloudpoint 
   -v /var/run/docker.sock:/var/run/docker.sock 
   veritas/flexsnap-cloudpoint:<current_version> stop

   Here, current_version represents the currently installed CloudPoint version. Use the version number you noted in the earlier step.

   For example, if the installed CloudPoint version is 9.0.0.0.9234, the command will be as follows:

   # sudo docker run -it --rm -v /cloudpoint:/cloudpoint 
   -v /var/run/docker.sock:/var/run/docker.sock 
   veritas/flexsnap-cloudpoint:9.0.0.0.9234 stop

   Note:

   This is a single command. Ensure that you enter the command without any line breaks.

   The CloudPoint containers are stopped one by one. Messages similar to the following appear on the command line:

   Stopping the services
   Stopping container: flexsnap-agent.8a51aac1848c404ab61e4625d7b88703 ...done
   Stopping container: flexsnap-workflow-long-15 ...done
   Stopping container: flexsnap-workflow-long-14 ...done
   Stopping container: flexsnap-workflow-long-13 ...done
   Stopping container: flexsnap-workflow-long-12 ...done
   Stopping container: flexsnap-workflow-long-11 ...done
   Stopping container: flexsnap-workflow-long-10 ...done
   Stopping container: flexsnap-workflow-long-9 ...done
   Stopping container: flexsnap-workflow-long-8 ...done
   Stopping container: flexsnap-workflow-long-7 ...done
   Stopping container: flexsnap-workflow-long-6 ...done
   Stopping container: flexsnap-workflow-long-5 ...done
   Stopping container: flexsnap-workflow-long-4 ...done
   Stopping container: flexsnap-workflow-long-3 ...done
   Stopping container: flexsnap-workflow-long-2 ...done
   Stopping container: flexsnap-workflow-long-1 ...done
   Stopping container: flexsnap-workflow-long-0 ...done
   Stopping container: flexsnap-workflow-15 ...done
   Stopping container: flexsnap-workflow-14 ...done
   Stopping container: flexsnap-workflow-13 ...done
   Stopping container: flexsnap-workflow-12 ...done
   Stopping container: flexsnap-workflow-11 ...done
   Stopping container: flexsnap-workflow-10 ...done
   Stopping container: flexsnap-workflow-9 ...done
   Stopping container: flexsnap-workflow-8 ...done
   Stopping container: flexsnap-workflow-7 ...done
   Stopping container: flexsnap-workflow-6 ...done
   Stopping container: flexsnap-workflow-5 ...done
   Stopping container: flexsnap-workflow-4 ...done
   Stopping container: flexsnap-workflow-3 ...done
   Stopping container: flexsnap-workflow-2 ...done
   Stopping container: flexsnap-workflow-1 ...done
   Stopping container: flexsnap-workflow-0 ...done
   Stopping container: flexsnap-nginx ...done
   Stopping container: flexsnap-notification ...done
   Stopping container: flexsnap-policy ...done
   Stopping container: flexsnap-scheduler ...done
   Stopping container: flexsnap-idm ...done
   Stopping container: flexsnap-onhostagent ...done
   Stopping container: flexsnap-agent ...done
   Stopping container: flexsnap-coordinator ...done
   Stopping container: flexsnap-api-gateway ...done
   Stopping container: flexsnap-certauth ...done
   Stopping container: flexsnap-rabbitmq ...done
   Stopping container: flexsnap-mongodb ...done
   Stopping container: flexsnap-fluentd ...done

   Wait for all the CloudPoint containers to be stopped and then proceed to the next step.

6. Upgrade CloudPoint by running the following command:

   # sudo docker run -it --rm -v /cloudpoint:/cloudpoint 
   -v /var/run/docker.sock:/var/run/docker.sock
   veritas/flexsnap-cloudpoint:<new_version> install

   For an unattended installation, use the following command:

   # sudo docker run -it --rm -v /cloudpoint:/cloudpoint 
   -v /var/run/docker.sock:/var/run/docker.sock
   veritas/flexsnap-cloudpoint:<new_version> install -y

   Here, new_version represents the CloudPoint version you are upgrading to.

   The -y option passes an approval for all the subsequent installation prompts and allows the installer to proceed in a non-interactive mode.

   For example, using the version number specified earlier, the command will be as follows:

   # sudo docker run -it --rm -v /cloudpoint:/cloudpoint 
   -v /var/run/docker.sock:/var/run/docker.sock
   veritas/flexsnap-cloudpoint:9.1.0.0.9349 install -y

   Note:

   This is a single command. Ensure that you enter the command without any line breaks.

7. The new CloudPoint installer detects the existing CloudPoint containers that are running and asks for a confirmation for removing them.

   Press Y to confirm the removal of the old CloudPoint containers.

   Note:

   No inputs are required if the installer is run in a non-interactive mode.

   The installer first loads the individual service images and then launches them in their respective containers.

   Wait for the installer to display messages similar to the following and then proceed to the next step:

   Installing the services
   Configuration started at time: Sat May  1 17:27:49 UTC 2021
   docker server version: 19.03.12 Supported: true
   This is an upgrade to NetBackup CloudPoint 9.1.0.0.9349
   Previous CloudPoint version: 9.0.0.0.9234
   Removing exited container flexsnap-ipv6config ...done
   The containers
   flexsnap-agent.9eb4362a2aff43f885be984467faa230
   flexsnap-agent.0ae95311f7f74be89659e62746389bb7
   flexsnap-workflow-system-0-min
   flexsnap-workflow-general-0-min
   flexsnap-listener
   flexsnap-nginx
   flexsnap-notification
   flexsnap-policy
   flexsnap-scheduler
   flexsnap-idm
   flexsnap-onhostagent
   flexsnap-agent
   flexsnap-coordinator
   flexsnap-api-gateway
   flexsnap-certauth
   flexsnap-rabbitmq
   flexsnap-mongodb
   flexsnap-fluentd
   are running.
   Do you wish to remove them ? (y/n): y
   Removing container flexsnap-agent.9eb4362a2aff43f885be984467faa230 ...done
   Removing container flexsnap-agent.0ae95311f7f74be89659e62746389bb7 ...done
   Removing container flexsnap-workflow-system-0-min ...done
   Removing container flexsnap-workflow-general-0-min ...done
   Removing container flexsnap-listener ...done
   Removing container flexsnap-nginx ...done
   Removing container flexsnap-notification ...done
   Removing container flexsnap-policy ...done
   Removing container flexsnap-scheduler ...done
   Removing container flexsnap-idm ...done
   Removing container flexsnap-onhostagent ...done
   Removing container flexsnap-agent ...done
   Removing container flexsnap-coordinator ...done
   Removing container flexsnap-api-gateway ...done
   Removing container flexsnap-certauth ...done
   Removing container flexsnap-rabbitmq ...done
   Removing container flexsnap-mongodb ...done
   Removing container flexsnap-fluentd ...done
   Deleting network : flexsnap-network ...done
   Do you want to take a backup of the CloudPoint metadata prior to upgrade?
   (y/n): y
   Taking backup of CloudPoint metadata...done
   Backup completed successfully.
   Backup file located at /cloudpoint/backup/cloudpoint_9.0.0.0.9234.tar.gz.
   Creating network: flexsnap-network ...done
   Starting container: flexsnap-fluentd ...done
   Starting container: flexsnap-ipv6config ...done
   Starting container: flexsnap-mongodb ...done
   Starting container: flexsnap-rabbitmq ...done
   Starting container: flexsnap-certauth ...done
   Starting container: flexsnap-api-gateway ...done
   Starting container: flexsnap-coordinator ...done
   Starting container: flexsnap-listener ...done
   Starting container: flexsnap-agent ...done
   Starting container: flexsnap-onhostagent ...done
   Starting container: flexsnap-scheduler ...done
   Starting container: flexsnap-policy ...done
   Starting container: flexsnap-notification ...done
   Starting container: flexsnap-idm ...done
   Starting container: flexsnap-config ...done
   Starting container: flexsnap-nginx ...done
   Upgrade finished at time: Sat May  1 17:28:53 UTC 2021
   Before using backups from cloud snapshots, re-register CloudPoint with the
   NetBackup primary server
   

8. (Optional) Run the following command to remove the previous version images.

   # docker rmi -f <imagename>:<oldimage_tagid>

9. To verify that the new CloudPoint version is installed successfully:

   See Verifying that CloudPoint is installed successfully.

10. This concludes the upgrade process. Verify that your CloudPoint configuration settings and data are preserved as is.
11. If CloudPoint is not registered with the NetBackup primary server, you must register it now.

    Refer to the NetBackup Web UI Cloud Administrator's Guide for instructions.