This is an archive version of the document. To get the most up-to-date information, see the current version.

Starting Backup Job from Command Line Interface

You can start a backup job with the command line interface. When you start a backup job, Veeam Agent initiates a new backup job session and provides you with a Session ID. You can monitor the progress of the backup job session or view the session status.

Starting Backup Job from Command Line Interface Note:

Veeam Agent can currently perform only one backup job at a time. You cannot start a backup job when another backup job is already running.

To start a backup job, use the following command:

veeamconfig job start --name <job_name>

veeamconfig job start --id <job_id>

where:

<job_name> — name of the backup job that you want to start.
<job_id> — ID of the backup job that you want to start.

Starting Backup Job from Command Line Interface Tip:

Consider the following:

You can use the veeamconfig job start command with the --nosnap option to start a file-level backup job. In this case, Veeam Agent will not create a snapshot of the backed-up volume during the backup job session. Keep in mind that the snapshot-less file-level backup does not guarantee that data in the backup is consistent. To learn more, see Snapshot-Less File-Level Backup.
You can use the veeamconfig job start command with the --activefull option to create active full backups. To learn more, see Creating Active Full Backups.

For example:

$ veeamconfig job start --name SystemBackup
Backup job has been started.
Session ID: [{381532f7-426a-4e89-b9fc-43d98942c71a}].
Logs stored in: [/var/log/veeam/Backup/SystemBackup/Session_20161207_162608_{381532f7-426a-4e89-b9fc-43d98942c71a}].

You can check the backup job session status or view the backup job session log using the Veeam Agent command line interface.

You can also monitor the backup job performance in the Veeam Agent control panel. To learn more, see Viewing Real-Time Job Session Statistics.