NetBackup105 AdminGuide SnapshotManager
NetBackup105 AdminGuide SnapshotManager
Release 10.5
NetBackup™ Snapshot Manager for Data Center
Administrator's Guide
Last updated: 2024-09-25
Legal Notice
Copyright © 2024 Veritas Technologies LLC. All rights reserved.
Veritas, the Veritas Logo, Veritas Alta, and NetBackup are trademarks or registered trademarks
of Veritas Technologies LLC or its affiliates in the U.S. and other countries. Other names may
be trademarks of their respective owners.
This product may contain third-party software for which Veritas is required to provide attribution
to the third party (“Third-party Programs”). Some of the Third-party Programs are available
under open source or free software licenses. The License Agreement accompanying the
Software does not alter any rights or obligations you may have under those open source or
free software licenses. Refer to the Third-party Legal Notices document accompanying this
Veritas product or available at:
https://www.veritas.com/about/legal/license-agreements
The product described in this document is distributed under licenses restricting its use, copying,
distribution, and decompilation/reverse engineering. No part of this document may be
reproduced in any form by any means without prior written authorization of Veritas Technologies
LLC and its licensors, if any.
The Licensed Software and Documentation are deemed to be commercial computer software
as defined in FAR 12.212 and subject to restricted rights as defined in FAR Section 52.227-19
"Commercial Computer Software - Restricted Rights" and DFARS 227.7202, et seq.
"Commercial Computer Software and Commercial Computer Software Documentation," as
applicable, and any successor regulations, whether delivered by Veritas as on premises or
hosted services. Any use, modification, reproduction release, performance, display or disclosure
of the Licensed Software and Documentation by the U.S. Government shall be solely in
accordance with the terms of this Agreement.
Technical Support
Technical Support maintains support centers globally. All support services will be delivered
in accordance with your support agreement and the then-current enterprise technical support
policies. For information about our support offerings and how to contact Technical Support,
visit our website:
https://www.veritas.com/support
You can manage your Veritas account information at the following URL:
https://my.veritas.com
If you have questions regarding an existing support agreement, please email the support
agreement administration team for your region as follows:
Japan [email protected]
Documentation
Make sure that you have the current version of the documentation. Each document displays
the date of the last update on page 2. The latest documentation is available on the Veritas
website:
https://sort.veritas.com/documents
Documentation feedback
Your feedback is important to us. Suggest improvements or report errors or omissions to the
documentation. Include the document title, document version, chapter title, and section title
of the text on which you are reporting. Send feedback to:
You can also see documentation information or ask a question on the Veritas community site:
http://www.veritas.com/community/
https://sort.veritas.com/data/support/SORT_Data_Sheet.pdf
Contents
Expire after copy retention type for SLP operations ...................... 249
Fixed retention type for SLP operations ..................................... 250
Maximum snapshot limit retention type for SLP operations ............ 250
■ Verifying that specific ports are open on the instance or physical host
Two key services are RabbitMQ and PostgreSQL. RabbitMQ is NetBackup Snapshot
Manager for Data Center's message broker and PostgreSQL stores information on
all the assets NetBackup Snapshot Manager for Data Center discovers. The following
figure shows NetBackup Snapshot Manager for Data Center's micro-services model.
You can deploy NetBackup Snapshot Manager for Data Center in a NetBackup
media server, but not in a NetBackup primary server.
If you install NetBackup Snapshot Manager for Data Center on multiple hosts, we
recommend that each NetBackup Snapshot Manager for Data Center instance
manage separate resources. Two NetBackup Snapshot Manager for Data Center
instances should not manage the same resources.
If you host the NetBackup Snapshot Manager for Data Center and media server in
the same host, do the following for proper functioning of the backup from snapshot
jobs:
■ Assign distinct IPs and NetBackup client names to the NetBackup Snapshot
Manager for Data Center and the media server so that they can obtain different
NetBackup Certificates. This is required to have different NetBackup host ID
certificates for communication. Use the following configuration:
■ Configure the host with two network adapters.
■ Edit the /etc/hosts file and enter the details as mentioned in the following
example:
■ If the hostname that you intend to use for NetBackup Snapshot Manager for
Data Center is already mapped with a media server's hostname, you must
remove the older mapping. Refer to the Removing host ID to host name
mappings section in the Veritas NetBackup™ Security and Encryption Guide.
■ Once the NetBackup Snapshot Manager for Data Center is registered, ensure
that it has a different HOST DB entry.
■ Before performing the backup from snapshot jobs, perform the following
optimization: DISABLE SHM and NOSHM. See:
https://www.veritas.com/support/en_US/article.100016170
Preparing for NetBackup Snapshot Manager for Data Center installation 18
Meeting system requirements
This ensures that NetBackup does not use shared memory to communicate among
NetBackup data mover processes.
Category Requirement
Note: The single host name or FQDN for NetBackup Snapshot Manager for Data
Center has limit of 64 characters which is required at the time of installation.
Snapshot Manager does not support multiple aliases. You cannot install Snapshot
Manager 10.3 with NetBackup primary server 10.2 or earlier.
Preparing for NetBackup Snapshot Manager for Data Center installation 19
Meeting system requirements
Table 2-2 System requirements for the NetBackup Snapshot Manager for
Data Center host
Note: NetBackup Snapshot Manager for Data Center is not fully FIPS-compliant.
■ /var
The /var file system is further used for container run times. Ensure that the host
on which you install or upgrade NetBackup Snapshot Manager for Data Center has
sufficient space for the following components.
Table 2-3 Space considerations for NetBackup Snapshot Manager for Data
Center components
NetBackup Snapshot Manager for Data Minimum 10 GB free space (30 GB recommended).
Center containers
Preparing for NetBackup Snapshot Manager for Data Center installation 20
Meeting system requirements
Table 2-3 Space considerations for NetBackup Snapshot Manager for Data
Center components (continued)
NetBackup Snapshot Manager for Data 350 MB free space, for every NetBackup Snapshot
Center agents and plug-ins Manager for Data Center plug-in and configured
agent.
Additionally, NetBackup Snapshot Manager for Data Center also requires a separate
volume for storing NetBackup Snapshot Manager for Data Center data. Ensure that
you create and mount this volume to /cloudpoint on the NetBackup Snapshot
Manager for Data Center host.
Table 2-4 Space consideration for NetBackup Snapshot Manager for Data
Center data volume
/cloudpoint 50 GB or more
NetBackup Snapshot Manager for Data Center services that need to communicate
externally by a proxy server, use these predefined environment variables that are
set during the NetBackup Snapshot Manager for Data Center installation.
running on the NetBackup Snapshot Manager for Data Center at its peak
performance capacity.
Veritas recommends the following configurations for the NetBackup Snapshot
Manager for Data Center host:
Table 2-6 Typical NetBackup Snapshot Manager for Data Center host
configuration based on the number of concurrent tasks
Memory: 16 GB
Memory: 32 GB or more
Platform Description
For detailed instructions on installing the Docker on Ubuntu, see Install Docker Engine on Ubuntu.
For detailed instructions on installing Docker on RHEL, see Getting Docker in RHEL 7.
If the docker is using the default storage driver (overlay2 or overlay) on XFS backed file system,
then ensure that XFS FS has the ftype option set to 1. Use xfs_info to verify. For details,
see Use the OverlayFS storage driver. Otherwise, you can use a different storage driver. For
details, see Docker storage drivers.
Preparing for NetBackup Snapshot Manager for Data Center installation 24
Creating and mounting a volume to store data
Platform Description
■ Ensure that the UUID of the volume and the mount point (/cloudpoint) are
mentioned in the /etc/fstab so that the volume is auto-mounted when the host
or the extension is restarted.
Note: If you start your instance without this volume attached (for example, after
moving the volume to another instance), the nofail mount option enables the
instance to start even if errors occur while mounting the volume.
Preparing for NetBackup Snapshot Manager for Data Center installation 25
Verifying that specific ports are open on the instance or physical host
Table 2-8 Ports used by NetBackup Snapshot Manager for Data Center
Port Description
443 The NetBackup Snapshot Manager for Data Center user interface uses this
port as the default HTTPS port.
5671 The NetBackup Snapshot Manager for Data Center RabbitMQ server uses
this port for communications. This port must be open to support multiple
agents, extensions, backup from snapshot, and restore from backup jobs.
Note that once you configure the port when you install NetBackup Snapshot Manager
for Data Center, you cannot change it when you upgrade.
Chapter 3
Deploying NetBackup
Snapshot Manager for
Data Center using
container images
This chapter includes the following topics:
■ Before you begin installing NetBackup Snapshot Manager for Data Center
■ Associating NetBackup media server(s) with Snapshot Manager for Data Center
Note: If you plan to install NetBackup Snapshot Manager for Data Center on
multiple hosts, read this section carefully and understand the implications of this
approach.
From the Products dropdown, select NetBackup and select the required
version from the Version dropdown. Click Explore. Click Base and upgrade
installers.
The NetBackup Snapshot Manager for Data Center image name resembles
the following format for Docker and Podman environment:
NetBackup_SnapshotManager_<version>.tar.gz
Note: The actual file name may vary depending on the release version.
# ls
NetBackup_SnapshotManager_xx.x.x.x.xxxx.tar.gz
netbackup-flexsnap-xx.x.x.x.xxxx.tar.gz
flexsnap_preinstall.sh
Deploying NetBackup Snapshot Manager for Data Center using container images 29
Installing NetBackup Snapshot Manager for Data Center in the Docker/Podman environment
3 Run the following command to prepare the NetBackup Snapshot Manager for
Data Center host for installation:
# sudo ./flexsnap_preinstall.sh
Options:
-h, --help
Print this message and exit
Command:
backup To create backup of Snapshot Manager metadata.
install To install the Snapshot Manager stack on a host.
recover To restore from backup copy Snapshot Manager
metadata.
renew To renew the Snapshot Manager certificates or
extension.
restart To restart the Snapshot Manager services on a host.
servers information.
truststore To list and update Snapshot Manager truststore.
uninstall To uninstall the Snapshot Manager stack on a host.
Options Description
Options Description
--chain <chain> Absolute path of certificate chain containing all intermediate CAs
and server certificates.
--extname <name> Snapshot Manager for Data Center extension name identifier.
--path <install_path> Install path for Snapshot Manager for Data Center (default:
/cloudpoint).
--passphrase <file> Specifies the path of the file that contains the passphrase to
access the keystore. The first line in the file is used as a
passphrase.
--port Nginx port for Snapshot Manager for Data Center(default: 443).
<port_number>
Options Description
--token <token> Reissue or standard token. For the Snapshot Manager for Data
Center extension, it acts as a workflow token.
Note: The flexsnap_configure CLI uses the privilege flag implicitly (-u 0).
The installer displays messages similar to the following for interactive CLI
(NBCA):
# flexsnap_configure install -i
Configuration started at time: Sat Jul 29 14:34:08 UTC 2023
Docker server version: 20.10.7
This is a fresh install of NetBackup Snapshot Manager
10.x.x.x.xxxx
The installer displays messages similar to the following for interactive CLI
under ECA:
# flexsnap_configure install -i
Configuration started at time: Sat Jul 29 10:43:06 UTC 2023
Docker server version: 24.0.2
This is a fresh install of NetBackup Snapshot Manager
10.x.x.x.xxxx
Absolute path of CRL directory (Press ENTER for CDP based CRL
check): <crl_path>
CRL check level, Press ENTER for default 1 i.e. LEAF (0:
DISABLE, 1: LEAF and 2:CHAIN): <crl_level>
NetBackup Snapshot Manager hostname for TLS certificate (64
char FQDN limit): <snapshot_manager_fqdn>
Port (default:443): <snapshot_manager_port>
Creating runtime CIL policy ...done
Configuration started at time: Tue Jan 2 10:44:07 UTC 2024
Podman server version: 4.2.0
This is a fresh install of NetBackup Snapshot Manager
10.4.x.x-xxxx
Creating network: flexsnap-network ...done
Starting container: flexsnap-fluentd ...done
Creating container: flexsnap-postgresql ...done
Creating container: flexsnap-rabbitmq ...done
Creating container: flexsnap-certauth ...done
Creating container: flexsnap-api-gateway ...done
Creating container: flexsnap-coordinator ...done
Creating container: flexsnap-listener ...done
Creating container: flexsnap-agent ...done
Creating container: flexsnap-onhostagent ...done
Creating container: flexsnap-scheduler ...done
Creating container: flexsnap-policy ...done
Creating container: flexsnap-notification ...done
Creating container: flexsnap-nginx ...done
Waiting for Snapshot Manager configuration to complete (21/21)
...done
Configuration complete at time Tue Jan 2 10:49:02 UTC 2024!
Please register Snapshot Manager with NetBackup primary server
6 Use the following docker command to view the docker images that are loaded
on the host:
■ (For Docker) # sudo docker images
■ (For Podman) # sudo podman images
The output resembles as follows:
Deploying NetBackup Snapshot Manager for Data Center using container images 38
Installing NetBackup Snapshot Manager for Data Center in the Docker/Podman environment
Parameter Description
Host name for Specify the IP address or the Fully Qualified Domain Name (FQDN)
TLS certificate of the NetBackup Snapshot Manager for Data Center host.
Port Specify the port through which the NetBackup Snapshot Manager
for Data Center can communicate. The default is port 443.
Note: After the deployment of NetBackup Snapshot Manager for Data Center,
ensure that the IPv6 interface on the system is not disabled.
8 This concludes the NetBackup Snapshot Manager for Data Center deployment
process. The next step is to register the NetBackup Snapshot Manager for
Data Center with the Veritas NetBackup primary server.
Note: If you ever need to restart NetBackup Snapshot Manager for Data Center,
use the docker run command so that your environmental data is preserved.
See “Restarting NetBackup Snapshot Manager for Data Center” on page 46.
■ For NBCA and ECA mixed mode continue with ECA mode for NetBackup
Snapshot Manager for Data Center installation.
The following three parameters are tuneable, you can add the entry under the eca
section in the /cloudpoint/flexsnap.conf file.
■ 0 (disabled): No CRL/OCSP is
performed during validation.
■ 1 (leaf): CRL/OSCP validation is
performed only for leaf.
■ 2 (chain): CRL/OSCP validation is
performed for the whole chain.
For more information, refer to the following sections of the NetBackup™ Security
and Encryption Guide.
■ About the host ID-based certificate revocation list
■ When an authorization token is required during certificate deployment.
Note: Cache is not validated if any of the ECA tuneable are added or modified
manually inside the /cloudpoint/flexsnap.conf file.
■ ECA to NBCA:
Note: If the installation of NetBackup Snapshot Manager for Data Center fails,
then you must remove the stale containers and flexsnap-network by performing
the uninstall steps and attempt the installation again.
See “Before you begin installing NetBackup Snapshot Manager for Data Center”
on page 26.
■ Run the following command and verify that the NetBackup Snapshot Manager
for Data Center services are running and the status is displayed as UP:
For Docker environment: # sudo docker ps -a
For Podman environment: # sudo podman ps -a
The command output resembles the following:
NAMES
b13a96fbefa1 veritas/flexsnap-core:10.4.x.x-xxxxx
"/usr/bin/flexsnap-w…" 4 hours ago Up 4 hours
flexsnap-workflow-system-0-min
a3a6c801d7aa veritas/flexsnap-core:10.4.x.x-xxxxx
"/usr/bin/flexsnap-w…" 4 hours ago Up 4 hours
flexsnap-workflow-general-0-min
b9cd09ab7797 veritas/flexsnap-nginx:10.4.x.x-xxxxx
"/usr/sbin/nginx" 4 hours ago Up 4 hours
0.0.0.0:443->443/tcp, :::443->443/tcp, 0.0.0.0:5671->5671/tcp,
:::5671->5671/tcp flexsnap-nginx
7fd258cb575a veritas/flexsnap-core:10.4.x.x-xxxxx
"/usr/bin/flexsnap-n…" 4 hours ago Up 4 hours
flexsnap-notification
9c06318b001a veritas/flexsnap-core:10.4.x.x-xxxxx
"/usr/bin/flexsnap-p…" 4 hours ago Up 4 hours
flexsnap-policy
031f853377a5 veritas/flexsnap-core:10.4.x.x-xxxxx
"/usr/bin/flexsnap-s…" 4 hours ago Up 4 hours
flexsnap-scheduler
dfbcaeda1463 veritas/flexsnap-core:10.4.x.x-xxxxx
"/usr/bin/flexsnap-a…" 4 hours ago Up 4 hours
Deploying NetBackup Snapshot Manager for Data Center using container images 45
Verifying that NetBackup Snapshot Manager for Data Center is installed successfully
flexsnap-onhostagent
253e7284a945 veritas/flexsnap-core:10.4.x.x-xxxxx
"/usr/bin/flexsnap-a…" 4 hours ago Up 4 hours
flexsnap-agent
d54eed8434fe veritas/flexsnap-core:10.4.x.x-xxxxx
"/usr/bin/flexsnap-l…" 4 hours ago Up 4 hours
flexsnap-listener
759e4ee9653b veritas/flexsnap-core:10.4.x.x-xxxxx
"/usr/bin/flexsnap-c…" 4 hours ago Up 4 hours
flexsnap-coordinator
28c88bdc1ca2 veritas/flexsnap-core:10.4.x.x-xxxxx
"/usr/bin/flexsnap-g…" 4 hours ago Up 4 hours
8472/tcp
flexsnap-api-gateway
dd5018d5e9f9 veritas/flexsnap-core:10.4.x.x-xxxxx
"/usr/bin/flexsnap-c…" 4 hours ago Up 4 hours
9000/tcp
flexsnap-certauth
0e7555e38bb9 veritas/flexsnap-rabbitmq:10.4.x.x-xxxxx
"/opt/VRTScloudpoint…" 4 hours ago Up 4 hours (healthy)
5671/tcp
flexsnap-rabbitmq
b4953f328e8d veritas/flexsnap-postgresql:10.4.x.x-xxxxx
"/opt/VRTScloudpoint…" 4 hours ago Up 4 hours (healthy)
13787/tcp
flexsnap-postgresql
cf4a731c07a6 veritas/flexsnap-deploy:10.4.x.x-xxxxx
"/opt/VRTScloudpoint…" 4 hours ago Up 4 hours
flexsnap-ipv6config
9407ea65a337 veritas/flexsnap-fluentd:10.4.x.x-xxxxx
"/opt/VRTScloudpoint…" 4 hours ago Up 4 hours
0.0.0.0:24224->24224/tcp, :::24224->24224/tcp
flexsnap-fluentd
Deploying NetBackup Snapshot Manager for Data Center using container images 46
Restarting NetBackup Snapshot Manager for Data Center
■ To verify the configuration status using the flexsnap_configure CLI, run the
following command:
# flexsnap_configure status
The command output resembles the following:
■ Upgrade scenarios
■ Upgrading NetBackup Snapshot Manager for Data Center using patch or hotfix
the NetBackup Snapshot Manager for Data Center data volume of the previous
version is attached.
10.4 10.5
Notes:
■ Direct upgrade from versions prior to 9.1 to 10.2 is not supported. We need to
first upgrade to 9.1 before upgrading to 10.2 for any upgrade path.
■ Upgrading NetBackup Snapshot Manager for Data Center across the OS versions
is not supported. If you are using NetBackup Snapshot Manager for Data Center
on a RHEL7.x host, then you can only migrate it to a RHEL 8.6 or 8.4 host. Then
follow the upgrade paths mentioned in the above table for upgrading NetBackup
Snapshot Manager for Data Center on a RHEL 8.6 or 8.4 host.
See “Migrating and upgrading NetBackup Snapshot Manager for Data Center”
on page 64., for more information on migrating and upgrading NetBackup
Snapshot Manager for Data Center on RHEL.
■ See “Upgrade scenarios” on page 50., for more information on upgrading
NetBackup 8.3.x to NetBackup 10.2.
Upgrade scenarios
The following table lists the NetBackup Snapshot Manager for Data Center upgrade
scenarios.
Note: For all NetBackup versions, the NetBackup (primary, media) server and
NetBackup Snapshot Manager for Data Center version must be at the same level.
During the upgrade, first, upgrade NetBackup Snapshot Manager for Data Center
and then upgrade the NetBackup server.
Upgrading NetBackup Snapshot Manager for Data Center 51
Upgrade scenarios
Full upgrade from If you plan to upgrade ■ Disable NetBackup Snapshot Manager for Data Center
NetBackup 10.1, 10.2, NetBackup to 10.5 or later that servers.
10.3, 10.4 to includes upgrading all ■ Upgrade NetBackup Snapshot Manager for Data Center
NetBackup 10.5 or NetBackup Snapshot Manager servers.
later for Data Center servers. ■ Enable NetBackup Snapshot Manager for Data Center
servers.
Only NetBackup If you plan to upgrade only the Contact Veritas Support to obtain an Emergency Engineering
Snapshot Manager for NetBackup Snapshot Manager Binary (EEB) to support the incompatibility between the
Data Center upgrades for Data Center servers to 10.5 NetBackup Snapshot Manager for Data Center and
to version 10.5 or later or later; but do not plan to NetBackup versions.
upgrade NetBackup.
■ Disable NetBackup Snapshot Manager for Data Center
servers.
■ Apply the EEB patch on the NetBackup primary server
and associated media servers.
■ Upgrade NetBackup primary server.
■ Then enable NetBackup Snapshot Manager for Data
Center servers.
Upgrading to If your NetBackup 9.1.x server The process for this upgrade is:
NetBackup version has NetBackup Snapshot
■ Disable the NetBackup Snapshot Manager for Data
10.5 Manager for Data Center, you
Center server for maintenance in the NetBackup web UI.
must first upgrade NetBackup
■ Upgrade the NetBackup Snapshot Manager for Data
Snapshot Manager for Data
Center server from NetBackup 9.1.x to NetBackup 10.2.
Center to version 10.2. Then
■ Upgrade the NetBackup Snapshot Manager for Data
you can proceed to upgrade
Center server from NetBackup 10.2 to NetBackup 10.5.
version 10.2 to version 10.5.
■ Enable the NetBackup Snapshot Manager for Data Center
server in the NetBackup web UI.
Upgrading NetBackup Snapshot Manager for Data Center 52
Preparing to upgrade NetBackup Snapshot Manager for Data Center
Migrating and If you plan to migrate and See “Migrating and upgrading NetBackup Snapshot Manager
upgrading the upgrade NetBackup Snapshot for Data Center” on page 64.
NetBackup Snapshot Manager for Data Center on
Manager for Data RHEL 8.6 or 8.4.
Center on RHEL
Migrating and If you plan to migrate and See “Migrating and upgrading NetBackup Snapshot Manager
upgrading the upgrade Snapshot Manager for for Data Center” on page 64.
Snapshot Manager for Data Center on RHEL 8.8 or 9.x.
Data Center on
RHEL8/9 SELinux
enforcing.
■ To cancel the pending SLP operation for a specific image, use nbstlutil
cancel -backupid <value>
■ To cancel the pending SLP operation for images that belong to a specific
lifecycle, use nbstlutil cancel -lifecycle <name>
■ On the NetBackup primary server, run the following command to stop all
NetBackup processes:
■ UNIX: /usr/openv/netbackup/bin/bp.kill_all
■ Windows: install_path\NetBackup\bin\bpdown -f
■ After you upgrade NetBackup Snapshot Manager for Data Center, if required
you can upgrade the NetBackup primary server. Also, you must enable the
NetBackup Snapshot Manager for Data Center server from the NetBackup web
UI.
Note: The actual file name may vary depending on the release version.
2 Copy the downloaded compressed image file to the computer on which you
want to deploy NetBackup Snapshot Manager for Data Center.
Upgrading NetBackup Snapshot Manager for Data Center 54
Upgrading NetBackup Snapshot Manager for Data Center
# ls
NetBackup_SnapshotManager_10.4.x.x-xxxx.tar.gz
netbackup-flexsnap-10.4.x.x-xxxx.tar.gz
flexsnap_preinstall.sh
4 Run the following command to prepare the NetBackup Snapshot Manager for
Data Center host for installation:
# sudo ./flexsnap_preinstall.sh
# ./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
Upgrading NetBackup Snapshot Manager for Data Center 55
Upgrading NetBackup Snapshot Manager for Data Center
5 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:
Wait for all the NetBackup Snapshot Manager for Data Center containers to
be stopped and then proceed to the next step.
Upgrading NetBackup Snapshot Manager for Data Center 56
Upgrading NetBackup Snapshot Manager for Data Center
Example 2:
Upgrading NetBackup Snapshot Manager for Data Center 58
Upgrading NetBackup Snapshot Manager for Data Center
8 (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>
Upgrading NetBackup Snapshot Manager for Data Center 62
Upgrading NetBackup Snapshot Manager for Data Center
9 To reinstall the same version of Snapshot Manager for Data Center, use the
--force option with the install command.
10 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” on page 43.
11 This concludes the upgrade process. Verify that your NetBackup Snapshot
Manager for Data Center configuration settings and data are preserved as is.
Upgrading NetBackup Snapshot Manager for Data Center 63
Upgrading NetBackup Snapshot Manager for Data Center using patch or hotfix
# ls
NetBackup_SnapshotManager_10.x.x.x.xxxx.tar.gz
netbackup-flexsnap-10.x.x.x.xxxx.tar.gz
flexsnap_preinstall.sh
3 Run the following command to prepare the NetBackup Snapshot Manager for
Data Center host for installation:
# sudo ./flexsnap_preinstall.sh
5 Upgrade NetBackup Snapshot Manager for Data Center by running the following
command using the flexsnap_configure CLI:
# flexsnap_configure install
The installer first loads the individual service images and then launches them
in their respective containers.
6 (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>
7 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” on page 43.
8 This concludes the NetBackup Snapshot Manager for Data Center upgrade
process using a patch or a hotfix. Verify that your NetBackup Snapshot Manager
for Data Center configuration settings and data are preserved as is.
■ Prepare a RHEL 8.6 or 8.4 host for installation. You can either upgrade your
existing RHEL 7.x OS to RHEL 8.6 or 8.4 OS, or create a new system with RHEL
8.6 or 8.4.
■ For upgrading the system from RHEL 7.x to RHEL 8.6 or 8.4, follow the Red
Hat documentation.
■ For creating a new system with RHEL 8.6 or 8.4, configure a Podman
container platform.
See “Installing container platform (Docker, Podman)” on page 23.
The brief steps include:
■ Enable your subscriptions:
# sudo subscription-manager register --auto-attach
--username=<username> --password=<password>
■ Run the following commands to install the required packages (lvm2, udev ,
dnsmaq, udica, and policycoreutils-devel) on the hosts:
#yum install -y lvm2-<version>
#yum install -y lvm2-libs-<version>
#yum install -y systemd-udev-<version>
#yum install -y podman-plugins
# yum install -y udica
# yum install -y policycoreutils-devel
■ Run the following commands to lock the Podman and Conmon versions to the
supported versions, so that they do not get updated with the yum update:
sudo yum install -y podman-4.0.2-7.module+el8.3.1+9857+68fb1526
sudo yum install -y python3-dnf-plugin-versionlock
■ Verify that specific ports are open on the instance or physical host.
See “Verifying that specific ports are open on the instance or physical host”
on page 25.
Next, migrate NetBackup Snapshot Manager for Data Center from the RHEL 7.x
host to the newly prepared RHEL 8.6 or 8.4 host.
See “Migrate and upgrade NetBackup Snapshot Manager for Data Center on RHEL
8.6 or 8.4” on page 66.
Upgrading NetBackup Snapshot Manager for Data Center 66
Migrating and upgrading NetBackup Snapshot Manager for Data Center
# ls
NetBackup_SnapshotManager_10.4.x.x-xxxx.tar.gz
netbackup-flexsnap-10.4.x.x-xxxx.tar.gz
flexsnap_preinstall.sh
3 Run the following command to prepare the NetBackup Snapshot Manager for
Data Center host for installation:
# sudo ./flexsnap_preinstall.sh
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.
For Podman:
# podman rmi -f <imagename>:<oldimage_tagid>
For Docker:
# docker rmi -f <imagename>:<oldimage_tagid>
6 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” on page 43.
Upgrading NetBackup Snapshot Manager for Data Center 67
Migrating and upgrading NetBackup Snapshot Manager for Data Center
The NetBackup Snapshot Manager for Data Center containers are stopped
one by one. Messages similar to the following appear on the command line:
Wait for all the NetBackup Snapshot Manager for Data Center containers to
be stopped and then proceed to the next step.
2 Migrate the NetBackup Snapshot Manager for Data Center 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 mount point.
Note: For detailed instructions to detach or attach the data disks, follow
the documentation provided by your cloud or storage vendor.
Upgrading NetBackup Snapshot Manager for Data Center 68
Migrating and upgrading NetBackup Snapshot Manager for Data Center
■ 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 data” on page 24.
■ If you have upgraded from RHEL 7.x to RHEL 8.6 or 8.4, copy the
/cloudpoint mount point data from the RHEL 7.x system and move it to
the RHEL8.6 or 8.4 system under /cloudpoint folder.
This concludes the NetBackup Snapshot Manager for Data Center migration
process.
After migrating NetBackup Snapshot Manager for Data Center to a RHEL 8.6
or 8.4 host, perform the following steps to upgrade NetBackup Snapshot
Manager for Data Center. See “Upgrading NetBackup Snapshot Manager for
Data Center” on page 53.
3 During migration process, if NetBackup Snapshot Manager for Data Center is
migrated to another system or IP address is changed, then regenerate the
certificates as follows:
Using flexsnap_configure CLI
■ Stop the NetBackup Snapshot Manager for Data Center services using the
following command:
# flexsnap_configure stop
■ Start the NetBackup Snapshot Manager for Data Center services using the
following command:
# flexsnap_configure start
4 After migrating NetBackup Snapshot Manager for Data Center to a RHEL 8.6
or 8.4 host, perform the following steps to upgrade NetBackup Snapshot
Manager for Data Center to 10.3.
See “About NetBackup Snapshot Manager for Data Center upgrades”
on page 49.
5 This concludes the migration and upgrade process for NetBackup Snapshot
Manager for Data Center. Verify that your NetBackup Snapshot Manager for
Data Center configuration settings and data are preserved as is.
Chapter 5
Uninstalling NetBackup
Snapshot Manager for
Data Center
This chapter includes the following topics:
■ All the snapshot data and configuration data from your existing installation is
maintained in the external /cloudpoint data volume. This information is external
to the NetBackup Snapshot Manager for Data Center containers and images
and is deleted after the uninstallation.
You can take a backup of all the data in the /cloudpoint volume, if desired.
See “Backing up NetBackup Snapshot Manager for Data Center” on page 70.
2 Ensure that all NetBackup Snapshot Manager for Data Center containers are
stopped. This step is important because all activity and connections to and
from NetBackup Snapshot Manager for Data Center must be stopped to get a
consistent NetBackup Snapshot Manager for Data Center backup.
Enter the following:
(For Docker) # sudo docker ps | grep veritas
(For Podman) # sudo podman ps | grep veritas
This command should not return any actively running NetBackup Snapshot
Manager for Data Center containers.
Uninstalling NetBackup Snapshot Manager for Data Center 71
Removing NetBackup Snapshot Manager for Data Center from a standalone Docker host environment
3 (Optional) If you still see any active containers, repeat this step 2. If that does
not work, run the following command on each active container:
(For Docker) # sudo docker kill container_name
(For Podman) # sudo podman kill container_name
For example, the following is the command for the docker environment:
# sudo docker kill flexsnap-api
4 Back up the folder /cloudpoint. Use any backup method you prefer.
For example:
# tar -czvf cloudpoint_dr.tar.gz /cloudpoint
flexsnap_configure uninstall
Uninstalling NetBackup Snapshot Manager for Data Center 72
Removing NetBackup Snapshot Manager for Data Center from a standalone Docker host environment
The installer begins to unload the relevant NetBackup Snapshot Manager for
Data Center container packages from the host. Messages similar to the following
indicate the progress status:
2. Confirm that the NetBackup Snapshot Manager for Data Center containers are
removed.
Use the following docker command:
(For Docker) # sudo docker ps -a
(For Podman) # sudo podman ps -a
3. If desired, remove the NetBackup Snapshot Manager for Data Center container
images from the host.
Use the following docker command to view the docker images that are loaded
on the host:
■ (For Docker) # sudo docker images -a
■ (For Podman) # sudo podman images -a
Use the following respective commands to remove the NetBackup Snapshot
Manager for Data Center container images from the host:
■ (For Docker) # sudo docker rmi <image ID>
■ (For Podman) # sudo podman rmi <image ID>
4. This completes the NetBackup Snapshot Manager for Data Center uninstallation
on the host.
A possible next step is to re-deploy NetBackup Snapshot Manager for Data
Center.
Uninstalling NetBackup Snapshot Manager for Data Center 73
Restoring NetBackup Snapshot Manager for Data Center
2 Download or copy the NetBackup Snapshot Manager for Data Center installer
binary to the new server.
3 Install NetBackup Snapshot Manager for Data Center.
Use the following command in the flexsnap_configure CLI:
# flexsnap_configure install
4 When the installation completes, you can resume working with NetBackup
Snapshot Manager for Data Center using your existing credentials.
Chapter 6
Snapshot Manager for
Data Center catalog
backup and recovery
This chapter includes the following topics:
■ Run the following command to recover NetBackup Snapshot Manager for Data
Center metadata post Snapshot Manager for Data Center fresh installation:
# flexsnap_configure recover --backup-file <path_of_backup_file>
Snapshot Manager for Data Center catalog backup and recovery 75
NetBackup Snapshot Manager for Data Center data backup
5 (Required only if NetBackup primary server version is other than 10.4 or later)
NetBackup Snapshot Manager for Data Center must be registered again using
re-issue token in NetBackup.
6 (Optional) If the backups fail, restart NetBackup Snapshot Manager for Data
Center, run the command:
flexsnap-configure restart
After following the recovery steps, NetBackup Snapshot Manager for Data Center
operates normally. You can also recover assets using earlier snapshots or backup
copies.
Chapter 7
Configure NetBackup
Snapshot Manager for
Data Center
This chapter includes the following topics:
■ Plug-in Discovery
“Configure the storage array plug-ins for Snapshot Manager for Data Center”
on page 90. for configuration parameters for each storage array plug-in.
Note: After upgrading from Java UI, the discovery statuses of the storage array
plug-ins appear blank in the web UI. You can re-initiate the configured plug-in
discovery, to view the correct discovery data.
Configure NetBackup Snapshot Manager for Data Center 79
Verify storage array certificate
To add a plug-in
1 On the left, click Snapshot Manager, under Storage. You can see the
configured plug-ins in the Plug-ins tab. Click Add.
2 Select a snapshot server from the drop-down. Select the required plug-in from
the Select product list.
3 (Optional) If required change the plug-in display name.
4 Click Next.
5 Enter the FQDN or IP address of the array. Enter the username and password.
6 If available for the array, enter the discovery interval at which you want to
discover new assets.
7 Click Next. On the Review page, review the configuration that you have entered,
and click Finish.
You may also add storage array plug-ins in the Snapshot Manager for Data Center
using NetBackup APIs. Refer to the NetBackup API documentation for details.
To update credentials for a plug-in
1 Click the ellipsis menu (three dots) in the row of the plug-in for which you want
to edit the credentials.
2 Click Update credentials. Update the credentials and click Save.
In the tpconfig utility, enter true or false manually for the option Enter Verify
Certificate, depending on whether the certificate needs to be verified or not.
In the web UI, use the Verify certificate option in the Plug-in configuration page
or the Edit credentials dialog.
Note: If the custom port tag is not reflected in the output of this command, then
the port is non-communicable for some other reasons.
Plug-in Discovery
Plug-in discovery functionality is available for all the supported storage arrays. As
a part of the discovery operation, the Snapshot Manager for Data Center discovers
all the assets: disks, LUNs, volumes, replication relationships, and so on, from the
storage array. These assets are persisted in the Snapshot Manager for Data Center
database and are further used for snapshot and replication operations.
Whenever a new storage array plug-in is configured, NetBackup initiates a discovery
operation to retrieve the assets from the storage array. Snapshot Manager for Data
Center automatically schedules the plug-in discovery after every 4 hours. This
discovery interval can be configured using the NetBackup API.
Configure NetBackup Snapshot Manager for Data Center 82
Plug-in Discovery
You can monitor the status of discovery in the Status column of the Storage array
plug-in, inside the Snapshot Manager for Data Center Plugin pane.
Also, you can manually initiate the discovery operation for a specific storage array
plug-in.
To manually initiate a discovery operation:
1 Right-click the storage array plug-in for which you want to initiate discovery in
the Snapshot Manager for Data Center Plugins pane.
2 Click Discover Assets.
This changes the Status column of the added storage plug-in to Discovering.
You may also initiate the plug-in discovery by NetBackup API. To perform discovery
using the NetBackup APIs, refer to the NetBackup API documentation:
https://swagger.javaws.kubert.vrts.io/
Chapter 8
Storage array replication
This chapter includes the following topics:
Prerequisites
■ You must establish the replication relationship between the source and
destination.
■ Complete the management host/console setup to manage the storage arrays.
■ Configure the required user for admin activities with necessary permissions as
required by NetBackup. Refer to the individual storage array section in the
Supported storage arrays in data center chapter.
2. Configure the storage array See “Configure the storage array plug-ins
plug-in. for Snapshot Manager for Data Center”
on page 90.
If source and destination
volume reside on different
arrays, configure a separate
storage array plug-in for
source and destination.
3. Create a storage unit for any See the NetBackup Administrator's Guide,
operation that produces Volume I.
non-snapshot copies.
1 Configure the Snapshot Manager for Data See “Before you begin
Center server in NetBackup installing NetBackup
Snapshot Manager for
Data Center” on page 26.
2 Configure the NetApp storage array or HPC See “Configure the storage
RMC plug-in. array plug-ins for Snapshot
Manager for Data Center”
on page 90.
4 Configure the SLP to use snapshot and For more details about
replication replication, refer to these
chapters in this guide.
1 Storage array
replication
2 Configuring storage
lifecycle policies for
snapshots and
snapshot replication
3 Supported storage
arrays in the data
center
Note: Backup from Snapshot job failures (error code 4213) occur when multipathing
is enabled on the array side. To resolve this issue, enable Linux multipathing on
the backup host or client.
Note: In NetBackup, NetApp supports cascaded and fanout replication, while the
HPC RMC plug-in supports only source-to-destination replication.
Chapter 9
Storage array plug-ins for
Snapshot Manager for
Data Center
This chapter includes the following topics:
■ Configure the storage array plug-ins for Snapshot Manager for Data Center
■ HPE XP plug-in
Storage array plug-ins for Snapshot Manager for Data Center 90
Configure the storage array plug-ins for Snapshot Manager for Data Center
operations supported by each of these storage array plug-in are also mentioned in
detail.
Unisphere managing the Dell EMC 443 Storops SDK python library
Unity
Table 9-2 Snapshot Manager for Data Center operations on the Azure
NetApp Files
Discover assets Snapshot Manager for Data Center discovers all the volumes
and snapshots. Volumes are primary assets, each contains
the associated snapshots and asset IDs.
If NetBackup Snapshot Manager for Data Center is deployed on Azure, then the
configuration can be done via Application Service Principal, System Managed
Identity or User Managed Identity.
Credential Type Credential type which will be used for plug-in configuration.
Select either Application Service Principal, System Managed
Identity or User Managed Identity.
Storage array plug-ins for Snapshot Manager for Data Center 95
Azure NetApp Files plug-in
Client ID (User Managed If User Managed Identity is selected then client ID of that
Identity) User Managed Identity.
■ If all the export rules for the volume are exhausted (NetApp Volume supports
at most 5 rules) then NetBackup Snapshot Manager for Data Center updates
the 5th rule of the volume and honor the permissions assigned to the rule.
■ For SMB, the user must provide permissions to the volume as mentioned in the
following web site :https://learn.microsoft.com/en-us/azure/azure-netapp-files/
Credential Type Select the credential type to be used for plug-in configuration:
either Application Service Principal, System Managed Identity,
or User Managed Identity.
Client ID (User Managed If User Managed Identity is selected then client ID of that
Identity) User Managed Identity.
Table 9-7 Snapshot Manager for Data Center operations on the Azure Files
Discover assets Snapshot Manager for Data Center identifies all volumes and
their snapshots. Shares are primary assets, each containing
associated snapshots and asset IDs.
Deport snapshot This operation will be a no-op because deport is the opposite
of export, and Snapshot Manager for Data Center does not
grant specific permissions to the share.Azure Files plug-in
configuration prerequisites.
Table 9-8 Snapshot Manager for Data Center operations on Dell EMC
PowerMax/ VMax plug-in
Snapshot Description
Manager for
Data Center
operation
Discover NetBackup Snapshot Manager for Data Center discovers all the volumes,
assets Storage groups, and Storage group snapshots.
Create Dell EMC Unisphere for PowerMax and Unipshere for VMax allows snapshot
snapshot creation for entire storage group. The storage group snapshot contains a
single Point-in-time copy of all the volumes in the storage group at that
time.
NB<unique_21digit_number>
Note: Snapshots are created in the storage group. The only way to
distinguish the snapshots is based on which asset the operation was
created. If the snapshot is created on a volume, then the snapshot is
mapped to the volume. If created on a storage group, the snapshot is
mapped to the storage group asset.
Table 9-8 Snapshot Manager for Data Center operations on Dell EMC
PowerMax/ VMax plug-in (continued)
Snapshot Description
Manager for
Data Center
operation
Restore Snapshot Manager for Data Center uses the storage group snapshot restore
snapshot API from Unisphere.
Deport When a snapshot deport operation is initiated, the exported storage group,
snapshot and the volume(s) inside it, and the temporary storage group used as a
source for the snapshot, are all deleted. It is a revert or clean-up of the
export snapshot.
Storage array plug-ins for Snapshot Manager for Data Center 102
Dell EMC PowerMax and VMax array
Parameter Description
Array ID Array ID is the 12-digit unique ID of the array that you want
to protect.
■ None: No capabilities.
■ Monitor: Performs read-only operations on an array, excluding the ability to
read the audit log or access control definitions.
■ PerfMonitor: Includes Monitor role permissions and grants additional privileges
within the performance component of Unisphere for the VMAX application to
set up various alerts and update thresholds to monitor array performance.
■ StorageAdmin: Perform all management and control functions. See the specific
permissions pertaining to this role:
■ SecurityAdmin Performs security operations (symaudit, symacl, symauth)
on an array in addition to all monitor operations. Users or groups assigned
the SecurityAdmin or Admin roles can create or delete component-specific
authorization rules. The SecurityAdmin also has all Auditor rights.
■ Admin: Performs all operations on an array, including security operations
and monitor operations. The Admin also has StorageAdmin rights,
SecurityAdmin rights, and application performance monitoring privileges.
■ Auditor: Grants the ability to view, but not modify, security settings for an array
(including reading the audit log, symacl list, and symauth) in addition to all
monitor operations. This is the minimum role required to view the array audit
log.
It is important to clarify that your Storage_Admin role remains your ssuper user,
and keeps sole control of provisioning storage on the array.
■ Don't refresh the re-purpose copy as this changes the data on the copy by
refreshing from the parent volume. For example, if you create a snapshot of
volume V1, the protection copy is made using V1.NB<unique_21digit_number>
and the export re-purpose copy is made with the name
V1.NB<unique_21digit_number>.repurpose. Refreshing a re-purpose copy
affects backup and restore.
Table 9-9 Snapshot Manager for Data Center operations on the Dell EMC
PowerFlex array
Discover assets Snapshot Manager for Data Center discovers all the array
volumes and snapshots inside the snapshot group
flexsnap_snap_group with some metadata. The volumes
which have 'CMD' in the attributes without mapping are not
discovered.
Restore snapshot Snapshot Manager for Data Center offers the ability to restore
the snapshots using an SDK method with different restore
paths.
Table 9-11 Snapshot Manager for Data Center operations on Dell EMC
PowerScale (Isilon) plug-in
Snapshot Description
Manager for
Data Center
operation
Discover NetBackup Snapshot Manager for Data Center discovers all the NFS
assets exports, SMB shares, and their snapshots along with some of their directory
metadata from all the Access Zones the user has privileges to access or
view. By default, a DELL PowerScale cluster has a Single access zone
known as the System Access Zone and unless you have additional Access
Zones, all the NFS export and SMB Shares are in this default Access Zone.
The multiple access zone can be mapped to the same or different Groupnet
(Groupnet -> Subnet -> Pool). During discovery, the Snapshot Manager
for Data Center also associates the relevant SmartConnect of a pool to its
NFS export or SMB share.
NetBackup Snapshot Manager for Data Center also discovers all the nested
NFS exports and SMB shares irrespective of the depth at which they are
created. Mentioned below are a few examples of nested shares discovered
by Snapshot Manager for Data Center: ["/ifs/test_fs1", "/ifs/test_fs1/test_fs2",
"/ifs/test_fs1/test_data/test_fs3", "/ifs/smb_03/test_data/dir01"]
The discovered NFS export and SMB shares must have valid underlying
filesystem paths. The filesystem directory path must be shared by NFS
export, and SMB shares.
Create To create a snapshot, Snapshot Manager for Data Center initiates a POST
snapshot REST API call on the nfs_export with the required information and the
snapshot name. The API returns the details of the snapshot.
A typical snapshot created by Snapshot Manager for Data Center has the
following naming convention:
SnapNB-NB<unique_21digit_number>
Delete To delete a snapshot, NetBackup Snapshot Manager for Data Center calls
snapshot or the REST API with the required snapshot details. You can see a confirmation
replicated when the snapshot is deleted successfully on the array.
snapshot
Storage array plug-ins for Snapshot Manager for Data Center 108
Dell EMC PowerScale (Isilon)
Table 9-11 Snapshot Manager for Data Center operations on Dell EMC
PowerScale (Isilon) plug-in (continued)
Snapshot Description
Manager for
Data Center
operation
Restore Snapshot Manager for Data Center uses the JobAPI to revert a snapshot.
snapshot
To revert a snapshot that contains a directory, it is recommended that you
create a SnapRevert domain for a directory.
Export ■ When a snapshot export operation is initiated for NFS, a new export is
snapshot or created over the snapshot path:
replicate ("/ifs/test_fs/.snapshot/NB15985918570166499611/")
snapshot with the backup host added as a Root Clients with read-only permissions.
■ When a snapshot export operation is initiated for SMB, a new share is
created over the snapshot path:
("/ifs/test_fs/.snapshot/NB15985918570166499611/")
The user and the domain provided while exporting the snapshot is added
with privileges to access the SMB share created.
The user must be in the domain specified.
Table 9-11 Snapshot Manager for Data Center operations on Dell EMC
PowerScale (Isilon) plug-in (continued)
Snapshot Description
Manager for
Data Center
operation
Create Snapshot Manager for Data Center uses the JobAPI to create a change
snapshot diff list between snapshots.
Replicate NetBackup Snapshot Manager for Data Center creates, and replicates
snapshot snapshots based on the backup selections in the policy. For these backup
selections, you need to set up a SyncIQ policy on the DELL EMC
PowerScale (Isilon). NetBackup only supports synchronize action for the
SyncIQ policy.
■ Ensure that the SmartConnectIQ license is activated on the storage array. This
enables Snapshot Manager for Data Center to use the load-balancing and
failover capabilities of the Isilon cluster.
■ For the list of all the supported Data OneFS versions, refer to the NetBackup
Snapshot Manager for Data Center section in the NetBackup Hardware
and Cloud Storage Compatibility List (HCL).
■ Ensure that the SyncIQ license is activated on the Dell EMC PowerScale (Isilon)
and SyncIQ service is on. This is required to initiate a replication operation.
■ For replication operation, both source and target Dell EMC PowerScale (Isilon)
array plug-ins must be registered with NetBackup.
Parameter Description
Cluster FQDN / IP address An Isilon cluster consists of three or more hardware nodes.
Even if the plug-in is configured with the FQDN or IP which is not a SmartConnect
FQDN, NetBackup Snapshot Manager for Data Center would still export the
snapshots using the SmartConnect FQDN.
Table 9-12 Permissions required by the Isilon user account on the array
Network Read-only
Snapshot Read/Write
NFS Read/Write
SMB Read/Write
SyncIQ Read-only
The snapshots can be replicated when you have multiple targets configured as
destination.
Snapshot Description
Manager for
Data Center
operation
Discover In a SAN environment, NetBackup discovers all the Dell EMC PowerStore
assets primary volumes and volume snapshots present on the array. NetBackup
discovers only primary type volumes and skips the clone type volumes. For
volume snapshots only the snapshot type volumes are discovered.
NetBackup also discovers the nested NFS exports and SMB shares
irrespective of the depth.
NB<unique_21digit_number>
Restore In a SAN environment, NetBackup offers the capability for the PIT rollback,
snapshot and you can use the created snapshot to restore the primary volume. For
restoring the .snapshot type volume is used.
Snapshot Description
Manager for
Data Center
operation
Export In a SAN environment, NetBackup can export using the snapshots created
snapshot for volumes. When a NetBackup initiates an export call, a new clone-type
volume is created from the snapshot and used for backup purposes. A host
is added to this clone based on the details that are sent by the NetBackup
client.
Deport In a SAN environment, the deport snapshot operation removes the hosts
snapshot added for the cloned volume created during the export call. NetBackup
deletes all the hosts that are available on the volume. The newly cloned
volume is also deleted during the deportation operation.
Parameter Description
User name The Dell EMC PowerStore user account that has the
permissions to invoke the PowerStore REST APIs to perform
all snapshot operations on the array.
■ The cloned volumes never expire. You can manually delete the cloned volumes
from NetBackup during deport and delete operations.
■ Volumes from multiple appliances are not allowed within the same volume group.
All Volumes must reside on the same appliance.
■ If a protection policy is assigned with a volume group, you cannot assign a
protection policy to an individual resource within the group.
■ The volume groups do not support mapping and unmapping, the workaround
is to attach and detach the host with each volume in the volume group separately.
■ Single volume restore operations are only allowed when write order consistency
is disabled on the volume group.
■ Before restoring a snapshot, you must shut down the application and unmount
the file system that is running on the production host. Also, delete the host cache
to prevent data corruption during the restore operation.
In a NAS environment:
■ All snapshots are captured at the file system level and the snapshots are in
read-only mode.
■ The limit for the file system name is 255 characters. NFS export or SMB share
name is 80 characters on the array. For a snapshot name, the maximum length
must be 255 characters.
■ Dell EMC PowerStore plug-in does not support point-in-time (PIT) rollback
restore of shares using snapshots.
Table 9-14 Snapshot Manager for Data Center operations on the Dell EMC
XtremIO SAN array
Discover assets The XtremIO array has three types of volumes: Primary,
Re-purpose copy, and Protection-copy. You can create the
primary volumes manually and they can be of any size based
on the limit of the associated volume. A re-purpose copy is
a thin-provisioned volume created from the protection copy
during the snapshot creation process.
NB<unique_21digit_number>
Table 9-14 Snapshot Manager for Data Center operations on the Dell EMC
XtremIO SAN array (continued)
Restore snapshot NetBackup Snapshot Manager for Data Center offers the
ability to restore the snapshots using a Put REST API. You
can restore the source volume only with the protection-copy
type snapshot. Any PIT rollback uses the snapshot associated
with the source volume.
■ All the snapshots taken for any volume are read-only. A new re-purpose copy,
cloned from the snapshot volume, is used for data backup.
■ The limit for any volume name is 128 characters on the array. For a repurpose
copy, the maximum length of the volume name is 128 -
(23(NB<unique_21digit_number>) - 9(Repurpose) - 2(Dot notations)) = 94. It is
a strict requirement to limit the volume name to 94 characters for a successful
snapshot.
■ Do not write data to the repurpose copy created by NetBackup by manually
mapping it to a host. You can consider the re-purpose copies created by them
as an individual volume in NetBackup. Do not use the copies starting with
volume_name.NB<unique_21digit_number>.repurpose.
■ Do not refresh the repurpose copy, as this changes the data on the image by
refreshing from the parent volume. This affects backup and restore.
Table 9-16 Snapshot Manager for Data Center operations on Dell EMC Unity
array
Snapshot Description
Manager for
Data Center
operation
Create In a NAS environment, NetBackup Snapshot Manager for Data Center calls
snapshot an SDK method to create a snapshot of a file system. When a snapshot is
initiated, a redirect-on-write (ROW) snapshot of the entire file system is
created. The API returns the snapshot details.
The snapshot name and retention period are not set on the array for these
snapshots. A typical snapshot created by NetBackup Snapshot Manager
for Data Center has the following naming convention:
NB<unique_21digit_number>
Table 9-16 Snapshot Manager for Data Center operations on Dell EMC Unity
array (continued)
Snapshot Description
Manager for
Data Center
operation
Restore For NAS, NetBackup Snapshot Manager for Data Center does not support
snapshot PIT restore on file system, NFS share, and SMB Share.
For SAN:
■ PIT restores for volume snapshot restores the volume to the snapshot
state.
■ PIT restores for a volume inside the consistency group is restored to
the PIT snapshot state.
Note: The latest snapshot is not required for PIT. You can perform the
restore operation with old snapshots related to the file system.
Storage array plug-ins for Snapshot Manager for Data Center 124
Dell EMC Unity Array
Table 9-16 Snapshot Manager for Data Center operations on Dell EMC Unity
array (continued)
Snapshot Description
Manager for
Data Center
operation
Table 9-16 Snapshot Manager for Data Center operations on Dell EMC Unity
array (continued)
Snapshot Description
Manager for
Data Center
operation
Table 9-17 Dell EMC Unity array plug-in configuration parameters (continued)
Dell EMC Unisphere IP Unisphere IP is the management interface that accepts IPv4,
IPv6 and FQDN. Unisphere is mapped to the Unity array and
performs storage management actions.
Table 9-18 Snapshot Manager for Data Center operations on Fujitsu Eternus
AF/DX SAN array
Discover assets NetBackup discovers all the volumes and their snapshots.
Volumes are primary assets; each contains the associated
snapshots and asset IDs.
Restore snapshot NetBackup uses the volume snapshot restore API to restore
volume snapshots to the point-in-time image on the volume.
Deport snapshot During snapshot export, NetBackup deletes the copy session
of the source volume, host connection of snapshot volume,
and exported snapshot volume. It is a revert of the export
snapshot operation.
■ Create one thin provision pool that has a "flexsnap_pool" prefix to store
snapshots.
■ Ensure that a supported version of the Fujitsu Eternus AF/DX plug-in is installed
on the Fujitsu Eternus AF/DX arrays.
■ For the list of all the supported versions of Fujitsu Eternus AF/DX, refer to the
NetBackup Snapshot Manager section in the NetBackup Hardware and Cloud
Storage Compatibility List (HCL).
■ A user account that has the permission to call the Fujitsu Eternus AF/DX APIs
and perform all snapshot operations on the array.
Table 9-19 Snapshot Manager for Data Center operations on Fujitsu AB/HB
array
Discover snapshot NetBackup Snapshot Manager for Data Center discovers all
the Fujitsu AB/HB volumes and their snapshots.
Create assets For each volume, NetBackup creates a snapshot group with
the following naming convention: NBSG<volume_name> The
snapshot group is created with 40% capacity of the base
volume.
The SAN zoning should be done between the host and the
array that is required to be attached to the snapshot.
Note: The discovery for the Snapshot Volume created in
the export operation will be skipped.
Storage array plug-ins for Snapshot Manager for Data Center 131
Fujitsu Eternus AB/HB SAN array
Table 9-19 Snapshot Manager for Data Center operations on Fujitsu AB/HB
array (continued)
You can find the storage array WWN in the array details.
To get the array details, use the following API:
https://<array / proxy IP>:<port no>/devmgr/v2/storage-systems
Role Responsibilities
Storage admin Full read/write access to storage objects on the arrays, but
no access to the security configuration.
■ SVMs contain data volumes and one or more LIFs through which they serve
data to the clients.
■ SVMs provide file-level data access using NFS and CIFS protocols for NAS
clients.
■ Fujitsu AX/HX Logical Unit Number (LUNs) storage units in a SAN environment.
■ Protocol configured with Fujitsu AX/HX SVM: ISCSI, FC/FCoE, CIFS, NFs
Note: In the case of Fujitsu AX/HX, a LUN is part of a volume and the action
performed on a single LUN is performed on its entire parent volume internally.
Therefore, a volume acts as a consistency group.
Table 9-22 Snapshot Manager for Data Center operations on the Fujitsu
AX/HX array
Table 9-22 Snapshot Manager for Data Center operations on the Fujitsu
AX/HX array (continued)
Delete snapshot When a delete snapshot operation is initiated for the following:
Table 9-22 Snapshot Manager for Data Center operations on the Fujitsu
AX/HX array (continued)
Table 9-22 Snapshot Manager for Data Center operations on the Fujitsu
AX/HX array (continued)
■ For NAS-based storage deployments, ensure that the Fujitsu AX/HX shares
are configured using an active junction path.
■ Ensure that the Fujitsu AX/HX user account to configure the plug-in has the
privileges to perform the following operations on the Fujitsu AX/HX array:
Storage array plug-ins for Snapshot Manager for Data Center 138
Fujitsu AX/HX Series plug-in
■ Create snapshot
■ Delete snapshot
■ Restore snapshot
■ Ensure that the Fujitsu AX/HX user account to configure the plug-in is
configured with HTTP and ontapi access.
■ Ensure that the Fujitsu AX/HX user account to configure the plug-in have
the following roles assigned:
■ Default: read-only
■ LUN: all
■ Volume snapshot: all
■ vserver export-policy: all
■ Ensure that the export policy of the NAS share must not be 'default'. There
must be a policy that has the host configuration of either NFS or SMB or
both.
While configuring a Data LIF, use the prefix nbu_nas_ in the interface name of the
SVM. If a Data LIF exists, NetBackup automatically uses only that LIF for accessing
the snapshots.
Note: This is an optional step, if you configure the Data LIF, the backup reads are
restricted via the dedicated LIF.
If not configured, volume snapshots are accessed via any available DATA LIF of
the corresponding SVM.
Discovery
In the Fujitsu AX/HX array, NetBackup discovers the volumes, and LUNs that are
created on the storage array. It also discovers the snapshots of the following assets.
■ All the NFS and SMB shares using volumes NAS path on the Fujitsu AX/HX
storage.
■ The Fujitsu AX/HX Storage Virtual Machines (SVMs) from which the NFS and
SMB shares are created to mount.
Note: NetBackup will only discover the volumes that are online.
Discover assets Snapshot Manager for Data Center discovers all the HPE
RMC volume sets and their snapshot sets.
Storage array plug-ins for Snapshot Manager for Data Center 142
HPE RMC plug-in
Create snapshot HPE RMC allows you to take snapshots of the entire volume
set at once. The result of a create snapshot operation is a
snapshot set that contains snapshots of every volume in the
volume set.
NB<unique_21digit_number>
Delete snapshot To delete a snapshot set, Snapshot Manager for Data Center
calls a REST API method with the required snapshot details.
Snapshot Manager for Data Center deletes only those
snapshots that it creates itself.
Restore snapshot To restore a snapshot set, Snapshot Manager for Data Center
calls a Post REST API method with the required snapshot
details. If the base volume is in an attached state, it is
detached and then restore is tried. After the restore, the
volume is re-attached to the same host. With the RMC APIs
you can restore a single snapshot from a snapshot set, you
can restore any volume from a snapshot set.
Export snapshot Snapshot Manager for Data Center supports the export of
snapshots over the iSCSI and FC protocols. When a snapshot
export operation is initiated, a new clone volume set is created
using the snapshot set. Once this clone is created, then a
host is attached to the same. It is recommended to do a SAN
zoning between the host and array that is required to be
attached to the snapshot.
Note: NetBackup does not discover the cloned volume set
created in the export operation.
Storage array plug-ins for Snapshot Manager for Data Center 143
HPE RMC plug-in
■ Export snapshot
■ Report snapshot
■ Delete snapshot
There are two predefined user roles in HPE RMC:
■ Admin: Admin has all the required privileges to perform all the supported
operations provided by RMC.
■ Member: Members have only view privileges and cannot perform any tasks.
Users with the Admin role assigned can perform all the snapshot management
operations.
HPE XP plug-in
Snapshot Manager for Data Center provides a robust data protection solutions for
volumes that are set up on a SAN storage host. NetBackup extends SAN support
and allows you to protect mounted iSCSI/FC volumes that are hosted on an HPE
XP array.
Storage array plug-ins for Snapshot Manager for Data Center 145
HPE XP plug-in
The Snapshot Manager for Data Center plug-in for HPE XP contains the necessary
functional logic that enables NetBackup to discover the SAN volumes on the array,
and create, export, deport, and delete snapshots for volumes. Configure this plug-in
on the NetBackup primary server to discover the volumes, and perform backup and
restore operations.
Snapshot Manager for Data Center establishes a connection with HPE XP storage
array by creating sessions in HPE XP Configuration Manager and uses the REST
APIs to discover the SAN volumes and their snapshots that need to be backed up.
Discover assets Snapshot Manager for Data Center discovers the Logical
Devices (LDEV) created on the storage array and snapshots
inside the snapshot group named similar to
flexsnap_snap_group along with some of their metadata.
Create snapshot For snapshots, Snapshot Manager for Data Center uses HPE
XP Fast Snap Pairs and initiates a sequence of REST API
requests with the required information and snapshot name.
The API returns the details of the snapshot.
Export snapshot Snapshot Manager for Data Center supports export over
iSCSI and FC protocols, using REST API to set the LUN path
of the snapshot.
Array user name HPE XP storage array user account which has permissions
for snapshot operations.
Storage array plug-ins for Snapshot Manager for Data Center 147
HPE Alletra 9000 SAN array
Array Storage Device ID Storage device ID of the array that is already registered with
the HPE XP Configuration Manager.
■ To view the list of all supported versions of HPE Alletra 9000, refer to the
NetBackup Snapshot Manager for Data Center section in the NetBackup
Hardware and Cloud Storage Compatibility List (HCL).
Specify the following details when you configure the HPE Alletra 9000 SAN array:
Discover assets NetBackup Snapshot Manager for Data Center discovers all
the volumes (except clone volumes and system volumes)
and snapshots. Volumes are primary assets, each contains
the associated snapshots and asset IDs.
Restore snapshot NetBackup Snapshot Manager for Data Center restores the
parent volume, when you restore a volume from a volume
snapshot.
Specify the following details when you configure the HPE Alletra 6000 SAN array:
Power user All actions except user management, inactivity timeout, array
setup, and array reset up.
Ensure that the HPE Alletra 6000 user account has the privileges to perform the
following operations:
■ Create snapshots
■ Export Snapshots
■ Restore Snapshots
■ Delete Snapshots
■ All snapshots are captured at a volume level and those snapshots are in
read-write mode.
■ Prior restore a volume snapshot is created storing the present state of the
volume.
■ The limit for any volume name is 215 characters.
Discover assets NetBackup Snapshot Manager for Data Center discovers all
the HPE Alletra volumes and their snapshots.
Discover assets NetBackup Snapshot Manager for Data Center discovers all
the volumes (except clone volumes and system volumes)
and snapshots. Volumes are primary assets, each contains
the associated snapshots and asset IDs.
Restore snapshot NetBackup Snapshot Manager for Data Center restores the
parent volume, when you restore a volume from a volume
snapshot.
the Hitachi NAS array through REST API. Then NetBackup uses the API endpoints
to discover the NFS exports, SMB shares, and file system snapshots that need to
be backed up.
Table 9-35 Snapshot Manager for Data Center operations on Hitachi NAS
plug-in
Snapshot Description
Manager for
Data Center
operation
Discover NetBackup Snapshot Manager for Data Center discovers all the Hitachi
assets NAS EVS servers, NFS export, SMB shares, and their file system snapshots
along with some of their directory metadata. NetBackup Snapshot Manager
for Data Center also discovers all the nested NFS exports and SMB shares,
irrespective of the depth at which they are created.
A typical snapshot created by Snapshot Manager for Data Center has the
following naming convention:
NB<unique_21digit_number>
Delete To delete a snapshot, NetBackup Snapshot Manager for Data Center calls
snapshot the DELETE REST API using SDK method, with the required snapshot
details.
The API confirms that the snapshot has been deleted successfully on the
array.
Storage array plug-ins for Snapshot Manager for Data Center 158
Hitachi NAS array
Table 9-35 Snapshot Manager for Data Center operations on Hitachi NAS
plug-in (continued)
Snapshot Description
Manager for
Data Center
operation
Restore NetBackup Snapshot Manager for Data Center does not support PIT restore
snapshot operation on the array. Instead, we can perform Normal restore on specified
locations.
Export NetBackup Snapshot Manager for Data Center supports export operations
snapshot using the NFS and SMB protocol. When a snapshot export operation is
initiated, an export path is created using the snapshot directory and
snapshot name. For NFS exports, the host access configurations are added
as read-only on a particular export or share. For SMB shares, the user and
domain provided while exporting the snapshot are added with privileges to
access the SMB share created.
■ NFS:
<EVS-server-ip>:<share_name>/.snapshot/<snapshot_name>
■ SMB: \\<EVS-server-ip>\<share_name>\@UTC_for_snapshot
Deport When a snapshot deport operation is initiated, Snapshot Manager for Data
snapshot Center makes a PUT REST API call to the Hitachi NAS array, and does
the following:
■ For NFS, it removes the host access configurations entry that was added
during the export operation.
■ For SMB, it removes the privileges provided to the user to access the
SMB share created.
Parameter Description
NAS Manager Server IP / The array's NAS Manager Server or REST Server IP address,
FQDN in either IPV4 or The Fully Qualified Domain Name (FQDN).
User name The Hitachi user account that has the permissions to invoke
the Hitachi NAS REST APIs to perform all snapshot
operations on the array.
Password The password of the Hitachi NAS REST API user account.
■ To upgrade NetBackup Snapshot Manager for Data Center from version 10.1
to later versions, you must expire all snapshots before starting the upgrade
process.
Table 9-36 Snapshot Manager for Data Center operations on Hitachi SAN
plug-in
opeSnapshot Description
Manager for
Data
Centerration
Discover Snapshot Manager for Data Center discovers all the Logical Devices (LDEV)
assets created on the storage array. The primary LDEV objects appear as disk
assets. The secondary LDEV objects that are part of a Thin Image (TI) pair
appear under snapshots.
One or more LDEV objects are grouped in a logical entity called pool. For
the Snapshot Manager for Data Center Hitachi plug-in to work, you must
create a pool named `flexsnap_pool` on the storage array.
The LDEVs that have "CMD" in their attributes and those without any logical
unit number (LUN) mapped are not discovered.
Storage array plug-ins for Snapshot Manager for Data Center 161
Hitachi SAN array
Table 9-36 Snapshot Manager for Data Center operations on Hitachi SAN
plug-in (continued)
opeSnapshot Description
Manager for
Data
Centerration
Create NetBackup takes a snapshot of all the LDEV objects that are attached to
snapshot a hostgroup.
■ Creates a new LDEV object of the same size as the original (base)
LDEV.
■ Puts the base LDEV and the new LDEV into a Thin Image (TI) pair. The
base LDEV is the primary LDEV and the new LDEV is the secondary
LDEV.
■ Splits the TI pair to create a point-in-time snapshot of the base LDEV
and then updates the snapshot LUN path to point to the secondary
LDEV.
■ Attaches the snapshot to the same hostgroup where the base LDEV is
attached.
A typical snapshot created by Snapshot Manager for Data Center has the
following naming convention: NB<unique_21digit_number>
Delete When Snapshot Manager for Data Center deletes a snapshot, it performs
snapshot the following actions:
Restore Snapshot Manager for Data Center performs a restore operation on a thin
snapshot image snapshot of LDEV. All the data in the primary LDEV is overwritten
by the data from the secondary LDEV.
Export When NetBackup exports a snapshot, Snapshot Manager for Data Center
snapshot searches for the target host based on the World Wide Name (WWN) or the
iSCSI Qualified Name (IQN) specified in the export request. After the host
is identified on the storage array, Snapshot Manager for Data Center
updates the path attribute of the secondary LDEV with the target host,
where the snapshot is to be exported. Once the target host is added to the
secondary LDEV host ports, the exported snapshot is immediately visible
on the target host.
Storage array plug-ins for Snapshot Manager for Data Center 162
Hitachi SAN array
Table 9-36 Snapshot Manager for Data Center operations on Hitachi SAN
plug-in (continued)
opeSnapshot Description
Manager for
Data
Centerration
Deport When a snapshot deport operation is initiated, Snapshot Manager for Data
snapshot Center removes the target host from the secondary LDEV path attribute.
Once the target host entry is removed from the secondary LDEV host ports,
the exported snapshot is no longer visible on the target host and the deport
operation is complete.
Parameter Description
Parameter Description
protocol://host-name:port-number/ConfigurationManager
Array User name The name of the user account that has access to the Hitachi
storage array.
Array Password The password for the user account that is used to access the
Hitachi storage array.
Array Storage Device ID ID of the storage array device that is already registered with
the Hitachi Configuration Manager.
■ Snapshot Manager for Data Center uses a snapshot group while creating
snapshots, so the maximum number of snapshots in the Snapshot Manager for
Data Center for an array is 8192 per pool.
■ The Thin Image Pool must be large enough to accommodate all snapshot needs.
groups. You must configure this plug-in on the NetBackup primary server to perform
these operations.
Snapshot Manager for Data Center uses the REST API supported by the IBM
Storwize family to communicate with the protected assets.
Table 9-37 Snapshot Manager for Data Center operations on the IBM
Storwize array
Discover assets Snapshot Manager for Data Center discovers all the volumes,
consistency groups, volume snapshots, and consistency
group snapshot present on the array. Snapshot Manager for
Data Center discovers only the snapshots created by
NetBackup.
Note: The snapshot volume is also considered a volume
asset, created while creating a snapshot. Snapshot Manager
for Data Center discovers the FlashCopy mappings present
on the array where the target volume of mapping is
considered a snapshot.
Storage array plug-ins for Snapshot Manager for Data Center 165
IBM Storwize SAN V7000 plug-in
Table 9-37 Snapshot Manager for Data Center operations on the IBM
Storwize array (continued)
Table 9-37 Snapshot Manager for Data Center operations on the IBM
Storwize array (continued)
Export snapshot Snapshot Manager for Data Center supports export snapshot
over the iSCSI and FC protocols. When a snapshot export
operation is initiated, the snapshot volume is attached to the
host on the array. Snapshot Manager for Data Center uses
the same process for consistency group snapshots. SAN
zoning must be done between the host and the array that is
required to be attached to the snapshot.
■ Copy Operator—can manage all FlashCopy®, Metro Mirror, and Global Mirror
relationships, Tivoli® Storage Manager and Tivoli Storage Manager for Space
Management integration, NDMP, asynchronous replication, and remote caching.
■ Monitor—can only list management information.
■ Privileged—can submit native Linux commands with Linux root privilege in
addition to all other user role-authorized functions.
■ Data Access—can clone files.
Users with Security Administrator, Administrator, and Privileged role assigned can
perform all the snapshot management operations in NetBackup.
The Snapshot Manager for Data Center plug-in for IBM FlashSystem contains the
functional logic that enables NetBackup to discover SAN volumes and consistency
groups on the array. It can also initiate snapshot to create, export, deport, and
delete operations for volumes and consistency groups. You must configure this
plug-in on the NetBackup primary server to discover the volumes and consistency
groups, and perform backup and restore operations.
Snapshot Manager for Data Center uses the REST API supported by the IBM
FlashSystem family to communicate with the IBM FlashSystem assets.
Table 9-39 Snapshot Manager for Data Center operations on the IBM
FlashSystem array
Discover assets Snapshot Manager for Data Center discovers all the volumes,
consistency groups, volume snapshots, and consistency
group snapshot present on the array. Snapshot Manager for
Data Center discovers only the snapshots created by
NetBackup.
Note: The snapshot volume is also considered as the volume
asset which while creating a snapshot. Snapshot Manager
for Data Center discovers the FlashCopy mappings present
on the array, where the target volume of mapping is
considered as a snapshot.
Storage array plug-ins for Snapshot Manager for Data Center 170
IBM FlashSystem plug-in
Table 9-39 Snapshot Manager for Data Center operations on the IBM
FlashSystem array (continued)
Table 9-39 Snapshot Manager for Data Center operations on the IBM
FlashSystem array (continued)
Export snapshot Snapshot Manager for Data Center supports export snapshot
over the iSCSI and FC protocols. When a snapshot export
operation is initiated, the snapshot volume gets attached to
the host on the array. Snapshot Manager for Data Center
uses the same process for consistency group snapshots.
SAN zoning must be done between the host and the array,
which is required to attach with the snapshot.
■ Service - Users can set the time and date on the system, delete dump files, add
and delete nodes, apply service, and shut down the system. Users can also
complete the same tasks as users in the monitor role.
■ Monitor - The operator role can only list management information.
■ Restricted administrator - Users can perform the same task as the
administrator-role user and can run most of the commands. However, they
cannot remove volumes, host mappings, hosts, or pools. Support personnel
can be assigned to this role to help resolve errors and solve problems.
Users with security administrator, and administrator roles assigned can perform all
the NetBackup Snapshot Manager for Data Center's management operations.
The Snapshot Manager for Data Center plug-in for IBM SVC contains the functional
logic that enables NetBackup to discover SAN volumes and consistency groups on
the array. It can also initiate snapshot to create, export, deport, and delete operations
for volumes and consistency groups. You must configure this plug-in on the
NetBackup primary server to discover the volumes and consistency groups, and
perform backup and restore operations.
Snapshot Manager for Data Center uses the REST API supported by the IBM SVC
family to communicate with the IBM SVC assets.
Table 9-41 Snapshot Manager for Data Center operations on the IBM SVC
array
Discover assets Snapshot Manager for Data Center discovers all the volumes,
consistency groups, volume snapshots, and consistency
group snapshot present on the array. Snapshot Manager for
Data Center discovers only the snapshots created by
NetBackup.
Note: The snapshot volume is also considered as the volume
asset while creating a snapshot. Snapshot Manager for Data
Center discovers the FlashCopy mappings present on the
array, where the target volume of mapping is considered as
a snapshot.
Storage array plug-ins for Snapshot Manager for Data Center 175
IBM SAN Volume Controller plug-in
Table 9-41 Snapshot Manager for Data Center operations on the IBM SVC
array (continued)
Table 9-41 Snapshot Manager for Data Center operations on the IBM SVC
array (continued)
Export snapshot Snapshot Manager for Data Center supports export snapshot
over the iSCSI and FC protocols. When a snapshot export
operation is initiated, the snapshot volume gets attached to
the host on the array. Snapshot Manager for Data Center
uses the same process for consistency group snapshots.
SAN zoning must be done between the host and the array,
which is required to attach with the snapshot.
■ Service - Users can set the time and date on the system, delete dump files, add
and delete nodes, apply service, and shut down the system. Users can also
complete the same tasks as users in the monitor role.
■ Monitor - The operator role can only list management information.
■ Restricted administrator - Users can perform the same task as of the
administrator-role user and can run most of the commands. However, they
cannot remove volumes, host mappings, hosts, or pools. Support personnel
can be assigned to this role to help resolve errors and solve problems.
Users with security administrator, and administrator roles assigned can perform all
the NetBackup Snapshot Manager for Data Center's management operations.
Snapshot Manager for Data Center supports all the InfiniBox storage arrays that
are compatible with InfiniSDK.
Table 9-43 Supported Snapshot Manager for Data Center operations on the
InfiniBox SAN array
Discover assets Snapshot Manager for Data Center discovers all the SAN
volumes (virtual disks) that are part of storage pools that are
created on the InfiniBox storage array. The plug-in sends a
request to the array to return a list of all the volumes that
have the type set to PRIMARY. Such volumes are considered
base volumes and appear as disk assets.
Create snapshot Snapshot Manager for Data Center takes a snapshot of all
the SAN volumes that are part of a storage pool. When a
snapshot is created, the Snapshot Manager for Data Center
plug-in uses InfiniSDK to send a create_snapshot method
request on the selected volume and passes a snapshot name
as an argument in that request.
Delete snapshot When a snapshot is deleted, the Snapshot Manager for Data
Center plug-in sends a delete_snapshot method request
on the parent volume that is associated with the snapshot
and passes the snapshot volume name as an argument in
that request. The InfiniBox array deletes the specified
snapshot associated with the parent volume.
Storage array plug-ins for Snapshot Manager for Data Center 181
InfiniBox SAN array
Table 9-43 Supported Snapshot Manager for Data Center operations on the
InfiniBox SAN array (continued)
■ The InfiniBox plug-in supports discovery and snapshot operations only on volume
snapshots that have the depth attribute value set to 1. Volume snapshots that
have a depth attribute value other than 1 are not supported.
■ All parent volume objects and snapshot objects on an InfiniBox array are unique.
While creating a snapshot of a volume, if an object with the same name already
exists on the array, the create operation fails. You must ensure that the snapshot
names are unique.
■ When you delete snapshots using Snapshot Manager for Data Center, only the
snapshots that are managed by Snapshot Manager for Data Center are available
for deletion. You cannot use Snapshot Manager for Data Center to delete
snapshots that are not created using Snapshot Manager for Data Center.
■ The snapshot export operation is supported using the following protocols:
■ Fibre Channel (FC)
■ Internet Small Computer Systems Interface (iSCSI)
Username The name of the user account that has access to the InfiniBox
storage array.
Password The password of the user account that is used to access the
InfiniBox storage array.
environment. You can configure Snapshot Manager for Data Center to discover
and then perform backup operations on NFS exports and SMB Shares.
Snapshot Manager for Data Center plug-in for InfiniBox has the functional logic that
enables NetBackup to discover the NFS exports and SMB Shares on the InfiniBox
system. Then initiates snapshot create, export, deport, and delete operations for
the exports.
You must configure this plug-in on the NetBackup primary server.
1. Snapshot Manager for Data Center uses the REST APIs to communicate with
the InfinBox assets.
2. Snapshot Manager for Data Center establishes a connection with InfiniBox to
discover the NFS exports, SMB Shares and its snapshots for backup.
Discover assets NetBackup Snapshot Manager for Data Center discovers all
the NFS export, SMB shares, file systems, and snapshots.
MASTER and SNAPSHOT are the two types of data sets for
file systems.
The file system path where the backup hosts are added as
clients with read-only permissions.
Restore snapshot Snapshot Manager for Data Center does not support restore
operation.
Note: Users with POOL_ADMIN, ADMIN, or INFINIDAT can perform all the
NetBackup Snapshot Manager for Data Center's snapshot management
operations.
Note: At present, this solution supports only the snapshots that are created for NAS
storage.
■ Lenovo DM Volumes: ONTAP serves data to clients and hosts from the logical
containers called FlexVol volumes.
■ Lenovo DM NFS or SMB volumes in the NAS environment.
■ Lenovo DM Storage Virtual Machines (SVM) allow NAS clients to access storage
using NFS.
■ SVMs contain data volumes and one or more LIFs through which they serve
data to the clients.
■ SVMs provide file-level data access using NFS and CIFS protocols for NAS
clients.
■ For NAS-based storage deployments, ensure that the Lenovo DM shares are
configured using an active junction path.
■ Ensure that the Lenovo DM user account to configure the plug-in have the
privileges to perform the following operations on the Lenovo DM array:
■ Create snapshot
■ Delete snapshot
■ Restore snapshot
■ Ensure that the Lenovo DM user account to configure the plug-in is configured
with http and ONTAPI access.
Storage array plug-ins for Snapshot Manager for Data Center 189
Lenovo DM 5000 series array
■ Ensure that the Lenovo DM user account to configure the plug-in has the
following roles assigned:
■ Default: read-only
■ LUN: all
■ Volume snapshot: all
■ vserver export-policy: all
■ Ensure that the export policy of the NAS share must not be the default. There
must be a policy which has the host configuration of either NFS or SMB or both.
To view the list of all supported versions of Lenovo DM, refer to the NetBackup
Snapshot Manager for Data Center section in the NetBackup Hardware and Cloud
Storage Compatibility List (HCL).
Specify the following details when you configure the Lenovo DM array:
Interface type Provide the API type with which all operations are to be
performed.
The following screen is displayed when you configure the plug-in using the
NetBackup administration console:
■ REST support starts from array version 9.6. But this support is partial. In ONTAP
9.10, full support required for SAN proliferations is provided.
■ While registering the plug-in, it selects the APIs based on the user input. In the
upgrade scenario NetBackup uses the REST APIs for Lenovo DM ONTAP array
version 9.10 or later and for version less than 9.10, it uses the ZAPI.
■ Lenovo DM NMSDK supports only the existing functionalities of current versions.
But it does not support any new functionalities from array version 9.8 onwards.
Storage array plug-ins for Snapshot Manager for Data Center 190
Lenovo DM 5000 series array
Note: This is an optional step. If you configure the Data LIF, the backup reads are
restricted via the dedicated LIF. If not configured, volume snapshots are accessed
via any available DATA LIF of the corresponding SVM.
Note: In the case of Lenovo DM, a LUN is part of a volume and the action performed
on a single LUN is performed on it's entire parent volume internally. Therefore, a
volume acts as a consistency group.
Discover assets NetBackup Snapshot Manager for Data Center discovers the
volume, LUNs that are created from storage volumes.
If no export rule match is found, then a new rule with the NFS
protocol, read-only with superuser access, is created in the
export policy and assigned to the export snapshot.
Example: NB<unique_21digit_number>-432464523
Storage array plug-ins for Snapshot Manager for Data Center 193
Lenovo DM 5000 series array
Delete snapshot When the delete snapshot operation is triggered for the
following:
For more information on the latest and most accurate methods to set
max_diffs/max_sessionsto, refer to the Lenovo DM documentation.
Discovery
In the Lenovo DM array, NetBackup discovers the volumes, and LUNs that are
created on the storage array. It also discovers snapshots of these assets.
■ NetBackup discovers all the NFS and SMB shares using volumes NAS path on
the Lenovo DM storage.
■ Discovers the Lenovo DM Storage Virtual Machines (SVMs) from which the
NFS and SMB shares are created to mount.
■ It will only discover volumes that are online.
■ The export operation fails if the volume is attached only to the Default export
policy on Lenovo DM. You must assign the NAS volume to a non-default export
policy.
Support
■ Minimum supported ONTAP version for ZAPI is 8.3
■ Minimum supported ONTAP version is for REST 9.10
■ Minimum supported ONTAP version for SnapDiff is 9.4 for Lenovo DM NAS
Volume snapshots till ONTAP 9.9.
NetBackup Description
Snapshot
Manager for
Data Center
operation
Discover assets ■ In a SAN environment, NetBackup Snapshot Manager for Data Center
for Data Center discovers the Volumes and LUNs that are created
from storage volumes, as well as replication relationships of Volumes.
Only LUNs whose status is online, read-write operations are enabled,
and the Snapshot auto delete parameter is set to false, are
discoverable.
[“state”:”online”,”vol_type”:”rw”,”
is_snapshot_auto_delete_enabled”: “false”]
Note: In a SAN environment, NetBackup can discover only the
snapshots that are created using Snapshot Manager for Data Center,
the volumes having “CMD” in their attributes, and the volumes without
host mappings discovered.
■ In a NAS environment, NetBackup Snapshot Manager for Data Center
discovers all the NFS shares and volumes with security style UNIX
and mixed mode on the NetApp storage. It also discovers SMB shares
with Windows security style. The shares must have an active
junction_path configured so that NetBackup Snapshot Manager
for Data Center can discover them.
■ In a NAS environment, NetBackup Snapshot Manager for Data Center
discovers all the Data Protection volumes with NFS shares, volumes
with security style UNIX as well as mixed mode, and SMB shares
with Windows security style.
■ In a NAS environment, NetBackup discovers FlexGroup volumes.
NetApp provides supports FlexGroup volumes as NAS shares.
FlexGroup volume is a scale-out NAS container that provides high
performance along with automatic load distribution and scalability.
Storage array plug-ins for Snapshot Manager for Data Center 198
NetApp storage array
NetBackup Description
Snapshot
Manager for
Data Center
operation
Create snapshot ■ In a SAN environment, NetBackup Snapshot Manager for Data Center
takes a snapshot of the NetApp volumes and LUNs.
When NetBackup Snapshot Manager for Data Center initiates a LUN
snapshot on the NetApp storage, it internally initiates a
redirect-on-write (ROW) snapshot of the entire volume to which the
LUN belongs. If the volume contains multiple LUNs, the snapshot
includes data from all the LUNs that reside on that volume.
When a volume Snapshot is initiated on the NetApp Storage, it
creates a redirect-on-write (ROW) snapshot of the entire volume and
returns the snapshot data of that volume.
A typical snapshot created by NetBackup Snapshot Manager for
Data Center has the following naming convention:
NB<unique_21digit_number>
■ In a NAS environment, NetBackup Snapshot Manager for Data Center
takes a snapshot of the NetApp NFS as well as SMB shares.
Delete snapshot / ■ In a SAN environment, when you delete a LUN snapshot, NetBackup
Snapshot Manager for Data Center internally deletes the snapshot
Delete replicated
of one or more volumes to which the LUN belongs.
snapshot
When you delete a volume snapshot, NetBackup Snapshot Manager
for Data Center for Data Center deletes the snapshot corresponding
to the volume.
■ In a NAS environment, NetBackup Snapshot Manager for Data Center
deletes the snapshot of the share.
Storage array plug-ins for Snapshot Manager for Data Center 199
NetApp storage array
NetBackup Description
Snapshot
Manager for
Data Center
operation
Restore snapshot ■ In a SAN environment, when you restore a LUN from a snapshot,
NetBackup Snapshot Manager for Data Center only restores the
particular LUN on which the restore is initiated. The LUN snapshot
is a ROW snapshot of the underlying volume, and that volume can
contain multiple additional LUNs. Even if the snapshot contains data
from multiple LUNs, the restore is performed only for the selected
LUN. The data on the other LUNs remains unchanged.
■ When you restore a volume from a volume snapshot, NetBackup
Snapshot Manager for Data Center restores the snapshot copy to
the read-write volume. Replacing the current working copy of the
volume that is all underlying LUNs of the volume with snapshot. This
changes the volume state to that of the snapshot copy.
■ In a NAS environment, NetBackup Snapshot Manager for Data Center
restores the volume using the specified snapshot.
Storage array plug-ins for Snapshot Manager for Data Center 200
NetApp storage array
NetBackup Description
Snapshot
Manager for
Data Center
operation
NetBackup Description
Snapshot
Manager for
Data Center
operation
Restore replica NetBackup Snapshot Manager for Data Center (Point-In-Time) PIT
snapshot restores for the replica snapshots are not supported for NAS and SAN
environment.
■ For the list of all the supported Data ONTAP versions, refer to the NetBackup
Snapshot Manager for Data Center section in the NetBackup Hardware and
Cloud Storage Compatibility List (HCL).
■ For the NAS environment, ensure that the NetApp shares are configured using
an active junction_path.
■ In NAS replication, the data-protection volume must include the active
junction_path configuration, whereas this requirement is not mandatory in a
SAN environment.
Roles and privileges on NetApp storage array for the ZAPI interface
To allow NetBackup Snapshot Manager for Data Center to perform snapshot
management operations, ensure that the NetApp user account used for plug-in
configuration has the below-mentioned roles and privileges assigned to the storage
array:
■ Ensure that the NetApp user account has the privileges to perform the following
operations on the NetApp array:
■ Create snapshot
■ Delete snapshot
■ Restore snapshot
■ Ensure that the NetApp user account is configured with http and ontapi access
methods.
Storage array plug-ins for Snapshot Manager for Data Center 203
NetApp storage array
■ Ensure that the NetApp user account has the following roles assigned:
■ Default: readonly
■ lun: all
■ volume snapshot: all
■ vserver export-policy: all
■ vserver cifs: all (required for SMB protocol only)
■ snapmirror: all (required privileges in role to perform replication operations)
Refer to NetApp documentation for instructions on how to create users and roles
and assign permissions.
/api/cluster Read-only
/api/cluster/peers Read/Write
/api/network/ip/interfaces Read-Only
/api/protocols/cifs/shares Read/Write
/api/protocols/nfs/export-policies Read/Write
/api/protocols/san/igroups Read-only
/api/protocols/san/lun-maps Read/Write
/api/snapmirror/relationships Read/Write
/api/storage/luns Read-only
/api/storage/volumes Read/Write
/api/svm/svms Read-only
Refer to NetApp documentation for instructions on how to create users and roles
and assign permissions.
Storage array plug-ins for Snapshot Manager for Data Center 204
NetApp storage array
Note: This is an optional step. If configured, the backup reads are restricted via the
dedicated LIF. If not configured, volume snapshots are accessed via any available
data LIF of the corresponding SVM.
Snapshot Replication
NetBackup Snapshot Manager for Data Center Replication can replicate snapshots
on a NetApp cluster mode array. Clustered Data ONTAP (cDOT) is used to replicate
snapshots between storage virtual machines (SVMs or vServers) and between
cDOT clusters.
Storage array plug-ins for Snapshot Manager for Data Center 205
NetApp storage array
Both NAS and SAN are supported for replication. The NetBackup Snapshot Manager
for Data Center supports NetApp synchronous as well as asynchronous replication.
For synchronous replication, Sync and StrictSync policies are supported. For
asynchronous replication, policies like DPDefault, MirrorAllSnapshots,
MirrorAndVault, MirrorLatest, Unified7year and XDPDefault are supported.
The supported policies are represented as ‘NetApp_SnapMirror’ and
‘NetApp_SnapVault’ replication types within NetBackup. Users can choose these
replication types as the replication destination in SLP to replicate the snapshots to
the desired replication destination.
The following table depicts the differentiation of various policies under
NetApp_SnapMirror and NetApp_SnapVault.
MirrorAllSnapshots
MirrorLatest
MirrorAndVault NetApp_SnapVault
XDPDefault
Unified7Years
StrictSync
[netapp] netapp_replication_job_timeout = 90
The value 90 represents the timeout duration in minutes. Note that the default
timeout for snapshot replication is 60 minutes.
The snapshot can be replicated in a cascaded configuration. Note that NetApp CVO
and Amazon FSx for NetApp ONTAP do not support cascaded relationships.
The snapshot can be replicated when you have multiple targets of the same or
different type configured on the array.
The snapshot can be replicated in a fanout configuration. You can have a maximum
of eight fan-out relationships from a single source volume.
Storage array plug-ins for Snapshot Manager for Data Center 207
NetApp storage array
The snapshot can be replicated once and then further replicated in a fan-out
configuration.
The snapshot replications can fan out first and later cascade further.
Storage array plug-ins for Snapshot Manager for Data Center 208
NetApp Cloud Volumes ONTAP (CVO)
■ If an old snapshot is selected during PIT rollback, all new snapshots created
after that snapshot are deleted automatically from the array.
■ Fan out of replication topology is not supported with synchronous replication.
■ You can have a maximum of eight fan out relationships from a single source
volume.
■ If you create any new replication relationship between source and destination
apart from the ones mentioned in the Policy Name, Policy Type, and Replication
Type table, then the new relationship is considered as NetApp_SnapMirror.
■ For SAN environment, if destination LUNs are on different SVM than source
LUNs, then the NetBackup client should have FC zoning with destination
SVM, in case of FC; iscsi session with destination SVM, in case of iscsi.
Note: It is recommended to keep the backup host and the CVO in the same region,
and preferably in the same VPC to reduce cloud networking costs during backup.
Discover assets NetBackup Snapshot Manager for Data Center discovers all
the NetApp E-Series volumes and the snapshots.
Storage array plug-ins for Snapshot Manager for Data Center 211
NetApp E-Series array
■ You can find the storage array WWN in the array details.
■ To get the array details, use the following API:
https://<array / proxy IP>:<port no>/devmgr/v2/storage-systems
Table 9-53 Snapshot Manager for Data Center operations on Nutanix Files
File Server
Discover assets Snapshot Manager for Data Center discovers all the shares
and their snapshots, along with some of their metadata.
Shares that have CFT_BACKUP capabilities are eligible for
snapshot-diff based incremental backups.
Note: Snapshot operations are not supported for nested
shares on the Nutanix Files File Server.
Storage array plug-ins for Snapshot Manager for Data Center 215
Nutanix Files array
Table 9-53 Snapshot Manager for Data Center operations on Nutanix Files
File Server (continued)
/mount_target_snapshot/:snapshot_uuid
Restore snapshot Snapshot Manager for Data Center does not support this
operation.
Table 9-53 Snapshot Manager for Data Center operations on Nutanix Files
File Server (continued)
Create snapshot diff Nutanix Files provides an API that allows you to create a diff
between two snapshots of a share. This process is called
Changed File Tracking (CFT). When a request to create a
snapshot diff is made, Snapshot Manager for Data Center
makes a REST API call to generate the CFT between two
snapshots, and then retrieves and stores the CFT data on
the Snapshot Manager for Data Center server. CFT-based
backups are supported only for top-level shares. Nested
shares are not supported.
Parameter Description
FQDN/ IP Address The Fully Qualified Domain Name (FQDN) of the Nutanix
Files File Server.
User name The user account that has the permissions to invoke the
Nutanix Files REST APIs on the File Server.
■ The same file server must not be configured on two separate NSM instances.
If such a configuration is done, then there are chances of image import and
cleanup failing.
Table 9-54 Snapshot Manager for Data Center operations on the IBM
Storwize array
Discover assets Snapshot Manager for Data Center discovers all the volumes,
protection groups, protection group snapshots, and volume
snapshots.
Table 9-54 Snapshot Manager for Data Center operations on the IBM
Storwize array (continued)
Export snapshot Snapshot Manager for Data Center can perform FC/iSCSI
based exports. When a snapshot export operation initiates,
a new clone volume is created from the snapshot, and
attached to the host. For protection group snapshots too, the
clone volumes are created and attached to the host. The
SAN zoning must be done between the host and array to be
attached to the snapshot.
Deport snapshot Snapshot Manager for Data Center deletes the export
mapping created between the host and the cloned volume(s)
created from the volume snapshot or the protection group
snapshot.
■ Do not delete a volume from the array or remove it from the protection group
after taking the backup operation. This might cause the restore to fail.
■ During the delete operation, if the array has safe mode enabled, the snapshot
is not removed completely from the array. NetBackup destroys the snapshot
but does not eradicate it.
Table 9-56 Snapshot Manager for Data Center operations on the Pure
Storage FlashBlade array
Discover assets Snapshot Manager for Data Center discovers all the Pure
Storage FlashBlade file system assets and their snapshots.
NetBackup calls the array's API to retrieve the assets
mentioned in the list.
Storage array plug-ins for Snapshot Manager for Data Center 222
Pure Storage FlashBlade plug-in configuration notes
Table 9-56 Snapshot Manager for Data Center operations on the Pure
Storage FlashBlade array (continued)
Delete snapshot To delete a snapshot set, NetBackup calls the SDK with the
required snapshot details.
Restore snapshot Snapshot Manager for Data Center restores snapshots using
the SDK methods with different restore paths. The latest
snapshot is required for PIT. You cannot perform a PIT
restore with old snapshots.
Export snapshot You can export snapshots using SMB and NFS-based
exports. When a snapshot export is initiated, a new rule is
added for the host as read-only. An export path is generated
using the VLAN interface available on the array, and this path
is shared with NetBackup for mounting.
■ For registration from NetBackup, an Active Directory user with an API token is
required, who can create, delete, and restore snapshots; and attach or detach
the file system with hosts.
■ You cannot create shares within the Pure Storage FlashBlade array, but you
can create file systems.
Password The password for the Pure Storage FlashBlade user account.
configure Snapshot Manager for Data Center to discover and then perform backup
operations on NFS exports and SMB shares.
Snapshot Manager for Data Center plug-in for PowerMax eNAS contains the
functional logic that enables NetBackup to discover the NFS exports and SMB
shares on the PowerMax eNAS system. Then it initiates the snapshot to create,
export, deport, and delete operations for the exports.
You must configure this plug-in on the NetBackup primary server.
■ Snapshot Manager for Data Center uses the XML APIs to communicate with
the PowerMax eNAS assets.
■ Snapshot Manager for Data Center establishes a connection with PowerMax
eNAS to discover the NFS exports, SMB shares, and its snapshots for backup.
Discover assets NetBackup Snapshot Manager for Data Center discovers all
the PowerMax Data movers, NFS exports, SMB shares, and
their file system snapshots.
NB<unique_21digit_number>
Restore snapshot NetBackup Snapshot Manager for Data Center does not
support PIT restore operations on the array. Instead, we can
perform the normal restore on the specified location.
Storage array plug-ins for Snapshot Manager for Data Center 225
PowerMax eNAS array
■ NFS: <server-ip>:/<snapshot_name>/
■ SMB: \\<server-ip>\<snapshot_name>\
■ You can enable the Unicode to change the limitations. In case of a snapshot
name, the maximum length must be 240 characters.
■ PowerMax eNAS plug-in does not support point-in-time (PIT) rollback restore
of shares using snapshots.
■ Following are the assets that the PowerMax eNAS array does not discover:
■ The shares and exports that are created from the snapshot.
■ The shares that don’t have the CIFS server linked.
Storage array plug-ins for Snapshot Manager for Data Center 227
Qumulo NAS array
Table 9-60 Snapshot Manager for Data Center operations on Qumulo plug-in
Snapshot Description
Manager for
Data Center
operation
Discover Snapshot Manager for Data Center discovers all the Qumulo file system
assets paths and their snapshots, along with some of their metadata. Single-depth
discovery is supported.
Create To create a snapshot, Snapshot Manager for Data Center initiates an SDK
snapshot method with the required information and snapshot name. The API returns
the details of the snapshot.
A typical snapshot created by Snapshot Manager for Data Center has the
following naming convention:
NB<unique_21digit_number>
Storage array plug-ins for Snapshot Manager for Data Center 228
Qumulo NAS array
Table 9-60 Snapshot Manager for Data Center operations on Qumulo plug-in
(continued)
Snapshot Description
Manager for
Data Center
operation
Delete To delete a snapshot, Snapshot Manager for Data Center initiates an SDK
snapshot method call with the required snapshot details. Then Snapshot Manager
for Data Center confirms that the snapshot has been deleted successfully
on the cluster.
Restore Snapshot Manager for Data Center does not support this operation.
snapshot
Export When NetBackup exports a snapshot, a new NFS export is created over
snapshot the same file system path on which the backup host is added as a client
with read-only permission.
Deport When a snapshot deport operation is initiated, Snapshot Manager for Data
snapshot Center deletes the NFS export created over the snapshot path at the time
of the export operation.
Create Snapshot Manager for Data Center does not support this operation.
snapshot diff
Parameter Description
Parameter Description
FQDN/ IP address You can add any management IP address or the Fully
Qualified Domain Name (FQDN) of the node. You can also
use Qumulo DNS round-robin FQDN here.
Permissions
CLUSTER_READ
FILE_FULL_ACCESS
NFS_EXPORT_READ
NFS_EXPORT_WRITE
Storage array plug-ins for Snapshot Manager for Data Center 230
Qumulo NAS array
Permissions
SMB_SHARE_READ
SMB_SHARE_WRITE
SNAPSHOT_READ
SNAPSHOT_WRITE
Note: If you attempt to join the domain and get an error message similar
to this: "Sorry, the NetBIOS name (QUMULO) is incorrect". Your domain’s
NetBIOS is different from your domain name.
■ For additional details, see the Using Active Directory for POSIX attributes
article.
and delete operations for those shares. You must configure this plug-in on
NetBackup primary server.
Snapshot Manager for Data Centeruses the pyVmomi SDK and its extension for
vSAN managed objects provided by VMware to communicate with the VMware
vSAN File Services to discover the vSAN clusters, file shares, and the snapshots
to back up.
Table 9-61 Snapshot Manager for Data Center operations on the VMware
vSAN cluster
Discover assets Snapshot Manager for Data Center discovers all VMware
vSAN clusters, NFS, and SMB file shares and the snapshots
with its metadata.
Delete snapshot To delete a file share snapshot, Snapshot Manager for Data
Center initiates a DELETE Rest API call with the required
snapshot details.
Restore snapshot Snapshot Manager for Data Center does not support file
share-level PIT restore operations on the vSAN cluster.
Instead, you can perform a normal restore at a specified
location.
Storage array plug-ins for Snapshot Manager for Data Center 233
VMware vSAN File Services plug-in
Table 9-61 Snapshot Manager for Data Center operations on the VMware
vSAN cluster (continued)
■ NFS: <file-server-primary-host>:/vsanfs/<share_name>
/.vdfs/snapshot/<snapshot_name>
■ SMB: \\<file-server-primary-host>\\vsanfs\\<share_name>
\\.vdfs\\snapshot\\<snapshot_name>
vCenter Host The vCenter Server IP address, in either IPV4 or the Fully
Qualified Domain Name (FQDN).
vCenter Username The vCenter user account that has the permissions to invoke
the vSAN REST APIs to perform all snapshot operations on
the vCenter server.
■ About configuring storage lifecycle policies for snapshots and snapshot replication
See Figure 10-1 on page 237.. It represents an SLP for a replication scenario. In the
example, the following operations are used:
■ A Snapshot operation creates a snapshot.
■ A Replication operation replicates the snapshot to another volume.
■ A Backup from Snapshot operation creates a tar-formatted backup from the
snapshot.
■ A Duplication operation copies the backup to tape.
Table 10-1 describes the four types of operations that are required in this example
replication scenario.
1 Snapshot Operation 1 creates a snapshot in the primary storage. The snapshot serves as
the source for the other operations in the SLP.
2 Replication Operation 2 replicates the snapshot that the first operation created.
4 Duplication Operation 4 makes a duplicate copy from the tar-formatted backup copy. In this
example, the copy is duplicated to tape media.
(Child to
■ The operation must be a Duplication operation. This operation creates a
Operation 3)
backup copy of the tar-formatted image.
■ The storage must be a backup storage unit.
After the SLP is configured for different operations, the NetBackup administrator
configures a backup policy that points to the snapshot SLP.
The SLP Parameters host properties in the NetBackup Web UI allow administrators
to customize how SLPs are maintained and how SLP jobs run.
This Snapshot operation creates a snapshot of the primary data and serves
as the source for other operations in the SLP. For example:
■ A Replication operation.
■ A Backup form Snapshot operation.
■ An Index form Snapshot operation.
Characteristic Description
Storage unit The snapshot operation does not write data to a NetBackup storage unit.
selection However, you need to select a storage unit to specify the media server
to use to launch the snapshot job. Use these storage units for snapshot
operation:
■ Snapshot label
■ Media Server Deduplication Pool storage unit
■ AdvancedDisk storage unit
Considerations for the ‘Snapshot’ label as the storage unit:
Note: To use the Snapshot label all the NetBackup hosts must be version
10.1 or later.
Child of A snapshot operation cannot serve as the child of any other operation.
Therefore, do not click on any other operation in the SLP when adding
a snapshot operation.
Source for A snapshot operation can be the source for the following operations:
Job type A snapshot operation generates a snapshot job in the Activity Monitor.
Configuring storage lifecycle policies for snapshots and snapshot replication 241
Operation types in a storage lifecycle policy
Characteristic Description
Window Snapshot operations do not offer the option to create an SLP window.
Figure 10-3 SLP that contains a snapshot operation and two replication
operations
Configuring storage lifecycle policies for snapshots and snapshot replication 243
Operation types in a storage lifecycle policy
Characteristic Description
■ Auto
■ <Vendor>_<ReplicationType>
Characteristic Description
Source for A replication operation can be the source for the following operations:
■ Replication
■ Backup from snapshot
■ Index from snapshot
Live browse restore NetBackup Backup, You can navigate the During a live browse
Archive, and Restore directory structure to restore, NetBackup
interface locate and select the automatically mounts
files for restoration. the snapshot so that
you can see what files
it contains. Mounting
and unmounting the
snapshot can be
time-consuming.
The Backup from snapshot operation also creates an image catalog file. An Index
from snapshot may not be required if a Backup from snapshot occurs frequently
enough for the restore needs in your environment. For example, if the Backup from
snapshot runs once per week but file restores are required daily, consider using
the Index from snapshot feature.
Snapshot restore requires that the snapshot is mounted, regardless of whether an
index from snapshot is performed or not.
Configuring storage lifecycle policies for snapshots and snapshot replication 245
Operation types in a storage lifecycle policy
Characteristic Description
Storage unit The Index from snapshot operation does not write data to a storage unit. However, a storage unit
selection selection is needed to select the media server that is to be used to access the snapshot. As a best
practice, use the storage unit from the snapshot or replication operation that is the source for this
operation.
Child of When an Index from snapshot operation appears in an SLP, it must be the child of a snapshot or
replication operation.
Therefore, select either a snapshot or a replication operation in the SLP when adding an Index
from snapshot operation.
Source for While an Index from snapshot operation cannot be the source for any operation, a replication
operation can follow it.
Hierarchy notes The index from snapshot operation can consume system resources and requires that each snapshot
is mounted to create the image catalog file.
See “Determining where and when the Index from snapshot operation occurs” on page 245.
Job type An Index from snapshot operation generates an Index form Snapshot job in the Activity Monitor.
Window An SLP window can be created for an Index from snapshot operation.
Consider the following items before using the Index from snapshot operation:
■ Standard, NAS-Data-Protection, and VMware backup policy types support the
use of storage lifecycle policies that contain the Index from snapshot operation.
(toward the top of the operations list), may consume time when the restore
capabilities are not needed. To place the operation toward the end of the
operations list may cause a delay to restore operations until earlier snapshots
or replications are complete.
■ Use the Index from snapshot operation in an SLP only once. You can perform
a restore from any snapshot after one image .f file is created.
■ Any operations list that includes a backup from snapshot operation, does
not need an Index from snapshot operation. The backup from snapshot
operation creates an image .f file. The only exception may be if the index
is needed for restores before the backup from snapshot operation occurs.
Characteristic Description
Storage unit The selection must be a backup storage unit or a backup storage unit
selection group.
Source for A Backup from snapshot operation can be the source for a Duplication
operation.
Hierarchy notes An SLP may contain more than one backup from snapshot operation. If
the first backup from snapshot operation fails with an unrecoverable error,
NetBackup does not attempt the second one. For a NAS-Data-Protection
policy, the SLP supports only one backup from snapshot operation.
Configuring storage lifecycle policies for snapshots and snapshot replication 247
Operation types in a storage lifecycle policy
Characteristic Description
Job type A Backup from snapshot operation generates a Backup job in the Activity
Monitor.
The Backup job that results from the Backup from snapshot operation is
under the control of the SLP Manager. If an SLP window is configured,
the Backup job runs during the configured SLP window. If no SLP window
is configured, the Backup job can run at any time; possibly outside of the
backup window as configured in the backup policy. You may experience
a slight degradation in performance on the client or the client storage
device while NetBackup accesses the snapshot.
Window An SLP window can be created for a Backup from snapshot operation.
Characteristic Description
Storage unit The selection must be a backup storage unit or a backup storage unit
selection group.
Characteristic Description
■ Backup operation
■ Backup from snapshot operation
■ A Duplication operation
Hierarchy notes When a Duplication operation appears in an SLP, it cannot be the first
operation.
Figure 10-6 SLP that contains one Backup operation and two Duplication
operations
Note: You can set the Retention types for storage lifecycle policy operations from
the NetBackup web UI.
Configuring storage lifecycle policies for snapshots and snapshot replication 249
Retention types for storage lifecycle policy operations
Target retention Invalid Invalid Valid if the first Invalid Valid if the first
operation in the operation in the SLP
SLP is an Import is an Import.
and if the storage
is of the backup
type.
Note: Retention is not associated with the Index form Snapshot operation because
the operation does not create any copy.
Note: Although synthetic backups do support the use of storage lifecycle policies,
SLPs cannot be used for the multiple-copy synthetic backups method.
If a policy is configured to use an SLP for the backup, the retention that is indicated
in the SLP is the value that is used. The Retention attribute in the schedule is not
used.
Expire after copy retention type cannot be used for the snapshot operation when
a sync replication stage is added in the SLP.
An image copy with an Expire after copy retention expires as soon as all of its direct
child copies have been successfully created. Any mirrored children must also be
eligible for expiration.
■ Agentless logs
service logs are now structured and routed to the Fluentd data collector from where
they are sent to the configured output plug-ins. The flexsnap-fluentd container log
is the output plug-in that is configured by default.
Using Fluentd-based logging provides several benefits including the following:
■ A persistent structured repository that stores the logs of all the NetBackup
Snapshot Manager services
■ A single stream of all NetBackup Snapshot Manager logs (vs disparate individual
log files) makes it easy to trail and monitor specific logs
■ Metadata associated with the logs allow for a federated search that speeds up
troubleshooting
■ Ability to integrate and push NetBackup Snapshot Manager logs to a third-party
tool for analytics and automation
[logging]
log_rotate_age = 7
log_rotate_size = 20000
```
■ log_rotate_age: Specifies the generations to keep rotated log files (the total
number of files that can be accumulated before rotation), the default value
is 30.
■ log_rotate_size: Specifies the log file size (in bytes) after which a single log
file will be rotated, the default value is 100000000 bytes.
plug-in definition from this configuration file to determine where to send the
NetBackup Snapshot Manager log messages.
The following output plug-in definition is added to the configuration file by default:
STDOUT: This is used to send the NetBackup Snapshot Manager log messages to
/cloudpoint/logs/flexsnap.log.
Note that the changes take effect immediately and apply only to the newer log
messages that get generated after the change. The file changes do not apply to
the older logs that were generated before the configuration file was updated.
NetBackup Snapshot Manager logging 256
Viewing NetBackup Snapshot Manager logs
-n 50
-d <days> | --days <days> Displays the logs for the last "DAYS" number
of days.
-d 7
NetBackup Snapshot Manager logging 257
Viewing NetBackup Snapshot Manager logs
You can view the NetBackup Snapshot Manager logs using any of the following
commands on the NetBackup Snapshot Manager host:
■ To obtain all the NetBackup Snapshot Manager service logs, run the following
command:
# sudo docker exec flexsnap-coordinator flexsnap-log
■ To obtain the last "N" number of log messages, run the following command:
# sudo docker exec flexsnap-coordinator flexsnap-log -n <N>
■ You can also combine these options to achieve a specific output. For example,
to obtain the last 10 log messages for the flexsnap-agent service, run the
following command:
# sudo docker exec flexsnap-coordinator flexsnap-log -n 10
flexsnap-agent
The command output displays messages similar to the following:
The most recent NetBackup Snapshot Manager logs are also available in the
flexsnap-fluentd container logs. You can use standard Docker commands to
obtain the logs.
NetBackup Snapshot Manager logging 258
Fluentd-based logging requirements and considerations
flexsnap-agent: {"container_name":"flexsnap-agent","source":"stdout","log":
"Mar 04 09:10:20 f5d1ae1c4808 flexsnap-agent-offhost[1] MainThread agent:
INFO - Not generating certificate. Join token not passed for role agent"}
flexsnap-agent: {"container_name":"flexsnap-agent","source":"stdout","log":
"Mar 04 09:10:20 f5d1ae1c4808 flexsnap-agent-offhost[1] MainThread
flexsnap.ca: INFO - Loading /opt/VRTScloudpoint/keys/agent.6c5c9.cert.pem
/opt/VRTScloudpoint/keys/cacert.pem"}
flexsnap-agent: {"container_name":"flexsnap-agent","source":"stdout","log":
"Mar 04 09:10:20 f5d1ae1c4808 flexsnap-agent-offhost[1] MainThread
flexsnap.connectors.rabbitmq: INFO - Starting service"}
To view the flexsnap-fluentd container logs in real time, run the following command:
# sudo docker logs flexsnap-fluentd -f | grep <flexsnap-service-name>
Note: This is applicable only if the NetBackup Snapshot Manager plug-in for
MongoDB is enabled.
■ An alternative approach is to use the STDOUT plug-in for such requirements. The
logs appear as the logs of the flexsnap-fluentd container and can be obtained
using Docker commands.
NetBackup Snapshot Manager logging 259
NetBackup Snapshot Manager logs
Log Description
■ bpbkar, bpcd, bpclntcmd, nbcert, vnetd, vxms and all other services logs
can be found inside netbackup directory
To increase logging verbosity, bp.conf and nblog.conf files can be updated on
NetBackup Snapshot Manager at /cloudpoint/openv/netbackup. See NetBackup
Logging Reference Guide
Changes to the bp.conf and nblog.conf files come to effect when the next
backup from snapshot or restore job runs.
Log retention
The default configuration for datamover logs is as follows:
■ Log retention maximum period is 30 days. Logs older than 30 days are deleted.
■ The default configuration for high and low water marks for datamover logs is
70% and 30% of the size of "/cloudpoint" mount point. For example, if the usable
size of the /cloudpoint folder is 30 GB, then the high water mark is 21 GB
NetBackup Snapshot Manager logging 260
NetBackup Snapshot Manager logs
(70%) and low water mark is 9GB (30%). In case, the logs directory
(/cloudpoint/openv/dm/) size reaches to high water mark, older logs for which
the datamover containers are cleaned up and no longer running are considered
for deletion. The logs are deleted for such datamover containers until low water
mark is reached or no logs are remaining for the datamover containers cleaned
up or no longer running.
Modifying the default configuration:
You can modify the default configuration for log retention by adding such a section
in the flexsnap.conf on the primary NetBackup Snapshot Manager. Open the
flexsnap.conf file from the path /cloudpoint/flexsnap.conf and add the
following section:
[datamover]
high_water_mark = 50
low_water_mark = 20
log_retention_in_days = 60
Agentless logs
Logs for agentless connection to cloud instance(s) are present on the cloud instance
at following locations based on the platform:
■ Linux: /tmp/ directory
■ Windows: C:\ProgramData\Veritas\CloudPoint\logs\
Chapter 12
Troubleshooting
This chapter includes the following topics:
■ 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.
■ Run the following command on the primary server to get the NetBackup
UUID:
/usr/openv/netbackup/bin/admincmd/nbhostmgmt -list -host
<primary server host name> | grep "Host ID"
Workaround:
Run the following #podman CLI(s) command:
{"Status":"healthy","FailingStreak":0,"Log":[{"Start":"2022-02-14T07:32:13.051150432Z","End":"2022-02-14T07:32:13.444636429Z","ExitCode":0,"Output":""}]}
{"Status":"healthy","FailingStreak":0,"Log":[{"Start":"2022-02-14T07:32:46.537804403Z","End":"2022-02-14T07:32:47.293695744Z","ExitCode":0,"Output":""}]}
[ec2-user@ip-172-31-23-60 log]$
from backup, indexing (VxMS based), and so on. Hence, if certificate generation
fails, these jobs cannot be performed. Hence NetBackup Snapshot Manager
for Data Center on cloud VMs cannot connect to NetBackup on lab VMs, hence
the registration will fail, and hence NetBackup Snapshot Manager for Data
Center cannot be added to NetBackup.
Workaround:
To add NetBackup Snapshot Manager for Data Center in such a scenario
requires to skip certificate generation on NetBackup Snapshot Manager for Data
Center by adding the following entry in the /cloudpoint/flexsnap.conf file:
[client_registration] skip_certificate_generation = yes
{
"CPServer1": [
{
"Plugin_ID": "test",
"Plugin_Type": "aws",
"Config_ID": "aws.8dda1bf5-5ead-4d05-912a-71bdc13f55c4",
"Plugin_Category": "Cloud",
"Disabled": false
}
]
},
{
"CPServer2": [
{
"Plugin_ID": "gcp.2080179d-c149-498a-bf1f-4c9d9a76d4dd",
"Plugin_Type": "gcp",
"Config_ID": "gcp.2080179d-c149-498a-bf1f-4c9d9a76d4dd",
"Plugin_Category": "Cloud",
"Disabled": false
},
Troubleshooting 267
Troubleshooting NetBackup Snapshot Manager for Data Center
{
"Plugin_ID": "gcp.2080179d-c149-498a-bf1f-4c9d9a76d4dd",
"Plugin_Type": "gcp",
"Config_ID": "gcp.2080179d-c149-498a-bf1f-4c9d9a76d4dd",
"Plugin_Category": "Cloud",
"Disabled": false
}
]
}
{
"CPServer1": [
{
"Plugin_ID": "config10",
"Plugin_Type": "azure",
"Config_ID": "azure.327ec7fc-7a2d-4e94-90a4-02769a2ba521",
"Plugin_Category": "Cloud",
"Disabled": false
}
]
},
{
"CPServer2": [
{
"Plugin_ID": "azure.327ec7fc-7a2d-4e94-90a4-02769a2ba521",
"Plugin_Type": "azure",
Troubleshooting 268
Backup from snapshot job fails with time out error
"Config_ID": "azure.327ec7fc-7a2d-4e94-90a4-02769a2ba521",
"Plugin_Category": "Cloud",
"Disabled": false
},
{
"cpserver101.yogesh.joshi2-dns-zone": [
{
"Plugin_ID": "azure.327ec7fc-7a2d-4e94-90a4-02769a2ba521",
"Plugin_Type": "azure",
"Config_ID": "azure.327ec7fc-7a2d-4e94-90a4-02769a2ba521",
"Plugin_Category": "Cloud",
"Disabled": false
},
{
"Plugin_ID": "AZURE_PLUGIN",
"Plugin_Type": "azure",
"Config_ID": "azure.4400a00a-8d2b-4985-854a-74f48cd4567e",
"Plugin_Category": "Cloud",
"Disabled": false
}
]
}
]
}
[capability_limit]
max_backup_jobs = <num>
Where, <num> is the maximum number of backup jobs that can run at a time.
In the case of multiple backups from snapshot jobs running in parallel, if any service
fails due to non-availability of resources, then reduce the number of parallel backups
from snapshot jobs that can be performed on the provided node type.
Error log:
To avoid this failure, update the volume snapshot auto delete trigger to “volume”
from “snap_reserve”.
2. volume snapshot autodelete modify -vserver <SvmName> -volume
<VolumeName> -trigger volume