User Tools


Using Dragon Disk to Connect with LibCloud

In 2014, the Coop rolled out a new remote storage service called LibCloud. Libcloud uses ceph, a distributed storage technology that supports the Amazon s3 API as well as the Openstack Swift API. In order to connect to Libcloud, users need to use a client that supports one of these APIs.

One such client is Dragon Disk, which is both free and cross platform. Below are instructions on how to connect to LibCloud via Dragon Disk

Download Dragon Disk

Dragon disk can be downloaded from http://www.dragondisk.com/download-amazon-s3-client-google-cloud-storage-client.html

Once you have downloaded it, open the downloaded file (or in the case of Linux run the standard procedure to install the package) to install it locally.

Configure the Account

You will have received an email with the details needed to connect to LibCloud. It should have contained the following details:

  • username
  • access_key
  • secret_key
  • Hostname
  • Bucket

Open up Dragon Disk. Under the File menu, go to Accounts

Then click New. This will open up the dialog box to enter in the details you have recieved. In the drop down menu, select "Other S3 Compatible Service"

The "Service Endpoint" is the Hostname. Enter it.

The "Account name" is the user name you have been sent. Enter it.

Enter the access key and secret key. Click ok. The account has now been set up.

Connect Manually

Once you've set up the account, you can connect to it manually to upload a file. Dragon Disk functions like many file transfer programs - in the main window there are two places to connect to file systems. One will be the source, the other will be the target.

Presuming that the file you want to transfer is on your hard drive, in the first (left-hand) "Root" menu, select the root (e.g. /) of your computer and navigate to the file or directory you want to transfer

Then, in the right hand pane, select the S3 endpoint you just set up (it will be named with the account name you chose.) In this example it is "BGSI"

Transferring a file or directory manually is as simple as dragging it from one pane to the other. To transfer a file from your hard drive up to libcloud, in this example simply select it in the left-hand pane and drag it over to the right.

Set up a Sync Job

A more common use case for LibCloud is to back up an entire directory on a regular basis. Ceph supports incremental updates via "Synchronization" of files and directories. To set this up, go to the Synchronization Menu and select "Manage Sync Jobs" Next, "Add" a new job. This will bring up a dialog which asks you to give this job a name, and pick the source and target directories. Give it whatever descriptive name you like. The Source and Target directories are exactly like above - source is where you want to copy from (typically your hard drive) and Target is the LibCloud endpoint. There are other configuration options here, but by and large the default work fine. Once you have set this up, sync the directories is as straightforward as using the Sync command under the Synchronization menu More advanced users wanting to automate synchronization may want to investigate command line tools, which Coop staff are happy to explore with you.

Additional Help

This is but a brief overview. For more details we encourage you to refer to the Dragon Disk documentation itself.

In addition, ceph itself has extensive API documentation available at http://ceph.com/docs/master/api/ for the more ambitious.

public/dragon-disk.txt · Last modified: 2018/08/16 22:06 (external edit)