NetBackup™ Snapshot Manager Install and Upgrade Guide

To upgrade NetBackup Snapshot Manager in docker environment

1. Download the NetBackup Snapshot Manager upgrade installer.

   Example: NetBackup_SnapshotManager_<version>.tar.gz

2. Un-tar the image file and list the contents:

   # ls
   NetBackup_SnapshotManager_10.2.x.x.xxxx.tar.gz
   netbackup-flexsnap-10.2.x.x.xxxx.tar.gz
   flexsnap_preinstall.sh
   

3. Run the following command to prepare the NetBackup Snapshot Manager host for installation:

   # sudo ./flexsnap_preinstall.sh

4. Upgrade NetBackup Snapshot Manager by running the following command:

   # docker run -it --rm -u 0
   -v /cloudpoint:/cloudpoint
   -v /run/docker/docker.sock:/run/docker/docker.sock 
   veritas/flexsnap-deploy:<new_version> install

   For an unattended installation, use the following command:

   # docker run -it --rm -u 0
   -v /cloudpoint:/cloudpoint
   -v /run/docker/docker.sock:/run/docker/docker.sock
   veritas/flexsnap-deploy:<new_version> install -y

   Here, new_version represents the NetBackup Snapshot Manager 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.

   Note:

   Ensure that you enter the command without any line breaks.

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

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

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

6. To verify that the new NetBackup Snapshot Manager version is installed successfully:

   See Verifying that NetBackup Snapshot Manager is installed successfully.

To migrate NetBackup Snapshot Manager in Podman environment

1. On the RHEL 7.x host, verify that there are no protection policy snapshots or other operations in progress and then stop NetBackup Snapshot Manager 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 NetBackup Snapshot Manager version.

   Example:

   # 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 stop

   Note:

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

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

   Stopping the services
   Stopping container: flexsnap-core.8a51aac1848c404ab61e4625d7b88703 ...done
   Stopping container: flexsnap-core-long-15 ...done
   Stopping container: flexsnap-core-long-14 ...done
   Stopping container: flexsnap-core-long-13 ...done
   Stopping container: flexsnap-core-long-12 ...done
   Stopping container: flexsnap-core-long-11 ...done
   Stopping container: flexsnap-core-long-10 ...done
   Stopping container: flexsnap-core-long-9 ...done
   Stopping container: flexsnap-core-long-8 ...done
   Stopping container: flexsnap-core-long-7 ...done
   Stopping container: flexsnap-core-long-6 ...done
   Stopping container: flexsnap-core-long-5 ...done
   Stopping container: flexsnap-core-long-4 ...done
   Stopping container: flexsnap-core-long-3 ...done
   Stopping container: flexsnap-core-long-2 ...done
   Stopping container: flexsnap-core-long-1 ...done
   Stopping container: flexsnap-core-long-0 ...done
   Stopping container: flexsnap-core-15 ...done
   Stopping container: flexsnap-core-14 ...done
   Stopping container: flexsnap-core-13 ...done
   Stopping container: flexsnap-core-12 ...done
   Stopping container: flexsnap-core-11 ...done
   Stopping container: flexsnap-core-10 ...done
   Stopping container: flexsnap-core-9 ...done
   Stopping container: flexsnap-core-8 ...done
   Stopping container: flexsnap-core-7 ...done
   Stopping container: flexsnap-core-6 ...done
   Stopping container: flexsnap-core-5 ...done
   Stopping container: flexsnap-core-4 ...done
   Stopping container: flexsnap-core-3 ...done
   Stopping container: flexsnap-core-2 ...done
   Stopping container: flexsnap-core-1 ...done
   Stopping container: flexsnap-core-0 ...done
   Stopping container: flexsnap-nginx ...done
   Stopping container: flexsnap-core ...done
   Stopping container: flexsnap-core ...done
   Stopping container: flexsnap-scheduler ...done
   Stopping container: flexsnap-idm ...done
   Stopping container: flexsnap-core ...done
   Stopping container: flexsnap-core ...done
   Stopping container: flexsnap-core ...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 NetBackup Snapshot Manager containers to be stopped and then proceed to the next step.

