Platform: LinuxProducts: MSP360 Backup
Article ID: s0452Last Modified: 14-Oct-2024

Add and Manage Backup Storage

This chapter covers the following topics:

To add a backup storage using CLI, use the addAccount command. Different cloud storage services require different authentication methods with different parameters. Most storage providers, however, rely on Access/Secret key authentication.

Add Storage Account

Add Storage Account Using Classic CLI

To request help for addAccount command, type the following:

./cbb addAccount

Amazon S3, S3-compatible, and other Access/Secret Key-type Services

The following table describes the required parameters for addAccount:

Parameter Description Value
-st Storage Type AmazonS3, AmazonS3Chinese, S3Compatible, CenturyLink, Cloudian, DreamObjects, Scality, ThinkOn, Verizon, Minio, Wasabi, Azure, OpenStack, HPCloud, Rackspace, OracleCloud, SoftLayer, Google, Backblaze, AliBabaCloud, FileSystem, SFTP
-d Display Name String
-ac Access Key String
-sk Secret Key String
-c Bucket or container String

Here's a sample command that adds an S3 account:

./cbb addAccount -st AmazonS3 -d "My S3 account" -ac "APIAIXPUW2UXRWqyFAKE" -sk "rUdioasiY4kunLB+sxKPaRsEEfQe8J6Y33huFaskFAKE" -c "dopeBucket"

Apart from required parameters, MSP360 (CloudBerry) Backup CLI provides you a number of optional parameters, including specific parameters for certain storage services:

Parameter Description Value
-bp Backup Prefix. Used for differentiation between different computers. String
-ssl Specifies if SSL should be used. yes (default) / no

Here's a sample command that adds an S3 account with all parameters:

./cbb addAccount -st AmazonS3 -d "My S3 account" -ac "APIAIXPUW2UXRWqyFAKE" -sk "rUdioasiY4kunLB+sxKPaRsEEfQe8J6Y33huFaskFAKE" -c "dopeBucket" -bp "corporateMacbook" -ssl yes

Google Cloud

Adding Google Cloud as a backup storage is a bit more tricky, as Google offers three authentication mechanisms for its cloud storage:

  • Access/Secret Key:

Adding a Google Cloud account using Access/Secret keys can be done with the help the following command:

./cbb addAccount -st Google -d "Google Cloud" -ac "yourAccessKey" -sk "yourSecretKey" -c "container"

where:

Parameter Description Value
-st StorageType Google
-d Display Name String
-ac Access Key String
-sk Secret Ket String
-c Google Cloud container String
  • OAuth 2.0 (Service Account):

Adding a Google Cloud account using OAuth 2.0 (Service Account) can be done with the help the following command:

./cbb addAccount -st Google -d "Display name" -d "Google Cloud" —pi "Project ID" -se "service account" -pk "private key path" -c "container"

where:

Parameter Description Value
-st Storage Type Google
-d Display Name String
-pi Project ID String
-se Service account email String
-pk Private key path String
-c Google Cloud container String
  • OAuth 2.0 (Installed Application):

Adding a Google Cloud account using OAuth 2.0 (Installed Application) can be done with the help the following command:

./cbb addAccount -st Google -d "Display name" -ac "authentication code" -pi "project_id" -c "container"

where:

Parameter Description Value
-st Storage Type String
-d Display Name String
-ac Authentication code that can be generated here. String
-pi Project ID String
-c Google Cloud Container String

Add SFTP Destination

To add an SFTP destination, use the following command:

./cbb addAccount -st SFTP

where:

Parameter Description Value
-d DisplayName Account name
-user User Username
-pass Password Password
-pk PrivateKey Private Key
-server ServerAddress Server address: hostname or IP
-c Container path Server container path
-port Port Server port. Default: 22
-keepAlive Possible values: **yes no** Keep the connection alive. Default value: yes
-useProxy Possible values: **yes no** Use proxy. Default: yes
bp BackupPrefix Backup prefix to differentiate backups from different computers. Optional. Default value is a computer name
--h show help -

An example of cbb addAccount command:

./ cbb addAccount -st SFTP -d -user <-pass | -pk > -server -c [-port ] [-keepAlive <yes/no>] [-bp ] [-useProxy <yes/no>]

Manage Storage Account

To list available storage accounts, execute the following command:

./cbb account -l

Synchronize Repository

Specify the following parameters to run a repository synchronization:

  • -sync. Run a repository synchronization for a specified storage account
./cbb account -sync "MyGoogle"

Note that the storage account name must be in quotes

Edit Storage Account

To edit storage account, use the following command:

./cbb editAccount -d "account name"

Note that the storage account name must be in quotes

Delete Storage Account

To delete an unecessary storage account, use the following command:

./cbb deleteAccount -d "My S3 storage"

Note that the storage account name must be in quotes

https://git.cloudberrylab.com/egor.m/doc-help-std.git