mkcloudaccountswift

Use the mkcloudaccountswift command to configure a new cloud account that uses OpenStack Swift object storage.

Syntax

Read syntax diagramSkip visual syntax diagram  mkcloudaccountswift  -namename-keystone -containerprefix container_prefix -endpoint http_endpoint_URLhttps_endpoint_URL -tentantname tenant_name -username user_name -password 'password' -certificatepath_to_certificate-upbandwidthmbitsupbandwidth_limit_in_mb-downbandwidthmbitsdownbandwidth_limit_in_mb-encryptyesno

Parameters

-name name
(Optional) Specifies the account identifier. The value must be an alphanumeric string.
-keystone
(Optional) Specifies that the system authenticate with OpenStack Keystone. If you do not specify this parameter, the system authenticates with OpenStack TempAuth.
-containerprefix container_prefix
(Required) Specifies the Swift container names the system uses or creates. The value must be 1 - 12 characters and contain no spaces or slashes.
-endpoint http_endpoint_URL | https_endpoint_URL
(Required) Specifies the URL that the system uses to access object storage.

If Keystone authentication is used, it is the URL of the Keystone service, probably ending with v2.0. Otherwise, it is the URL of the Swift service.

-tentantname tenant_name
(Required) Specifies the OpenStack tenant the system uses to access cloud storage. The value must be a 1 - 64 alphanumeric characters that contain no spaces.
-username user_name
(Required) Specifies the OpenStack user name the system uses to access cloud storage. The value must be 1 - 255 alphanumeric characters with no spaces.
-password 'password'
(Required) Specifies the password that the system uses to access cloud storage. For IBM Cloud® accounts, this password is the application programming interface (API) key. The value must be 1 - 64 alphanumeric characters and it must not begin or end with a space. You must enclose the password in single quotation marks.
-certificate path_to_certificate
(Optional) Specifies the file path for the object storage server SSL certificate. The value must be:
  • 1 - 255 alphanumeric characters with no period or dot next to another period or dot, and no period or dot at the start or end of the specified value
  • In base64-encoded PEM format
-upbandwidthmbits upbandwidth_limit_in_mb
(Optional) Specifies the upload bandwidth limit in megabits per second (Mbps). The value must be a number 1 - 10240.
-downbandwidthmbits downbandwidth_limit_in_mb
(Optional) Specifies the download bandwidth limit in megabits per second (Mbps). The value must be a number 1 - 10240.
-encrypt yes | no
(Optional) Specifies whether to encrypt the data in the cloud account. By default, encryption is enabled unless you specify -encrypt no.

Description

This command configures a new cloud account that uses OpenStack Swift object storage.

An invocation example

mkcloudaccountswift -containerprefix svc_backups
                    -endpoint https://lon02.objectstorage.cloud.net/auth/v1.0 
                    -tenantname mytenant
                    -username jamivard
                    -password 'WKF84FAQRKLOICDF53LANBWKF84FAQRKLOICDF53LANBEXAMPLEEXAMPLEEXAMPL'
                    -upbandwidthmbits 100 
                    -downbandwidthmbits 100

The resulting output:

Cloud Account, id [0], successfully created
Note: If the system contains an encrypted cloud account that uses USB encryption, a USB flash drive with the system master key must be present in the configuration node before the cloud account can move to the online state. This requirement is necessary when the system is powered down, and then restarted.