Creating Standalone Backup Job
To create a standalone backup job, use the following command:
veeamconfig job create filelevel --name <job_name> --reponame <repository_name> <objects> <advanced_options> <schedule_options> <active_full_backup_options> --nosnap |
where:
- <job_name> — name for the created backup policy.
- <repository_name> — name of the backup repository that should be used as a target location for the backup policy. The backup repository must be created in advance. To learn more, see Creating Backup Repository
If you want to create Veeam Agent backups in the Veeam backup repository, you should connect to the Veeam backup server in advance, before configuring the backup policy. To learn more, see Connecting to Veeam Backup Server.
- <objects> — files and directories inclusion/exclusion options. To learn more, see File Inclusion Options.
- <advanced_options> — advanced options for the backup policy. To learn more, see Advanced Backup Policy Settings.
- <schedule_options> — schedule options for the backup policy. To learn more, see Schedule Settings.
- <active_full_backup_options> — active full backup schedule options for the backup policy. To learn more, see Active Full Backup Schedule Settings.
For example:
user@wrk01:~$ veeamconfig job create filelevel --name HomeFolderBackup --reponame NetworkRepository --includedirs /home/user --excludedirs /home/user/temp --excludemasks *.pdf |
|
Consider the following:
|
To define the backup scope for the backup policy, you can use the following command-line options:
Option | Description and values |
---|---|
--includedirs | Full path to a folder that should be included in backup, for example: /home/user. You can specify one or several paths to directories in the computer file system. To separate several paths, use the ',' (comma) character, for example: /home/user/Documents,/home/user/reports. Tip: If you want to back up the root directory and specify the '/' (slash) character, Veeam Agent does not automatically include mount points in the backup scope. To include mount points, you need to specify paths to these mount points manually. For example, you have a file system mounted to the /home/media directory. If you add / as an object to the backup scope, Veeam Agent will not back up the mounted file system. To back up the root directory and the mounted file system, add the following objects to the backup scope: /,/home/media. |
--excludedirs | Full path to a folder that should be excluded from backup. The folder specified with this option must be a subfolder of the folder specified with the --includedirs option. To separate several paths, use the ',' (comma) character, for example, /home/user/Documents,/home/user/reports. |
--includemasks | Mask for file name or path that should be included in backup. You can use the following UNIX wildcard characters for file name masks:
Keep in mind that you must specify all names with masks in double quotation marks (""). For example: --includemasks "*.bak". If you want to use several file name masks, you must specify them in double quotation marks ("") and separated with a comma (,). For example: --includemasks "*.bak,*.pdf". File inclusion option is applied to all directories that are specified with the --includedirs option. For example, if you include in backup the /home/user/Documents folder and files that match the repor?.pdf file name mask, Veeam Agent will back up the /home/user/Documents/report.pdf file and will not back up the /home/user/reports/report.pdf file. |
--excludemasks | Mask for file name or path that should be excluded from backup. You can use the following UNIX wildcard characters for file name masks:
Keep in mind that you must specify all names with masks in double quotation marks (""). For example: --excludemasks "*.bak". If you want to use several file name masks, you must specify them in double quotation marks ("") and separated with a comma (,). For example: --excludemasks *.bak,*.pdf". File exclusion option is applied to all directories that are specified with the --includedirs option and files that match file name masks specified with the --includemasks option. For example, you may want to specify the following backup scope for the backup policy:
In this case, Veeam Agent will back up the /home/user/Documents/report.pdf file and will not back up /home/user/Documents/report.odt and /home/user/reports/report.pdf files. |
Advanced Backup Policy Settings
You can specify the following advanced options for the backup policy:
Option | Description and values |
---|---|
--compressionlevel | Data compression level. Possible values are:
|
--blocksize | Data block size in kilobytes. Possible values are 256, 512, 1024, 4096 or 8192. The default value is 1024. |
--maxpoints | The number of restore points that you want to store in the backup location. By default, Veeam Agent keeps 7 latest restore points. When the new restore point that exceeds the specified number is created, Veeam Agent will remove the earliest restore point from the backup chain. |
--setencryption | Defines that data encryption option is enabled for the policy. When you use the veeamconfig job create command with the --setencryption option, Veeam Agent will prompt you to specify a password for data encryption and hint for the password. |
The number of days to keep the backup created with the backup job in the target location. If Veeam Agent does not create new restore points for the backup, the backup will remain in the target location for the specified number of days. When this period is over, the backup will be removed from the target location. Possible values are: 1–999. If you do not specify the --deleteold option, Veeam Agent will not apply this setting. As a result, backup will be stored in the target location until you delete it manually. |
Option | Description and values |
---|---|
--daily | Defines that the backup policy must start daily at specific time. |
--weekdays | Weekdays when the backup policy must start separated by a comma (','). Possible values are:
|
--at | Time of day when the backup policy must start specified in the HH:MM format. For example: 20:00. |
After the backup policy is created, Veeam Agent automatically enables backup schedule. To learn about how to configure backup schedule for an existing backup policy, see Configuring Backup Schedule.
Active Full Backup Schedule Settings
Option | Description and values |
---|---|
--weekdays-full | Weekdays when the backup policy must create an active full backup separated by a comma (','). Possible values are:
|
--thisday-full | Days of the month when the backup policy must create an active full backup separated by a comma (','). Possible values are: 1-30 (or 1-31, depending on the month length). |
After the backup policy is created, Veeam Agent automatically enables active full backup schedule. To learn about how to configure active full backup schedule for an existing backup policy, see Configuring Active Full Backup Schedule.