2. Migrate the NetBackup Snapshot Manager configuration data to the RHEL 8.6 or 8.4 host:

   • If you have created a new system with RHEL 8.6 or 8.4:

     • Run the following command to unmount /cloudpoint from the current host.

       # umount /cloudpoint

     • Detach the data disk that was mounted on /cloudpoint mountpoint.

       Note:

       For detailed instructions to detach or attach the data disks, follow the documentation provided by your cloud or storage vendor.

     • On the RHEL8.6 or 8.4 host, run the following commands to create and mount the disk:

       # mkdir /cloudpoint

       # mount /dev/<diskname> /cloudpoint

       For vendor-specific details

       See Creating and mounting a volume to store NetBackup Snapshot Manager data.

   • If you have upgraded from RHEL 7.x to RHEL 8.6 or 8.4, copy the /cloudpoint mountpoint data from RHEL 7.x system and move it to the RHEL8.6 or 8.4 system under /cloudpoint folder.

   This concludes the NetBackup Snapshot Manager migration process.

   After migration, install the new_version on the new host by following the steps mentioned in the To upgrade NetBackup Snapshot Manager in docker environment.

3. During migration process, if NetBackup Snapshot Manager is migrated to another system or IP address is changed, then regenerate the certificates as follows:

   • Stop the NetBackup Snapshot Manager services using the following command:

     # podman run -it --rm -u 0 -v /cloudpoint:/cloudpoint -v /run/podman/podman.sock:/run/podman/podman.sock veritas/flexsnap-deploy:10.2.x.x.xxxx stop

   • Regenerate the certificates using the following command:

     /cloudpoint/scripts/cp_regenerate_certs.sh -i <CP_IP_ADDRESS> -h <CP_HOSTNAME>

     Setting up certificate authority ...done
     Generating certificates for servers ...done
     Generating certificates for clients ...done
     Adding MongoDB and RabbitMQ certificate to the trust store ...[Storing /cloudpoint/keys/idm_store]
     [Storing /cloudpoint/keys/flexsnap-idm_store]
     done
     Creating symlinks for nginx certificates ...done

   • Start the NetBackup Snapshot Manager services using the following command:

     # podman run -it --rm -u 0 -v /cloudpoint:/cloudpoint -v /run/podman/podman.sock:/run/podman/podman.sock veritas/flexsnap-deploy:10.2.x.x.xxxx start

4. Depending on the following appropriate scenario, update the /cloudpoint/openv/netbackup/bp.conf file to update the value of CLIENT_NAME to new Snapshot Manager IP/hostname.

   • If IP address does not change, then edit the NetBackup Snapshot Manager server entry and provide a reissue token generated for the NetBackup Snapshot Manager host.

   • If IP address changes, then disable the previous NetBackup Snapshot Manager host, and add a NetBackup Snapshot Manager host with new IP address. Then perform the following steps:

     • Revoke the certificate of previous NetBackup Snapshot Manager host.

     • Add the mapping of new NetBackup Snapshot Manager host IP/hostname into the previous NetBackup Snapshot Manager host using the host mappings.

     • Generate reissue token by selecting previous NetBackup Snapshot Manager host, then use that token to edit the new NetBackup Snapshot Manager host. Old NetBackup Snapshot Manager host Certificate entry and Host Mapping would be replaced.

5. After migrating NetBackup Snapshot Manager to a RHEL 8.6 or 8.4 host, perform the following steps to upgrade NetBackup Snapshot Manager to 10.2.

   See Upgrading NetBackup Snapshot Manager.

6. This concludes the migration and upgrade process for NetBackup Snapshot Manager. Verify that your NetBackup Snapshot Manager configuration settings and data are preserved as is.