How to Provision an Oracle SOA Cloud Service Environment – Storage

Object Storage Provisioning

Oracle Storage Cloud Service (OSCS) enables businesses to store and manage digital content in the cloud. Stored objects can be retrieved directly by external clients or by applications running within Oracle Cloud. A container is just a storage compartment that provides a way to organize the data stored in OSCS.

Oracle Public Cloud (OPC) uses OSCS storage containers to host the artefacts produced by the built-in automated backup feature.

  1. Oracle Storage Cloud Service Provisioning via APIs

    In this section of the guide we will show how to create a storage container using the OSCS REST APIs that is based on OpenStack Swift.

    Request an Authentication Token

    Using your preferred tool, submit the REST request in the table below, where:

  • is the identity domain name to which your OPC account belongs
  • and are your OPC account credentials
Resource URL https://.storage.oraclecloud.com/auth/v1.0
Method GET
Headers X-Storage-User: Storage-:
X-Storage-Pass:

If you use cURL, the command syntax would be:

curl \
-v -X GET \
-H X-Storage-User:Storage-: \
-H X-Storage-Pass: \
https://.storage.oraclecloud.com/auth/v1.0

For example, in this example I used the following API call:

curl -v -X GET -H X-Storage-User:Storage-auoracle02747:carlos.rodriguez.iturria@oracle.com -H X-Storage-Pass:PASSWORD_GOES_HERE https://auoracle02747.storage.oraclecloud.com/auth/v1.0

Note: In bold, there are the sections that you will have to replace based on your Identity domain and account details.

The authentication token, that is valid during the next 30 minutes, is delivered as an X-Auth-Token HTTP response header. In the command output locate the line that starts with X-Auth-Token.

For example, something like: < X-Auth-Token: AUTH_tk456c26d5cd07fba11a470cee403ae692

Create the Storage Container

Using your preferred tool, submit the REST request in the table below, where:

  • is the identity domain name to which your OPC account belongs
  • is just the container unique identifier
  • is the authentication token you got from previous step
Resource URL https://.storage.oraclecloud.com/v1/Storage-/
Method PUT
Headers X-Auth-Token:

The cURL command syntax would be:

curl \
-v -X PUT \
-H X-Auth-Token: \
https://.storage.oraclecloud.com/v1/Storage-/

For example, in this example I used the following API call:

curl -v -X PUT -H X-Auth-Token:AUTH_tk456c26d5cd07fba11a470cee403ae692 https://auoracle02747.storage.oraclecloud.com/v1/Storage-auoracle02747/dafwaContainer1

Note: In bold, there are the sections that you will have to replace based on your Identity domain and account details.

In the command output verify that the HTTP status code is 201 Created

… < HTTP/1.1 201 Created

If you want to validate that your container was successfully created, you can run another APi to list all containers:

curl -v -X GET -H “X-Auth-Token:AUTH_tk83d5d5df6b89c19ec2a4748a761c0202” -H “Accept: application/json” https://auoracle52459.storage.oraclecloud.com/v1/Storage-auoracle52459

Note: In bold, there are the sections that you will have to replace based on your Identity domain and account details.

  1. Oracle Storage Cloud Service Provisioning via OpenStack GUIs

    Since Oracle Storage Cloud Service is based on OpenStack specifications, you can use a third party GUI that complies with such standard. For example, CloudBerry on Windows or CyberDuck in iOS.

    This section will make use of CloudBerry to illustrate how to use it.

    1. The first thing you have to do is to download CloudBerry for OpenStack http://www.cloudberrylab.com/free-openstack-storage-explorer.aspx
    2. Once you download and install the software, open it.
    3. If automatically asks to create a connection, select a “New Oracle Cloud Storage Account”. Otherwise, once it is open, select File > New Oracle Cloud Account

    4. Fill in the details according to your environment details, where:
  • Display Name: Whatever name you want
  • User Name: Storage-[identity domain]:[user name]
  • Password: Your Oracle Cloud Account Password
  • Authentication Service: https://%5Bidentity domain].storage.oraclecloud.com/auth/v1.0
  • Account Location: Select your Availability zone, most likely it will be us2
  • Keystone version: Keep it as “Do not use“, as you are already specifying the identity domain as part of the Authentication service.

For example this is how I filled mine:

  1. Test the connection and make sure you get a successful connection

  2. By default it should be selected in the source drop down menu. Otherwise select it.

  3. It will show any existing containers as if they were simple folders. This tool allows you to create, update or delete containers, as well as to move object files from your hard drive or any other Cloud Storage instance (right pane), into the left pane, as if it was any other FTP tool.

  4. In order to create a new container, simply click on the blue box icon

  5. Then provide a name and click OK

  6. CloudBerry will show the new container

  7. Open up the new container and search in your hard drive (right pane) a file to drag and drop into the container.

…. If using CyberDuck on MAC, it would look like this:

Advertisement

Author: David Reid

Cloud Platform Architect

7 thoughts on “How to Provision an Oracle SOA Cloud Service Environment – Storage”

  1. Hey Guys, things are becoming easier all the time. The provisioning of storage prior to provisioning the Oracle SOA Cloud Service is not required any more. You have the option (if you need to) to create the storage as part of the Oracle SOA Cloud Service provisioning wizard. So, not need to use curl, postmac, cyberduck or cloudberry to provision the storage before you get started.

    Like

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: