NetBackup™ Snapshot Manager for Cloud Install and Upgrade Guide
- Introduction
- Section I. NetBackup Snapshot Manager for Cloud installation and configuration
- Preparing for NetBackup Snapshot Manager for Cloud installation
- Deploying NetBackup Snapshot Manager for Cloud using container images
- Deploying NetBackup Snapshot Manager for Cloud extensions
- Installing the NetBackup Snapshot Manager extension on a VM
- Installing the NetBackup Snapshot Manager extension on a managed Kubernetes cluster (AKS) in Azure
- Installing the NetBackup Snapshot Manager extension on a managed Kubernetes cluster (EKS) in AWS
- Installing the NetBackup Snapshot Manager extension on a managed Kubernetes cluster (GKE) in GCP
- NetBackup Snapshot Manager for cloud providers
- AWS plug-in configuration notes
- Google Cloud Platform plug-in configuration notes
- Prerequisites for configuring the GCP plug-in using Credential and Service Account option
- Microsoft Azure plug-in configuration notes
- Microsoft Azure Stack Hub plug-in configuration notes
- OCI plug-in configuration notes
- Configuration for protecting assets on cloud hosts/VM
- Protecting assets with NetBackup Snapshot Manager's on-host agent feature
- Installing and configuring NetBackup Snapshot Manager agent
- Configuring the NetBackup Snapshot Manager application plug-in
- Microsoft SQL plug-in
- Oracle plug-in
- Protecting assets with NetBackup Snapshot Manager's agentless feature
- Snapshot Manager for cloud catalog backup and recovery
- NetBackup Snapshot Manager for cloud assets protection
- Volume encryption in NetBackup Snapshot Manager for cloud
- NetBackup Snapshot Manager for Cloud security
- Preparing for NetBackup Snapshot Manager for Cloud installation
- Section II. NetBackup Snapshot Manager for Cloud maintenance
- NetBackup Snapshot Manager for Cloud logging
- Upgrading NetBackup Snapshot Manager for Cloud
- Migrating and upgrading NetBackup Snapshot Manager
- Post-upgrade tasks
- Uninstalling NetBackup Snapshot Manager for Cloud
- Troubleshooting NetBackup Snapshot Manager for Cloud
Upgrading NetBackup Snapshot Manager
The following procedures describe how to upgrade your NetBackup Snapshot Manager deployment. During the upgrade, you replace the container that runs your current version of NetBackup Snapshot Manager with a newer container.
To upgrade NetBackup Snapshot Manager server in Podman/Docker environment
- Download the NetBackup Snapshot Manager upgrade installer.
On the NetBackup Snapshot Manager download page, click Download Now to download the NetBackup Snapshot Manager installer.
The NetBackup Snapshot Manager software components are available in a package form. The file name has the following format:
NetBackup_SnapshotManager_<version>.tar.gz
Note:
The actual file name may vary depending on the release version.
- Copy the downloaded compressed image file to the computer on which you want to deploy NetBackup Snapshot Manager.
- Un-tar the image file and list the contents:
# ls NetBackup_SnapshotManager_11.0.x.x-xxxx.tar.gz netbackup-flexsnap-11.0.x.x-xxxx.tar.gz flexsnap_preinstall.sh
- Run the following command to prepare the NetBackup Snapshot Manager host for installation:
# sudo ./flexsnap_preinstall.sh
The output resembles the following:
For Podman
Checking for disk space ... done Checking for swap space ... done Validate host resources ... done Validate SELINUX ... done Check for podman installation ... done Validate podman version support ... done Check for podman socket file ... done Checking for required packages ... done Validate required services health ... done Removing deprecated services ... done Loading Snapshot Manager service images ... done Creating nbsvcusr user and group ... done Loading CIL policy for containers ... done Copying flexsnap_configure script ... done
For Docker
Checking for disk space ... done Checking for swap space ... done Validate host resources ... done Check for docker installation ... done Validate docker version support ... done Check for docker socket file ... done Checking for required packages ... done Validate required services health ... done Loading Snapshot Manager service images ... done Copying flexsnap_configure script ... done
- Verify that there are no protection policy snapshots or other operations in progress and then stop NetBackup Snapshot Manager by running the following command:
# flexsnap_configure stop
Note:
Veritas recommends the use of flexsnap_configure CLI for Snapshot Manager installation. Snapshot Manager installation through docker/podman CLI is deprecated for non RHEL 8/9 and dropped for RHEL 8/9.
Or
Use the following equivalent docker/podman command to stop NetBackup Snapshot Manager:
For Podman
# sudo podman run -it --rm -u 0 -v /cloudpoint:/cloudpoint -v /run/podman/podman.sock:/run/podman/podman.sock veritas/flexsnap-deploy:<current_version> stop
For Docker
# sudo docker run -it --rm -u 0 -v /cloudpoint:/cloudpoint -v /run/docker/docker.sock:/run/docker/docker.sock veritas/flexsnap-deploy:<current_version> stop
Here, current_version represents the currently installed NetBackup Snapshot Manager version.
Note:
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 services at time: Mon Jul 31 12:49:01 UTC 2023 Stopping container: flexsnap-workflow-system-0-min ...done Stopping container: flexsnap-workflow-general-0-min ...done Stopping container: flexsnap-listener ...done Stopping container: flexsnap-nginx ...done Stopping container: flexsnap-notification ...done Stopping container: flexsnap-policy ...done Stopping container: flexsnap-scheduler ...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-postgresql ...done Stopping container: flexsnap-fluentd ...done Stopping services completed at time: Mon Jul 31 12:49:21 UTC 2023
Wait for all the NetBackup Snapshot Manager containers to be stopped and then proceed to the next step.
- Upgrade NetBackup Snapshot Manager by running the following command:
flexsnap_configure install
Note:
Veritas recommends the use of flexsnap_configure CLI for Snapshot Manager installation. Snapshot Manager installation through docker/podman CLI is deprecated for non RHEL 8/9 and dropped for RHEL 8/9.
Or
Use the following equivalent docker/podman command to upgrade NetBackup Snapshot Manager:
For Podman
# podman run -it --rm -u 0 -v /cloudpoint:/cloudpoint -v /run/podman/podman.sock:/run/podman/podman.sock veritas/flexsnap-deploy:<new_version> install
For an unattended installation, use the following command:
# podman run -it --rm -u 0 -v /cloudpoint:/cloudpoint -v /run/podman/podman.sock:/run/podman/podman.sock veritas/flexsnap-deploy:<new_version> install -y
For Docker
# sudo docker run -it --rm -u 0 -v /cloudpoint:/cloudpoint -v /cloudpoint:/cloudpoint -v /var/run/docker.sock:/var/run/docker.sock veritas/flexsnap-deploy:<new_version> install
For an unattended installation, use the following command:
# sudo docker run -it --rm --privileged -u 0 -v /cloudpoint:/cloudpoint -v /cloudpoint:/cloudpoint -v /var/run/docker.sock:/var/run/docker.sock veritas/flexsnap-deploy:<new_version> install -y
Here, new_version represents the NetBackup Snapshot Manager version you are upgrading to, for example '11.0.x.x-xxxx'
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.
The output resembles the following (Below is an example of the Podman environment output:
Stopping the services Stopping services at time: Wed Jan 3 06:12:52 UTC 2024 Stopping container: flexsnap-workflow-system-0-min ...done Stopping container: flexsnap-workflow-general-0-min ...done Stopping container: flexsnap-listener ...done Stopping container: flexsnap-nginx ...done Stopping container: flexsnap-notification ...done Stopping container: flexsnap-policy ...done Stopping container: flexsnap-scheduler ...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-postgresql ...done Stopping container: flexsnap-fluentd ...done Stopping services completed at time: Wed Jan 3 06:13:24 UTC 2024 Configuration started at time: Wed Jan 3 06:13:31 UTC 2024 Podman server version: 4.2.0 This is an upgrade to NetBackup Snapshot Manager 11.0.x.x-xxxx Previous Snapshot Manager version: 10.4.x.x.xxxx Removing exited container flexsnap-nginx ...done Removing exited container flexsnap-scheduler ...done Removing exited container flexsnap-listener ...done Removing exited container flexsnap-api-gateway ...done Removing exited container flexsnap-agent ...done Removing exited container flexsnap-onhostagent ...done Removing exited container flexsnap-notification ...done Removing exited container flexsnap-postgresql ...done Removing exited container flexsnap-certauth ...done Removing exited container flexsnap-fluentd ...done Removing exited container flexsnap-policy ...done Removing exited container flexsnap-coordinator ...done Removing exited container flexsnap-rabbitmq ...done Deleting network : flexsnap-network ...done Taking backup of Snapshot Manager metadata...done Backup completed successfully. Backup file located at /cloudpoint/backup/cloudpoint_10.4.x.x.xxxx.tar.gz. Creating network: flexsnap-network ...done Starting container: flexsnap-fluentd ...done Starting container: flexsnap-postgresql ...done Waiting for flexsnap-postgresql container to move to healthy state...Starting container: flexsnap-rabbitmq ...done Waiting for flexsnap-rabbitmq container to move to healthy state...Starting container: flexsnap-certauth ...done Waiting for flexsnap-certauth container to move to healthy state...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-nginx ...done Upgrade finished at time: Wed Jan 3 06:16:56 UTC 2024
Example 2:
Stopping the services Stopping services at time: Fri Aug 4 10:38:37 UTC 2023 Stopping container: flexsnap-workflow-system-0-min ...done Stopping container: flexsnap-workflow-general-0-min ...done Stopping container: flexsnap-listener ...done Stopping container: flexsnap-nginx ...done Stopping container: flexsnap-notification ...done Stopping container: flexsnap-policy ...done Stopping container: flexsnap-scheduler ...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 Stopping services completed at time: Fri Aug 4 10:38:55 UTC 2023 Configuration started at time: Fri Aug 4 10:38:57 UTC 2023 Docker server version: 20.10.7 IPv6 configuration is temporarily disabled on system. Snapshot Manager will be configured without IPv6 support. For Snapshot Manager with IPv6 support, enable IPv6 configuration on the system. This is an upgrade to NetBackup Snapshot Manager 11.0.x.x-xxxx Previous Snapshot Manager version: 10.4.0.0.xxxx Removing exited container flexsnap-nginx ...done Removing exited container flexsnap-notification ...done Removing exited container flexsnap-policy ...done Removing exited container flexsnap-scheduler ...done Removing exited container flexsnap-onhostagent ...done Removing exited container flexsnap-agent ...done Removing exited container flexsnap-listener ...done Removing exited container flexsnap-coordinator ...done Removing exited container flexsnap-api-gateway ...done Removing exited container flexsnap-certauth ...done Removing exited container flexsnap-rabbitmq ...done Removing exited container flexsnap-mongodb ...done Removing exited container flexsnap-fluentd ...done Deleting network : flexsnap-network ...done Taking backup of Snapshot Manager metadata...done Backup completed successfully. Backup file located at /cloudpoint/backup/cloudpoint_10.4.0.0.xxxx.tar.gz. Creating network: flexsnap-network ...done Starting container: flexsnap-fluentd ...done Starting container: flexsnap-postgresql ...done Waiting for flexsnap-postgresql container to move to healthy state...Starting container: flexsnap-mongodb ...done Waiting for flexsnap-mongodb container to move to healthy state...Data migration required from mongo database to postgresql database Data migration is successful. Starting container: flexsnap-rabbitmq ...done Waiting for flexsnap-rabbitmq container to move to healthy state...Starting container: flexsnap-certauth ...done Waiting for flexsnap-certauth container to move to healthy state...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-nginx ...done Deleteing mongo resources flexsnap-mongodb
- Interactive and non interactive upgrade of NetBackup Snapshot Manager:
Interactive upgrade of NetBackup Snapshot Manager:
# flexsnap_configure install -i
The output resembles the following:
Do you want to take a backup of the Snapshot Manager metadata prior to upgrade? (y/n): n Stopping the services Stopping services at time: Wed Jan 3 06:12:52 UTC 2024 Stopping container: flexsnap-workflow-system-0-min ...done Stopping container: flexsnap-workflow-general-0-min ...done Stopping container: flexsnap-listener ...done Stopping container: flexsnap-nginx ...done Stopping container: flexsnap-notification ...done Stopping container: flexsnap-policy ...done Stopping container: flexsnap-scheduler ...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-postgresql ...done Stopping container: flexsnap-fluentd ...done Stopping services completed at time: Wed Jan 3 06:13:24 UTC 2024 Configuration started at time: Wed Jan 3 06:13:31 UTC 2024 Podman server version: 4.2.0 This is an upgrade to NetBackup Snapshot Manager 11.0.x.x-xxxx Previous Snapshot Manager version: 10.4.x.x.xxxx Removing exited container flexsnap-nginx ...done Removing exited container flexsnap-scheduler ...done Removing exited container flexsnap-listener ...done Removing exited container flexsnap-api-gateway ...done Removing exited container flexsnap-agent ...done Removing exited container flexsnap-onhostagent ...done Removing exited container flexsnap-notification ...done Removing exited container flexsnap-postgresql ...done Removing exited container flexsnap-certauth ...done Removing exited container flexsnap-fluentd ...done Removing exited container flexsnap-policy ...done Removing exited container flexsnap-coordinator ...done Removing exited container flexsnap-rabbitmq ...done Deleting network : flexsnap-network ...done Creating network: flexsnap-network ...done Starting container: flexsnap-fluentd ...done Starting container: flexsnap-postgresql ...done Waiting for flexsnap-postgresql container to move to healthy state...Starting container: flexsnap-rabbitmq ...done Waiting for flexsnap-rabbitmq container to move to healthy state...Starting container: flexsnap-certauth ...done Waiting for flexsnap-certauth container to move to healthy state...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-nginx ...done Upgrade finished at time: Wed Jan 3 06:16:56 UTC 2024
Non-interactive upgrade of NetBackup Snapshot Manager:
# flexsnap_configure install
The output resembles the following:
Configuration started at time: Thu Jul 13 09:23:27 UTC 2023 Docker server version: 1.13.1 This is an upgrade to NetBackup Snapshot Manager 11.0.x.x-xxxx Previous Snapshot Manager version: 10.4.0.0.1188 Taking backup of Snapshot Manager metadata...done Backup completed successfully. Backup file located at /cloudpoint/backup/cloudpoint_10.2.0.0.1188.tar.gz. Removing exited container flexsnap-agent.837b51be82f5451e8eca27761d2f5b0c ...done Removing exited container flexsnap-nginx ...done Removing exited container flexsnap-notification ...done Removing exited container flexsnap-policy ...done Removing exited container flexsnap-scheduler ...done Removing exited container flexsnap-onhostagent ...done Removing exited container flexsnap-agent ...done Removing exited container flexsnap-listener ...done Removing exited container flexsnap-coordinator ...done Removing exited container flexsnap-api-gateway ...done Removing exited container flexsnap-certauth ...done Removing exited container flexsnap-rabbitmq ...done Removing exited container flexsnap-postgresql ...done Removing exited container flexsnap-fluentd ...done Deleting network : flexsnap-network ...done Creating network: flexsnap-network ...done Starting container: flexsnap-fluentd ...done Starting container: flexsnap-postgresql ...done Waiting for flexsnap-postgresql container to move to healthy state... Starting container: flexsnap-rabbitmq ...done Waiting for flexsnap-rabbitmq container to move to healthy state... 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-nginx ...done Upgrade finished at time: Thu Jul 13 09:27:18 UTC 2023
- NetBackup Snapshot Manager can be upgraded to a higher version without upgrading Primary/Media server for cloud VM workloads.
- (Optional) Run the following command to remove the previous version images.
(For Podman) # podman rmi -f <imagename>:<oldimage_tagid>
(For Docker) # docker rmi -f <imagename>:<oldimage_tagid>
- To verify that the new NetBackup Snapshot Manager version is installed successfully:
See Verifying that NetBackup Snapshot Manager is installed successfully.
- This concludes the upgrade process. Verify that your NetBackup Snapshot Manager configuration settings and data are preserved as is.
The next step is to register the NetBackup Snapshot Manager with the Veritas NetBackup primary server (10.2 or earlier) with credentials.