bpschedulerep

bpschedulerep — modify attributes of disk staging storage unit (DSSU) schedule

SYNOPSIS

<admin_dir_path>bpschedulerep sched_label [ -M master_server,...] [-v] [-freq backup_frequency] [-stage_priority number] [-altreadhost hostname] [-cal 0|1|2] [-incl mm/dd/yyyy] [-excl mm/dd/yyyy] [-delincl mm/dd/yyyy] [-delexcl mm/dd/yyyy] [-weekday day_name week] [-dayomonth 1-31 | 1] [-delweekday day_name week] [-deldayomonth 1-31 | 1] [-ci] [-ce] [-cw] [-cd] [-number_copies number] [-fail_on_error 0|1[,0|1,...,0|1]] [-residence storage_unit_label [,stunit-copy2,...]] [-pool volume_pool_label [,pool-copy2,...]] [-(0..6) start duration]

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

DESCRIPTION

bpschedulerep changes the attributes of a NetBackup disk staging storage unit (DSSU) schedule. The schedule that bpschedulerep named should already exist when this command is run. bpschedulerep changes the schedule on each of the master servers that are listed, if the -M option is used.

Any authorized user can initiate this command.

For more information about NetBackup authorization, refer to the NetBackup Security and Encryption Guide.

OPTIONS

-(0..6) start duration

Specifies the window during which NetBackup can run the backups for this schedule. This window applies to a specific day of the week. 0 corresponds to Sunday, 1 to Monday, and so on.

start is the time at which the backup window opens for this schedule. This number is the number of seconds since midnight. It is an integer between 0 and 86400 (the number of seconds in a day).

duration is the length of time that the window remains open. The time unit is seconds. It is a non-negative integer.

-cal 0|1|2

Indicates whether bpschedulerep follows a calendar-based schedule or a frequency-based schedule.

0 = frequency-based schedule

1 = calendar-based schedule with no retries after run day

2 = calendar-based schedule with retires after run day

-dayomonth 1-31 | 1

Specifies the day of every month to run the schedule. Enter l (lowercase L) to run the last day of every month, whether the month contains 28, 29, 30, or 31 days.

For example, to run the schedule the 15th day of every month, enter:

-dayomonth 15

To run the last day of every month, enter:

-dayomonth l
-deldayomonth 1-31 | 1

Specifies a day of every month to be excluded as a run day. Enter 1 (lowercase L) to exclude the last day of every month, whether the month contains 28, 29, 30, or 31 days.

For example, to exclude the 10th of every month from the schedule, enter:

-deldayomonth 20
-delweekday day_name week

Specifies a day of the week and the week of the month to be excluded as a run day from the schedule.

The day_name is: Sunday, Monday, ..., Friday, or Saturday.

The week is the number of the week in the month.

For example, to exclude the second Monday of the month, enter:

-delweekday Monday 2
-excl mm/dd/yyyy

Indicates to exclude this single date.

-delincl mm/dd/yyyy

Indicates to delete this single date.

-delexcl mm/dd/yyyy

Indicates to delete this single date.

-ci

Clears all specific include dates.

-ce

Clears all specific exclude dates.

-cw

Clears all week days.

-cd

Clears all days of a month.

-fail_on_error 0|1[,0|1,...,0|1]

Specifies whether to fail all other copies if one copy fails. If no parameter is specified, 0 is default for all copies. Specify a value for each copy.

0 = Do not fail the other copies

1 = Fail other copies

-freq backup_frequency

Specifies how much time can elapse between successful automatic backups for clients on this schedule. Frequency does not apply to user schedules because the user can perform a backup or archive any time the backup window is open. This value is a positive integer that represents the number of seconds between successful automatic backups for this schedule.

-help

Prints a command-line usage message.

-incl mm/dd/yyyy

Indicates to include this single date.

-M master_server,...

A list of alternative master servers. This list is a comma-separated list of hostnames. If this option is present, each master server in the list runs the bpschedulerep command. Each master server in the list must allow access by the system that issued the bpschedulerep command. If an error occurs for any master server, the process terminates at that point.

