This technical note documents how to configure Cloudian with Dragondisk GUI file manager.

1. March 10, 2014
Cloudian Sales Engineering KB Collection
Dragondisk S3 Client Integration

2. I. Introduction
Dragondisk is a file manager for Windowsthat allowsclientsto synchronize,copy, move and delete
filesbetweentheirlocal storage and a cloud objectstorage such as Amazon S3, Google Cloud drive,
includingCloudianS3 objectstorage platform. Dragondisk is a GUI basedclientapplication.
In additionto the GUI application,there isa command line utilitycalled: dgsync.exe that is designed
to provide the same featuresas the GUI but in command line interface. In the labsof salesengineering
it has beendeterminedthat dgsync.exe isnot fully supported withCloudian. This 3rd part applicationis
currently defunctand it is possible that at the time Dragondisk ceased to exist,onlya partial
integrationto Cloudianwas completed.
This technical note documents howto configure CloudianwithDragondisk GUI file manager. A
separate sectionwill explainwhywe determinedthat dgsync.exe isnot fullyintegratedwithCloudian.

3. II. Dragondisk File Manager
Dragondisk is a file manager for Windowsthat allowsclientsto synchronize,copy, move and delete
filesbetweenaclient’slocal drive and the cloud(such as Amazon S3, Google Drive,and other S3
compatible storage). This sectionwill demonstrate how to quicklyintegrate the CloudianObject
storage software on-premise orhybrid cloudsolutionwith Dragondisk File Manager. For more detailed
informationplease visitthe Dragondisk Website’sFAQ.
This Technical Note describesthe Dragondisk File Manager for Windows integrationwithCloudian. For
more detailson Dragondisk GUI, please referto the Quick Start Guide.
1. Download Dragondisk for Windows here.
2. Followthe Windows Installationprocess and complete the installation.
3. Click on the Dragondisk icon to launch the applicationand you will see this:

4. 3. On the upper left-handcorner of the screen, clickon File -> Accounts-> and you will see the
followingpop-upwindow:
4. Click on the <New> button and then click on the Provider scroll down button to selectthe provider:
“Cloudian Powered Cloud”. Enter the valuesto connect to your Cloudiancluster as in the example
below:

5. The followingdefinesthe requiredfieldsthatyou will needto enter:
 Service Endpoint fullyqualifieds3.<company>.com that you definedduringyour Cloudian
installation. The defaultS3 domain ina Cloudianinstallationis s3.cloudian.com. Enter the
domain name that appliesto your environment.
 Account Name user-definedvariable thatyouwish to label this S3 bucket/folder
 Access Key your account’s Access that is available foryou to copy from your Cloudian
CMC: loginas the user, Clickon Account-> SecurityCredentialsand thencopy and paste the
Access Keyvalue.
 Secret Key while at the CloudianCMC in the Security Credentialswindowas
describedabove,click on View Secret Key and thencopy and paste the value intothis field
 HTTP Port the defaultport in Cloudianis18080
 HTTPS Port the defaultSSL/HTTPS port is 18443
Clickon the <OK> tab. You will returnback to the main Dragondisk GUI. Simplyclick the scroll down
arrow on the upperlefthand corner of the screenby the Root prompt and you may selectthe
appropriate local file systemfolderor cloudbucket/folderfrom Cloudian.

6. III. dgsync.exe
Dragondisk’s dgsync.exe isthe command line tool that let’syou schedule backups. The Dragondisk GUI
does not provide any scheduledbackup features.
The followingshowsattemptsto integrate thisutilitywithCloudian. However we realizedthat the
code has problemswith performinga PUT, we noticedit onlyputs directories,howeverisfine with
performinga GET. We therefore conclude that dgsync.exe is not fully integratedwithCloudian’s
object storage platform.
1. The syntax to run dgysnc isas following:
dgsync.exe -A008a2726cbfb345d736f-S y3CsJ9Jy6NK8JuRO382hsjauOAOeas5YUcR/TYZU--endpoint
s3.cloudian.jp "C:/temp/""http://anna01.s3.cloudian.jp/temp/"
-A = Access key
-S = Secretkey
--endpoint=your S3 domainname,intheaboveitis: s3.cloudian.jp
“C:/temp/”= sourcedirectoryresidingin my localdrive
“http://anna.01.s3.cloudian.jp/temp”=syntaxto accesstheuser’sbucketandfolder: anna01isthebucket,/temp isa
folder residingunder thebucket.
2. The problemwith the above,although upon runningthe command, it resultsin success per the
output revealedinverbose mode:
PUTn
n
application/octet-streamn
Sun,09 Mar 2014 19:35:53GMTn
/anna01/temp/Cloudian%20Cisco%20Test%20Plan%20and%20Results%20-Cisco%20Sept%2020
13.docx
3. However, when I checkedthe Data Explorerin the CMC the fileswere not uploadedsuccessfully.
However,performinga GET proved to be successful:
dgsync.exe-D -v -A008a2726cbfb345d736f -S y3CsJ9Jy6NK8JuRO382hsjauOAOeas5YUcR/TYZU--endpoint
s3.cloudian.jp "http://anna01.s3.cloudian.jp/temp/""C:/temp"
4. Finallyto note,if you needto change the defaultport numbers (default: 80/443 for HTTP/HTTPS)
using the –port argument, the command line doesnot seemto pass this value into the server. During
our integrationtests in the labs we noticedthat if the Cloudianobjectstorage isconfiguredwith
18080/18443 ports the command fails.However,whenwe changed the Cloudianlisteningport to
80/443 the command succeeds.