NetBackup™ Snapshot Manager Install and Upgrade Guide

Last Published:
Product(s): NetBackup (10.2)
  1. Introduction
    1.  
      About the deployment approach
    2.  
      Deciding where to run NetBackup Snapshot Manager
    3.  
      About deploying NetBackup Snapshot Manager in the cloud
  2. Section I. NetBackup Snapshot Manager installation and configuration
    1. Preparing for NetBackup Snapshot Manager installation
      1.  
        Meeting system requirements
      2.  
        NetBackup Snapshot Manager host sizing recommendations
      3.  
        NetBackup Snapshot Manager extension sizing recommendations
      4.  
        Creating an instance or preparing the host to install NetBackup Snapshot Manager
      5.  
        Installing container platform (Docker, Podman)
      6.  
        Creating and mounting a volume to store NetBackup Snapshot Manager data
      7.  
        Verifying that specific ports are open on the instance or physical host
      8.  
        Preparing NetBackup Snapshot Manager for backup from snapshot jobs
    2. Deploying NetBackup Snapshot Manager using container images
      1.  
        Before you begin installing NetBackup Snapshot Manager
      2.  
        Installing NetBackup Snapshot Manager in the Docker/Podman environment
      3.  
        Verifying that NetBackup Snapshot Manager is installed successfully
      4.  
        Restarting NetBackup Snapshot Manager
    3. Deploying NetBackup Snapshot Manager extensions
      1.  
        Before you begin installing NetBackup Snapshot Manager extensions
      2.  
        Downloading the NetBackup Snapshot Manager extension
      3. Installing the NetBackup Snapshot Manager extension on a VM
        1.  
          Prerequisites to install the extension on VM
        2.  
          Installing the extension on a VM
      4. Installing the NetBackup Snapshot Manager extension on a managed Kubernetes cluster (AKS) in Azure
        1.  
          Prerequisites to install the extension on a managed Kubernetes cluster in Azure
        2.  
          Installing the extension on Azure (AKS)
      5. Installing the NetBackup Snapshot Manager extension on a managed Kubernetes cluster (EKS) in AWS
        1.  
          Prerequisites to install the extension on a managed Kubernetes cluster in AWS
        2. Installing the extension on AWS (EKS)
          1.  
            Install extension using the extension script
      6. Installing the NetBackup Snapshot Manager extension on a managed Kubernetes cluster (GKE) in GCP
        1.  
          Prerequisites to install the extension on a managed Kubernetes cluster in GCP
        2.  
          Installing the extension on GCP (GKE)
      7.  
        Install extension using the Kustomize and CR YAMLs
      8.  
        Managing the extensions
    4. NetBackup Snapshot Manager cloud providers
      1.  
        Why to configure the NetBackup Snapshot Manager cloud providers?
      2. AWS plug-in configuration notes
        1.  
          Prerequisites for configuring the AWS plug-in
        2.  
          Configuring AWS permissions for NetBackup Snapshot Manager
        3.  
          AWS permissions required by NetBackup Snapshot Manager
        4.  
          Before you create a cross account configuration
      3. Google Cloud Platform plug-in configuration notes
        1.  
          Google Cloud Platform permissions required by NetBackup Snapshot Manager
        2.  
          Configuring a GCP service account for NetBackup Snapshot Manager
        3.  
          Preparing the GCP service account for plug-in configuration
        4.  
          GCP cross-project restore configuration
      4. Microsoft Azure plug-in configuration notes
        1.  
          Configuring permissions on Microsoft Azure
        2.  
          About Azure snapshots
      5. Microsoft Azure Stack Hub plug-in configuration notes
        1.  
          Configuring permissions on Microsoft Azure Stack Hub
        2.  
          Configuring staging location for Azure Stack Hub VMs to restore from backup
    5. Configuration for protecting assets on cloud hosts/VM
      1.  
        Deciding which feature (on-host agent or agentless) of NetBackup Snapshot Manager is to be used for protecting the assets
      2. Protecting assets with NetBackup Snapshot Manager's on-host agent feature
        1. Installing and configuring NetBackup Snapshot Manager agent
          1.  
            Downloading and installing the NetBackup Snapshot Manager agent
          2. Linux-based agent
            1.  
              Preparing to install the Linux-based agent
            2.  
              Registering the Linux-based agent
          3. Windows-based agent
            1.  
              Preparing to install the Windows-based agent
            2.  
              Registering the Windows-based agent
        2. Configuring the NetBackup Snapshot Manager application plug-in
          1.  
            Configuring an application plug-in
          2. Microsoft SQL plug-in
            1.  
              Microsoft SQL plug-in configuration requirements
            2.  
              Restore requirements and limitations for Microsoft SQL Server
            3.  
              Steps required before restoring SQL AG databases
            4.  
              Additional steps required after restoring SQL AG databases
            5. Additional steps required after a SQL Server instance snapshot restore
              1.  
                Steps required after a SQL Server host-level restore
              2.  
                Steps required after a SQL Server instance disk-level snapshot restore to new location
          3. Oracle plug-in
            1. Oracle plug-in configuration requirements
              1.  
                Optimizing your Oracle database data and metadata files
            2.  
              Restore requirements and limitations for Oracle
            3.  
              Additional steps required after an Oracle snapshot restore
      3. Protecting assets with NetBackup Snapshot Manager's agentless feature
        1. Prerequisites for the agentless configuration
          1.  
            Configuring SMB for Windows (Optional)
          2.  
            Configuring WMI security for Windows (optional)
        2.  
          Configuring the agentless feature
        3.  
          Configuring the agentless feature after upgrading NetBackup Snapshot Manager
    6. NetBackup Snapshot Manager assets protection
      1. NetBackup protection plan
        1.  
          Creating a NetBackup protection plan for cloud assets
        2.  
          Subscribing cloud assets to a NetBackup protection plan
      2.  
        Configuring VSS to store shadow copies on the originating drive
      3.  
        Additional steps required after restoring an AWS RDS database instance
    7. Volume Encryption in NetBackup Snapshot Manager
      1.  
        About volume encryption support in NetBackup Snapshot Manager
      2.  
        Volume encryption for Azure
      3.  
        Volume encryption for GCP
      4.  
        Volume encryption for AWS
    8. NetBackup Snapshot Manager security
      1.  
        Configuring security for Azure Stack
      2.  
        Configuring the cloud connector for Azure Stack
      3.  
        CA configuration for Azure Stack
      4.  
        Securing the connection to NetBackup Snapshot Manager
  3. Section II. NetBackup Snapshot Manager maintenance
    1. NetBackup Snapshot Manager logging
      1.  
        About NetBackup Snapshot Manager logging mechanism
      2. How Fluentd-based NetBackup Snapshot Manager logging works
        1.  
          About the NetBackup Snapshot Manager fluentd configuration file
        2.  
          Modifying the fluentd configuration file
      3.  
        NetBackup Snapshot Manager logs
      4.  
        Agentless logs
      5.  
        Troubleshooting NetBackup Snapshot Manager logging
    2. Upgrading NetBackup Snapshot Manager
      1.  
        About NetBackup Snapshot Manager upgrades
      2.  
        Supported upgrade path
      3.  
        Upgrade scenarios
      4.  
        Preparing to upgrade NetBackup Snapshot Manager
      5.  
        Upgrading NetBackup Snapshot Manager
      6.  
        Upgrading NetBackup Snapshot Manager using patch or hotfix
      7. Migrating and upgrading NetBackup Snapshot Manager
        1.  
          Before you begin migrating NetBackup Snapshot Manager
        2.  
          Migrate and upgrade NetBackup Snapshot Manager on RHEL 8.6 or 8.4
      8.  
        GCP configuration for migration from zone to region
      9. Post-upgrade tasks
        1.  
          Upgrading NetBackup Snapshot Manager extensions
      10.  
        Post-migration tasks
    3. Uninstalling NetBackup Snapshot Manager
      1.  
        Preparing to uninstall NetBackup Snapshot Manager
      2.  
        Backing up NetBackup Snapshot Manager
      3.  
        Unconfiguring NetBackup Snapshot Manager plug-ins
      4.  
        Unconfiguring NetBackup Snapshot Manager agents
      5.  
        Removing the NetBackup Snapshot Manager agents
      6.  
        Removing NetBackup Snapshot Manager from a standalone Docker host environment
      7.  
        Removing NetBackup Snapshot Manager extensions - VM-based or managed Kubernetes cluster-based
      8.  
        Restoring NetBackup Snapshot Manager
    4. Troubleshooting NetBackup Snapshot Manager
      1.  
        Troubleshooting NetBackup Snapshot Manager
      2.  
        SQL snapshot or restore and granular restore operations fail if the Windows instance loses connectivity with the NetBackup Snapshot Manager host
      3.  
        Disk-level snapshot restore fails if the original disk is detached from the instance
      4.  
        Discovery is not working even after assigning system managed identity to the control node pool
      5.  
        Performance issue with GCP backup from snapshot
      6.  
        Post migration on host agents fail with an error message
      7.  
        File restore job fails with an error message
      8.  
        Acknowledgment not received for datamover
      9.  
        Upgrade of extension on AWS (EKS) fails when upgrading through script
      10.  
        Backup from snapshot job fails with timeout error