The schedule attributes are modified on all the master servers in this list.

-number_copies number

Specify the number of simultaneous backup copies. The minimum value is 1. The maximum value is 4 or the Maximum backup copies global parameter, whichever is smaller. The default is 1.

-pool volume_pool_label[,pool-copy2,...]

Specifies the volume pool(s) for the schedule. Do not use this option if a disk storage unit is the residence for the schedule. If "*NULL*" is specified, the volume pool for the schedule is the volume pool of the policy that contains this schedule.

Specify a pool for each copy.

To display the configured volume pools, run the following command:

On Windows systems: install_path\Volmgr\bin\vmpool -listall
-residence storage_unit_label[,stunit-copy2,...]

Specifies the label(s) of the storage unit to be used for storing the backups that were created according to this schedule. If "*NULL*" is specified, the residence for the schedule defaults to the residence of the policy that contains this schedule. If the residence value is a storage unit label, the residence for the schedule becomes that storage unit; it overrides the residence for the policy.

Specify a storage unit for each copy.

Run bpstulist to display the set of defined storage units.

-stage priority number

The order in which storage units are to be selected within a storage unit group:

1 = Use the storage units in the order that appears in the storage unit group dialog box (default).

2 = Use the storage unit least recently used. (The storage units take turns.)

3 = Use the first storage unit in the list that is not full or down. If the storage unit is only busy, the policy waits to write to it.

-altreadhost hostname

The server to be used to read a backup image that a different media server originally wrote.

sched_label

The name of the previously created schedule to be changed.

-weekday day_name week

Specifies a day of the week, and the week of the month, as a run day in the schedule.

The day_name is: Sunday, Monday, ..., Friday, or Saturday.

The week is the number of the week in the month.

For example, to instruct the policy to run the third Monday of the month, enter:

-weekday Monday 3
-v

Selects the verbose mode. This option causes bpschedulerep to log additional information for debugging purposes. The information goes into the NetBackup administration daily debug log. This option is meaningful only when NetBackup enables the debug log function (that is, when the following directory is defined):

Windows systems: install_path\NetBackup\logs\admin

EXAMPLES

EXAMPLE 1

Change and schedule named test.

# bpschedulerep test -cal 2

The following is received after the change and a bpschedule -label test listing.

SCHED test 0 1 604800 1 0 0 0 *NULL* 0 2 0 0 0 
SCHEDWIN 0 0 0 0 0 0 0 0 0 0 0 0 0 0
SCHEDRES *NULL* *NULL* *NULL* *NULL* *NULL* *NULL* *NULL* *NULL*
SCHEDPOOL *NULL* *NULL* *NULL* *NULL* *NULL* *NULL* *NULL* *NULL*
SCHEDRL 1 1 1 1 1 1 1 1 
SCHEDFOE 0 0 0 0 0 0 0 0

EXAMPLE 2

For Saturday and Sunday of each week, have the window for schedule test open at 10 p.m. instead of 11 p.m. Also, have the window duration be two (2) hours instead of one (1) hour. bpschedulerep resets the windows, and bpschedule lists the new schedule values.

# bpschedulerep test -0 79200 7200 -6 79200 7200
bpschedule -U -label test
Schedule:		test
  Type:			Full Backup
  Frequency:	 every 7 days
  Retention Level: 1 (2 weeks)
  Maximum MPX:	 1
  Residence:	 (specific storage unit not required)
  Volume Pool:	 (same as policy volume pool)
  Daily Windows:
		Sunday	 22:00:00  -->  Sunday	 24:00:00
		Monday	 23:00:00  -->  Monday	 24:00:00
		Tuesday	23:00:00  -->  Tuesday	24:00:00
		Wednesday  23:00:00  -->  Wednesday  24:00:00
		Thursday   23:00:00  -->  Thursday   24:00:00
		Friday	 23:00:00  -->  Friday	 24:00:00
		Saturday   22:00:00  -->  Saturday   24:00:00

FILES

Windows systems:

install_path\NetBackup\logs\admin\*
install_path\NetBackup\db\sched\schedule name

SEE ALSO

bpschedule