Veritas NetBackup™ Commands Reference Guide
- Appendix A. NetBackup Commands
nbcloudrestore — restores an in-cloud asset using a Perl script.
-master_server host_name -username user -password [password] [-port port_number] [-domainname domain_name -domaintype domain_type] [-source_assetid nb_source_assetid [-filter filter]] [-backupid backup_id] [-destination_assetid destination_assetid] [-recovery_type recovery_type] [ -copy_number copy_number] [-overwrite_existing overwrite_existing] [-recovered_state recovered_state] [-waittime [wait_time]] [-verbose [verbose]]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/goodies/
On Windows systems, the directory path to this command is install_path\NetBackup\bin\goodies
Use the nbcloudrestore command to restore in-cloud assets. The command supports Windows, RedHat Linux, and SUSE Linux master server platforms.
You must use Perl version 5.10 or later. You must also install the Perl modules that are listed on the NetBackup master server before you run the nbcloudrestore command. The modules must also appear in the list of search paths in the include paths (
- -backupid backup_id
Use this option to provide the backup image identifier to use for this recovery. You can obtain the backup ID from the bpimagelist command.or with the
- -copy_number copy_number
Specify the backup copy you want to restore. Valid values are 1 to 10. If not specified, primary copy is used.
- -domainname domain_name
Use this option to provide the domain name for the user that is used to connect to the NetBackup master server.
- -domaintype domain_type
Use this option to provide the domain type for the user that is used to connect to the NetBackup master server. Supported values are:
- -destination_assetid destination_asset_id
Use this option to provide the NetBackup asset identifier for the recovery destination. If not specified, the asset is restored to its original location. This option is currently supported only with the recovery API.
- -filter [filter]
Use this option to select the backup images for recovery based on the specified filter. This option must be used with the source_assetid option. The date range is specified in the format shown: YYYY-MM-DDTHH:MM:SSZ. You can also use ge to specify greater than or equal to, and le for less than or equal to when you specify the filter. The date range must contain a recovery point. Refer to the tab for the asset in the NetBackup web user interface. If more than one backup image matches the filter, NetBackup selects the most recent one.
- -master_server master_server
Use this option to specify the NetBackup master server that is used for running restore jobs.
- -overwrite_existing overwrite_existing
Use this option to overwrite an existing cloud asset. Accepted values for this option are true, which overwrites the original database, and false, which retains the original database. This parameter is optional.
- -password password
Use this option to provide the password for the user that is used to connect to the NetBackup master server. When you provide an empty value for password parameter, you are prompted for the password. For security reasons, the password is not displayed when you enter it at the prompt.
- - port [port_number]
Use this option to provide the port number to connect to the NetBackup master server.
- -recovery_type recovery_type
Specify the recovery type. Valid values are ORIGINAL, ALTERNATE, and ROLLBACK.
- -recovered_state recovered_state
Use this option with the ALTERNATE recovery type to select the recovered state of a database. Valid values are RECOVERED or NOT RECOVERED. This parameter is optional.
- -source_assetid nb_source_asset
Use this option to provide the NetBackup source asset identifier that was used at the time of backup. Recovery is performed using the most recent backup image, unless a filter is specified. You can obtain the source_assetid from the NetBackup web user interface by referring to the list of discovered cloud assets.
- -username username
Use this option to provide the user name to connect to the NetBackup master server.
- -verbose verbose
Use this option to set verbose levels for diagnostics purpose. Supported values are:
1 for minimal
2 for normal (the default value)
3 for detailed
- -wait_time wait_time
Use this option to specify wait time in minutes. NetBackup waits for a completion status for the given duration from the master server before it returns you to the system prompt. If the wait time expires before the operation is complete, the command exits with a time-out status. The operation, however, still completes on the server. If you specify 0 or empty value, the default time-out value of 180 seconds is used.
Example 1: Restore an asset using a source asset ID with a date range.
./nbcloudrestore.pl -master_server example.server.com -username root -password - source_assetid 18e0a55a-6732-40d9-9c98-323fc2975bdc -filter "backupTime ge "2018-05-01T01:01:01Z" and backupTime le "2018-05-31T23:20:50Z""
Example 2 - Restore an asset using the backup ID.
./nbcloudrestore.pl - master_server example.server.com -username root -password - backupid aws-ec2-ap-south-1-i-02df039d2b6867a1b_1525946138