Creating Repository in Object Storage

To create a repository in an object storage location, you must specify a storage provider name, a name for the backup repository and settings for the object storage account and bucket or container.

Before You Begin

Before you start creating an object storage repository, consider the following:

  • [Microsoft Azure Blob storage] The soft delete feature for blobs and containers must be disabled in the storage account.
  • [Microsoft Azure Blob storage] To use the Veeam backup immutability feature, you must enable blob versioning and version-level immutability support in the storage account. For more information, see this Microsoft Azure documentation.
  • [S3 Compatible and Amazon S3 storage] To use the Veeam backup immutability feature, you must enable versioning and the S3 Object Lock feature in the storage account. For more information, see this Amazon S3 documentation.
  • [Google Cloud storage] The Veeam backup immutability feature is not supported for repositories configured in Google Cloud storage.

Creating Object Storage Repository

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:
  • azureblob — for creating a Microsoft Azure Blob repository.
  • google — for creating a Google Cloud repository.
  • amazons3 — for creating an Amazon S3 repository.
  • s3compatible for creating an S3 Compatible repository (including Wasabi Cloud and IBM Cloud repositories).
  • <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 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:

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:

  • IPv6 is the IPv6 address of the object storage.
  • port is the number of the port that Veeam Agent will use to connect to the object storage.

Creating Repository in Object Storage Note

You can find the list of supported regions in the documentation of the selected storage provider.

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.

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:

Creating Repository in Object Storage Note

You can find the full list of supported regions by storage provider in the PublicCloudRegions.xml file located in the /Library/Application Support/Veeam folder on Veeam Agent computer.

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.

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 Google Cloud Repository

To create a backup repository in a Google Cloud storage bucket, use the following command:

veeamconfig objectstorage createrepository google --name <repository_name> --accesskeyid <id> --region <storage_region> --bucketname <bucket_name> --folder <folder_name>

where:

Creating Repository in Object Storage Note

You can find the full list of supported regions by storage provider in the PublicCloudRegions.xml file located in the /Library/Application Support/Veeam folder on Veeam Agent computer.

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 google --name google --accesskeyid GOOGLE56L5ATTDKJCLWUQG3E --region europe-west3 --bucketname backup01 --folder folder01

After you use the command, Veeam Agent will prompt you to specify a secret key associated with the Google Cloud storage account. Enter the secret key to complete the creation of the repository.

Specifying Options for Microsoft Azure Blob Repository

To create a backup repository in a Microsoft Azure Blob container, use the following command:

veeamconfig objectstorage createrepository azureblob --name <repository_name> --account <storage_account_name> --region <storage_region> --bucketname <bucket_name> --folder <folder_name>

Creating Repository in Object Storage Note

Veeam Agent supports specification of 3 generic Microsoft Azure Blob storage locations:

  • Azure Global (Standard) — can be used for any data center region, except the regions in China and the regions intended for US governments. To specify this region in the command to create the repository, use the following value: AzureCloud.
  • Asia China — can be used for any region in China. To specify this region in the command to create the repository, use the following value: AzureChinaCloud.
  • Azure Government — can be used for Azure Government regions only. To specify this region in the command to create the repository, use the following value: AzureGovernmentCloud.

You can find the full list of supported regions by storage provider in the PublicCloudRegions.xml file located in the /Library/Application Support/Veeam folder on Veeam Agent computer.

If Veeam Agent does not find a folder with the name specified in the command, Veeam Agent creates a new folder in the container under Veeam/Backup/ — for example, Veeam/Backup/folder01.

For example:

$ veeamconfig objectstorage createrepository azureblob --name azure --account my-account --region azurecloud --bucketname backup01 --folder folder01

After you use the command, Veeam Agent will prompt you to specify the shared key associated with the object storage account. Enter the shared key to complete the creation of the repository.