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_10.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 10.0.0.0.9800, the command syntax is as follows:

   # sudo docker load -i Veritas_CloudPoint_10.0.0.0.9800.img.gz

   Messages similar to the following appear on the command line:

   Load -i VRTScloudpoint-docker-10.0.0.0.9800.img.gz
   
   # docker load -i VRTScloudpoint-docker-10.0.0.0.9800.img.gz
   84d4c3ed8c69: Loading layer [==================================================>] 23.04 kB/23.04 kB
   d84981a44f6f: Loading layer [==================================================>] 778.9 MB/778.9 MB
   d16d96b1c9c2: Loading layer [==================================================>] 139.5 MB/139.5 MB
   c3e609767136: Loading layer [==================================================>]  2.56 kB/2.56 kB
   831c43947848: Loading layer [==================================================>] 1.429 GB/1.429 GB
   e4e2d238ca51: Loading layer [==================================================>] 3.072 kB/3.072 kB
   Loaded image: veritas/flexsnap-coordinator:10.0.0.0.9800
   b4c897c6bcb4: Loading layer [==================================================>]  2.56 kB/2.56 kB
   41ddf91b45b9: Loading layer [==================================================>] 1.429 GB/1.429 GB
   8e48499e30a3: Loading layer [==================================================>] 3.072 kB/3.072 kB
   Loaded image: veritas/flexsnap-onhostagent:10.0.0.0.9800
   b0220c3f236d: Loading layer [==================================================>] 27.87 MB/27.87 MB
   9e90f5eac12e: Loading layer [==================================================>]  2.56 kB/2.56 kB
   98765bae5c6b: Loading layer [==================================================>] 20.99 kB/20.99 kB
   1be3ffeabb75: Loading layer [==================================================>]  52.9 MB/52.9 MB
   3042d315be1a: Loading layer [==================================================>] 5.632 kB/5.632 kB
   0a344789d6a2: Loading layer [==================================================>] 32.31 MB/32.31 MB
   a050f5e0c3b2: Loading layer [==================================================>] 35.33 kB/35.33 kB
   Loaded image: veritas/flexsnap-config:10.0.0.0.9800
   e8228e50fe18: Loading layer [==================================================>]   107 MB/107 MB
   4716779a2c02: Loading layer [==================================================>] 20.48 kB/20.48 kB
   c2f47959d296: Loading layer [==================================================>] 32.26 kB/32.26 kB
   91008c4f5394: Loading layer [==================================================>] 273.2 MB/273.2 MB
   Loaded image: veritas/flexsnap-nginx:10.0.0.0.9800
   293db2c3b6b9: Loading layer [==================================================>] 1.429 GB/1.429 GB
   dd80a649929d: Loading layer [==================================================>] 3.072 kB/3.072 kB
   Loaded image: veritas/flexsnap-workflow:10.0.0.0.9800
   3f57d7433543: Loading layer [==================================================>] 83.25 MB/83.25 MB
   1f73b2a83aa0: Loading layer [==================================================>] 20.48 kB/20.48 kB
   1e3d4cc3ad29: Loading layer [==================================================>] 11.78 kB/11.78 kB
   1009be131793: Loading layer [==================================================>] 6.656 kB/6.656 kB
   95a6aa756736: Loading layer [==================================================>] 490.4 MB/490.4 MB
   Loaded image: veritas/flexsnap-datamover:10.0.0.0.9800
   2ec23a901704: Loading layer [==================================================>] 197.6 kB/197.6 kB
   493fc1cdb251: Loading layer [==================================================>] 27.87 MB/27.87 MB
   b72568ad4206: Loading layer [==================================================>]  2.56 kB/2.56 kB
   fec969040470: Loading layer [==================================================>]  52.9 MB/52.9 MB
   54b1b851f710: Loading layer [==================================================>]  70.6 MB/70.6 MB
   Loaded image: veritas/flexsnap-cloudpoint:10.0.0.0.9800
   Loaded image: veritas/flexsnap-scheduler:10.0.0.0.9800
   4de8cab6c086: Loading layer [==================================================>]   142 MB/142 MB
   b355e933b16a: Loading layer [==================================================>] 4.096 kB/4.096 kB
   05b7dc006c75: Loading layer [==================================================>] 3.072 kB/3.072 kB
   Loaded image: veritas/flexsnap-rabbitmq:10.0.0.0.9800
   744c86b54390: Loading layer [==================================================>] 104.1 MB/104.1 MB
   1323ffbff4dd: Loading layer [==================================================>] 20.48 kB/20.48 kB
   b3c084534040: Loading layer [==================================================>] 3.072 kB/3.072 kB
   9e3242667b03: Loading layer [==================================================>] 109.8 MB/109.8 MB
   44bf86c64a25: Loading layer [==================================================>] 868.9 kB/868.9 kB
   f525c078fda1: Loading layer [==================================================>] 3.072 kB/3.072 kB
   3658a337606a: Loading layer [==================================================>] 328.5 MB/328.5 MB
   Loaded image: veritas/flexsnap-api-gateway:10.0.0.0.9800
   6e61460d1644: Loading layer [==================================================>] 9.216 kB/9.216 kB
   ed2435cdcf18: Loading layer [==================================================>] 310.1 MB/310.1 MB
   Loa
   
   Loaded image: veritas/flexsnap-cloudpoint:10.0.0.0.9800

   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.1.0.1.9408, 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.1.9408 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:10.0.0.0.9800 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:

   [root@ip-172-31-28-254 ec2-user]# docker run -it --rm -v /cloudpoint:/cloudpoint -v /var/run/docker.sock:/var/run/docker. sock veritas/flexsnap-cloudpoint:10.0.0.0.9800 install
   Installing the services
   Configuration started at time: Thu Jan 13 16:12:30 UTC 2022
   WARNING: You're not using the default seccomp profile
   docker server version: 1.13.1 Supported: true
   WARNING: You're not using the default seccomp profile
   This is an upgrade to NetBackup CloudPoint 10.0.0.0.9800
   Previous CloudPoint version: 9.1.0.1.9408
   Do you want to take a backup of the CloudPoint metadata prior to upgrade? (y/n): y
   Removing exited container flexsnap-ipv6config ...done
   The containers flexsnap-agent.8d0bd0c9929840d29ae64613b4dd9287 flexsnap-agent.97324e7ceff84b4092cefdab1cfcf253 flexsnap-w orkflow-longrun-0-min flexsnap-workflow-system-0-min flexsnap-workflow-general-0-min flexsnap-listener flexsnap-nginx fle xsnap-notification flexsnap-policy flexsnap-scheduler flexsnap-idm flexsnap-onhostagent flexsnap-agent flexsnap-coordinat or 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.8d0bd0c9929840d29ae64613b4dd9287 ...done
   Removing container flexsnap-agent.97324e7ceff84b4092cefdab1cfcf253 ...done
   Removing container flexsnap-workflow-longrun-0-min ...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
   Taking backup of CloudPoint metadata...done
   Backup completed successfully.
   Backup file located at /cloudpoint/backup/cloudpoint_9.1.0.1.9408.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
   Waiting for flexsnap-rabbitmq container to move to healthy state...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
   Finalizing the upgrade..done
   Upgrade finished at time: Thu Jan 13 16:14:12 UTC 2022
   

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.