bpchangeprimary

bpchangeprimary — promote a copy of a backup to be the primary copy

SYNOPSIS

<admin_dir_path>bpchangeprimary -copy number | -pool volume_pool | -group volume_group [-id backup_id] [-M master_server]

<admin_dir_path>bpchangeprimary -copy number | -pool volume_pool | -group volume_group [-sl schedule_name] [-pn policy_name] [-st schedule_type] [-pt policy_type] [-cl client_name] [-kw keyword] [-sd date time] [-ed date time] [-M master_server]

On Windows systems, <admin_dir_path> is <install_path>\NetBackup\bin\admincmd\

DESCRIPTION

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.

OPTIONS

One and only one of the following three options is required:

-copy number

Specifies that the number of the backup copy you want to promote to primary.

-pool volume_pool

Specifies that the copy on the media that belongs to volume_pool is to be promoted to primary.

-group volume_group

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.

-cl client_name

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.

-sd date time, -ed date time

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.

-id backup_id

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.

-kw keyword

Specifies a keyword phrase for NetBackup to use when you identify backup images for which the primary copy is changed.

-M master_server

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.

-pn policy_name

Specifies the name of the backup policy of the backups for which the primary copy is changed. The default is all policies.

-pt policy_type

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:

Informix-On-BAR

MS-Exchange-Server

MS-SQL-Server

MS-Windows

NetWare

Oracle

OS/2

Standard

Sybase

NDMP

The following policy types apply only to NetBackup Enterprise Server:

AFS

Auspex-FastBackup

DataTools-SQL-BackTrack

DB2

Enterprise-Vault

FlashBackup

SAP

Split-Mirror

-sl schedule_name

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.

-st schedule_type

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:

FULL (full backup)

INCR (differential-incremental backup)

CINC (cumulative-incremental backup)

UBAK (user backup)

UARC (user archive)

NOT_ARCHIVE (all backups except user archive)

EXAMPLES

Example 1

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

Example 2

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

Example 3

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