Veritas NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
Name
nbplupgrade — upgrade policy type from FlashBackup-Windows to VMware or Hyper-V
SYNOPSIS
[policy_name | -allpolicies] [-vm_force] [-vm_report] [-verbose] [-help]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/
On Windows systems, the directory path to this command is <install_path>\NetBackup\bin\admincmd\
DESCRIPTION
The nbplupgrade utility (CLI) upgrades FlashBackup-Windows policies that were created for VMware or Hyper-V backup. To successfully convert a policy, note the following requirements:
The current policy must not specify a NetBackup pre-7.5 media server or pre-7.5 VMware backup host.
The current policy must not specify any option that requires VMware VCB.
To convert the policy even when the above requirements are not satisfied, use the -vm_force option. This option may require further editing of the converted policy. During conversion, the nbplupgrade utility converts the policy type from FlashBackup-Windows to VMware or Hyper-V as appropriate. It also converts the snapshot method to the new VMware or Hyper-V type as required by the new policy. It retains all other attributes from the original policy and converts them as needed to the new 7.5 policy layout.
This upgrade is necessary only if you want the policy to use the new VMware or Hyper-V features in NetBackup 7.5.
OPTIONS
- -allpolicies
Upgrades all FlashBackup-Windows policies that were created for VMware or Hyper-V backup.
- -help
Lists usage information on the nbplupgrade command.
- policy_name
Performs the upgrade only on the specified policy.
- -verbose
Helps you track the progress of the utility script.
- -vm_force
Before the conversion, the utility checks for incompatibilities such as a policy that is tied to an old media server or an old client. If an incompatibility exists, the utility issues a warning and exits or moves to the next policy if -allpolicies is selected. However, when the -vm_force option is specified, the policy converts despite the compatibility check failure. Use this option with care, because it can cause backup failures for the migrated policy.
- -vm_report
Performs the compatibility checks and reports the results. Note that it does not perform the actual policy conversion. This option is designed to be used only as a migration dry run before you attempt the actual conversion.
-vm_force and -vm_report cannot be used together in the same command.
EXAMPLES
Example 1 - Perform compatibility checks on the mypolicy
policy and report the results. This action is only a dry run of an actual conversion to be run later.
# nbplupgrade mypolicy -vm_report
Example 2 - Perform compatibility checks on all the FlashBackup-Windows policies and report the results. This action is only a dry run of an actual conversion to be run later.
# nbplupgrade -allpolicies -vm_report
Example 3 - Upgrade the policy named mypolicy
.
# nbplupgrade mypolicy
Example 4 - Upgrade all the FlashBackup-Windows policies that were created for VMware or Hyper-V backup.
# nbplupgrade -allpolicies
Example 5 - Upgrade the policy named mypolicy
even if the compatibility check fails.
# nbplupgrade mypolicy -vm_force
Example 6 - Upgrade all the FlashBackup-Windows policies that were created for VMware or Hyper-V backup.even if the compatibility check fails.
# nbplupgrade -allpolicies -vm_force