Veritas NetBackup™ CloudPoint Install and Upgrade Guide

Last Published:
Product(s): NetBackup & Alta Data Protection (10.0)
  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.  
        Downloading the CloudPoint extension
      3.  
        Preparing to install the extension on a VM
      4.  
        Installing the CloudPoint extension on a VM
      5.  
        Preparing to install the extension on a managed Kubernetes cluster (AKS) in Azure
      6.  
        Preparing to install the extension on a managed Kubernetes cluster (EKS) in AWS
      7.  
        Install extension using the Kustomize and CR YAMLs
      8.  
        Installing the CloudPoint extension on Azure (AKS)
      9. Installing the CloudPoint extension on AWS (EKS)
        1.  
          Install extension using the extension script
      10.  
        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. FUJITSU AF/DX plug-in configuration notes
        1.  
          FUJITSU AF/DX plug-in configuration parameters
        2.  
          Supported CloudPoint operations on FUJITSU AF/DX models
      8. NetApp NAS plug-in configuration notes
        1.  
          NetApp NAS plug-in configuration parameters
        2.  
          Supported CloudPoint operations on NetApp NAS models
      9. Dell EMC PowerStore plug-in configuration notes
        1.  
          Dell EMC PowerStore plug-in configuration parameters
        2.  
          Supported CloudPoint operations on Dell EMC PowerStore models
      10. Dell EMC PowerStore NAS plug-in configuration notes
        1.  
          Dell EMC PowerStore NAS plug-in configuration parameters
        2.  
          Supported CloudPoint operations on Dell EMC PowerStore NAS models
      11. Dell EMC PowerFlex plug-in configuration notes
        1.  
          Dell EMC PowerFlex plug-in configuration parameters
        2.  
          Supported CloudPoint operations on Dell EMC PowerFlex models
      12. Dell EMC XtremIO SAN plug-in configuration notes
        1.  
          Dell EMC XtremIO SAN plug-in configuration parameters
        2.  
          Supported CloudPoint operations on Dell EMC XtremIO SAN models
      13. Pure Storage FlashArray plug-in configuration notes
        1.  
          Supported Pure Storage FlashArray models
        2.  
          Supported CloudPoint operations on Pure Storage FlashArray models
      14. Pure Storage FlashBlade plug-in configuration notes
        1.  
          Pure Storage FlashBlade plug-in configuration parameters
        2.  
          Supported CloudPoint operations on Pure Storage FlashBlade models
      15. IBM Storwize plug-in configuration notes
        1.  
          IBM Storwize plug-in configuration parameters
        2.  
          Supported CloudPoint operations on IBM Storwize models
      16. 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
      17. HPE XP plug-in configuration notes
        1.  
          HPE XP plug-in configuration parameters
        2.  
          Supported CloudPoint operations on HPE XP storage arrays
      18. Hitachi plug-in configuration notes
        1.  
          Hitachi plug-in configuration parameters
        2.  
          Supported Hitachi storage arrays
        3.  
          Supported CloudPoint operations on Hitachi arrays
      19. 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
      20. InfiniBox plug-in configuration notes
        1.  
          InifiniBox plug-in configuration parameters
        2.  
          Supported CloudPoint operations on InfiniBox arrays
      21. 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
      22. 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
      23. 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.  
        About the installation and configuration process
      4.  
        Preparing to install the Linux-based agent
      5.  
        Preparing to install the Windows-based agent
      6.  
        Downloading and installing the CloudPoint agent
      7.  
        Registering the Linux-based agent
      8.  
        Registering the Windows-based agent
      9.  
        Configuring the CloudPoint application plug-in
      10.  
        Configuring VSS to store shadow copies on the originating drive
      11.  
        Creating a NetBackup protection plan for cloud assets
      12.  
        Subscribing cloud assets to a NetBackup protection plan
      13.  
        Restore requirements and limitations for Microsoft SQL Server
      14.  
        Restore requirements and limitations for Oracle
      15.  
        Additional steps required after an Oracle snapshot restore
      16.  
        Steps required before restoring SQL AG databases
      17.  
        Recovering a SQL database to the same location
      18.  
        Recovering a SQL database to an alternate location
      19. Additional steps required after a SQL Server snapshot restore
        1.  
          Steps required after a SQL Server disk-level snapshot restore to new location
      20.  
        Additional steps required after restoring SQL AG databases
      21.  
        SQL snapshot or restore and granular restore operations fail if the Windows instance loses connectivity with the CloudPoint host
      22.  
        Disk-level snapshot restore fails if the original disk is detached from the instance
      23.  
        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.5 or 8.4
      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

