NetBackup™ for OpenStack Administrator's Guide
- Introduction
- Deploying NetBackup for OpenStack
- Requirements
- NetBackup for OpenStack network considerations
- Existing endpoints in OpenStack
- OpenStack endpoints required by NetBackup for OpenStack
- Recommendation: Provide access to all OpenStack Endpoint types
- Backup target access required by NetBackup for OpenStack
- Example of a typical NetBackup for OpenStack network integration
- Other examples of NetBackup for OpenStack network integrations
- Preparing the installation
- Spinning up the NetBackup for OpenStack VM
- About NetBackup for OpenStack backup target types
- Installing NetBackup for OpenStack Components
- Installing on RHOSP
- Prepare for deployment
- Uploading the NetBackup for OpenStack puppet module
- Updating the overcloud roles data file to include NetBackup for OpenStack services
- Preparing the NetBackup for OpenStack container images
- Providing the environment details in nbos_env.yaml
- Deploying the overcloud with NetBackup OpenStack environment
- Verifying the deployment
- Additional Steps on NetBackup for OpenStack Appliance
- Troubleshooting for overcloud deployment failures
- Installing on Ansible OpenStack Ussuri
- Installing on Kolla Ussuri
- Changing the nova user ID on the NetBackup for OpenStack Nodes
- Copying the NetBackup for OpenStack deployment scripts
- Copying the NetBackup for OpenStack deployment scripts to Kolla-ansible deploy scripts
- Pushing NetBackup for OpenStack images to the local registry
- Editing globals.yml to set NetBackup for OpenStack parameters
- Enabling the NetBackup for OpenStack snapshot mount feature
- Pulling the NetBackup for OpenStack container images
- Deploying the NetBackup for OpenStack components
- Verifying the NetBackup for OpenStack deployment
- Installing on RHOSP
- Configuring NetBackup for OpenStack
- Post Installation Health-Check
- Uninstalling NetBackup for OpenStack
- Uninstalling from RHOSP
- Clean NetBackup for OpenStack Datamover API service
- Clean NetBackup for OpenStack Datamover Service
- Clean NetBackup for OpenStack haproxy resources
- Clean NetBackup for OpenStack Keystone resources
- Clean NetBackup for OpenStack database resources
- Revert overcloud deploy command
- Revert back to original RHOSP Horizon container
- Destroy the NetBackup for OpenStack VM Cluster
- Uninstalling from Ansible OpenStack
- Uninstall NetBackup for OpenStack Services
- Destroy NetBackup for OpenStack Datamover API container
- Clean openstack_user_config.yml
- Remove NetBackup for OpenStack haproxy settings in user_variables.yml
- Remove NetBackup for OpenStack Datamover API inventory file
- Remove NetBackup for OpenStack Datamover API service endpoints
- Delete NetBackup for OpenStack Datamover API database and user
- Remove nbosdmapi rabbitmq user from rabbitmq container
- Clean haproxy
- Remove certificates from Compute nodes
- Destroy the NetBackup for OpenStack VM Cluster
- Uninstalling from Kolla Openstack
- Cleaning NetBackupOpenStack_datamover_api container
- Cleaning NetBackupOpenStack_datamover container
- Cleaning haproxy of NetBackupOpenStack Datamover API
- Cleaning Kolla Ansible deployment procedure
- Reverting to original Horizon container
- Cleaning Keystone resources
- Cleaning NetBackup for OpenStack database resources
- Destroy the NetBackup for OpenStack VM Cluster
- Uninstalling from RHOSP
- Install nbosjm CLI client
- About log rotation in NetBackup for OpenStack
- Configuring NetBackup OpenStack Appliance
- Configuring NetBackup Master Server
- NetBackup for OpenStack policies
- Performing backups and restores of OpenStack
- About snapshots
- List of snapshots
- Creating a snapshot
- Snapshot overview
- Delete snapshots
- Cleaning up the volume snapshots
- Snapshot Cancel
- About restores
- List of Restores
- Restores overview
- Delete a Restore
- Cancel a Restore
- One-Click Restore
- Selective Restore
- In-place restore
- Required restore.json for CLI
- About file search
- Navigating to the file search tab in Horizon
- Configuring and starting a file search in Horizon
- Start the File Search and retrieve the results in Horizon
- Doing a CLI File Search
- About snapshot mount
- Creating a file recovery manager instance
- Mounting a snapshot
- Accessing the File Recovery Manager
- Identifying mounted snapshots
- Unmounting a snapshot
- About schedulers
- Disable a schedule
- Enable a schedule
- Modify a schedule
- About email notifications
- Requirements to activate email Notifications
- Activate/Deactivate the email Notifications
- Performing Backup Administration tasks
- NBOS Backup Admin Area
- Policy Attributes
- Policy Quotas
- Managing Trusts
- Policy import and migration
- Disaster Recovery
- Example runbook for disaster recovery using NFS
- Scenario
- Prerequisites for the disaster recovery process
- Disaster recovery of a single policy
- Copy the policy directories to the configured NFS Volume
- Make the Mount-Paths available
- Reassign the policy
- Add admin-user to required domains and projects
- Discover orphaned policies from NFS-Storage of Target Cloud
- List available projects on Target Cloud in the Target Domain
- List available users on the Target Cloud in the Target Project that have the right backup trustee role
- Reassign the policy to the target project
- Verify that the policy is available at the desired target_project
- Restore the policy
- Clean up
- Disaster recovery of a complete cloud
- Reconfigure the Target NetBackup for OpenStack installation
- Make the Mount-Paths available
- Reassign the policy
- Add admin-user to required domains and projects
- Discover orphaned policies from NFS-Storage of Target Cloud
- List available projects on Target Cloud in the Target Domain
- List available users on the Target Cloud in the Target Project that have the right backup trustee role
- Reassign the policy to the target project
- Verify that the policy is available at the desired target_project
- Restore the policy
- Reconfigure the Target NetBackup for OpenStack installation back to the original one
- Clean up
- Troubleshooting
- General Troubleshooting Tips
- Using the nbosjm CLI tool on the NetBackup for OpenStack Appliance
- Health check of NetBackup for OpenStack
- Important log files
- Troubleshooting NBOSDM container in offline state due to unavailable mount point
- About permission denied error when same NFS share path is used across multiple OpenStack distributions
- After restore of the Windows instance, disk is in offline state
- Index
Loading the images from tar and pushing them to the local repository
Ensure that the proper tar files of nbosdmapi, nbosdm and nbos-horizon-plugin are available on the deployment node.
NBOS_Version | NetBackup for OpenStack version number. |
kolla-base-distro | CentOS or Ubuntu |
kolla-install-type | Binary or source |
FQDN | Hostname of kolla deployment server. |
To load the images from tar and push them to the local repository
- Load NetBackup for OpenStack images from the tar file.
Run the following commands:
nbosdmapi
docker load --input nbosdmapi-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri.tar
For example,
docker load --input nbosdmapi-ubuntu-9.1.2.20211021104525-ussuri.tar
nbosdm
docker load i-input nbosdm-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri.tar
For example,
docker load --input nbosdm-ubuntu-9.1.2.20211021104525-ussuri.tar
nbos-horizon-plugin
docker load --input nbos-horizon-plugin-{{ kolla-install-type }}-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri.tar
For example,
docker load --input nbos-horizon-plugin-source-ubuntu-9.1.2.20211021104525-ussuri.tar
- Tag the NetBackup for OpenStack images with appropriate name.
Run the following commands:
nbosdmapi
docker tag nbosdmapi-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri nbos/nbosdmapi-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri
docker tag nbosdmapi-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri FQDN:5001/nbos/nbosdmapi-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri
Examples,
docker tag nbosdmapi-ubuntu:9.1.2.20211021104525-ussuri nbos/nbosdmapi-ubuntu:9.1.2.20211021104525-ussuri
docker tag nbosdmapi-ubuntu:9.1.2.20211021104525-ussuri deployment-vm.vxindia.veritas.com:5001/nbos/nbosdmapi-ubuntu:9.1.2.20211021104525-ussuri
nbosdm
docker tag nbosdm-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri nbos/nbosdm-<kolla-base-distro>:<NBOS_version>-ussuri
docker tag nbosdm-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri FQDN:5001/nbos/nbosdm-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri
Examples,
docker tag nbosdm-ubuntu:9.1.2.20211021104525-ussuri nbos/nbosdm-ubuntu:9.1.2.20211021104525-ussuri
docker tag nbosdm-ubuntu:9.1.2.20211021104525-ussuri deployment-vm.vxindia.veritas.com:5001/nbos/nbosdm-ubuntu:9.1.2.20211021104525-ussuri
nbos-horizon-plugin
docker tag nbos-horizon-plugin-{{ kolla-install-type }}-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri nbos/nbos-horion-plugin-{{ kolla-install-type }}-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri
docker tag nbos-horizon-plugin-{{ kolla-install-type }}-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri FQDN:5001/nbos/nbos-horizon-plugin-{{ kolla-install-type }}-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri
Examples,
docker tag nbos-horizon-plugin-source-ubuntu:9.1.2.20211021104525-ussuri nbos/nbos-horizon-plugin-source-ubuntu:9.1.2.20211021104525-ussuri
docker tag nbos-horizon-plugin-source-ubuntu:9.1.2.20211021104525-ussuri deployment-vm.vxindia.veritas.com:5001/nbos/nbos-horizon-plugin-source-ubuntu:9.1.2.20211021104525-ussuri
- Push the tagged image to local registry.
Run the following commands:
nbosdmapi
docker push FQDN:5001/nbos/nbosdmapi-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri
For example,
docker push deployment-vm.vxindia.veritas.com:5001/nbos/nbosdmapi-ubuntu:9.1.2.20211021104525-ussuri
nbosdm
docker push FQDN:5001/nbos/nbosdm-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri
For example,
docker push deployment-vm.vxindia.veritas.com:5001/nbos/nbosdm-ubuntu:9.1.2.20211021104525-ussuri
nbos-horizon-plugin
docker push FQDN:5001/nbos/nbos-horizon-plugin-{{ kolla-install-type }}-{{ kolla-base-distro }}:{{ NBOS_version }}-ussuri
For example,
docker push deployment-vm.vxindia.veritas.com:5001/nbos/nbos-horizon-plugin-source-ubuntu:9.1.2.20211021104525-ussuri
- Add the insecure-registries entry in
/etc/docker/daemon.jsonon all controller and compute nodes.Open the daemon.json file and make the changes as follows:
cat /etc/docker/daemon.json { "log-opts": { "max-file": "5", "max-size": "50m" }, "registry-mirrors": [ "http://<deployment node ip>:4000" ], "insecure-registries": [ "FQDN:5001" ] } - Add the insecure-registries entry in
/etc/docker/daemon.jsonon deployment nodes.If
/etc/docker/directory does not exist, create it and createdaemon.jsonfile.Open the daemon.json file and make the changes as follows:
cat /etc/docker/daemon.json { "insecure-registries":["FQDN:5001"] } - Restart the docker.
systemctl restart docker
- Verify that the specified images are pushed in the registry.
Controller and compute nodes: curl -X GET http://FQDN:5001/v2/_catalog
Deployment node: docker info
For example,
curl -X GET http://deployment-vm.vxindia.veritas.com:5001/v2/_catalog
Sample output:
curl -X GET http://deployment-vm.vxindia.veritas.com: 5001/v2/_catalog //Output should look like below: {"repositories":["nbos/nbos-horizon-plugin-source-centos", "nbos/nbosdm-centos","nbos/nbosdmapi-centos"]}