Veritas NetBackup™ CloudPoint Install and Upgrade Guide

Post-upgrade tasks

1. Upgrade the CloudPoint agents on the Linux and Windows application hosts.

   Note:

   If you are upgrading from CloudPoint 8.3 to 9.0 or 9.1, then you must manually upgrade the on-host agents. If you are upgrading from CloudPoint 9.0 to 9.1, upgrading the on-host agents is optional.

   Perform the following steps to upgrade the agent on Linux hosts:

   • Sign in to NetBackup UI and download the newer agent package.

     Navigate to Cloud > CloudPoint servers > Actions > Add agent.

   • Stop the flexsnap agent service on the Linux host where you want to upgrade the agent.

     Run the following command on the Linux host:

     # sudo systemctl stop flexsnap-agent.service

   • Upgrade the agent on the Linux host.

     Run the following command on the Linux host:

     # sudo rpm -Uvh --force cloudpoint_agent_rpm_name

     Here, cloudpoint_agent_rpm_name is the name of the agent rpm package you downloaded earlier.

   • Generate the token for agent configuration. Navigate to NetBackup Web UI > Cloud > CloudPoint Servers > Actions > Add agent > Create Token.

   • Start the flexsnap agent service on the Linux host.

     Run the following command on the Linux host:

     # sudo systemctl start flexsnap-agent.service --renew --token <auth_token>

   • Reload the daemon, if prompted.

     Run the following command on the Linux host:

     # sudo systemctl daemon-reload

   • Repeat these steps on all the Linux hosts where you wish to upgrade the Linux-based agent.

   Perform the following steps to upgrade the agent on Windows hosts:

   • Sign in to NetBackup UI and download the newer agent package.

     Navigate to Cloud > CloudPoint servers > Actions > Add agent.

   • Stop the Veritas CloudPoint Agent service that is running on the host.

   • Run the newer version of the agent package file and follow the installation wizard workflow to upgrade the on-host agent on the Windows host.

     The installer detects the existing installation and upgrades the package to the new version automatically.

   • Generate the token for agent configuration. Navigate to NetBackup Web UI > Cloud > CloudPoint Servers > Actions > Add agent > Create Token.

   • ([Not applicable when upgrading from 9.1.x to 10.0]) Register the agent on the host again.

     From the command prompt, navigate to the agent installation directory (C:\Program Files\Veritas\CloudPoint\) and run the following command:

     # flexsnap-agent.exe --renew --token <auth_token>

   • Repeat these steps on all the Windows hosts where you wish to upgrade the Windows-based agent.

   For details on how to download the agent installation package from the NetBackup UI, refer to the following:

   See Downloading and installing the CloudPoint agent.

2. If you want to run backup from snapshot and restore from backup jobs after upgrade, you must update the NetBackup configuration so that the upgraded CloudPoint configuration details are available with NetBackup. After upgrading, all the CloudPoint servers that you want to use for backup from snapshot or restore from backup jobs, must be re-edited by providing a token so that NetBackup certificates are generated. See Edit a CloudPoint server section, in the NetBackup Web UI Cloud Administrator's Guide.

   Perform one of the following actions:

   • From the NetBackup Web UI, edit the CloudPoint server information.

     • In the Web UI, click Workloads > Cloud from the left navigation pane and then click the CloudPoint servers tab.

     • Select the CloudPoint server that you just upgraded, and then click Edit from the ellipsis action button on the right.

     • In the Edit CloudPoint server dialog, specify all the requested details.

     • Click Validate to validate the CloudPoint server certificate.

     • In the Token field enter the Standard Host Token.

     • Click Save to update the CloudPoint server configuration.

   • Or, on the NetBackup primary server, run the following command:

     # ./tpconfig -update -cloudpoint_server cp-hostname-cloudpoint_server_user_id admin -manage_workload <manage_workload>

     Note:

     Additional option -security_token is required for updating CloudPoint which is managing cloud workloads. The token must be Standard host token. This is required for NetBackup certificates generation on CloudPoint.

     On UNIX systems, the directory path to this command is /usr/openv/volmgr/bin/. On Windows systems, the directory path to this command is install_path\Volmgr\bin\. Refer to the Veritas NetBackup Commands Reference Guide for details.

   • Or, make a PATCH API call to the NetBackup primary server using the following URL:

     https://primaryserver.domain.com/netbackup/config/servers/snapshot-mgmt-servers/cp-hostname