Help Center
Choose product document...
Veeam Agent for Microsoft Windows 2.0
Configurator Reference

Server Scheduling Settings

This section describes server scheduling settings of the backup job.

General Settings

Parent Tag

Parameter

Description

ScheduleInfo

Parent tag that encapsulates information about scheduling settings.

 

RunManually

Parameter specifying if the backup job must be run manually or started automatically by schedule. Possible values:

  • True — backup job schedule is enabled.
  • False — backup job schedule is disabled. The job must be started manually.

 

Type

Type of job schedule. Possible values:

 

UseBackupWindow

Parameter describing if the backup window is set for the backup job. Possible values:

  • True — backup window is enabled.
  • False — backup window is disabled.

If you set this parameter to True, you must specify backup window settings.

 

Daily Scheduling Settings

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:

  • 0 — backup job runs every day.
  • 1 — backup job runs on week days (all days of the week except Saturday and Sunday).
  • 2 — backup job runs on specific days. If you set the Kind parameter value to 2, you must list days on which you want to run the backup job in the Days parameter.

 

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:

  • Sunday
  • Monday
  • Tuesday
  • Wednesday
  • Thursday
  • Friday
  • Saturday

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.

 

Monthly Scheduling Settings

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:

  • January
  • February
  • March
  • April
  • May
  • June
  • July
  • August
  • September
  • October
  • November
  • December

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:

  • 0 — Sunday
  • 1 — Monday
  • 2 — Tuesday
  • 3 — Wednesday
  • 4 — Thursday
  • 5 — Friday
  • 6 — Saturday

 

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:

  • 1 — first week of month
  • 2 — second week of month
  • 3 — third week of month
  • 4 — fourth week of month
  • 5 — last week of month
  • 6 — backup job runs on a specific date within a month.

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). For example, if you want to run the backup job on the 24th of every month, you must set the DayOfMonth parameter to 24.

 

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: hhh:mm.

For example, if you want to run the backup job every 30 minutes, you must set the Time parameter to 000:30. If you want to run the backup job every 2 hours, you must set the Time parameter to 002:00. If you want to run the backup job every 5 days, you must set the Time parameter to 120: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:

  • 0 —  permitted hours for the backup job are specified.
  • 1 — prohibited hours for the backup job are specified.

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:

  • 0 —  permitted hours for the backup job are specified.
  • 1 — prohibited hours for the backup job are specified.

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.

 

Synthetic Full Backup Settings

Parent Tag

Parameter

Description

SyntheticFull

Parent tag that encapsulates information about synthetic full backups created with the backup job.

 

Enabled

Parameter specifying if the backup job must periodically create synthetic full backups. Possible values:

  • True — backup job creates synthetic full backups.
  • False — backup job does not create synthetic full backups.

 

Days

List of days on which the backup job must create synthetic full backups. Possible values:

  • Sunday
  • Monday
  • Tuesday
  • Wednesday
  • Thursday
  • Friday
  • Saturday

Entries in the list are separated with a comma followed by a space (, ), for example: Days="Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday".

 

Active Full Backup Settings

Parent Tag

Parameter

Description

ActiveFull

Parent tag that encapsulates information about active full backups created with the backup job.

 

Enabled

Parameter specifying if the backup job must periodically create active full backups. Possible values:

  • True — backup job creates active full backups.
  • False — backup job does not create active full backups.

 

Kind

Mode in which the backup job creates active full backups. Possible values:

  • 0 — backup job creates active full backups on specific days of week. If you set the Kind parameter to 0, you must specify the Days parameter.
  • 1 — backup job creates active full backups on a specific day every month. If you set the Kind parameter to 1, you must specify Months, DayofWeek and Week parameters.

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:

  • Sunday
  • Monday
  • Tuesday
  • Wednesday
  • Thursday
  • Friday
  • Saturday

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:

  • January
  • February
  • March
  • April
  • May
  • June
  • July
  • August
  • September
  • October
  • November
  • December

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:

  • 0 — Sunday
  • 1 — Monday
  • 2 — Tuesday
  • 3 — Wednesday
  • 4 — Thursday
  • 5 — Friday
  • 6 — Saturday

 

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:

  • 1 — first week of month
  • 2 — second week of month
  • 3 — third week of month
  • 4 — fourth week of month
  • 5 — last week of month

Job Retry Settings

Parent Tag

Parameter

Description

RetryInfo

Parent tag that encapsulates information about job retry settings.

 

Enabled

Parameter specifying if Veeam Agent for Microsoft Windows must automatically retry the backup job if the job fails. Possible values:

  • True — Veeam Agent for Microsoft Windows retries the backup job. If you set the Enabled parameter to True, you must specify the number of times for which Veeam Agent for Microsoft Windows must retry the job, and time interval between job retries.
  • False — Veeam Agent for Microsoft Windows does not retry the backup job.

 

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.

 

Backup Window Settings

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:

  • 0 —  permitted hours for the backup window are specified.
  • 1 — prohibited hours for the backup window are specified.

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:

The input XML file will contain the following parameters:

<?xml version="1.0"?>
   <JobInfo CryptType="10">
     <ScheduleInfo Type="4" RunManually="False">
       <ContinuouslyInfo>
         <Schedule Kind="1">
           <Days>
             <Monday Intervals="06-18"/>
             <Tuesday Intervals="06-18"/>
             <Wednesday Intervals="06-18"/>
             <Thursday Intervals="06-18"/>
             <Friday Intervals="06-18"/>
           </Days>
         </Schedule>
       </ContinuouslyInfo>
     </ScheduleInfo>
  </JobInfo>

Example 2

You want to run the backup job daily at 12:00 AM, and set up the following backup window for the job:

The input XML file will contain the following parameters:

<?xml version="1.0"?>
   <JobInfo CryptType="10">
     <ScheduleInfo Type="1" UseBackupWindow="True" RunManually="False">
 <DailyInfo Kind="0" Days="Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday" Time="00:00:00"/>
       <BackupWindow Kind="1">
         <Days>
           <Monday Intervals="06-18"/>
           <Tuesday Intervals="06-18"/>
           <Wednesday Intervals="06-18"/>
           <Thursday Intervals="06-18"/>
           <Friday Intervals="06-16"/>
         </Days>
       </BackupWindow>
     </ScheduleInfo>
  </JobInfo>

 

Veeam Large Logo

User Guide

Configurator Reference

Veeam Backup & Replication Documentation

Veeam ONE Documentation

Veeam Management Pack Documentation

Veeam Agent for Linux Documentation