<admin_dir_path>bpplschedrep policy_name sched_label [ -M master_server,...] [-v] [-generation generation] [-st sched_type] [-freq backup_frequency] [-mpxmax mpx_factor] [-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|l] [-delweekday day_name week] [-deldayomonth 1-31|l] [-ci] [-ce] [-cw] [-cd] [-number_copies number][-rl retention_level[,rl-copy2,...]] [-fail_on_error 0|1[,0|1,...,0|1]] [-residence storage_unit_label [,stunit_copy2,...]] [-pool volume_pool_label [,pool_copy2,...]] [-sg share_group [,share_copy2,...]] [-(0..6) start duration] [-res_is_stl 0|1]
bpplschedrep changes the attributes of a NetBackup schedule. The schedule and policy that bpplschedrep names should already exist when this command is run. If the -M option is used, bpplschedrep changes the schedule on each of the listed master servers.
Any authorized user can initiate this command.
For more information about NetBackup authorization, refer to the NetBackup Security and Encryption Guide.
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 time 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. This unit is a non-negative integer.
Indicates whether bpplschedrep follows a calendar-based schedule or a frequency-based schedule.
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
Specifies a day of every month to exclude 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. This command can only remove the dates that were added by using the -dayomonth command.
For example, to exclude the 20th day of every month from the schedule, enter:
-deldayomonth 20
Specifies a day of the week and the week of the month to exclude as a run day from the schedule. This command can only remove the dates that were added by using the -weekday command.
The day_name is: Sunday, Monday, Tuesday, Wednesday, Thursday, 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
Indicates to delete this single date. This command can only remove the dates that were added by using the -incl command.
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.
The backup frequency controls 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.
Ensures that the command acts on a specific generation or version of a policy. The generation value increments each time a policy is saved. Use bpplinfo or bppllist to list the current generation value. If no generation is indicated, the command acts on the current version.
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 bpplschedrep command. Each master server in the list must allow access by the system that issued the bpplschedrep command. If an error occurs for any master server, the process terminates at that point.
The schedule attributes is modified on all the master servers in this list.
The maximum multiplexing factor for this schedule. Multiplexing sends concurrent, multiple backups from one or several clients to a single drive.
The multiplexing factor can range from 1 through 8 for the NetBackup Server and 1 through 32 for the NetBackup Enterprise Server. A value of 1 specifies no multiplexing and a value greater than one means that NetBackup should create multiplexed images on the destination media. The multiplexing factor should be less than or equal to the multiplexing factor for the storage unit.
For more information on multiplexing, refer to the multiplexing topic in the NetBackup Administrator's Guide.
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.
The name of the policy that contains the schedule. This policy has been previously created.
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.
To display the configured volume pools, run the following command:
Windows systems: install_path\Volmgr\bin\vmpool -listall
Identifies that the data in the storage unit is storage lifecycle.
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 and overrides the residence for the policy.
Specifies how long NetBackup retains the backups that it creates by using this schedule. Valid retention levels and their corresponding default retention times are listed later in this description.
Specify a retention level for each copy.
Otherwise, backups can expire sooner than you expect, which results in loss of data.
0 |
1 week |
1 |
2 weeks |
2 |
3 weeks |
3 |
1 month |
4 |
2 months |
5 |
3 months |
6 |
6 months |
7 |
9 months |
8 |
1 year |
9 - 24 |
infinite |
NetBackup keeps the information about the backups for the specified time. Then it deletes information about them. When the information is deleted, the files in the backups are unavailable for restores. When all the backups on a volume have expired, the volume can be reassigned.
Specifies the name of the schedule to be changed. This schedule has been previously created.
Specifies the share group(s) for the schedule. Do not use this option if the schedule resides on a disk storage unit. If *NONE* is specified, the writing media server owns the media that this policy writes. If *ANY* is specified, EMM chooses the media owner. *ANY* is the default value. Otherwise, the named share group owns the media. Specify a share group for each copy to display the configured share groups. Enter the following:
Windows systems: install_path\NetBackup\bin\admincmd\nbsvrgrp -list -summary
Specifies the type of backup this schedule performs. Schedule types fall into either an automatic or user category. Automatic schedules define the windows during which the NetBackup scheduler can initiate a backup for this policy.
User schedules define the windows during which a user can initiate a backup or archive.
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, Tuesday, Wednesday, Thursday, Friday, or Saturday.
The week is the number of the week in the month.
For example, to instruct the policy to run the second Monday of the month, enter:
-weekday Monday 2
Selects the verbose mode. This option causes bpplschedrep 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
Set the frequency for a schedule.
# bpplschedrep mkbpolicy incr -freq 604800
This sets to one (1) week the frequency with which automatic backups are performed for the schedule incr in policy mkbpolicy.
For Saturday and Sunday of each week, have the window for schedule full in policy mkbpolicy open at 10 p.m. instead of 11 p.m. Also, set the window duration to two (2) hours instead of one (1) hour. bpplschedrep resets the windows, and bpplsched lists the new schedule values.
# bpplschedrep newpolicy full -0 79200 7200 -6 79200 7200 # bpplsched newpolicy -U -label full Schedule: full 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