Connecting to Veeam Backup Server
To create Veeam Agent backups in the backup repository managed by Veeam Backup & Replication, you must connect Veeam Agent to a Veeam backup server.
Before You Begin
Consider the following about connections to Veeam backup servers:
- Veeam Agent operating in standalone mode can use only one Veeam backup server as a backup target. If you want to create backups on a backup repository managed by another backup server, you must delete the current backup server connection and all jobs that target repositories managed by that backup server. For more information, see Deleting Connection to Veeam Backup Server.
- If you connect Veeam Agent to another backup server, backups created on repositories managed by the original backup server become unavailable in Veeam Agent. To use the original backup server again, delete the connection to the new backup server and reconnect to the original backup server. After that, the previously stored backups become available again. You must also re-create all backup jobs that use the original backup server.
- If you change the account used to connect to the Veeam backup server and then start a backup job that targets a repository managed by that backup server, Veeam Agent starts a new backup chain on the repository.
- To restore data from a backup stored on another Veeam backup server, you can connect Veeam Agent to that backup server in read-only mode. A Veeam backup server connected in read-only mode cannot be used as a backup target. For more information, see Connecting to Veeam Backup Server in Read-Only Mode.
Connecting to Veeam Backup Server
To connect Veeam Agent to a Veeam backup server, use the following command:
veeamconfig vbrserver add --name <vbr_name> --address <vbr_address> [--port <vbr_port>] --login <username> [--domain <domain>] [--password <password>] [--fingerprint <tls_cert_thumbprint>] |
where:
- <vbr_name> — name of the Veeam backup server that manages the backup repository.
- <vbr_address> — IP address of the Veeam backup server.
- <vbr_port> — port over which Veeam Agent must communicate with Veeam Backup & Replication. The default port used for communication with the Veeam backup server is 10006.
- <username> — a user name of the account that has access to the Veeam backup repository.
You can specify a user name in the username or username@domain format. In the latter case, you do not need to specify a domain as a value of the --domain option.
Note |
You cannot provide a user name in the domain\username format. |
- <domain> — a name of the domain in which the account that has access to the Veeam backup repository is registered.
- <password> — password of the account that has access to the Veeam backup repository. If you do not specify a password as a value of the --password option, Veeam Agent will prompt you to enter the password when you run the veeamconfig vbrserver add command.
Permissions on the backup repository managed by the target Veeam backup server must be granted beforehand. To learn more, see Setting Up User Permissions on Backup Repositories.
- <tls_cert_thumbprint> — the thumbprint of the backup server's self-signed TLS certificate. For more information on using TLS certificates for secure connections to Veeam backup server, see the Backup Server Certificate section in the Veeam Backup & Replication User Guide.
Note |
If you do not specify the fingerprint of the Veeam backup server certificate, during command execution, you will be prompted to verify and accept the server certificate. |
For example:
user@srv01:~$ veeamconfig vbrserver add --name vbr01 --address 172.17.53.1 --port 10006 --login veeam --domain tech --password P@ssw0rd --fingerprint X1554144XXXX692173X31X3X2X614157686XX7X3 |
When Veeam Agent connects to a Veeam Backup & Replication server, Veeam Agent retrieves information about backup repositories managed by this Veeam backup server and displays them in the list of available backup repositories. You can then specify a Veeam backup repository as a target for a backup job.
Tip |
To view the list of backup repositories, use the veeamconfig repository list command. To learn more, see Viewing List of Backup Repositories. |