A SHORT INTRODUCTION TO CYBERDUCK WITH CLOUD OBJECT STORAGE Version 1.12 2014-07-01
PAGE _ 2 TABLE OF CONTENTS 1. Introduction....Page 03 2. Access Cloud Object Storage using Cyberduck...Page 04 3. Create a New Container....Page 06 4. Upload File....Page 07 5. Download File....Page 09 6. Delete File............................................................................ Page 10 7. Edit File in External Editor....Page 11
PAGE _ 3 1. INTRODUCTION Cyberduck lets you transfer files to and from your local computer using a powerful and easy to use graphical user interface. Cyberduck supports the most common protocols, e.g., FTP, SSH/SFTP, WebDAV, OpenStack Object Storage (Swift), Windows Azure Storage, and Amazon S3, and using the Swift protocol you are able to connect to Cloud&Heat and interact with the Cloud Object Storage solution. With the combination of Cloud Object Storage and Cyberduck you have a setup which supports multiple connections, editing of files in an external editor, a bookmarking system, the most common protocols, and offers an all-around pleasant user interface and an excellent user experience. Since Cyberduck uses Cloud Object Storage as a backend, all the containers and files that are uploaded using Cyberduck are also accessible using the Cloud&Heat Dashboard. Read A Short Introduction to Cloud Object Storage for more information. The data stored in Cloud Object Storage is encrypted at rest, but to achieve maximum security we recommend additionally encrypting the data. Also note that although the Swift specification does not allow directories or folders inside a container, it is possible to create them using Cyberduck, since Cyberduck also supports other protocols. Doing so is however not supported by Cloud&Heat. Cyberduck is available for Windows and Mac OS. The documentation covers Cyberduck Version 4.4.3.
PAGE _ 4 2. ACCESS CLOUD OBJECT STORAGE USING CYBERDUCK 1) Download and install Cyberduck (http://www.cyberduck.io). 2) Login to the Cloud&Heat Dashboard. Username and password were provided in the initial email you received when signing up with Cloud&Heat. 3) Download the Cyberduck profile from Cloud&Heat Dashboard. The download button can be found in the Cloud&Heat Dashboard under Access & Security > API Access > Download Cyberduck Profile. 4) Open the Cyberduck profile using Cyberduck. This can either be done by double clicking on the Cyberduck profile file, or by dragging the profile file onto the icon of the Cyberduck program. A window will open.
PAGE _ 5 5) Close the window. You will see a different window with an entry showing an Cloud&Heat icon labeled with your connection information. 6) To log in, double click on the entry. You will be presented with a login window. 7) As username, enter your Cloud&Heat project name and username separated by a colon. The Cloud&Heat username is what you use to log in to the Cloud&Heat Dashboard, and the Cloud&Heat project name can be found in the Cloud&Heat Dashboard under Current Project at the top of the left side bar. 8) As password, enter your password for the Cloud&Heat Dashboard. 9) Click the Login button. Cyberduck will log you in to your Cloud&Heat account, and if you already created containers and files over the Cloud&Heat Dashboard (see A Short Introduction To Cloud Object Storage), they are now visible.
PAGE _ 6 3. CREATE A NEW CONTAINER 1) To add a new container, select New Folder from the dropdown menu Action. You can also right-click in the lower part of the window, and select New Folder in the context menu that appears. 2) Enter the name of the container to be created, and click on Create.
PAGE _ 7 4. UPLOAD FILE 1) Initiate the upload process in one of the folloiwng three ways: a) Via Drag and Drop into the desired container (in which case you can skip the next step), or b) by right-clicking on the container and select Upload from the resulting context menu, or c) by selecting Upload from the dropdown menu Action.
PAGE _ 8 2) Select the desired file and click Upload. 3) Refresh the view of the container in Cyberduck, by pressing the Refresh button in the menu bar.
PAGE _ 9 5. DOWNLOAD FILE You can download a file in three ways: a) Drag and Drop the desired file to the desired target location, or b) right-click on the desired file and select Download from the resulting context menu, or c) first select the file, and then select Download from the dropdown menu Action. The download then starts automatically.
PAGE _ 10 6. DELETE FILE To delete a file from a container, either right-click on it and select Delete from the resulting context menu, or highlight the file to be deleted and then select Delete from the Action dropdown menu.
PAGE _ 11 7. EDIT FILE IN EXTERNAL EDITOR You can edit a file with an external editor in the following way: 1) Select the file to be edited in the Cyberduck window. 2) Select Edit With followed by your desired external editor in the Action dropdown menu. 3) The selected file will be saved in a temporary directory, and after you close the file, the changes will be automatically propagated to the file in the Cloud Object Storage. To see the new changes be reflected in the size and modification date displayed, select the Refresh option in the Action dropdown menu.