Specifying Health Check Schedule

You can schedule a backup health check to run on a specific day of a specific month or on specific days of the week.

Specifying Monthly Health Check Schedule

IMPORTANT

Starting from Veeam Agent version 2.1.2, the --thisday option for the veeamconfig healthcheck set command is no longer available. If in a previous Veeam Agent version, the health check schedule was set to run on a specific day of the month using the --thisday option, after upgrade to version 2.1.2, the health check schedule will be automatically reset to the default weekly configuration to run every Saturday.

To instruct Veeam Agent to perform backup health check on a specific weekday of a month, use the following command:

veeamconfig healthcheck set --light --jobid <job_id> --monthlyweekday <day> --weeknumber <week> [--months <months>]

or

veeamconfig healthcheck set --light --jobname <job_name> --monthlyweekday <day> --weeknumber <week> [--months <months>]

where:

  • <job_id> — ID of the backup job for which you want to configure health check schedule. You should look up the backup job ID before you configure the schedule — for example, with the veeamconfig job list command. To learn more, see Viewing List of Backup Jobs.
  • <job_name> — name of the backup job for which you want to configure the health check schedule.

TIP

If the name of the job consists of several words and contains spaces, use quote marks around the name — for example, --jobName "Files Backup".

  • <day> — day of the week when the backup job must perform health check — for example, Tuesday or Tue.
  • <week> — week of the month when the backup job must perform health check. Possible values: First, Second, Third, Fourth or Last.
  • <months> — months when the backup job must perform health check, separated by a comma (',') — for example: Jan,Apr,Jul,Oct. If you do not specify this option, the health check will run every month.

For example:

user@wrk01:~$ veeamconfig healthcheck set --light --jobname SystemBackup --monthlyweekday Fri --weeknumber Last --months Mar,Jun,Sep,Dec

 

Specifying Weekly Health Check Schedule

To instruct Veeam Agent to perform backup health check on specific week days, use the following command:

veeamconfig healthcheck set --light --jobid <job_id> --weekdays <days>

or

veeamconfig healthcheck set --light --jobname <job_name> --weekdays <days>

where:

  • <job_id> — ID of the backup job for which you want to configure health check schedule. You should look up the backup job ID before you configure the schedule — for example, with the veeamconfig job list command. To learn more, see Viewing List of Backup Jobs.
  • <job_name> — name of the backup job for which you want to configure the health check schedule.

TIP

If the name of the job consists of several words and contains spaces, use quote marks around the name — for example, --jobName "Files Backup".

  • <days> — comma-separated list of days when the backup job must run backup health check. For example: Mon,Fri. The backup job will run the health check on the specified days at the time specified in the backup job schedule settings.

For example:

user@wrk01:~$ veeamconfig healthcheck set --light --jobname "System Backup" --weekdays mon,fri