Attach a volume through an S3-compatible endpoint

Overview

Follow the procedure below if you want to connect your storage as a volume to CAVATICA using an S3-compatible endpoint:

  • There is an additional API layer implemented on your cloud storage, compatible with the AWS S3 API. This means that you need to use an additional service or software on top of your storage, that will emulate the behavior and interaction of AWS S3 storage. You will then use the AWS option in the connection wizard on CAVATICA to attach your storage.
  • You or your cloud storage administrator can provide S3-compatible storage endpoint and credentials that are required to connect the storage to CAVATICA. These should be available for creation or obtaining when you have met the previous prerequisite.

📘

You can use an S3-compatible endpoint only when it has been whitelisted on CAVATICA.

Or, learn more if the storage bucket that you want to attach is actually hosted on Amazon Web Services or Google Cloud Storage (GCS).

Step 1: Access the Volumes Dashboard

  1. Click on the Data tab of the top navigation bar.
  2. Select Volumes from the drop-down menu.

Step 2: Choose a cloud storage provider

  1. On the Volumes Dashboard, click +Attach volume.
  2. Select Amazon Web Services as your cloud storage provider.
  3. Click Next.

Step 3: Provide S3 bucket details

  1. Enter your cloud storage bucket name.
  2. (Optional) Define a new name for the volume created on CAVATICA.
  3. (Optional) Enter a description for your volume.
  4. Keep Read only (RO) selected as this is the only connection mode available for this type of cloud storage at the moment. Trying to connect the volume in read-write mode will result in an error.
  5. (Optional) enter a prefix.
  6. Click Next.

Step 4: Policy

This step is not needed when connecting storage other than AWS S3 or GCS. Click Next to continue.

Step 5: Enter user credentials

  1. Enter Access Key ID and Secret Access Key. If you are not sure about these credentials, ask your cloud storage administrator.
  2. Click Next.

Step 6: Configure additional options

  1. Enter the storage S3-compatible endpoint. If you are not sure about the endpoint, ask your cloud storage administrator.
  2. Unless you have specific instructions about Server-side encryption type and Canned ACL, keep the default values.
  3. Click Next.

Step 7: Review volume details

On this tab, review the details for your volume and click Connect.

Next step

Congratulations! You've attached your volume to CAVATICA. You can make individual data objects within it available as "aliases" on CAVATICA. Aliases point to files stored on your cloud storage bucket and can be copied, executed, and organized like normal files on CAVATICA.