Installing CloudPoint in the Podman environment

CloudPoint installation prerequisites on Podman:

  • Run the following commands to install the required packages (lvm2, udev and dnsmaq) on the hosts:

    #yum install -y lvm2-<version>

    #yum install -y lvm2-libs-<version>

    #yum install -y python3-pyudev-<version>

    #yum install -y systemd-udev-<version>

    #yum install -y dnsmasq-<version>

To install CloudPoint

Note:

When you deploy CloudPoint, you may want to copy the commands below and paste them in your command line interface. If you do, replace the information in these examples with what pertains to your installation such as, the product and build version, the download directory path, and so on.

  1. Download the CloudPoint image to the system on which you want to deploy CloudPoint.

    The CloudPoint image name resembles the following format:

    VRTScloudpoint-podman-10.x.x.x.x.tar.gz

  2. Change directories to where you have downloaded the CloudPoint image.
  3. Un-tar the image file and list the contents:

    # gunzip VRTScloudpoint-podman-10.x.x.x.x.tar.gz

    # ls

    The output resembles the following:

    # gunzip VRTScloudpoint-podman-10.x.x.x.x.tar.gz
    
    # tar -xvf VRTScloudpoint-podman-10.x.x.x.x.tar
    VRTScloudpoint-podman-10.x.x.x.9803.img.gz
    flexsnap-podman-api.service
    flexsnap_preinstall.sh
    flexsnap-podman-containers.service
    dnsname
    
    # ls
    VRTScloudpoint-podman-10.x.x.x.9803.img.gz
    flexsnap-podman-api.service
    flexsnap_preinstall.sh
    flexsnap-podman-containers.service
    dnsname
  4. Run the following command to prepare the CloudPoint host for installation:

    # ./flexsnap_preinstall.sh

    The output resembles the following:

    Executing the following changes on this node to prepare the CloudPoint
    server for installation:
    1) Loading CloudPoint service images.
    2) Copying dnsname plugin to the /usr/libexec/cni folder.
    3) Check if dnsmasq rpm is installed on the host, if not,
       installation is done automatically.
    4) Creating and starting the systemd service for the Podman API server.
    Do you want to continue? (Yes/No): Yes
    Loaded image(s): localhost/veritas/flexsnap-agent:9.x.x.x.x
    Loaded image(s): localhost/veritas/flexsnap-api-gateway:9.x.x.x.x
    Loaded image(s): localhost/veritas/flexsnap-certauth:9.x.x.x.x
    ............
    ............
    Loaded image(s): localhost/veritas/flexsnap-workflow:9.x.x.x.x
    Copying dnsname plugin...done
    Starting Podman API service...done
    Enabling Podman Containers service...done
  5. Install NetBackup CloudPoint with the following command:

    # podman run -it --rm --privileged -v /cloudpoint:/cloudpoint -v /run/podman/podman.sock:/run/podman/podman.sock veritas/flexsnap-cloudpoint:10.x.x.x.x install

    Note:

    This is a single command. Ensure that you enter the command without any line breaks.

    In this step, CloudPoint does the following:

    • Creates and runs the containers for each of the CloudPoint services.

    • Creates self-signed keys and certificates for nginx

    The output resembles the following:

    Installing the services
    Configuration started at time: Thu Feb 18 09:20:12 UTC 2021
    podman server version: 2.2.1 or 3.3.1 Supported: true
    This is a fresh install of NetBackup CloudPoint 9.x.x.x.x
    CloudPoint currently is not configured.
    Starting initial services before configuration.
    Creating network: flexsnap-network ...done
    Starting container: flexsnap-fluentd ...done
    Creating container: flexsnap-mongodb ...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-idm ...done
    Starting container: flexsnap-config ...done
    Creating self signed keys and certs for nginx ...done
    Please provide CloudPoint admin credentials for configuration:

    If the CloudPoint host is behind a proxy server, use the following command instead:

    # podman run -it --rm --privileged 
    -v /<full_path_to_volume_name>:/<full_path_to_volume_name> 
    -e VX_HTTP_PROXY=<http_proxy_value>
    -e VX_HTTPS_PROXY=<https_proxy_value>
    -e VX_NO_PROXY=<no_proxy_value>
    -v /run/podman/podman.sock:/run/podman/podman.sock
    veritas/flexsnap-cloudpoint:10.x.x.x.x install

    Replace the following parameters as per your environment:

    Parameter

    Description

    <http_proxy_value>

    (required only if the instance uses a proxy server)

    Represents the value to be used as the HTTP proxy for all connections.

    For example, "http://proxy.mycompany.com:8080/".

    <https_proxy_value>

    (required only if the instance uses a proxy server)

    Represents the value to be used as the HTTPS proxy for all connections.

    For example, "https://proxy.mycompany.com:8080/".

    <no_proxy_value>

    (required only if the instance uses a proxy server)

    Represents the addresses that are allowed to bypass the proxy server. You can specify host names, IP addresses, and domain names in this parameter.

    Use commas to separate multiple entries. For example, "localhost,mycompany.com,192.168.0.10:80".

    Note:

    If CloudPoint is being deployed in the cloud, ensure that you set the following values in this parameter:

    • For an AWS instance, add the following:

      169.254.169.254

    • For a GCP virtual machine, add the following:

      169.254.169.254,metadata,metadata.google.internal

    • For an Azure virtual machine, add the following:

      169.254.169.254

    CloudPoint uses these addresses to gather instance metadata from the instance metadata service.

  6. Provide the following details when prompted on the command prompt:

    Parameter

    Description

    Admin username

    Specify a user name for the CloudPoint administrator user account.

    Admin password

    Specify a password for the admin user.

    Confirm Admin password

    Confirm the admin user password.

    Host name for TLS certificate

    Specify the IP address or the Fully Qualified Domain Name (FQDN) of the CloudPoint host.

    If you connect to the host using different names (for example, myserver, myserver.mydomain, or myserver.mydomain.mycompany.com), then ensure that you add all the names here if you want to enable CloudPoint access using those names.

    Use commas to specify multiple entries. The names you specify here must point to the same CloudPoint host.

    The specified names or IP address are added to the list of host names to use for configuring CloudPoint. The installer uses these names to generate a server certificate for the CloudPoint host.

    Port

    Specify the port through which the CloudPoint server can communicate. Default is port 443.

    The installer then displays messages similar to the following:

    Starting container: flexsnap-nginx ...done
    Waiting for CloudPoint configuration to complete (22/22) ...done
    Configuration complete at time Thu Feb 18 09:26:36 UTC 2021!
  7. This concludes the CloudPoint deployment process. The next step is to register the CloudPoint server with the Veritas NetBackup primary server.

    If CloudPoint is deployed in the cloud, refer to the NetBackup Web UI Cloud Administrator's Guide for instructions. If CloudPoint is deployed on-premise, refer to the NetBackup Snapshot Client Administrator's Guide for instructions.

Note:

If you ever need to restart CloudPoint, use the podman run command so that your environmental data is preserved.

See Restarting CloudPoint.