1.7 Cyberduck

Here is a guide on how to use the Aruba Object Storage service with the Cyberduck connection client. To use the service you need the following details:

Account Name - the name you have given to the account when creating it;
Password - the password you have chosen for the account;
Region URL - the address of the Region to which the account belongs to, available in the account details page;
 
  • Download the software, start the installation and run the program.
  • An interface like the following will open.

  • Click on "Open Connection" found in the left corner of the menu at the top. A window will open where you will need to configure the settings.
    Select the "S3 (Amazon Simple Storage Service)" option from the list of available connections.
    Enter the Region URL indicated in the Object Storage account details page (without http://) in the "Server" field.
    Enter the Account name of the Object Storage account in the "Access Key ID" field.
    Enter the Password of the Object Storage account in the "Secret Access Key" field.



  • Click on "Connect". The Cyberduck client is now connected to the remote space associated with the Object Storage account. It is possible to check if the operation has been successful by seeing the "Title" of the application which should be changed from "Cyberduck" to that of the entered Region URL.
  • The first thing you need to do is create a folder which will represent the "bucket" (unique for each Region) of the Object Storage account, the name of the folder will serve to generate the URL you will then type in the browsers to access the files uploaded in the remote space.
  • Click on "New Folder" found in the dropdown menu in "File".

  • You will need to enter the name of the new folder you are creating (see guide). You can create several folders (and therefore several "buckets") within the same remote space.

  • To upload a file, go to the created folder, click on "Upload" found on the right of the top menu. Select the file and confirm the upload. After completing this process you will find the file in the remote space and you will have access to it via web browser.
  • Before you download a file you need to configure the space where the file will be downloaded. Select "Preferences" in "Edit" at the top, then click on "Transfers" to select the download location folder.
  • To download a file right-click on the file and click on "Download": the file will be downloaded by following the previously configured path.

Configure the permissions

After uploading a file in the remote storage space it is possible to configure the permissions and decide whether to make it private. The permissions can be assigned to the bucket, to the folders and to the single files. To make an item private proceed as follows:
 
  • Select the item (bucket, folder or file) in the remote storage space and right-click it, a dropdown menu will appear,
     
    Alternatively it is possible to select the item and then click on the "Get Info" icon found in the menu at the top.

     
  • Select "Info". The "Info - item name" window will appear.



    [N.B. In this example "TestStorage" is the account used for the Object Storage service.]
  • Select "Everyone" in "Permission", a list like the following will appear,

  • It is possible to select one of the listed options. To make the file private select "WRITE". To make the file public select "READ". For experienced users it is also possible to create new profiles by using the button found in the bottom left corner.
  • The permissions cannot be inherited. Therefore if you configure a folder as private, the items it contains will be public. The permissions need to be configured on the item you wish to make private.
  • We remind you that Cyberduck by default configures any uploaded file as a public file. It is therefore necessary to perform the above process to make it private.