Go to primary content

# Using the Oracle Storage Cloud Service

Oracle Storage Cloud Service is a public cloud storage solution which allows you to store, manage, and consume large amounts of unstructured data over the Internet.

The Storage Cloud Service design time tools support a number of actions including:

- Create new storage containers.

- Store and retrieve objects in the storage containers.

- Rename the storage object and object manifest. (You cannot rename the container.)

- Update the container and object metadata.

- Support transparent encryption and define access controls to containers.

- View the properties of any container and object.

For more information about the Oracle Storage Cloud Service see, `http://cloud.oracle.com/storage`.

## How to Log In to Oracle Storage Cloud Service

You can create a connection to Oracle Storage Cloud Service from the Oracle Cloud view, described in How to Create an Oracle Cloud Connection.

After validating credentials, you are logged in to Oracle Storage Cloud Service from OEPE. After you log in, the Oracle Cloud Storage Service containers and objects are displayed in the Oracle Cloud view, as shown below.

Figure: Oracle Cloud Storage Service Elements

The Oracle Cloud view displays the container and objects in the storage service instance. When you open a container or folder, Eclipse lists the contents of the container.

## How to Upload and Download Objects

There are a number of ways that you can move objects between OEPE and Oracle Developer Cloud Service, which are summarised here:

- To move individual files, you can drag and drop them from the OEPE Project Explorer into storage containers in the Oracle Cloud view.

- To bulk copy objects, you can create `*.tar` and `*.tar.gz` files, then drag them to the Cloud storage connection. The archive file must be in the proper format, with one level of folders corresponding to the Cloud storage container. For more information, search for "Bulk-Creating Objects" in the Oracle Storage Cloud Service Help Center at `http://docs.oracle.com/cloud/latest/storagecs_common/index.html`.

- For source files larger than 5GB, you can create object manifests to store segmented objects.

  When you drag and drop the manifest into the local file system, the combined object is copied over. (This cannot be used with transparent encryption.)

- You can drag and drop, or copy and paste objects and object manifests across containers within the same Cloud storage instance.

- You can drag and drop, or copy and paste objects across containers and across same Cloud storage instance. (The object manifest cannot be dragged and dropped into the Cloud instance.)

- You can drag and drop, or copy and paste objects from the Cloud storage container into the local project folder or file system.

- You can open the object in the Eclipse editor and save changes back to the Cloud instance.

## How to Create a New Storage Container

To create a new storage container:

1. In the Oracle Cloud view, right-click the Storage node under the Cloud Service connection and choose New Container.
2. In the New Folder dialog, enter a name for the new storage container. Click OK.

   The new container is created and listed in the Oracle Cloud view.

## How to Rename Objects

You can rename storage objects and object manifests. You cannot rename containers.

To rename an object:

1. Right-click the object and choose Rename.
2. In the Rename dialog, enter the new name and click OK.

## How to Work with Large Objects

Objects larger than 5 GB cannot be stored directly in Oracle Storage Cloud Service. Instead, you create a manifest which allows you to store a large object as a number of segments which are associated by the manifest.

To manage a file larger than 5 GB:

1. In the file system, segment the file into multiple sequential segment files, each smaller than 5 GB:

   - Use a common prefix in the names of all the segment files.

   - Make sure that the segment file names sort lexicographically in the correct order. Append suffixes to segment file names accordingly (that is, `segment_a`, `segment_b`, and so on.).

2. Create objects from each segment file, preserving the segment file names. Create all objects in the same container.
3. Create a manifest object which specifies the container with all of the segment objects and the common prefix shared by all segment objects. The manifest object, when downloaded, will sequentially concatenate all segment objects together to produce an object equivalent of the original file that was larger than 5 GB.

   In Eclipse in the Oracle Cloud view, right-click a container and choose New Manifest Object.

4. In the New Manifest Object dialog:

   - Enter a name for the manifest object.

   - Choose the segment container that holds the segmented objects.

   - Choose the prefix for the segmented object.

   - Enter a content type or accept the default (`application/octet-stream`).

   Click OK.

   The new container is created and listed in the Oracle Cloud view.

## How to Bulk-Create Objects

To bulk-create objects, you can create `*.tar` file and `*.tar.gz` files to contain archives and add them to Oracle Storage Cloud Service by dragging them to the Cloud Storage connection in the Oracle Cloud view.

The archive file must have the proper structure, with the top level of folders corresponding to existing Cloud storage containers. For more information, search for "Bulk-Creating Objects" in the Oracle Storage Cloud Service Help Center at `http://docs.oracle.com/cloud/latest/storagecs_common/index.html`.

