Veritas NetBackup™ CloudPoint Install and Upgrade Guide
- Section I. CloudPoint installation and configuration
- Preparing for CloudPoint installation
- About the deployment approach
- Deciding where to run CloudPoint
- About deploying CloudPoint in the cloud
- Meeting system requirements
- CloudPoint host sizing recommendations
- CloudPoint extension sizing recommendations
- Creating an instance or preparing the host to install CloudPoint
- Installing container platform (Docker, Podman)
- Creating and mounting a volume to store CloudPoint data
- Verifying that specific ports are open on the instance or physical host
- Preparing CloudPoint for backup from snapshot jobs
- Deploying CloudPoint using container images
- Deploying CloudPoint extensions
- Before you begin installing CloudPoint extensions
- Downloading the CloudPoint extension
- Preparing to install the extension on a VM
- Installing the CloudPoint extension on a VM
- Preparing to install the extension on a managed Kubernetes cluster (AKS) in Azure
- Preparing to install the extension on a managed Kubernetes cluster (EKS) in AWS
- Install extension using the Kustomize and CR YAMLs
- Installing the CloudPoint extension on Azure (AKS)
- Installing the CloudPoint extension on AWS (EKS)
- Managing the extensions
- CloudPoint cloud plug-ins
- CloudPoint storage array plug-ins
- How to configure the CloudPoint storage array plug-ins?
- NetApp plug-in configuration notes
- ACL configuration on NetApp array
- Nutanix Files plug-in configuration notes
- Configuring ACL for Nutanix array
- Dell EMC Unity array plug-in configuration notes
- FUJITSU AF/DX plug-in configuration notes
- NetApp NAS plug-in configuration notes
- Dell EMC PowerStore plug-in configuration notes
- Dell EMC PowerStore NAS plug-in configuration notes
- Dell EMC PowerFlex plug-in configuration notes
- Dell EMC XtremIO SAN plug-in configuration notes
- Pure Storage FlashArray plug-in configuration notes
- Pure Storage FlashBlade plug-in configuration notes
- IBM Storwize plug-in configuration notes
- HPE RMC plug-in configuration notes
- HPE XP plug-in configuration notes
- Hitachi plug-in configuration notes
- Hitachi (HDS VSP 5000) plug-in configuration notes
- InfiniBox plug-in configuration notes
- Dell EMC PowerScale (Isilon) plug-in configuration notes
- Dell EMC PowerMax and VMax plug-in configuration notes
- Qumulo plug-in configuration notes
- CloudPoint application agents and plug-ins
- Microsoft SQL plug-in configuration notes
- Oracle plug-in configuration notes
- About the installation and configuration process
- Preparing to install the Linux-based agent
- Preparing to install the Windows-based agent
- Downloading and installing the CloudPoint agent
- Registering the Linux-based agent
- Registering the Windows-based agent
- Configuring the CloudPoint application plug-in
- Configuring VSS to store shadow copies on the originating drive
- Creating a NetBackup protection plan for cloud assets
- Subscribing cloud assets to a NetBackup protection plan
- Restore requirements and limitations for Microsoft SQL Server
- Restore requirements and limitations for Oracle
- Additional steps required after an Oracle snapshot restore
- Steps required before restoring SQL AG databases
- Recovering a SQL database to the same location
- Recovering a SQL database to an alternate location
- Additional steps required after a SQL Server snapshot restore
- Additional steps required after restoring SQL AG databases
- SQL snapshot or restore and granular restore operations fail if the Windows instance loses connectivity with the CloudPoint host
- Disk-level snapshot restore fails if the original disk is detached from the instance
- Additional steps required after restoring an AWS RDS database instance
- Protecting assets with CloudPoint's agentless feature
- Volume Encryption in NetBackup CloudPoint
- CloudPoint security
- Preparing for CloudPoint installation
- Section II. CloudPoint maintenance
- CloudPoint logging
- Upgrading CloudPoint
- Uninstalling CloudPoint
- Preparing to uninstall CloudPoint
- Backing up CloudPoint
- Unconfiguring CloudPoint plug-ins
- Unconfiguring CloudPoint agents
- Removing the CloudPoint agents
- Removing CloudPoint from a standalone Docker host environment
- Removing CloudPoint extensions - VM-based or managed Kubernetes cluster-based
- Restoring CloudPoint
- Troubleshooting CloudPoint
Installing CloudPoint in the Podman environment
CloudPoint installation prerequisites on Podman:
Run the following commands to install the required packages (
lvm2,udevanddnsmaq) 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.
- 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 - Change directories to where you have downloaded the CloudPoint image.
- 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
- 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
- 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.
- 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!
- 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.