Creating Repository in Object Storage
To create an object storage repository, use the following command:
veeamconfig objectstorage createrepository <provider_type> <options> |
where:
- <provider_type> — name of the object storage provider. Veeam Agent supports the following options:
- amazons3 — for creating an Amazon S3 repository.
- s3compatible — for creating an S3 Compatible repository (including repositories in IBM Cloud, Wasabi Cloud and MinIO Cloud).
- <options> — options necessary to connect to the target object storage. For more information, see the following subsections:
After Veeam Agent creates a new backup repository in the object storage location, you can specify object storage as a destination for the backup job.
Specifying Options for Amazon S3 Repository
To create a backup repository in an Amazon S3 bucket, use the following command:
veeamconfig objectstorage createrepository amazons3 --name <repository_name> --accesskeyid <id> --region <storage_region> --bucketname <bucket_name> --folder <folder_name> |
where:
- <repository_name> — name for the backup repository.
- <id> — access key associated with the Amazon S3 storage account.
- <storage_region> — region associated with the bucket.
- <bucket_name> — name of the bucket.
IMPORTANT |
You must create the bucket where you want to store your backup data beforehand. When you create a bucket, consider Amazon bucket naming rules. For example, it is not recommended that you use dots (.) in the bucket name. For more information on bucket naming rules, see this AWS documentation article. |
- <folder_name> — name of the folder in the bucket.
If Veeam Agent does not find a folder with the name specified in the command, Veeam Agent will create a new folder in the bucket under Veeam/Backup/ — for example, Veeam/Backup/folder01.
For example:
$ veeamconfig objectstorage createrepository amazons3 --name amazon --accesskeyid AMAZONKIAWHDY4BDYCJC --region us-east-1 --bucketname bucket01 --folder folder01 |
After you use the command, Veeam Agent will prompt you to specify a secret key associated with the Amazon S3 storage account. Enter the secret key to complete the creation of the repository.
Specifying Options for S3 Compatible Repository
To create a backup repository in an S3 compatible storage bucket, use the following command:
veeamconfig objectstorage createrepository s3compatible --name <repository_name> --servicepoint <address> --region <storage_region> --accesskeyid <id> [--fingerprint <ssl_thumbprint>] --bucketname <bucket_name> --folder <folder_name> |
where:
- <repository_name> — name for the backup repository.
- <address> — address of the service point for the object storage.
NOTE |
If you want to connect to the repository using the IPv6 address and the port number, you must use the following format: IPv6:port, where:
|
- <storage_region> — region associated with the bucket.
Note |
You can find the list of supported regions in the documentation of the selected storage provider. |
- <id> — access key associated with the object storage account.
- <ssl_thumbprint> — fingerprint to verify the SSL certificate.
- <bucket_name> — name of the bucket.
- <folder_name> — name of the folder in the bucket.
If Veeam Agent does not find a folder with the name specified in the command, Veeam Agent will create a new folder in the bucket under Veeam/Backup/ — for example, Veeam/Backup/folder01.
For example:
$ veeamconfig objectstorage createrepository s3compatible --name s3comp --servicepoint fd00:ca19:0:18b0:0:ac8a:abca:c942:9000 --accesskeyid S3ertlD9EIO9DjnZjuD4 --region us-east-1 --fingerprint <value> --bucketname backup01 --folder folder01 |
After you use the command, Veeam Agent will prompt you to specify a secret key associated with the object storage account. Enter the secret key to complete the creation of the repository.