Veritas NetBackup™ CloudPoint Install and Upgrade Guide

Last Published:
Product(s): NetBackup (9.1)
  1. Section I. CloudPoint installation and configuration
    1. Preparing for CloudPoint installation
      1.  
        About the deployment approach
      2.  
        Deciding where to run CloudPoint
      3.  
        About deploying CloudPoint in the cloud
      4.  
        Meeting system requirements
      5. CloudPoint host sizing recommendations
        1.  
          CloudPoint sizing recommendations for cloud platforms
      6.  
        CloudPoint extension sizing recommendations
      7.  
        Creating an instance or preparing the host to install CloudPoint
      8.  
        Installing container platform (Docker, Podman)
      9.  
        Creating and mounting a volume to store CloudPoint data
      10.  
        Verifying that specific ports are open on the instance or physical host
      11.  
        Preparing CloudPoint for backup from snapshot jobs
    2. Deploying CloudPoint using container images
      1.  
        Before you begin installing CloudPoint
      2.  
        Installing CloudPoint in the Docker environment
      3.  
        Installing CloudPoint in the Podman environment
      4.  
        Verifying that CloudPoint is installed successfully
      5.  
        Restarting CloudPoint
    3. Deploying CloudPoint extensions
      1.  
        Before you begin installing CloudPoint extensions
      2.  
        Preparing to install the extension on a VM
      3.  
        Installing the CloudPoint extension on a VM
      4.  
        Preparing to install the extension on a managed Kubernetes cluster
      5.  
        Downloading the CloudPoint extension
      6.  
        Installing the CloudPoint extension on a managed Kubernetes cluster
      7.  
        Managing the extensions
    4. CloudPoint cloud plug-ins
      1.  
        How to configure the CloudPoint cloud plug-ins?
      2. AWS plug-in configuration notes
        1.  
          Prerequisites for configuring the AWS plug-in
        2.  
          Configuring AWS permissions for CloudPoint
        3.  
          AWS permissions required by CloudPoint
        4.  
          Before you create a cross account configuration
      3. Google Cloud Platform plug-in configuration notes
        1.  
          Google Cloud Platform permissions required by CloudPoint
        2.  
          Configuring a GCP service account for CloudPoint
        3.  
          Preparing the GCP service account for plug-in 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. CloudPoint storage array plug-ins
      1.  
        How to configure the CloudPoint storage array plug-ins?
      2. NetApp plug-in configuration notes
        1.  
          NetApp plug-in configuration parameters
        2.  
          Configuring a dedicated LIF for NetBackup access
        3.  
          Supported CloudPoint operations on NetApp storage
      3.  
        ACL configuration on NetApp array
      4. Nutanix Files plug-in configuration notes
        1.  
          Nutanix Files plug-in configuration prerequisites
        2.  
          Nutanix Files plug-in considerations and limitations
        3.  
          Supported CloudPoint operations on Nutanix Files File Server
        4. Troubleshooting NetBackup issues for Nutanix Files
          1.  
            Backup jobs for Nutanix Files fail due to snapshot import and export operations failures
          2.  
            Plug-in configuration may fail if the Nutanix Files version is unsupported
      5.  
        Configuring ACL for Nutanix array
      6. Dell EMC Unity array plug-in configuration notes
        1.  
          Dell EMC Unity array plug-in configuration parameters
        2.  
          Supported Dell EMC Unity arrays
        3.  
          Supported CloudPoint operations on Dell EMC Unity arrays
      7. Pure Storage FlashArray plug-in configuration notes
        1.  
          Supported Pure Storage FlashArray models
        2.  
          Supported CloudPoint operations on Pure Storage FlashArray models
      8. HPE RMC plug-in configuration notes
        1.  
          RMC plug-in configuration parameters
        2.  
          Supported HPE storage systems
        3.  
          Supported CloudPoint operations on HPE storage arrays
      9. HPE XP plug-in configuration notes
        1.  
          HPE XP plug-in configuration parameters
        2.  
          Supported CloudPoint operations on HPE XP storage arrays
      10. Hitachi plug-in configuration notes
        1.  
          Hitachi plug-in configuration parameters
        2.  
          Supported Hitachi storage arrays
        3.  
          Supported CloudPoint operations on Hitachi arrays
      11. Hitachi (HDS VSP 5000) plug-in configuration notes
        1.  
          Hitachi (HDS VSP 5000) plug-in configuration parameters
        2.  
          Supported CloudPoint operations on Hitachi (HDS VSP 5000) array
      12. InfiniBox plug-in configuration notes
        1.  
          InifiniBox plug-in configuration parameters
        2.  
          Supported CloudPoint operations on InfiniBox arrays
      13. Dell EMC PowerScale (Isilon) plug-in configuration notes
        1.  
          Dell EMC PowerScale (Isilon) plug-in configuration prerequisites
        2.  
          Supported CloudPoint operations on Dell EMC PowerScale (Isilon) plug-in
      14. Dell EMC PowerMax and VMax plug-in configuration notes
        1.  
          Dell EMC PowerMax and VMax plug-in configuration prerequisites
        2.  
          Supported CloudPoint operations on Dell EMC PowerMax and VMax
      15. Qumulo plug-in configuration notes
        1.  
          Qumulo plug-in configuration prerequisites
        2.  
          Qumulo plug-in considerations and limitations
        3.  
          Supported CloudPoint operations on Qumulo plug-in
    6. CloudPoint application agents and plug-ins
      1.  
        Microsoft SQL plug-in configuration notes
      2. Oracle plug-in configuration notes
        1.  
          Optimizing your Oracle database data and metadata files
      3.  
        MongoDB plug-in configuration notes
      4.  
        About the installation and configuration process
      5.  
        Preparing to install the Linux-based agent
      6.  
        Preparing to install the Windows-based agent
      7.  
        Downloading and installing the CloudPoint agent
      8.  
        Registering the Linux-based agent
      9.  
        Registering the Windows-based agent
      10.  
        Configuring the CloudPoint application plug-in
      11.  
        Configuring VSS to store shadow copies on the originating drive
      12.  
        Creating a NetBackup protection plan for cloud assets
      13.  
        Subscribing cloud assets to a NetBackup protection plan
      14. About snapshot restore
        1.  
          Process for restoring SQL AG databases
      15.  
        Restore requirements and limitations for Microsoft SQL Server
      16.  
        Restore requirements and limitations for Oracle
      17.  
        Additional steps required after an Oracle snapshot restore
      18.  
        Restore requirements and limitations for MongoDB
      19.  
        Additional steps required after a MongoDB snapshot restore
      20.  
        Steps required before restoring SQL AG databases
      21.  
        Recovering a SQL database to the same location
      22.  
        Recovering a SQL database to an alternate location
      23. Additional steps required after a SQL Server snapshot restore
        1.  
          Steps required after a SQL Server disk-level snapshot restore to new location
      24.  
        Additional steps required after restoring SQL AG databases
      25.  
        SQL snapshot or restore and granular restore operations fail if the Windows instance loses connectivity with the CloudPoint host
      26.  
        Disk-level snapshot restore fails if the original disk is detached from the instance
      27.  
        Additional steps required after restoring an AWS RDS database instance
    7. Protecting assets with CloudPoint's agentless feature
      1.  
        About the agentless feature
      2. Prerequisites for the agentless configuration
        1.  
          Configuring SMB for Windows (Optional)
        2.  
          Configuring WMI security for Windows (optional)
      3.  
        Configuring the agentless feature
      4.  
        Configuring the agentless feature after upgrading CloudPoint
    8. Volume Encryption in NetBackup CloudPoint
      1.  
        About volume encryption support in CloudPoint
      2.  
        Volume encryption for Azure
      3.  
        Volume encryption for GCP
      4.  
        Volume encryption for AWS
    9. CloudPoint security
      1.  
        Configuring security for Azure and Azure Stack
      2.  
        Configuring the cloud connector for Azure and Azure Stack
      3.  
        CA configuration for Azure Stack
      4.  
        Securing the connection to CloudPoint
  2. Section II. CloudPoint maintenance
    1. CloudPoint logging
      1.  
        About CloudPoint logging mechanism
      2. How Fluentd-based CloudPoint logging works
        1.  
          About the CloudPoint fluentd configuration file
        2.  
          Modifying the fluentd configuration file
      3.  
        CloudPoint logs
      4.  
        Agentless logs
      5.  
        Troubleshooting CloudPoint logging
    2. Upgrading CloudPoint
      1.  
        About CloudPoint upgrades
      2.  
        Supported upgrade path
      3.  
        Upgrade scenarios
      4.  
        Preparing to upgrade CloudPoint
      5. Upgrading CloudPoint
        1.  
          Upgrade in Docker environment
        2.  
          Upgrade in Podman environment
      6.  
        Upgrading CloudPoint using patch or hotfix
      7. Migrating and upgrading CloudPoint
        1.  
          Before you begin migrating CloudPoint
        2.  
          Migrate and upgrade CloudPoint on RHEL 8.3
      8.  
        Post-upgrade tasks
    3. Uninstalling CloudPoint
      1.  
        Preparing to uninstall CloudPoint
      2.  
        Backing up CloudPoint
      3.  
        Unconfiguring CloudPoint plug-ins
      4.  
        Unconfiguring CloudPoint agents
      5.  
        Removing the CloudPoint agents
      6.  
        Removing CloudPoint from a standalone Docker host environment
      7.  
        Removing CloudPoint extensions - VM-based or managed Kubernetes cluster-based
      8.  
        Restoring CloudPoint
    4. Troubleshooting CloudPoint
      1.  
        Troubleshooting CloudPoint

