NetBackup™ Snapshot Manager for Data Center Administrator's Guide
- Introduction
- Preparing for NetBackup Snapshot Manager for Data Center installation
- About the deployment approach
- Hosting NetBackup Snapshot Manager for Data Center
- Host sizing recommendations
- Meeting system requirements
- Creating an instance or preparing the host to install NetBackup Snapshot Manager for Data Center
- Installing container platform (Docker, Podman)
- Creating and mounting a volume to store data
- Verifying that specific ports are open on the instance or physical host
- Creating tokens for installation
- Deploying NetBackup Snapshot Manager for Data Center using container images
- Before you begin installing NetBackup Snapshot Manager for Data Center
- Installing NetBackup Snapshot Manager for Data Center in the Docker/Podman environment
- Securing the connection to NetBackup Snapshot Manager for Data Center
- Verifying that NetBackup Snapshot Manager for Data Center is installed successfully
- Restarting NetBackup Snapshot Manager for Data Center
- Associating NetBackup media server(s) with Snapshot Manager for Data Center
- Upgrading NetBackup Snapshot Manager for Data Center
- About NetBackup Snapshot Manager for Data Center upgrades
- Supported upgrade path
- Upgrade scenarios
- Preparing to upgrade NetBackup Snapshot Manager for Data Center
- Upgrading NetBackup Snapshot Manager for Data Center
- Upgrading NetBackup Snapshot Manager for Data Center using patch or hotfix
- Migrating and upgrading NetBackup Snapshot Manager for Data Center
- Uninstalling NetBackup Snapshot Manager for Data Center
- Snapshot Manager for Data Center catalog backup and recovery
- Configure NetBackup Snapshot Manager for Data Center
- Storage array replication
- Storage array plug-ins for Snapshot Manager for Data Center
- Configure the storage array plug-ins for Snapshot Manager for Data Center
- Required ports for different arrays
- Azure NetApp Files plug-in
- Azure Files plug-in
- Dell EMC PowerMax and VMax array
- Dell EMC PowerMax and VMax plug-in configuration prerequisites
- Supported Snapshot Manager for Data Center operations on Dell EMC PowerMax and VMax
- DELL EMC PowerMax and VMax plug-in configuration parameters
- Roles and privileges on Dell EMC Unisphere for PowerMax and VMax
- Dell EMC XtremIO plug-in considerations and limitations
- Dell EMC PowerFlex array
- Dell EMC PowerScale (Isilon)
- Supported NetBackup Snapshot Manager for Data Center Operation on DELL EMC PowerScale (Isilon)
- DELL EMC PowerScale (Isilon) plug-in configuration prerequisites
- Dell EMC PowerScale (Isilon) plug-in configuration parameters
- Using SmartConnect with Snapshot Manager for Data Center
- Roles and privileges on Dell EMC PowerScale (Isilon)
- Snapshot replication for Dell EMC PowerScale (Isilon)
- Supported Dell EMC PowerScale (Isilon) replication topologies
- Consideration for Dell EMC PowerScale (Isilon)
- Dell EMC PowerStore SAN and NAS plug-in
- Dell EMC XtremIO SAN array
- Dell EMC Unity Array
- Fujitsu Eternus AF/DX SAN array
- Fujitsu Eternus AB/HB SAN array
- Fujitsu AX/HX Series plug-in
- Supported Snapshot Manager for Data Center Operation on Fujitsu AX/HX array
- Fujitsu AX/HX plug-in Configuration prerequisites
- Fujitsu AX/HX plug-in configuration parameters
- Fujitsu AX/HX SnapDiff configuration prerequisites
- ACL configuration on Fujitsu AX/HX array
- Fujitsu AX/HX plug-in considerations and limitations
- HPE RMC plug-in
- HPE XP plug-in
- HPE Alletra 9000 SAN array
- HPE Alletra 6000 SAN array
- HPE GreenLake for Block Storage array
- HPE GreenLake for File Storage (VAST) array
- Hitachi NAS array
- Hitachi SAN array
- IBM Storwize SAN V7000 plug-in
- IBM FlashSystem plug-in
- IBM SAN Volume Controller plug-in
- Supported Snapshot Manager for Data Center Operation on IBM SAN Volume Controller array
- IBM SAN Volume Controller plug-in configuration prerequisites
- IBM SAN Volume Controller plug-in configuration parameters
- Roles and privileges on IBM SAN Volume Controller
- IBM SAN Volume Controller plug-in considerations and limitations
- InfiniBox SAN array
- InfiniBox NAS array
- Lenovo DM 5000 series array
- NetApp storage array
- Supported NetBackup Snapshot Manager for Data Center operations on NetApp storage
- NetApp plug-in configuration prerequisites
- NetApp plug-in configuration parameters
- Configurable parameter in the flexsnap.conf file
- Roles and privileges on NetApp storage array for the ZAPI interface
- Roles and privileges on NetApp storage array for REST interface
- Domain user permissions on the NetApp array
- Configuring a dedicated LIF for NetBackup operation
- Snapshot Replication
- Supported NetApp replication topologies
- Considerations for NetApp plug-in
- NetApp Cloud Volumes ONTAP (CVO)
- Amazon FSx for NetApp ONTAP Plug-in
- NetApp E-Series array
- Nutanix Files array
- Pure Storage FlashArray SAN
- Supported Snapshot Manager for Data Center operations on Pure Storage SAN array models
- Pure Storage SAN plug-in configuration pre-requisites
- Pure Storage SAN plug-in configuration parameters
- Roles and privileges on Pure Storage FlashArray
- Pure Storage FlashArray plug-in considerations and limitations
- Pure Storage Flash Array files services (NAS)
- Pure Storage FlashBlade plug-in configuration notes
- PowerMax eNAS array
- Qumulo NAS array
- Supported Snapshot Manager for Data Center operations on Qumulo plug-in
- Qumulo plug-in configuration prerequisites
- Qumulo plug-in configuration parameters
- Permissions and privileges on the Qumulo cluster
- Domain user permissions on the Qumulo cluster
- Configuring a dedicated VLAN for NetBackup access
- Qumulo plug-in considerations and limitations
- VMware vSAN File Services plug-in
- Supported Snapshot Manager for Data Center Operation on VMware vSAN cluster
- VMware vSAN File Services plug-in configuration prerequisites
- VMware vSAN File Services plug-in configuration parameters
- Domain user permissions on the VMware vSAN Cluster
- VMware vSAN File Services plug-in considerations and limitations
- NetBackup Snapshot Manager logging
- About NetBackup Snapshot Manager for Data Center logging mechanism
- How Fluentd-based NetBackup Snapshot Manager for Data Center logging works
- About the NetBackup Snapshot Manager for Data Center fluentd configuration file
- Modifying the fluentd configuration file
- Viewing NetBackup Snapshot Manager for Data Center logs
- Fluentd-based logging requirements and considerations
- NetBackup Snapshot Manager for Data Center logs
- Agentless and On-host agent logs
- Troubleshooting
- Troubleshooting NetBackup Snapshot Manager for Data Center
- Backup from snapshot job fails with time out error
- (SELinux) Storage array plug-in configuration failure for custom port
- Execution fails for the flexsnap_preinstall.sh command.
- For NetApp SAN volumes, failure to create snapshot of a volume
- D-NAS backup fails with the error: The file system crawler process timed-out waiting for streams to attach with shared memory. (3003)
- Isilon backup from snapshot failed with the Snapshot cannot be mounted error.
Upgrading NetBackup Snapshot Manager for Data Center
The following procedures describe how to upgrade your NetBackup Snapshot Manager for Data Center deployment. During the upgrade, you replace the container that runs your current version of NetBackup Snapshot Manager for Data Center with a newer container.
To upgrade NetBackup Snapshot Manager for Data Center server in Podman/Docker environment
- Download the NetBackup Snapshot Manager for Data Center upgrade installer.
On the NetBackup Snapshot Manager for Data Center download page, click Download Now to download the NetBackup Snapshot Manager for Data Center installer.
The NetBackup Snapshot Manager for Data Center software components are available in a package form. The file name has the following format:
NetBackup_SnapshotManager_<version>.tar.gzNote:
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 for Data Center.
- Un-tar the image file and list the contents:
# ls NetBackup_SnapshotManager_xx.x.x-xxxx.tar.gz netbackup-flexsnap-10.4.x.x-xxxx.tar.gz flexsnap_preinstall.sh
- Run the following command to prepare the NetBackup Snapshot Manager for Data Center host for installation:
# sudo ./flexsnap_preinstall.sh
The output resembles the following:
For Podman
# ./flexsnap_preinstall.sh 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 Loading SELinux policy for containers ... done Copying flexsnap_configure script ... done
For Docker
# ./flexsnap_preinstall.sh 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 policies with snapshot or other operations in progress and then stop NetBackup Snapshot Manager for Data Center by running the following command:
Using the flexsnap_configure CLI, run: # flexsnap_configure stop
The NetBackup Snapshot Manager for Data Center containers are stopped one by one. Messages similar to the following appear on the command line:
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
Wait for all the NetBackup Snapshot Manager for Data Center containers to be stopped and then proceed to the next step.
- Upgrade NetBackup Snapshot Manager for Data Center using the flexsnap_configure CLI, run: # flexsnap_configure install
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: Fri Jul 28 10:30:05 UTC 2023 Stopping container: flexsnap-agent.12ef61207c634aeba0f37aba192a4960 ...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 Jul 28 10:30:23 UTC 2023 Configuration started at time: Fri Jul 28 10:30:26 UTC 2023 Docker server version: 1.13.1 This is an upgrade to NetBackup Snapshot Manager xx.x.x.xxxx Previous Snapshot Manager version: xx.x.x.xxxx Removing exited container flexsnap-agent.12ef61207c634aeba0f37aba192a4960 ...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-mongodb ...done Removing exited container flexsnap-ipv6config ...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_xx.x.x.xxxx.tar.gz. Creating network: flexsnap-network ...done Starting container: flexsnap-fluentd ...done Starting container: flexsnap-ipv6config ...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 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 Upgrade finished at time: Fri Jul 28 10:35:37 UTC 2023
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 xx.x.x.xxxx Previous Snapshot Manager version: xx.x.x.x.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.1.1.0.1208.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 for Data Center:
Interactive upgrade of NetBackup Snapshot Manager for Data Center: # flexsnap_configure install -i
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 10.3.0.0.1008 Previous Snapshot Manager version: 10.2.1.0.1188 Do you want to take a backup of the Snapshot Manager metadata prior to upgrade? (y/n): n 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
Non-interactive upgrade of NetBackup Snapshot Manager for Data Center: # 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 10.3.0.0.1008 Previous Snapshot Manager version: 10.2.1.0.1188 Taking backup of Snapshot Manager metadata...done Backup completed successfully. Backup file located at /cloudpoint/backup/cloudpoint_10.2.1.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
- (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 reinstall the same version of Snapshot Manager for Data Center, use the --force option with the install command.
# flexsnap_configure install --force -i
The output resembles the following:
Configuration started at time: Tue Jan 2 11:02:32 UTC 2024 Podman server version: 4.2.0 This is an upgrade to NetBackup Snapshot Manager xx.x.xxxx Previous Snapshot Manager version: xx.x.xxxx 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: Tue Jan 2 11:05:42 UTC 2024
- To verify that the new NetBackup Snapshot Manager for Data Center version is installed successfully:
See Verifying that NetBackup Snapshot Manager for Data Center is installed successfully.
- This concludes the upgrade process. Verify that your NetBackup Snapshot Manager for Data Center configuration settings and data are preserved as is.