|
|
<admin_dir_path>bpchangeprimary -copy number | -pool volume_pool | -group volume_group [-id backup_id] [-M master_server]
The bpchangeprimary command lets you change which copy is the primary copy for a set of backup images. You can choose the copy to be promoted to primary by specifying a copy number, volume pool, or volume group. You can apply several optional criteria to identify the backup images to be affected.
The primary copy of a backup is the copy used by a restore process. Ensure that the primary copy is accessible for restore. For instance, if one copy of a backup was sent off site, change the primary copy to be the copy that remains on site.
The bpchangeprimary command finds all backups that match the specified criteria and updates their copy number to primary.
If you use the -copy option, the specified copy number becomes the primary copy. If you use the -group or -pool option, the process identifies all media IDs that belong to the specified volume group or volume pool. It then changes all copies that reside on those media to primary.
One and only one of the following three options is required:
Specifies that the number of the backup copy you want to promote to primary.
Specifies that the copy on the media that belongs to volume_pool is to be promoted to primary.
Specifies that the copy on the media that belongs to volume_group is to be promoted to primary.
You can apply combinations of one or more of the following optional criteria to specify which copies are made primary.
Specifies that backups of client_name are affected. This name must be as it appears in the NetBackup catalog. For those backup images, this option promotes the copy that corresponds to the specified -pool, -group, or -copy option to primary. The default is all clients.
Specifies the start date (-sd) or end date (-ed) of the backup images for which the primary copy is changed.
The required date and
time values format in NetBackup commands varies according to your
locale. The /user/openv/msg/.conf
file (UNIX and Linux) and the install_path\VERITAS\msg\LC.CONF file
(Windows) contain data such as the date-time formats for each
supported locale. The files contain instructions on how to add or
modify the list of supported locales and formats.
See the "Specifying the locale of the NetBackup installation" topic in the NetBackup Administrator's Guide, Volume II.
The default start date is January 1, 1970, which effectively causes a search for all images. If you run bpchangeprimary without using the -sd option, the following occurs: You are prompted for a confirmation that you want to change the primary copy for the backups that were created after January 1, 1970. The default end date is the current date. The valid range of dates is from 01/01/1970 to 01/19/2038.
Specifies the backup ID of the backup image for which the primary copy is changed. For that backup image, -id backup_id changes the copy that corresponds to the specified -pool, -group, or -copy option.
If you specify this option, you can specify an alternate master server (by using the -M option). You must specify one of -pool, -group, or -copy. No other options are used with -id.
Specifies a keyword phrase for NetBackup to use when you identify backup images for which the primary copy is changed.
Specifies that the backups that belong to master_server are affected. For those backup images, -M master_server promotes the copy that corresponds to the specified -pool, -group, or -copy option to primary.
If you use this option, any other options you specify determine which backup images on the specified master server are affected. The server must allow access by the system that issues the bpchangeprimary command. The default is the master server for the system that runs the bpchangeprimary command.
Specifies the name of the backup policy of the backups for which the primary copy is changed. The default is all policies.
Specifies the type of the backup policies of the backups for which the primary copy is changed. The default is all policy types.
The policy_type is one of the following character strings:
The following policy types apply only to NetBackup Enterprise Server:
Specifies the schedule name (label) for the selection of the backup images for which the primary copy is changed. By default, the bpchangeprimary command uses all schedules.
Specifies the schedule type for the selection of the backup images for which the primary copy is changed. By default, bpchangeprimary uses any schedule type. Valid values are as follows:
INCR (differential-incremental backup)
The following command
promotes all copies on the media that belongs to the volume pool
SUN created after 08/01/2009 to be
the primary copy.
bpchangeprimary -pool SUN -sd 08/01/2009
The following command promotes copy 2 of all backups of client, oak, created after 01/01/2010 to be the primary copy:
bpchangeprimary -copy 2 -cl oak -sd 01/01/2010
The following command
promotes copy 4 of all backups that the backup policy Offsite created after 08/01/2009 to be the
primary copy:
bpchangeprimary -copy 4 -pn Offsite -sd 08/01/2009