Server Scheduling Settings
This section describes scheduling settings of the backup job in the Server edition of Veeam Agent for Microsoft Windows.
- General settings
- Daily scheduling settings
- Monthly scheduling settings
- Periodical scheduling settings
- Continuous scheduling settings
- Active full backup settings
- Health check settings
- Backup file compact settings
- Job retry settings
- Backup window settings
Parent Tag | Parameter | Description |
---|---|---|
ScheduleInfo | Parent tag that encapsulates information about scheduling settings. | |
| RunManually | Parameter specifies if the backup job must be run manually or started automatically by schedule. Possible values:
|
| Type | Type of job schedule. Possible values:
|
| UseBackupWindow | Parameter describes if the backup window is set for the backup job. Possible values:
If you set this parameter to True, you must specify backup window settings. |
| CompletionMode | Action that is performed when the backup job is complete. Possible values:
|
| AtStorageAttach | Parameter describes if the backup job must start when the backup target is connected to the computer — external target disk is attached, shared folder becomes accessible and so on. Possible values:
|
| ResumeMissedBackup | Parameter describes what actions Veeam Agent for Microsoft Windows must perform if the machine was powered off when backup was scheduled, and the backup was missed. Possible values:
|
| AtLock | Parameter describes if the backup job must start when the user locks the computer. Possible values:
|
| AtLogOff | Parameter describes if the backup job must start when the user performs the logoff operation. Possible values:
|
| EjectRemovableStorage | Parameter describes if Veeam Agent for Microsoft Windows must eject the removable storage (backup target) when the backup job session completes. Possible values:
IMPORTANT! You must explicitly define a value in the EjectRemovableStorage |
| LimitBackupsFrequency | Parameter limiting the frequency of backup job sessions in the specified interval. Possible values:
|
| MaxBackupsFrequency | This parameter is used only if you have selected to limit the frequency of backup job sessions. Time interval (in minutes, hours or days) during which a new backup job session must not be started, for example, 30. |
| FrequencyTimeUnit | This parameter is used only if you have selected to limit the frequency of backup job sessions. Units of time for the time interval limiting the frequency of backup job sessions. Possible values:
|
Parent Tag | Parameter | Description |
---|---|---|
DailyInfo | Parent tag that encapsulates information about daily scheduling settings. | |
| Kind | Days of week on which the backup job must run. Possible values:
|
| Days | This parameter is used only if you set the Kind parameter value to 2. List of days on which you want to run the backup job. Possible values:
Entries in the list are separated with a comma followed by a space (, ), for example: Days="Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday". |
| Time | Time at which the backup job must start. The time is specified in the following format: hh:mm. |
Parent Tag | Parameter | Description |
---|---|---|
MonthlyInfo | Parent tag that encapsulates information about monthly scheduling settings. | |
| Months | List of months on which the backup job must run. Possible values:
Entries in the list are separated with a comma, for example: Months="January, February, March, April, May, June, July, August, September, October, November, December". |
| DayOfWeek | This parameter is used if you want to run the backup job on the Nth day of the Nth week in the month. Day on which the backup job must run. Possible values:
|
| Week | This parameter is used if you want to run the backup job on the Nth day of the Nth week in the month. Numerical order of the week on which you want to run the backup job. Possible values:
If you set the Week parameter value to 6, you must also specify the DayOfMonth parameter value. |
| DayOfMonth | This parameter is used if you want to run the backup job on a specific date. Date in a month on which you want to run the backup job. Possible values: 1-30 (or 1-31, depending on the month length) and 32 — the last day of the month. For example, if you want to run the backup job on the 24th of every month, you must set the DayOfMonth parameter to 24; if you want to run the job on the last day of every month, you must set the DayOfMonth parameter to 32; |
| Time | Time at which the backup job must start. The time is specified in the following format: hh:mm. |
Periodical Scheduling Settings
Parent Tag | Parameter | Description |
---|---|---|
PeriodicallyInfo | Parent tag that encapsulates information about periodical scheduling settings. | |
| Time | Periodicity with which the backup job must start. The time interval for periodicity is specified in the following format: hh:mm. For example, if you want to run the backup job every 30 minutes, you must set the Time parameter to 00:30. If you want to run the backup job every 2 hours, you must set the Time parameter to 02:00. |
Schedule | Parent tag that encapsulates information about periodic job schedule. | |
| Minutes | Exact time within an hour when the backup job must start. For example, if you want to run the backup job every hour and start on the 30th minute of the hour, for example, at 1:30 AM, 2:30 AM, 3:30 AM, 4:30 AM and so on, you must set the Time parameter to 001:00 and Minutes parameter to 30. |
| Kind | This parameter is used if you specify permitted or prohibited hours for the backup job. Method of setting permitted hours for the backup job. Possible values:
|
Days | This tag is used if you specify permitted or prohibited hours for the backup job. Parent tag that encapsulates information about permitted or prohibited hours for the backup job. | |
| <Weekday> Intervals | This tag is used if you specify permitted or prohibited hours for the backup job. Intervals of permitted or prohibited hours for the backup job. Intervals of hours are specified for every week day in the following format: <<Weekday> Intervals="10-12, 22-24"/>. You can specify several intervals separated with a comma followed by a space (, ). For example: <Days> <Monday Intervals="06-08, 18-20"/> <Tuesday Intervals="06-08, 18-20, 22-24"/> </Days> NOTE! If there are more prohibited hours intervals than permitted hours intervals, Veeam Agent Configurator will export information about prohibited hours when you run the SaveConfiguration command, and vice versa. |
Continuous Scheduling Settings
Parent Tag | Parameter | Description |
---|---|---|
ContinuouslyInfo | Parent tag that encapsulates information about continuous scheduling settings. | |
| Schedule | This tag is used if you specify permitted or prohibited hours for the backup job. Parent tag that encapsulates information about permitted and prohibited hours set for the backup job. |
| Kind | This parameter is used if you specify permitted and prohibited hours set for the backup job. Method of setting permitted hours for the backup job. Possible values:
|
Days | This tag is used if you specify permitted or prohibited hours for the backup job. Parent tag that encapsulates information about permitted or prohibited hours for the backup job. | |
| <Weekday> Intervals | This tag is used if you specify permitted or prohibited hours for the backup job. Intervals of permitted or prohibited hours for the backup job. The interval of hours is specified for every week day in the following format: <<Weekday> Intervals="10-12, 22-24"/>. You can specify several intervals separated with a comma followed by a space (, ). For example: <Days> <Monday Intervals="06-08, 18-20"/> <Tuesday Intervals="06-08, 18-20, 22-24"/> </Days> NOTE! If there are more prohibited hours intervals than permitted hours intervals, Veeam Agent Configurator will export information about prohibited hours when you run the SaveConfiguration command, and vice versa. |
Parent Tag | Parameter | Description |
---|---|---|
ActiveFull | Parent tag that encapsulates information about active full backups created with the backup job. | |
| Enabled | Parameter specifies if the backup job must periodically create active full backups. Possible values:
|
| Kind | Mode in which the backup job creates active full backups. Possible values:
|
DailyInfo | This parameter is used if you want to create active full backups on specific days of week. Parent tag that encapsulates information about daily settings for active full backups. | |
| Days | This parameter is used if you want to create active full backups on specific days of week. List of days on which the backup job must create active full backups. Possible values:
Entries in the list are separated with a comma followed by a space (, ), for example: Days="Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday". |
MonthlyInfo | This parameter is used if you want to create active full backups on a specific day every month. Parent tag that encapsulates information about monthly settings for active full backups. | |
| Months | This parameter is used if you want to create active full backups on a specific day every month. List of months on which the backup job must create active full backups. Possible values:
Entries in the list are separated with a comma followed by a space (, ), for example: Months="January, February, March, April, May, June, July, August, September, October, November, December". |
| DayOfWeek | This parameter is used if you want to create active full backups on a specific day every month. Day on which the backup job must create an active full backup. Possible values:
|
| Week | This parameter is used if you want to create active full backups on a specific day every month. Numerical order of week on which the backup job must create an active full backup. Possible values:
|
Parent Tag | Parameter | Description |
---|---|---|
HealthCheck | Parent tag that encapsulates information about health checks of the latest restore point in the backup chain. | |
| Enabled | Parameter specifies if Veeam Agent for Microsoft Windows must perform heath checks of the latest restore point in the backup chain. Possible values:
|
DailyInfo |
| This parameter is used if you want to perform health checks on specific days of week. Parent tag that encapsulates information about daily settings for health checks. |
| Days | This parameter is used if you want to health checks on specific days of week. List of days on which Veeam Agent for Microsoft Windows must perform health checks of the latest restore point in the backup chain. Possible values:
Entries in the list are separated with a comma followed by a space (, ), for example: Days="Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday". |
MonthlyInfo |
| This parameter is used if you want to perform health checks on a specific day every month. Parent tag that encapsulates information about monthly settings for health checks. |
| Months | This parameter is used if you want to perform health checks on a specific day every month. List of months on which Veeam Agent for Microsoft Windows must perform health checks of the latest restore point in the backup chain. Possible values:
Entries in the list are separated with a comma followed by a space (, ), for example: Months="January, February, March, April, May, June, July, August, September, October, November, December". |
| DayOfWeek | This parameter is used if you want to perform health checks on a specific day every month. Day on which Veeam Agent for Microsoft Windows must perform health checks of the latest restore point in the backup chain. Possible values:
|
| Week | This parameter is used if you want to perform health checks on a specific day every month. Numerical order of week on which Veeam Agent for Microsoft Windows must perform health checks of the latest restore point in the backup chain. Possible values:
|
Health Check Options Settings
Parent Tag | Parameter | Description |
---|---|---|
HealthCheckOptions | Parent tag that encapsulates information about health check options. | |
| EnableSimpleObjectStorageRecheck | [For object storage] Parameter specifies if the special health check mechanism for object storage is enabled.
|
Parent Tag | Parameter | Description |
---|---|---|
Compact | Parent tag that encapsulates information about defragment and compact operations of the full backup file. | |
| Enabled | Parameter specifies if Veeam Agent for Microsoft Windows must perform defragment and compact operations of the full backup file. Possible values:
|
DailyInfo |
| This parameter is used if you want to perform defragment and compact operations on specific days of week. Parent tag that encapsulates information about daily settings for defragment and compact operations. |
| Days | This parameter is used if you want to perform defragment and compact operations on specific days of week. List of days on which Veeam Agent for Microsoft Windows must perform defragment and compact operations. Possible values:
Entries in the list are separated with a comma followed by a space (, ), for example: Days="Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday". |
MonthlyInfo |
| This parameter is used if you want to perform defragment and compact operations on a specific day every month. Parent tag that encapsulates information about monthly settings for defragment and compact operations. |
| Months | This parameter is used if you want to perform defragment and compact operations on a specific day every month. List of months on which Veeam Agent for Microsoft Windows must perform defragment and compact operations. Possible values:
Entries in the list are separated with a comma followed by a space (, ), for example: Months="January, February, March, April, May, June, July, August, September, October, November, December". |
| DayOfWeek | This parameter is used if you want to perform defragment and compact operations on a specific day every month. Day on which Veeam Agent for Microsoft Windows must perform defragment and compact operations. Possible values:
|
| Week | This parameter is used if you want to perform defragment and compact operations on a specific day every month. Numerical order of week on which Veeam Agent for Microsoft Windows must perform defragment and compact operations. Possible values:
|
Parent Tag | Parameter | Description |
---|---|---|
RetryInfo | Parent tag that encapsulates information about job retry settings. | |
| Enabled | Parameter specifies if Veeam Agent for Microsoft Windows must automatically retry the backup job if the job fails. Possible values:
|
| Times | Number of times for which Veeam Agent for Microsoft Windows must retry a backup job. By default, Veeam Agent for Microsoft Windows retries the backup job 3 times. |
| TimeoutMinutes | Time interval between job retries in minutes. By default, the time interval is 10 minutes. NOTE! the TimeoutMinutes parameter is not applicable if the backup job runs continuously. In this case, Veeam Agent for Microsoft Windows will retry the job without any time intervals. |
Parent Tag | Parameter | Description |
---|---|---|
BackupWindow | Parent tag that encapsulates information about the backup window set for the job. If the backup job exceeds the specified window, the job will be terminated. | |
| Kind | Method of setting the backup window. Possible values:
|
Days | Parent tag that encapsulates information about the backup window for the backup job. | |
| <Weekday> Intervals | Intervals of permitted or prohibited hours for the backup job. The interval of hours is specified for every week day in the following format: <Monday Intervals="10-12, 22-24"/>. You can specify several intervals separated with a comma followed by space (, ). For example: <Days> <Monday Intervals="06-08, 18-20"/> <Tuesday Intervals="06-08, 18-20, 22-24"/> </Days> NOTE! If there are more prohibited hours intervals than permitted hours intervals, Veeam Agent Configurator will export information about prohibited hours when you run the SaveConfiguration command, and vice versa. |
Example 1
You want to run the backup job continuously with the following schedule:
- At weekend, the backup job can start any time.
- On week days, the backup job must not start between 6:00 AM to 6:00 PM.
The input XML file will contain the following parameters:
<ExecutionResult> |
Example 2
You want to run the backup job daily at 12:00 AM, and set up the following backup window for the job:
- At weekend, the backup job can run any time.
- On Monday through Thursday, the backup job must not run between 6:00 AM to 6:00 PM.
- On Friday, the backup job must not run between 6:00 AM and 4:00 PM.
The input XML file will contain the following parameters:
<ExecutionResult> |