Changing backup storage parameters

You can change the connection parameters for the current backup storage destination, for example, after credentials, an endpoint, or a DNS name has changed.

Changing storage parameters does not migrate backup data to another destination. If you need to switch the destination, release all nodes from the backup storage cluster and create new backup storage.

Prerequisites

The backup storage cluster is created and registered in the Cloud Management Panel, as described in Provisioning Acronis Backup Storage space.
Ensure that the updated connection parameters point to the destination that contains existing backup data.
Ensure that all Backup Gateway nodes can access the destination with the updated parameters.

To change backup storage parameters

Admin panel

On the Storage services > Backup storage screen, go to the Settings tab.
Click the settings section for the current backup destination: NFS share, Public cloud, or HPE StoreOnce.
Update the available connection parameters and credentials. Some parameters, such as the storage type, may be displayed for reference only.
Click Save.

For backup storage on the local cluster, there are no destination connection parameters. To change the local storage tier, failure domain, or redundancy mode, use the storage policy settings.

Command-line interface

Use the following command:

vinfra service backup storage-params change --storage-type {local,nfs,s3,swift,azure,google,storeonce}
                                                   [--nfs-host <host>]
                                                   [--nfs-export <export>]
                                                   [--nfs-version <version>]
                                                   [--s3-flavor <flavor>]
                                                   [--s3-region <region>]
                                                   [--s3-bucket <bucket>]
                                                   [--s3-endpoint <endpoint>]
                                                   [--s3-access-key-id <access-key-id>]
                                                   [--s3-secret-key-id <secret-key-id>]
                                                   [--s3-cert-verify <cert-verify>]
                                                   [--swift-auth-url <auth-url>]
                                                   [--swift-auth-version <auth-version>]
                                                   [--swift-user-name <user-name>]
                                                   [--swift-api-key <api-key>]
                                                   [--swift-domain <domain>]
                                                   [--swift-domain-id <domain-id>]
                                                   [--swift-tenant <tenant>]
                                                   [--swift-tenant-id <tenant-id>]
                                                   [--swift-tenant-domain <tenant-domain>]
                                                   [--swift-tenant-domain-id <tenant-domain-id>]
                                                   [--swift-trust-id <trust-id>]
                                                   [--swift-region <region>]
                                                   [--swift-internal <internal>]
                                                   [--swift-container <container>]
                                                   [--swift-cert-verify <cert-verify>]
                                                   [--azure-endpoint <endpoint>]
                                                   [--azure-container <container>]
                                                   [--azure-account-name <account-name>]
                                                   [--azure-account-key <account-key>]
                                                   [--google-bucket <bucket>]
                                                   [--google-credentials <credentials>]
                                                   [--storeonce-host <host>]
                                                   [--storeonce-store <store>]
                                                   [--storeonce-user <user>]
                                                   [--storeonce-password <password>]

--storage-type {local,nfs,s3,swift,azure,google,storeonce}: Storage type whose parameters you are changing.

The local storage type has no additional destination connection parameters. To change the local storage tier, failure domain, or redundancy mode, use vinfra service backup volume-params change.

Storage parameters for the nfs storage type:

--nfs-host <host>: NFS hostname or IP address. Required for the nfs storage type.
--nfs-export <export>: Export name. Required for the nfs storage type.
--nfs-version <version>: NFS version. Required for the nfs storage type.

Storage parameters for the s3 storage type:

--s3-flavor <flavor>: Flavor name.
--s3-region <region>: Region for Amazon S3.
--s3-bucket <bucket>: Bucket name. Required for the s3 storage type.
--s3-endpoint <endpoint>: Endpoint URL. Required for the s3 storage type.
--s3-access-key-id <access-key-id>: Access key ID. Required for the s3 storage type.
--s3-secret-key-id <secret-key-id>: Secret key ID. Required for the s3 storage type.
--s3-cert-verify <cert-verify>: Allow self-signed certificate of the S3 endpoint.

Storage parameters for the swift storage type:

--swift-auth-url <auth-url>: Authentication (Keystone) URL. Required for the swift storage type.
--swift-auth-version <auth-version>: Authentication protocol version.
--swift-user-name <user-name>: User name. Required for the swift storage type.
--swift-api-key <api-key>: API key or password. Required for the swift storage type.
--swift-domain <domain>: Domain name.
--swift-domain-id <domain-id>: Domain ID.
--swift-tenant <tenant>: Tenant name.
--swift-tenant-id <tenant-id>: Tenant ID.
--swift-tenant-domain <tenant-domain>: Tenant domain name.
--swift-tenant-domain-id <tenant-domain-id>: Tenant domain ID.
--swift-trust-id <trust-id>: Trust ID.
--swift-region <region>: Region name.
--swift-internal <internal>: Internal parameter.
--swift-container <container>: Container.
--swift-cert-verify <cert-verify>: Allow self-signed certificate of the Swift endpoint.

Storage parameters for the azure storage type:

--azure-endpoint <endpoint>: Endpoint URL. Required for the azure storage type.
--azure-container <container>: Container. Required for the azure storage type.
--azure-account-name <account-name>: Account name. Required for the azure storage type.
--azure-account-key <account-key>: Account key. Required for the azure storage type.

Storage parameters for the google storage type:

--google-bucket <bucket>: Google bucket name. Required for the google storage type.
--google-credentials <credentials>: Path to the Google credentials file. Required for the google storage type.

Storage parameters for the storeonce storage type:

--storeonce-host <host>: StoreOnce DNS name or IP address. Required for the storeonce storage type.
--storeonce-store <store>: Catalyst store name or ID. Required for the storeonce storage type.
--storeonce-user <user>: Catalyst access username. Required for the storeonce storage type.
--storeonce-password <password>: Catalyst access password. Required for the storeonce storage type.

For example, to update the HPE StoreOnce parameters, run:

# vinfra service backup storage-params change --storage-type storeonce \
--storeonce-host storeonce.example.com --storeonce-store accounting2 \
--storeonce-user catalyst-user --storeonce-password storeonce-password