Post-upgrade tasks

You may need to perform the following tasks after a successful upgrade of the NetBackup Snapshot Manager server.

Post-upgrade tasks

  1. Upgrade the NetBackup Snapshot Manager agents on the Linux and Windows application hosts.

    Note:

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

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

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

      Navigate to Cloud > NetBackup Snapshot Managers > Actions > Add agent.

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

      Run the following command on the Linux host:

      # sudo systemctl stop flexsnap-core.service

    • Upgrade the agent on the Linux host.

      Run the following command on the Linux host:

      # sudo rpm -Uvh --force flexsnap_agent_rpm_name

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

    • Reload the daemon, if prompted.

      Run the following command on the Linux host:

      # sudo systemctl daemon-reload

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

    Note the following:

    When upgrading from CloudPoint agent to Flexsnap agent, uninstall CloudPoint agent first and then install the Flexsnap agent using the following recommended uninstallation and installation commands:

    • Uninstallation: sudo yum -y remove cloudpoint_agent_rpm_name

    • Installation: sudo yum -y install flexnsap_agent_rpm_name

    • Connect to the Linux host and re-register the agent using the following command:

      sudo flexsnap-agent --ip <snapshotmanager_host_FQDN_or_IP> --token <authtoken>

    • Run discovery task.

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

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

      Navigate to Cloud > NetBackup Snapshot Managers > Actions > Add agent.

    • Stop the Veritas NetBackup Snapshot Manager Agent service that is running on the host.

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

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

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

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

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

    See Downloading and installing the NetBackup Snapshot Manager agent.

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

    Perform one of the following actions:

    • From the NetBackup Web UI, edit the NetBackup Snapshot Manager server information.

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

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

      • In the Edit NetBackup Snapshot Manager server dialog, specify all the requested details.

      • Click Validate to validate the NetBackup Snapshot Manager server certificate.

      • In the Token field enter the Standard Host Token.

      • Click Save to update the NetBackup Snapshot Manager server configuration.

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

      ./tpconfig -update -snapshot_manager <snapshot_manager_name> -snapshot_manager_user_id <user_ID> -manage_workload <manage_workload> [-requiredport <IP_port_number>] [-security_token <token_value>]

      Note:

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

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

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

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

  3. By default, the create snapshot operation in NetBackup Snapshot Manager version 10.2 would create recovery points instead of snapshots. Hence to use Azure recovery points for the snapshots to be application consistent, ensure that the following additional permissions are configured to enable Azure restore points:
    actions": [
     "Microsoft.Compute/restorePointCollections/read",
    	"Microsoft.Compute/restorePointCollections/write",
    	"Microsoft.Compute/restorePointCollections/delete",
    	"Microsoft.Compute/restorePointCollections/restorePoints/read",
    	"Microsoft.Compute/restorePointCollections/restorePoints/write",
    	"Microsoft.Compute/restorePointCollections/restorePoints/delete",
    	"Microsoft.Compute/restorePointCollections/restorePoints/
      retrieveSasUris/action",
    	"Microsoft.Compute/restorePointCollections/restorePoints/
      diskRestorePoints/read",
    	"Microsoft.Compute/restorePointCollections/restorePoints/
      diskRestorePoints/beginGetAccess/action",
    	"Microsoft.Compute/restorePointCollections/restorePoints/
      diskRestorePoints/endGetAccess/action"
                ],"
  4. After upgrading NetBackup Snapshot Manager to version 10.2, the on-host agent must be restarted to discover and protect assets on LVM storage.

For more details about the tpconfig command and its options, refer to the Veritas NetBackup Commands Reference Guide.