Amazon S3 - C2S Access Portal

Name

The name of the Cloud library.

Device Name

A unique device name generated by the system when the library is added.

Type

Select Amazon S3 from the list.

MediaAgent

The name of the MediaAgent to which the device is attached. Select a MediaAgent from the list to add to the cloud storage device. The list contains the names of all the MediaAgents configured in the CommCell.

Access Information

Add the credentials and other details required to access the cloud storage space.

Authentication

Select C2S Access Portal.

Use this Authentication for a user with credentials to either the Amazon C2S (Amazon Commercial Cloud Services) or Amazon SC2S (Amazon Secure - Commercial Cloud Services).

Service Host

A valid endpoint name for the Amazon S3 region provided by the agency. (Commvault transfers data using HTTPS protocol to the service host.)

Default: s3.[region].amazonaws.com. For example, s3.us-west-1.amazonaws.com.

• To find the region, see https://docs.aws.amazon.com/general/latest/gr/rande.html.

• Multiple hosts can be added in the Service Host field using commas to separate them. For example servicehost1, servicehost2, servicehost3. (For local cloud servers with multiple IP addresses, the list of IP addresses can be added. For example, 192.xxx.0.100,192.xxx.0.101, 192.xxx.0.102. )

  Note

  All the hosts (or IP addresses) in the list must point to the same storage. Adding a host or IP address to a different storage will result in data loss.

CAP URL

The CAP URL.

For example:

https://<URL:Port_Name>/TAP/api/v1/credentials?agency=<agency>&mission=<mission>&role=<role>

Certificate Filename

The certificate file name provided by the agency. For example: <file_name>.p12.

Make sure that the file is copied and available in all the MediaAgents using the library under the following folder:

<software install folder>/Base/Certificates

Passphrase

The password for the certificate file provided by the agency.

Bucket

Click the Detect button to detect an existing bucket.

Sometimes, existing bucket list may not get populated while detecting the buckets, as some vendors may not support this operation, or if there are no permissions to complete the operation. In such cases, type the name of the existing bucket that you want to use. The system will automatically use the existing bucket if it is available.

The following permissions must be enabled for the bucket:

Sample json file with these permissions.

"s3:CreateBucket",
"s3:GetBucketLocation",
"s3:GetObject",
"s3:PutObject",
"s3:PutObjectRetention",
"s3:PutObjectTagging",
"s3:ListBucket",
"s3:ListAllMyBuckets",
"s3:DeleteObject",
"s3:DeleteObjectVersion",
"s3:ListBucketVersions",
"s3:PutBucketObjectLockConfiguration"
"s3:PutBucketVersioning",
"s3:GetBucketVersioning",
"s3:GetBucketObjectLockConfiguration"

• The CreateBucket permission is required only when the bucket must be created by the MediaAgent while configuring the cloud storage. (This permission can be skipped if an existing bucket is used for configuring the cloud storage.)

• The ListAllMyBuckets permissions request is required for the Detect button to work.

• For a bucket with versioning enabled, the user must have DeleteObjectVersion and ListBucketVersions permissions to delete a versioned objects when a pruning request is sent to delete the objects.

• To recall data from Amazon Glacier Glacier/Deep Archive or Combined Tier Storage Classes, make sure that the user associated with the bucket has the RestoreObject permission. For more information on POST Object restore, see https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html.

• The PutBucketVersioning permission is required to enable versioning on the bucket. Object lock can be enabled only on versioning enabled bucket.

• The GetBucketVersioning permission is required to infer whether versioning is enabled on a bucket or not.

• The GetBucketObjectLockConfiguration permission is required to infer whether object lock is enabled on a bucket or not.

Storage Class

The following Amazon S3 storage classes are supported for Commvault Cloud Storage libraries:

• S3 Standard

• S3 Intelligent-Tiering

• S3 Standard-Infrequent Access

• S3 One Zone - Infrequent Access

• S3 Glacier Instant Retrieval

• S3 Glacier Flexible Retrieval

• S3 Glacier Deep Archive

• S3 Reduced Redundancy Storage

Reference https://aws.amazon.com/s3/storage-classes/ for more information.

Use Combined Tier

Enable the option to use a combine storage tier, with S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, or S3 Glacier Deep Archive Storage Classes.

This option will be enabled when S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, or S3 Glacier Deep Archive Storage Class is selected.

Combined Storage Class

The following combined Storage options are available for the Glacier Flexible and Glacier Deep Archive storage classes:

• Intelligent Tiering

• One Zone - Infrequent Access

• Standard

• Standard- Infrequent Access