Registering the Linux-based agent

Verify the following before you register the Linux-based agent:

  • Ensure that you have downloaded and installed the agent on the application host.

  • Ensure that you have root privileges on the Linux instance.

  • If the CloudPoint Linux-based agent was already configured on the host earlier, and you wish to re-register the agent with the same CloudPoint instance, then do the following on the Linux host:

    • Remove the /opt/VRTScloudpoint/keys directory from the Linux host.

      Type the following command on the host where the agent is running:

      # sudo rm -rf /opt/VRTScloudpoint/keys

  • If the CloudPoint Linux-based agent was already registered on the host earlier, and you wish to register the agent with a different CloudPoint instance, then do the following on the Linux host:

    • Uninstall the agent from the Linux host.

      See Removing the CloudPoint agents.

    • Remove the /opt/VRTScloudpoint/keys directory from the Linux host.

      Type the following command:

      # sudo rm -rf /opt/VRTScloudpoint/keys

    • Remove the /etc/flexsnap.conf configuration file from the Linux host.

      Type the following command:

      sudo rm -rf /etc/flexsnap.conf

    • Re-install the agent on the Linux host.

      See Downloading and installing the CloudPoint agent.

    If you do not perform these steps, then the on-host agent registration may fail with the following error:

    On-host registration has failed. The agent is already registered 
    with CloudPoint instance <instance>.

