IBM Support

Quick Start Guide for Cloud Storage Solutions

News


Abstract

Quick Start Set-up Steps

Content

You are in: IBM i Technology Updates > IBM Cloud Storage Solutions for i > Quick Start Guide for Cloud Storage Solutions

Step 1: Create a bucket in IBM Cloud Object Storage

The first step is to create a “bucket” to hold data in the cloud. To do this navigate to https://www.ibm.com/cloud/object-storage using your browser and click “Get started for free”.

If you already have an account and your browser was already logged in, you will be redirected to the page in figure 4; otherwise you will be redirected to the page in figure 2.

image 2070

Figure 1

If you do not already have an IBM Cloud account, create one, log in, and you will be redirected to the page in figure 3.

If you already have an IBM Cloud, select “Log in”, log in, and you will be redirected to the page in figure 3.

Note: If for some reason the redirections do not work properly you may be redirected to the IBM Cloud Dashboard.  If this happens follow the directions in the “Creating an object storage resource from the dashboard” section at the bottom of this how-to guide.

image 2072

Figure 2

 
Select the “Create” button to create a cloud object storage resource.
image 2074

Figure 3

Select “Buckets” from the list of topics on the left-hand side of the page then select the “Create bucket” button.

Instructions to create a bucket

Figure 4

 

Give the bucket a name and select the “Create bucket” button.

image 2075

Figure 5

 

After creating the bucket you will see the following page. Keep this page open in the browser. The information from this page will be needed to create a resource in Cloud Storage Solutions.

image 2076

Figure 6

 

Step 2: Create a resource in Cloud Storage Solutions

The next step is to create a resource in Cloud Storage Solutions that corresponds to the bucket you created in the first step.

Run the Work with ICC Resources (WRKCFGICC) command.

 WRKCFGICC command
 

Create a new resource using option 1. Give the resource a name of your choice, use “AWSS3” for the resource type and press <enter>.

Instructions creating a new resource using opt 1 and type as AWSS3

 
  • 1.  Enter a description of this resource.
  • 2.  Create the “Access key ID” and the “Secret access key” by following the directions in the, “Creating credentials for a cloud storage resource” section. After creating the credentials copy the access key ID and the secret access key and paste them into the corresponding fields.
  • 3.  Leave the “Use compression” and the “Use encryption” fields as *NO to begin with. These can be changed to *YES later if desired.
Creating a new resource continued
 
  • 4.  Press the <enter> key and the “Bucket” field will display.
  • 5.  Enter the name of the bucket you created in, “Step 1: Create a bucket in IBM Cloud Object Storage”.
Creating new resource continued
  • 1.  Press <page down>.
  • 2.  Obtain the resource URI by following the directions in the, “Determining the resource URI for a bucket” section and copy it into the “Resource URI” field.
  • 3.  Press <enter> to create the resource.
Creating new resource continued

Step 3: Configure SSL for Cloud Storage Solutions

IBM Cloud Object Storage only accepts SSL connections so SSL must be enabled for Cloud Storage Solutions. SSL is configured for Cloud Storage Solutions using the IBM i Digital Certificate Manager. Follow the steps at https://www.ibm.com/support/knowledgecenter/en/ssw_ibm_i_72/icc/topics/iccutsk_config_ssl.htm to setup SSL.

Step 4: Try it out

 

Cloud Storage Solutions is now configured and ready to use. Try out some transfers using the “Copy ICC File to Cloud (CPYTOCLD)” and “Copy ICC File from Cloud (CPYFRMCLD)” commands. To delete a file from the cloud use the “Delete ICC File from Cloud (DLTCLDF)” command.


Creating credentials for a cloud storage resource

  • 1.  Select “Service credentials” from the list of topics on the left-hand side of the page.
  • 2.  Select the “New credential” button.
  • 3.  In the “Select Service ID” drop-down box, select “Auto Generate”.
  • 4.  Check the “Include HMAC Credential” checkbox.
  • 5.  Select the “Add” button.

Instructions creating credentials

Select the “View credentials” button. The access key ID and the secret access key are listed in the cos_hmac_keys field in the JSON object. Copy these and paste them into the corresponding fields in the “Create ICC AWS S3 Resource (CRTS3RICC)” screen.

Copy and paste the cos hmac keys


Determining the resource URI for a bucket

  • 1.  Select “Buckets” from the list of topics on the left-hand side of the page.
  • 2.  Select the bucket you created in the list of buckets.
Instructions to determine the resource URL for a bucket
 
  • 3.  Select “Configuration” from the list of topics on the left-hand side of the page.
  • 4.  Scroll to the bottom of the page to the “Endpoints” section.
  • 5.  The “Resource URI” is the public endpoint appended to “https://”. In this example it would be, https://s3.us-east.cloud-object-storage.appdomain.cloud.
  • 6.  Copy this value into the “Resource URI” field of the “Create ICC AWS S3 Resource (CRTS3RICC)” screen.”
Instructions to determine the resource URL for a bucket continued

Creating an object storage resource from the dashboard

The following are instructions on how to create an IBM Cloud Object Storage resource starting from the IBM Cloud Dashboard: https://cloud.ibm.com.

Select the ‘Create resource’ button.

 Creating an object storage resource from the dashboard
Select “Storage” in the list of categories on the left side of the page. 
Select “Storage” in the list of categories on the left side of the page
Select the ‘Object Storage’ box. This will take you to the page in figure 3 of “Step 1: Create a bucket in IBM Cloud Object Storage”. 
Select the ‘Object Storage’ box

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Component":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Document Information

Modified date:
07 January 2020

UID

ibm11135312