Veritas NetBackup™ Virtual Appliance Documentation
- Getting to know the NetBackup Virtual Appliance
- NetBackup Virtual Appliance product description
- Preparing to deploy the appliance
- Deploying and configuring the appliance
- Post initial configuration procedures
- Appliance common tasks
- Storage management
- About NetBackup Virtual Appliance storage configuration
- About viewing storage space information using the Show command
- About OpenStorage plugin installation
- About NetBackup Virtual Appliance storage configuration
- Deduplication pool catalog backup and recovery
- Network connection management
- Managing users
- About user name and password specifications
- About authenticating LDAP users
- About authenticating Active Directory users
- About authentication using smart cards and digital certificates
- About user authorization on the NetBackup Virtual Appliance
- Creating NetBackup administrator user accounts
- Using the appliance
- About configuring Host parameters for your appliance on the NetBackup Virtual Appliance
- About Copilot functionality and Share management
- About NetBackup Virtual Appliance as a VMware backup host
- About running NetBackup commands from the appliance
- About mounting a remote NFS
- About Auto Image Replication from a NetBackup Virtual Appliance
- Monitoring the appliance
- About SNMP
- About Call Home
- Appliance security
- About Symantec Data Center Security on the NetBackup Virtual Appliance
- About data encryption
- Setting the appliance login banner
- Upgrading the appliance
- About upgrading to NetBackup Virtual Appliance software version 5.1.1
- Requirements and best practices for upgrading NetBackup appliances
- Methods for downloading appliance software release updates
- NetBackup client upgrades with VxUpdate
- Appliance restore
- Decommissioning and Reconfiguring
- Troubleshooting
- About disaster recovery
- About NetBackup support utilities
- Appliance logging
- About forwarding logs to an external server
- Commands overview
- Appendix A. Appliance commands
- Appendix B. Manage commands
- Appendix C. Monitor commands
- Appendix D. Network commands
- Appendix E. Reports commands
- Appendix F. Settings commands
- Appendix G. Support commands
- Appendix H. Available commands for a NetBackupCLI user
Migrating from NetBackup Cloud Catalyst Appliance to MSDP direct cloud tiering
Starting with NetBackup Virtual Appliance release 4.1, the Cloud Catalyst feature is no longer supported. However, you are encouraged to move to MSDP direct cloud tiering. This technology offers improved performance, reliability, usability, and flexibility when compared to the earlier Cloud Catalyst product.
Details for migrating from Cloud Catalyst to MSDP direct cloud tiering are included in the Veritas NetBackup Deduplication Guide, Appendix B. You should review that information before proceeding with the migration.
Note:
Note: The procedures in this appendix must be run on MSDP servers running appliance versions 5.0 through 5.???. The master server may be running a newer version, but the MSDP server on which the nbdecommission -migrate_cloudcatalyst command is run, must be running one of these versions.
This document provides the additional required information to convert a NetBackup Virtual Appliance Cloud Catalyst to use MSDP direct cloud tiering. The following describes the supported and unsupported migration scenarios, and the migration process.
New NetBackup Virtual Appliance installations
You can deploy any new NetBackup Virtual Appliance media server with software version 5.0 and later and configure it to use MSDP direct cloud tiering.
Existing NetBackup Virtual Appliance media server installations that are used as an MSDP target server
You can upgrade most existing NetBackup Virtual Appliance media server installations with software version 5.0 to use MSDP direct cloud tiering.
The actual time to complete the migration (Task 6: Perform migration steps) can vary, depending on the cloud provider involved and the available network bandwidth for downloading from the cloud. Most migrations should finish within 24 hours, and many require much less than 24 hours. However, in some cases it may take longer.
The following shows a summarized list of the required tasks to migrate to MSDP direct cloud tiering. Click on each link for the details of each task.
Task 1: Review migration documentation
Task 2: Upgrade primary server
Task 3: Collect required data to prepare for pre-migration steps
Task 4: Perform pre-migration steps
Task 5: Deploy or upgrade media server appliance
Task 6: Perform migration steps
Task 7: Perform post-migration steps
For complete details about migrating to MSDP direct cloud tiering, see the Veritas NetBackup Deduplication Guide, Appendix B.
For additional details about migrating a NetBackup Cloud Catalyst appliance to MSDP direct cloud tiering, review this entire topic.
Upgrade the associated primary server as follows:
For a NetBackup Virtual Appliance primary server, upgrade to appliance version 5.0 or later. See About upgrading to NetBackup Virtual Appliance software version 5.1.1 .
For a NetBackup Appliance primary server, upgrade to appliance version 5.0 or later. See the Veritas NetBackup Appliance Upgrade Guide.
For a traditional NetBackup primary server, upgrade to version 10.0 or later. See the Veritas NetBackup Upgrade Guide.
Before you start the migration, collect the following information about the existing Cloud Catalyst appliance and any new information as needed for the migrated MSDP direct cloud tier storage server. Use the right column in the table to enter the information.
Table: Data for pre-migration tasks
Item | Configuration data |
---|---|
Cloud Catalyst appliance hostname | |
Admin login credentials to elevate to maintenance mode | |
Cloud Catalyst storage server name | |
Cloud Catalyst bucket or container name | |
KMS configuration/KMS Key Group Name | |
Name to use for the new disk volume for the migrated MSDP direct cloud tier storage server | |
Name to use for the new disk pool for the migrated MSDP direct cloud tier storage server | |
Your cloud credentials | |
Other cloud-specific configuration information | |
List of policies and SLPs, that currently write to the Cloud Catalyst storage server |
After you have completed collecting the information above, do the following:
Create a NetBackupCLI user with administrator privileges on the associated appliance primary server and on the appliance media server.
Sign in to the Veritas Download Center to obtain one of the following hot fixes (EEBs), based on the current software version on your Cloud Catalyst appliance:
NBAPP_EEB_ET4063815-5.0.0-1.x86_64.rpm
(for software versions 3.2)NBAPP_EEB_ET4063818-5.0.0-1.x86_64.rpm
(for software version 3.3.0.1)Note:
Hot fixes are not available for Cloud Catalyst appliances that use software versions earlier than 3.2. Before you can perform the migration for those appliances, you must first upgrade them to version 3.2 or 3.3.0.1.
After you have manually performed the initial pre-migration steps in the following task, hot fix installation performs the remaining pre-migration steps.
The following procedure describes the pre-migration tasks.
To perform the pre-migration steps
- Stop all jobs on the Cloud Catalyst appliance as follows.
Deactivate all backup policies that write to the Cloud Catalyst storage server.
Deactivate all storage lifecycle policies (SLPs) that write to the Cloud Catalyst storage server.
Verify all active jobs that are targeted for the Cloud Catalyst storage server have been stopped.
- Log in to the primary appliance server as a NetBackupCLI Administrator and run the following command to clean up the NetBackup catalog:
bpimage -cleanup -allclients -prunetir
For a traditional NetBackup primary server, log in to the NetBackup Administration Console to run the command.
- To complete the pre-migration steps on the Cloud Catalyst appliance, install the EEB that you downloaded from the Vertias Download Center (in Task 3) and respond to the prompts as they appear.
You can either deploy and configure a new NetBackup Virtual Appliance 5.0 media server or upgrade an existing NetBackup Virtual Appliance media server to version 5.0.
To perform the configuration tasks
- Remove the Cloud Catalyst appliance from the primary server.
- Deploy a NetBackup Virtual Appliance 5.0 media server or upgrade an existing NetBackup Virtual Appliance media server to version 5.0. The appliance must be managed by the same primary server as the Cloud Catalyst appliance. Make sure the primary server has an adequate amount of space for the MSDP partition.
- If the appliance was previously configured for KMS, make sure to configure it.
Note:
Upgraded appliances do not require reconfiguration of KMS or other enabled features.
- After completing the configuration, log in to the appliance shell menu and run the following command to reset the storage:
Support > Storage Reset
- Log in to the NetBackup Web UI and delete the PureDisk storage unit and disk pool on the media server.
Caution:
Do not perform a factory reset after you configure the new media server.
After the deployment of a new NetBackup Virtual Appliance media server or an upgrade of a NetBackup Virtual Appliance media server to 5.0, you are ready to perform the migration.
Note:
The actual time to complete this task can vary, depending on the cloud provider involved and the available network bandwidth for downloading from the cloud. Most migrations should finish within 24 hours, and many require much less than 24 hours. However, in some cases it may take longer.
To perform the migration steps
- Log in to the newly deployed or upgraded appliance as a NetBackupCLI Administrator and run the following command:
bpnbat -Login -loginType WEBUI -requestApproval
- To start the migration process, run the following command:
sudo /usr/openv/netbackup/bin/admincmd/nbdecommission -migrate_cloudcatalyst
- Monitor the migration and provide the following information or responses when prompted to do so:
The line number of the Cloud Catalyst server to migrate
Cloud bucket name
Cloud Catalyst server hostname
Indicate if MSDP KMS encryption is enabled for
cloudcatalyst_server_name
.New disk volume name for the migrated Cloud Catalyst server
New disk pool name for the migrated Cloud Catalyst server
Cloud account username or access key
Cloud account password or secret access key
Indicate if you want to migrate
cloudcatalyst_server_name
to the new MSDP cloud server.Verify that no jobs are currently running on the Cloud Catalyst server.
Decide if you wish to skip migrating Cloud Catalyst image sharing information.
Select how to handle the SLP-controlled images that are in-process or yet to be processed. Options are displayed.
Select how to delete the Cloud Catalyst disk pool, storage unit, and storage server, or how to deactivate the policies that reference the Cloud Catalyst storage unit. Options are displayed.
Immediately after the migration process has completed successfully, perform the following tasks:
After the migration process has completed successfully
- Log in to the appliance (image sharing server) as a NetBackupCLI Administrator and run the following command, and then restart the appliance:
cacontrol --catalog buildcloudcatalystobjects <new_disk_volume_name>
For details about this command, see the Veritas NetBackup Deduplication Guide, Appendix B.
- Create a new storage unit for this disk pool that was created during the migration through the NetBackup Web UI. Use the new storage unit as the destination for your policies and SLPs through the NetBackup Java Console.
- Re-enable any existing policies and SLPs that previously wrote to the migrated Cloud Catalyst server, as the migration process disables these policies.
- Optional step: To clean up any unused Cloud Catalyst objects from the cloud bucket, log in to the media server appliance as a NetBackupCLI user and run the following command:
cacontrol --catalog cleanupcloudcatalystobjects <new_disk_volume_name>
For details about this command, see the Veritas NetBackup Deduplication Guide, Appendix B.