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 virtual machine
- 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
- 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 backup 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
- Resource throttling in 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 virtual machine 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 virtual machine 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 virtual machine cluster
- Uninstalling from RHOSP
- Install nbosjm CLI client
- About log rotation in NetBackup for OpenStack
- Upgrading NetBackup for OpenStack
- Configuring NetBackup OpenStack Appliance
- Configuring NetBackup primary server
- NetBackup for OpenStack protections
- Performing snapshots, backups, and restores of OpenStack
- About recovery points
- List of recovery points
- Creating a snapshot
- Snapshot and backup overview
- Expire recovery points
- Cleaning up the volume snapshots
- About restores
- List of Restores
- Restores overview
- Delete a restore
- Cancel a restore
- One-click restore
- Selective restore
- In-place restore
- Required restore.json file for CLI
- About backup mount
- Creating a file recovery manager instance
- Mounting a backup copy
- Accessing the file recovery manager
- Identifying mounted backups
- Unmounting a backup
- About schedules
- About activating the email notifications
- Performing Backup Administration tasks
- Disaster recovery
- 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
- After restore of the Windows instance, the disk is in an offline state
- Selective restore from snapshot copy fails
- A backup fails due to an old nova ID in the universal share path
- Using the NetBackup support utility in NetBackup for OpenStack
- Cannot create volumes if the metadata size for physical volume and volume group is small
- NBOSVM configuration fails if DNS server cannot resolve IP address or IP address is wrong
- Error when storage unit is created with multiple storage servers
- Snapshot job fails if the OpenStack image is not accessible to the OpenStack user
- One-click restore fails if the subnet attached to the instance is not accessible to the OpenStack user
- The NBOSVM configurator UI does not detect the primary server
- A recovery point name is updated to a default name
- NBOS Backups and NBOS Backup Admin tabs disappear from Horizon UI after stack is updated
- The protection creation fails on the Horizon UI
- The NetBackup for OpenStack services do not start after NBOSVM is restarted
- The NBOSVM is not able to communicate with the nbosdmapi on the controller node
- Troubleshooting the OpenStack Keystone authentication failure
- Index
Configuring the email settings
These settings are used by NetBackup for OpenStack to send email reports of recovery points and restores to users. The email settings must be configured to provide email notification to OpenStack users.
The following information is required to configure the email settings:
SMTP server
SMTP username
SMTP password
SMTP port
SMTP time-out
Sender email address
A test email can be sent directly from the configuration page.
To work with email settings through the CLI use the following commands:
Configuring the email settings using the command-line
- Set an email setting for the first time or after the deletion.
nbosjm setting-create [--description <description>] [--category <category>] [--type <type>] [--is-public {True,False}] [--is-hidden {True,False}] [--metadata <key=value>] <name> <value>--description Optional description (Default=None). Not required for email settings.
--category Optional setting category (Default=None). Not required for email settings.
--type Settings type. Set to email_settings.
--is-public Sets if the setting can be seen publicly. Set to False.
--is-hidden Sets if the setting should always be hidden. Set to False.
--metadata Sets if the setting can be seen publicly. Not required for email settings.
<name> Name of the setting.
<value> Value of the setting.
- Update the existing email settings.
nbosjm setting-update [--description <description>] [--category <category>] [--type <type>] [--is-public {True,False}] [--is-hidden {True,False}] [--metadata <key=value>] <name> <value>--description Optional description (Default=None). Not required for email settings.
--category Optional setting category (Default=None). Not required for email settings.
--type Settings type. Set to email_settings.
--is-public Sets if the setting can be seen publicly. Set to False.
--is-hidden Sets if the setting will always be hidden. Set to False.
--metadata Sets if the setting can be seen publicly. Not required for email settings.
<name> Name of the setting.
<value> Value of the setting.
- Show the existing email settings.
nbosjm setting-show [--get_hidden {True,False}] <setting_name>--get_hidden Hidden settings (True) or not (False). Not required for email settings, use False if set.
<setting_name> Name of the setting to show.
- Delete the email settings.
nbosjm setting-delete <setting_name>
<setting_name> Name of the setting to delete.
Table: Email settings
Setting name | Value type | Example |
|---|---|---|
smtp_default_recipient | String | admin@example.net |
smtp_default_sender | String | admin@example.net |
smtp_port | Integer | 587 |
smtp_server_name | String | Mailserver_A |
smtp_server_username | String | admin |
smtp_server_password | String | password |
smtp_timeout | Integer | 10 |
smtp_email_enable | Boolean | True |