To register the Linux-based agent

  1. Return to the NetBackup Web UI, and on the Add agent dialog box, click Create Token.

    If you have closed the dialog box, sign in to the NetBackup Web UI again and do the following:

    • Click Cloud from the left navigation menu, and select the CloudPoint servers tab.

    • From the desired CloudPoint server row, click the actions button on the right and then select Add agent.

    • On the Add agent dialog box, click Create Token.

  2. Click Copy Token to copy the displayed CloudPoint validation token.

    The token is a unique sequence of alpha-numeric characters and is used as an authentication token to authorize the host connection with CloudPoint.

    Note:

    The token is valid for 180 seconds only. If you do not copy the token within that time frame, generate a new token again.

  3. Connect to the Linux host and register the agent using the following command:

    # sudo flexsnap-agent --ip <cloudpoint_host_FQDN_or_IP> --token <authtoken>

    Here, <cloudpoint_host_FQDN_or_IP> is the CloudPoint server's Fully Qualified Domain Name (FQDN) or IP address that was specified during the CloudPoint configuration.

    <authtoken> is the authentication token that you copied in the earlier step.

    Note:

    You can use flexsnap-agent --help to see the command help.

    CloudPoint performs the following actions when you run this command:

    • registers the Linux-based agent

    • creates a /etc/flexsnap.conf configuration file on the Linux instance and updates the file with CloudPoint host information

    • enables and then starts the agent service on the Linux host

    Note:

    If you encounter an error, check the flexsnap-agent logs to troubleshoot the issue.

  4. Return to the NetBackup Web UI, close the Add agent dialog box, and then from the CloudPoint server row, click the actions button on the right and then click Discover.

    This triggers a manual discovery of all the assets that are registered with the CloudPoint server.

  5. Click on the Virtual machines tab.

    The Linux host where you installed the agent should appear in the discovered assets list.

    Click to select the Linux host. If the host status is displayed as VM Connected and a Configure Application button appears, it confirms that the agent registration is successful.

  6. This completes the agent registration. You can now proceed to configure the application plug-in.

    See Configuring the CloudPoint application plug-in.