mkcloudserver

The mkcloudserver command creates a configuration entry for a cloud.

Read syntax diagramSkip visual syntax diagram mkcloudserver  -type  swift swift-keystone TS7700 aws-s3 ibmcos s3  -nossl1 -notest -tenant tenant_name -username user_name2 -pw password2 -endpointendpoint -loclocation -primary7700IPs , primary_ip_addresses3 -secondary7700IPs, alternate_ip_addresses4 -rootcaloc root_ca_location -intermcaloc interm_ca_location -syscaloc sys_ca_locationcloud_name  -keygrp key_group_ID  ... 
Notes:
  • 1 The nossl parameter is required when the -type is TS7700 or swift.
  • 2 The parameters tenant, username, pw, endpoint, rootcaloc, intermcaloc, and syscaloc cannot be used when the cloud -type is TS7700.
  • 3 The primary7700IPs parameter is required with -type TS7700.
  • 4 The secondary7700IPs parameter is required with -type TS7700.

Parameters

-type swift | swift-keystone | TS7700 | aws-s3 | ibmcos | s3
(Required) Displays the type of cloud. The following options are supported:
swift
Specifies that the DS8000® system uses OpenStack Swift cloud computing system to encrypt authentication credentials and connect to a cloud storage target.
swift-keystone
Specifies that the DS8000 system uses Swift-Keystone to encrypt authentication credentials and connect to a cloud storage target. Authentication is done using root or system certificates with either Secure Sockets Layer or Transport Layer Security, SSL/TLS.
TS7700
Specifies that the DS8000 system authenticates and stores data directly on the IBM® TS7700 system. Authentication credentials such as a user name, password, or certificate are not required. Instead, the DS8000 system uses primary and alternate IP addresses to authenticate and verify connection to the IBM TS7700 system.
aws-s3
Specifies that Amazon Simple Storage Service (Amazon S3) is to allow the DS8000 system to authenticate and connect to S3 storage.
ibmcos
Specifies IBM Cloud® Object Storage (COS) for data protection through backup and recovery.
s3
Specifies that s3 allows the DS8000 system to authenticate and store data on any other s3 compatible cloud storage target.
-nossl
(Optional) Specifies that communication between the DS8000 and the specified cloud does not require the SSL protocol.
Note: The -nossl parameter is required when you specify the -type parameter with either TS7700 or swift.
-notest
(Optional) Specifies that the default cloud connectivity test is not performed. The cloud connectivity test verifies the connection between the DS8000 and the cloud.
-tenant tenant_name
(Optional) The tenant name that you use to connect with the cloud.
-username user_name
(Optional) The user name that you use to connect with the cloud.
Note: The -username parameter cannot be used with -type TS7700.

The -username parameter is required when you specify the -type parameter with the swift, swift-keystone, aws-s3, s3, or ibmcos option.

-pw password
(Optional) The password that you use to connect with the cloud.
Note: The -pw parameter cannot be used with -type TS7700.

The -pw parameter is required when you specify the -type parameter with the swift, swift-keystone, aws-s3, s3, or ibmcos option.

-endpoint endpoint
(Optional) The location, or URL, of the cloud.
Note: The -endpoint parameter cannot be used with -type TS7700.

The -endpoint parameter is required when you specify the -type parameter with the swift, swift-keystone, aws-s3, or ibmcos option.

-loc location
(Optional) The detailed location or vault template of the cloud depending on the -type parameter.
Note: The -loc parameter is valid with type ibmcos or aws-s3, only.
ibmcos
The location parameter specifies the name of the user generated vault template created on the IBM Cloud Object Storage Manager.
aws-s3
The location parameter specifies the AWS Region as defined by the endpoint of the Amazon S3 service.
-primary7700IPs primary_ip_address
(Required for TS7700 only) The primary IP address of the cloud.
Note: You can specify up to four primary IP addresses (IPv4 is supported). Separate the primary IP addresses with a comma.
-secondary7700IPs alternate_ip_address
(Optional for TS7700 only) The alternate IP address of the cloud.
Note: You can specify up to four alternate IP addresses (IPv4 is supported). Separate the alternate IP addresses with a comma.
-rootcaloc root_ca_location
(Optional) The path of the root certification file on your computer. The certificate determines which protocol (such as Transport Layer Security, TLS) that is used to communicate with the cloud.

Multiple clouds can share the root certificate if a root certificate exists that is defined to the system. (Root and intermediate certificates are currently the same.) If a root certificate does not exist in the storage system, the -rootcaloc parameter is required.

Note: The -rootcaloc parameter cannot be used with -type TS7700. The -rootcaloc parameter is required if a root certificate does not exist for the storage system.
-intermcaloc interm_ca_location
(Optional) The path of the intermediate certification file on your computer.
Note: The -intermcaloc parameter cannot be used with -type TS7700.
-syscaloc sys_ca_location
(Optional) The path of the system certification file on your computer.

The certificate determines which protocol (such as TLS) to use to communicate with the cloud. Multiple clouds can share root certificate. Each cloud has a respective system certificate.

Note: The -syscaloc parameter cannot be used with -type TS7700.
cloud_name
(Required) The name of the cloud. DS8000 supports one cloud.
-keygrp key_group_ID
(Optional) Specifies a key group that is configured for encryption of transparent cloud tiering, which ensures that data is encrypted while it is transferred to cloud storage.

Example

dscli> mkcloudserver -type swift -tenant mytest04 -username mrproduct -pw ProdUct02
-endpoint "https://hostname:port/”  -rootcaloc "/tmp/ssl_cacert.pem" 
-syscaloc "/tmp/ssl_cert.pem" ibmcloud
Output
CMUC00505I mkcloudserver: The entered cloud ibmcloud was created successfully on node 0. 

CMUC00505I mkcloudserver: The entered cloud ibmcloud was created successfully on node 1.