Connecting to Veeam Backup Server
To create Veeam Agent backups on a backup repository managed by Veeam Backup & Replication, you must connect to a Veeam backup server.
IMPORTANT |
Currently, Veeam Agent for Linux can be connected to one Veeam Backup & Replication server only. If you want to create backups on the backup repository managed by another Veeam backup server, you need to delete currently used backup server and all jobs targeted at backup repositories managed by this backup server. To learn more, see Deleting Connection to Veeam Backup Server. If you add a connection to another backup server, backup jobs targeted at the original backup server will fail, and backups created on the Veeam backup repository will become unavailable in Veeam Agent. To continue using the original backup server, you need to delete the connection to the new backup server and re-create all backup jobs that use the original backup server. If you change an account to connect to the Veeam backup server and then start a backup job targeted at the backup repository managed by this backup server, Veeam Agent will start a new backup chain on the backup repository. |
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> — the name of the Veeam backup server that manages the backup repository.
- <vbr_address> — the IP address of the Veeam backup server.
- <vbr_port> — the port over which Veeam Agent must communicate with Veeam Backup & Replication. The default port used for communication with the Veeam backup server is 10006. If you want to use the default port, you do not need to specify the --port option.
- <username> — the name of the account that has access to the Veeam backup repository.
- <domain> — the name of the domain in which the account that has access to the Veeam backup repository is registered.
- <password> — the password of the account that has access to the Veeam backup repository. If you do not specify the password in the command, you will be prompted to enter the password during command execution.
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@wrk01:~$ veeamconfig vbrserver add --name vbr01 --address 172.17.53.1 --login veeamadmin --domain tech --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. |