HomeGuides
Log In
Guides

Storage Class: Amazon S3 - NEW! 🚀

Before you start configuring your remote Amazon S3 Storage Class, follow the instructions at this link on how to import the relevant certificates to properly operate an Amazon connector.

Once you have done that, these are the fields you need to fill in to create a new Amazon S3 Storage Class:

FieldDescription
NAME (*) Assign a Name to the Storage Class.
A maximum of 128 characters is allowed.
DESCRIPTION Enter the description of the Storage Class.
LOCATION TYPE (*)The location where files are stored. Choose Amazon S3 to store files on an Amazon S3 connector.
CONNECTION TIMEOUT (*)Number of seconds without network activity to wait before closing a session due to inactivity.
Default value: 60.
AUTHENTICATION TYPE Select if authentication occurs with Access Key (BASIC) or with Security Token Service (STS):
  • BASIC (default)

  • STS (Security Token Service)
    The STS authentication mode gives the user temporary access to use S3 api based on permissions given by credentials of another user. For example, if user A has permissions to upload and download a file, user B that connects using STS based on credentials of user A will inherit the same privileges.
  • ACCESS KEY ID (*) This field appears when BASIC is selected.
    Enter the AWS access key ID.
    SECRET ACCESS KEY (*)This field appears when BASIC is selected.
    Enter the AWS secret access key.
    BUCKET NAME * Enter the name of the S3 bucket. The minimum number of characters is 3 and the maximum is 63. Blanks are not supported.
    REGION *Select the region of the S3 bucket specified in the BUCKET NAME field.
    ENDPOINT URL Enter the URL of the entry point for the AWS web service.
    This field is optional and is used only to override the bucket name and region.
    It is recommended to leave this value blank unless connecting to a non-standard service endpoint. When empty, the endpoint is determined automatically based on the Region specified in the Basic field. If used, this property overrides the bucket name and the region.
    UPLOAD PART SIZE *This is the size of each part in a multipart upload. By default it is set to 5 MB and the value must be less than 10 MB.
    Multipart upload allows uploading an object (file) as a set of parts. Once uploaded, the object will be available as a unique part. This facilitates the upload, especially in case of pause and resume.
    VOLUME DESCRIPTION (*) Enter the volume description of the physical storage.
    INTERNAL FILES LOCATION (*) Enter the physical path where INTERNAL files must be saved. The path must begin with a "/". 🚀 If you do not enter it, the system will add it automatically.
    EXTERNAL FILES LOCATION(*) Enter the physical path where EXTERNAL files must be saved. The path must begin with a "/". 🚀 If you do not enter it, the system will add it automatically.
    TEMPORARY FILES LOCATION (*) Enter the physical path where incoming external files are temporarily saved before their transfer is completed. The path must begin with a "/". 🚀 If you do not enter it, the system will add it automatically.
    CLUSTERS Select the Cluster you want to associate with the Storage Class.
    SYMMETRIC KEYS Select the symmetric key you want to associate with the Storage Class.

    Note: If the menu is read-only, some files are already associated with the Storage Class. It must be empty to associate a Symmetric Key. Refer to the Security section for details on the association of a Symmetric Key.
    CONFIGURATION TESTUse this section to test whether the remote Storage Class you have selected can appropriately operate into Data One. Select the Cluster onto which you want to test the connection and press the TEST button. If only one Cluster is available, Data One will automatically select that Cluster to test the Storage Class.

    A list of the actions that the Storage Class can perform will appear for each peer associated with the selected Cluster. A green check will confirm that the action can be performed. A red exclamation mark will warn that the action cannot be executed. By hovering over each action, a tooltip with the description, elapsed time, and transfer rate of the action will appear.

    Warning: We recommend choosing a remote Storage Class that can sustain all of the actions listed in this test.

    Once you have created the Storage Class, press Save and your Storage Class will appear in the Result list.