## How to Manage Container and Object Properties

You can manage container properties in the Properties dialog. It allows you to edit metadata, and to view:

- Container or object name.

- The URL to the specific container or object at Oracle Cloud.

- The size of the container or object.

To edit container or object metadata:

1. In the Oracle Cloud view, right-click a container or an object and choose Properties.
2. In the Properties dialog select Container.
3. In the Container page, add or edit the metadata as name/value pairs. When you are finished click Apply and then click OK.

## How to Control Access to Containers

You can specify the access types available to the different roles for your Storage service.

You can specify the roles available for your service in the IDM Console, see How to Open the IDM Console.

1. In the Oracle Cloud view, right-click a container and choose Properties.
2. In the Properties dialog select Container Access Control.
3. In the Container Access Control page, specify the role. Click to create a new row, and click to open the Role dialog where you can select one of the roles defined for your Storage service.
4. Choose the type of access by double-clicking the Access type and choosing and choosing from the list: Read Only, Read and Write, Write.
5. When you are finished click Apply and then click OK.

## How to Use Encryption

Oracle Storage Cloud Service supports object encryption. For more information, search for "Encrypting Objects" in the Oracle Storage Cloud Service Help Center at `http://docs.oracle.com/cloud/latest/storagecs_common/index.html`

Encryption key pairs can be managed at Cloud service level, or at container level, or at the object level. You can:

- Assign security key pairs to the Cloud storage connection. These security key pairs can be used to encrypt and decrypt objects.

- Automatically decrypt encrypted files when they are downloaded.

- Optionally encrypt files when the are uploaded to the Cloud.

The encryption options are:

- Always encrypt. Encryption will always be used when storing objects to the Cloud service.

- Never encrypt. Encryption will never be used for storage objects.

- Always ask. You will be prompted to choose whether the object should be encrypted.

When you upload an object to Oracle Cloud storage instance, the Specify a RSA Key Pair dialog, shown below, opens where you can choose whether the object is encrypted.

Figure: Encrypting an Uploaded Object

### Using Service Level Encryption

To set encryption at service level:

1. In the Oracle Cloud view right-click the Storage service under the Cloud connection and choose Properties.
2. In the Properties dialog, choose Security. The Security page allows you to specify how the service uses encryption:

   - Choose the behavior: Always encrypt, Never encrypt, Always ask.

   - If you have chosen Always encrypt or Always ask, you can enter a private and public key pair. Click to navigate to a key in the file system.

     If necessary, click Generate a key pair to have OEPE generate them for you.

3. Click Apply, then OK.

### Using Container Level Encryption

To set encryption at container level:

1. In the Oracle Cloud view right-click the container and choose Properties.
2. In the Properties dialog, choose Encryption. The Encryption page allows you to specify how the container uses encryption:

   - Choose the behavior: Always encrypt, Never encrypt, Always ask.

   - If you have chosen Always encrypt or Always ask, you can enter a private and public key pair. Click to navigate to a key in the file system.

     If necessary, click Generate a key pair to have OEPE generate them for you.

3. Click Apply, then OK.

### Using Object Level Encryption

If an object is encrypted, this is indicated by having a lock icon overlay in the Oracle Cloud view.

If an object has inherited encryption from the container or the service, then in the Properties dialog the encryption details on the Object Encryption page are greyed out. You can override the inherited encryption by using object specific keys

To set object encryption:

1. In the Oracle Cloud view right-click the object and choose Properties.
2. In the Properties dialog, choose Object Encryption. The Object Encryption page allows you to enter a private and public key pair. Click to navigate to a key in the file system.

   If necessary, click Generate a key pair to have OEPE generate them for you.

3. Click Apply, then OK.

## How to Open Storage Cloud Control

You can open the Storage Cloud Control web interface, where you manage your Oracle Storage Cloud Service, from the Oracle Cloud view:

- In the Oracle Cloud view, right-click the Storage node under the Cloud Service connection and choose Open Storage Cloud Control.

  The Storage Cloud Control web interface opens in the Eclipse browser.

## How to View Storage Cloud Size

You can see how much of the quota you have used by examining the properties of the Storage Cloud Service.

To view the quota and how much has been used:

1. In the Oracle Cloud view, right-click the Storage service under the Cloud connection and choose Properties.
2. The General page of the Properties dialog displays the name of the service, and the quota and how much of the quota has been used.