Cyberduck is a free open source file transfer program for MacOS and Windows that supports several different transfer protocols (e.g., FTP, WebDAV). As of version 4.7.1, released July 7, 2015, Cyberduck supports direct data transfer into and out of iRODS. Cyberduck users can now directly upload and download files and directories from iRODS repositories using the high-throughput and parallel data transfer capabilities built into iRODS.
This post covers the installation and configuration of Cyberduck for use with iRODS. This is a slightly modified version of the instructions written by iPlant for use with the iPlant Data Store.
If Cyberduck is already installed, check if you need to update (must be version 4.7.1 or later):
To install Cyberduck for your operating system for the first time:
Go to the Cyberduck installation page at https://cyberduck.io/.
Follow the steps for your OS:
Click Download Cyberduck-4.7.1.zip (or later version than 4.7.1).
Extract and move the contents of the downloaded file to your Applications folder. IMPORTANT: The file must be located in your Applications folder.
Alternatively, you can install Cyberduck for Mac OS directly through the Mac Store for a fee that supports the Cyberduck development team.
Click Download Cyberduck-Installer-4.7.1.exe (or later version than 4.7.1, if displayed).
Locate the downloaded file and double click to begin installation.
Go through the install process.
To connect Cyberduck to an iRODS repository, you must first bookmark the connection using a .cyberduckprofile Connection Profile file.
Click this link to download a Connection Profile template, which contains preconfigured settings for using Cyberduck with iRODS repositories.
Use a text editor to edit the contents of the Connection Profile.
At a minimum, you will need to edit the "Region" key with the iRODS Zone name and default resource that you will connect to in the format zone_name:resource_name. You may also edit the default hostname, or you may opt to configure it at runtime.
Save the updated Connection Profile.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Protocol</key> <string>irods</string> <key>Vendor</key> <string>iRODS</string> <key>Description</key> <string>iRODS Cyberduck Bookmark</string> <key>Hostname Configurable</key> <true/> <key>Port Configurable</key> <true/> <key>Default Hostname</key> <string>hostname.example.org</string> <key>Region</key> <string>tempZone:demoResc</string> <key>Default Port</key> <string>1247</string> <key>Username Placeholder</key> <string>iRODS username</string> <key>Password Placeholder</key> <string>iRODS password</string> </dict> </plist>
Double click the updated irods.cyberduckprofile file to open it as a Cyberduck bookmark. The profile will open so you can edit the defaults.
Update the Cyberduck bookmark.
These instructions provide basic instructions for downloading and uploading files to an iRODS repository using Cyberduck.
In the Cyberduck window, double-click a bookmark.
Log in to the iRODS server using your iRODS username and password. By default, your Home folder is selected.
Once connected, to download a file or folder from iRODS using Cyberduck:
Click the file or folder to download.
Click the Cyberduck File menu and then click Download. The file is downloaded to your default download folder.
To navigate to a different folder:
Click the Cyberduck Go menu and then click Go to Folder:
To upload a file or folder to an iRODS repository using Cyberduck:
Click the Cyberduck File menu and then click Upload.
Click the file or folder to upload and then click Upload.
See the Cyberduck Preferences Help page for more information on installation, or connect with us on the iRODS Chat Google Group. If you are at an iRODS Consortium member site, you may contact us directly for support.