Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
rdms:access:windows:cyberduck [2026/07/08 12:54] – burcurdms:access:windows:cyberduck [2026/07/09 06:50] (current) – burcu
Line 1: Line 1:
 ====== Cyberduck ====== ====== Cyberduck ======
  
-Cyberduck is an open-source client for FTP, SFTP, and WebDAV available for macOS and Windows. It is pre-installed on the University Workspace (UWP) PCs and on the [[https://uwp.rug.nl/|virtual UWP]]. If you work on a user-managed workplace or any other device, you can [[https://cyberduck.io/download/|download Cyberduck]] from its official website.+Cyberduck is an open-source client for FTP, SFTP, and WebDAV available for macOS and Windows. It is pre-installed on the University Workspace (UWP) PCs and on the [[https://uwp.rug.nl/|virtual UWP]]. If you work on a user-managed workplace or any other device you can [[https://cyberduck.io/download/|download Cyberduck]] from its official website.
 {{ :rdms:access:cyberducklogo.png?direct&100|}} {{ :rdms:access:cyberducklogo.png?direct&100|}}
  
Line 29: Line 29:
  
 ===== Configuration of Cyberduck using the native iRODS Protocol ===== ===== Configuration of Cyberduck using the native iRODS Protocol =====
 +**Note: As of July 2026, there is a new iRODS native template for the Cyberduck profile. If you are using the old profile, Cyberduck will fail to connect and will ask for your credentials again. The profile in the Wiki is updated.**
 +
  
 If you would like to use the native iRODS protocol for connecting Cyberduck to the RDMS, you can download the iRODS (RUG) Cyberduck profile directly by clicking on the link below or by copying the content to a text editor of your choice and then saving it as a ''*.cyberduckprofile'' file. Afterwards, double-click the downloaded/created ''*.cyberduckprofile'' file to install and add it to Cyberduck. If you would like to use the native iRODS protocol for connecting Cyberduck to the RDMS, you can download the iRODS (RUG) Cyberduck profile directly by clicking on the link below or by copying the content to a text editor of your choice and then saving it as a ''*.cyberduckprofile'' file. Afterwards, double-click the downloaded/created ''*.cyberduckprofile'' file to install and add it to Cyberduck.
Line 34: Line 36:
 **iRODS Cyberduck profile**:  **iRODS Cyberduck profile**: 
 ++++ Click to display section | ++++ Click to display section |
 +<file xml RDMS.cyberduckprofile>
 <?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
 <!-- <!--
Line 39: Line 42:
   ~ https://cyberduck.io/   ~ https://cyberduck.io/
   ~   ~
-  ~ This program is free software; you can redistribute it and/or modify it+  ~ This program is free software; you can redistribute it and/or modify
   ~ it under the terms of the GNU General Public License as published by   ~ it under the terms of the GNU General Public License as published by
   ~ the Free Software Foundation; either version 2 of the License, or   ~ the Free Software Foundation; either version 2 of the License, or
Line 48: Line 51:
   ~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the   ~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   ~ GNU General Public License for more details.   ~ GNU General Public License for more details.
 +  -->
 +
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0"> <plist version="1.0">
Line 54: Line 59:
         <key>Protocol</key>         <key>Protocol</key>
         <string>irods</string>         <string>irods</string>
 +
         <!-- Undocumented for CLI, the URI prefix, e.g., rug:// -->         <!-- Undocumented for CLI, the URI prefix, e.g., rug:// -->
         <key>Vendor</key>         <key>Vendor</key>
         <string>rug</string>         <string>rug</string>
 +
         <!-- Name of the profile -->         <!-- Name of the profile -->
         <key>Description</key>         <key>Description</key>
         <string>RDMS (rug) 9.4.0+, iRODS 4.3.2+</string>         <string>RDMS (rug) 9.4.0+, iRODS 4.3.2+</string>
 +
         <!-- Default name of bookmark -->         <!-- Default name of bookmark -->
         <key>Default Nickname</key>         <key>Default Nickname</key>
         <string>RDMS rug zone</string>         <string>RDMS rug zone</string>
 +
         <!-- iRODS hostname settings -->         <!-- iRODS hostname settings -->
         <key>Hostname Configurable</key>         <key>Hostname Configurable</key>
Line 68: Line 77:
         <key>Default Hostname</key>         <key>Default Hostname</key>
         <string>store.data.rug.nl</string>         <string>store.data.rug.nl</string>
 +
         <!-- iRODS port settings -->         <!-- iRODS port settings -->
         <key>Port Configurable</key>         <key>Port Configurable</key>
Line 73: Line 83:
         <key>Default Port</key>         <key>Default Port</key>
         <string>1247</string>         <string>1247</string>
 +
         <!-- Default path to open -->         <!-- Default path to open -->
         <key>Default Path</key>         <key>Default Path</key>
         <string>/rug/home</string>         <string>/rug/home</string>
 +
         <!-- The zone of the iRODS server to connect to.  For backward -->         <!-- The zone of the iRODS server to connect to.  For backward -->
         <!-- compatibility, a root resource can be specified by appending -->         <!-- compatibility, a root resource can be specified by appending -->
Line 83: Line 95:
         <key>Region</key>         <key>Region</key>
         <string>rug</string>         <string>rug</string>
 +
         <!-- The authentication scheme used to establish a connection to -->         <!-- The authentication scheme used to establish a connection to -->
         <!-- an iRODS server.  Must be set to "native" or "pam_password". -->         <!-- an iRODS server.  Must be set to "native" or "pam_password". -->
Line 88: Line 101:
         <key>Authorization</key>         <key>Authorization</key>
         <string>pam_password</string>         <string>pam_password</string>
 +
         <!-- Advanced properties -->         <!-- Advanced properties -->
         <key>Properties</key>         <key>Properties</key>
Line 96: Line 110:
             <key>Destination Resource</key>             <key>Destination Resource</key>
             <string>rootResc</string>             <string>rootResc</string>
 +
             <!-- Controls whether deletion of an object permanently -->             <!-- Controls whether deletion of an object permanently -->
             <!-- removes or moves it into the trash collection. -->             <!-- removes or moves it into the trash collection. -->
             <key>Delete Objects Permanently</key>             <key>Delete Objects Permanently</key>
             <string>no</string>             <string>no</string>
 +
             <!-- The size (in bytes) of a file that must be exceeded before -->             <!-- The size (in bytes) of a file that must be exceeded before -->
             <!-- using parallel transfer. -->             <!-- using parallel transfer. -->
Line 105: Line 121:
             <key>Parallel Transfer Threshold</key>             <key>Parallel Transfer Threshold</key>
             <string>33554432</string>             <string>33554432</string>
 +
             <!-- The number of iRODS connections used for parallel transfer -->             <!-- The number of iRODS connections used for parallel transfer -->
             <!-- of a single file.  Each transfer will use the specified -->             <!-- of a single file.  Each transfer will use the specified -->
Line 111: Line 128:
             <key>Parallel Transfer Connections</key>             <key>Parallel Transfer Connections</key>
             <string>3</string>             <string>3</string>
 +
             <!-- The buffer size (in bytes) used for parallel transfer of -->             <!-- The buffer size (in bytes) used for parallel transfer of -->
             <!-- a single file. Applies to uploads and downloads.  The -->             <!-- a single file. Applies to uploads and downloads.  The -->
Line 116: Line 134:
             <key>Parallel Transfer Buffer Size</key>             <key>Parallel Transfer Buffer Size</key>
             <string>4194304</string>             <string>4194304</string>
 +
             <!-- Secure communication options must be one of "CS_NEG_REQUIRE", -->             <!-- Secure communication options must be one of "CS_NEG_REQUIRE", -->
             <!-- "CS_NEG_DONT_CARE", or "CS_NEG_REFUSE". -->             <!-- "CS_NEG_DONT_CARE", or "CS_NEG_REFUSE". -->
Line 123: Line 142:
             <key>Client Server Negotiation</key>             <key>Client Server Negotiation</key>
             <string>CS_NEG_REQUIRE</string>             <string>CS_NEG_REQUIRE</string>
 +
             <!-- TLS options, when enabled. -->             <!-- TLS options, when enabled. -->
             <key>Encryption Algorithm</key>             <key>Encryption Algorithm</key>
Line 135: Line 155:
     </dict>     </dict>
 </plist> </plist>
 +
 +</file>
 +
 ++++ ++++
  
-If everything went right, you will see the login screen below.  It will connect you to the RDMS "rug" zone using the native iRODS protocol. Insert your UG email address (lowercase!) and associated password to connect to the system. It should have also created an editable bookmark for your connection.+If everything went right, you will see the login screen below.  It will connect you to the RDMS "rug" zone using the native iRODS protocol. Simply insert your UG email address (lowercase!) and associated password to connect to the system. It should have also created an editable bookmark for your connection.
  
-{{ :rdms:access:windows:cyberduck_rug_connection.png?direct&500 |}}+{{ :rdms:access:windows:newcyberduckprofile_rug.png?direct&400 |}}
  
 ===== Configuration of Cyberduck to access the RDMS SD Zone ===== ===== Configuration of Cyberduck to access the RDMS SD Zone =====
 +**Note: As of July 2026, there is a new iRODS native template for the Cyberduck profile. If you are using the old profile, Cyberduck will fail to connect and will ask for your credentials again. The profile in the Wiki is updated.**
  
 In order to access the RDMS SD zone, you need to first download the RDMS Sensitive data zone Cyberduck profile directly by clicking on the link below or by copying the content to a text editor of your choice and then saving it as a ''*.cyberduckprofile'' file. Afterwards, double-click the downloaded/created ''*.cyberduckprofile'' file to install and add it to Cyberduck. Then, click **Open Connection**, select the RDMS SD Cyberduck Profile protocol, and configure the login credentials as follows: In order to access the RDMS SD zone, you need to first download the RDMS Sensitive data zone Cyberduck profile directly by clicking on the link below or by copying the content to a text editor of your choice and then saving it as a ''*.cyberduckprofile'' file. Afterwards, double-click the downloaded/created ''*.cyberduckprofile'' file to install and add it to Cyberduck. Then, click **Open Connection**, select the RDMS SD Cyberduck Profile protocol, and configure the login credentials as follows:
Line 148: Line 172:
 <file xml RDMSsd.cyberduckprofile> <file xml RDMSsd.cyberduckprofile>
 <?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
 +<!--
 +  ~ Copyright (c) 2002-2017 iterate GmbH. All rights reserved.
 +  ~ https://cyberduck.io/
 +  ~
 +  ~ This program is free software; you can redistribute it and/or modify
 +  ~ it under the terms of the GNU General Public License as published by
 +  ~ the Free Software Foundation; either version 2 of the License, or
 +  ~ (at your option) any later version.
 +  ~
 +  ~ This program is distributed in the hope that it will be useful,
 +  ~ but WITHOUT ANY WARRANTY; without even the implied warranty of
 +  ~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 +  ~ GNU General Public License for more details.
 +  -->
 +
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0"> <plist version="1.0">
     <dict>     <dict>
 +        <!-- DO NOT CHANGE. This is the purpose of the profile-->
         <key>Protocol</key>         <key>Protocol</key>
         <string>irods</string>         <string>irods</string>
 +
 +        <!-- Undocumented for CLI, the URI prefix, e.g., rug:// -->
         <key>Vendor</key>         <key>Vendor</key>
         <string>sdrug</string>         <string>sdrug</string>
 +
 +        <!-- Name of the profile -->
         <key>Description</key>         <key>Description</key>
-        <string>RDMS (sdrugZone)</string>+        <string>RDMS (sdrugZone) 9.4.0+, iRODS 4.3.2+</string> 
 + 
 +        <!-- Default name of bookmark -->
         <key>Default Nickname</key>         <key>Default Nickname</key>
         <string>RDMS sdrugZone zone</string>         <string>RDMS sdrugZone zone</string>
 +
 +        <!-- iRODS hostname settings -->
 +        <key>Hostname Configurable</key>
 +        <false/>
         <key>Default Hostname</key>         <key>Default Hostname</key>
         <string>store-sd.data.rug.nl</string>         <string>store-sd.data.rug.nl</string>
-        <key>Hostname Configurable</key>+ 
 +        <!-- iRODS port settings --> 
 +        <key>Port Configurable</key>
         <false/>         <false/>
-        <key>Region</key> 
-        <string>sdrugZone:rootResc</string> 
         <key>Default Port</key>         <key>Default Port</key>
         <string>1247</string>         <string>1247</string>
-        <key>Port Configurable</key> + 
-        <false/> +        <!-- Default path to open -->
-        <key>Username Configurable</key> +
-        <true/>+
         <key>Default Path</key>         <key>Default Path</key>
         <string>/sdrugZone/home</string>         <string>/sdrugZone/home</string>
-        <key>Path Configurable</key> + 
-        <true/>+        <!-- The zone of the iRODS server to connect to.  For backward --> 
 +        <!-- compatibility, a root resource can be specified by appending --> 
 +        <!-- ":<resource>" to the zone.  The specified resource is only --> 
 +        <!-- used when uploading files.  Prefer setting "Destination --> 
 +        <!-- Resource" under the "Properties" section. --> 
 +        <key>Region</key> 
 +        <string>sdrugZone</string> 
 + 
 +        <!-- The authentication scheme used to establish a connection to --> 
 +        <!-- an iRODS server.  Must be set to "native" or "pam_password". --> 
 +        <!-- "standard" is an alias for "native". -->
         <key>Authorization</key>         <key>Authorization</key>
-        <string>PAM</string>+        <string>pam_password</string> 
 + 
 +        <!-- Advanced properties --> 
 +        <key>Properties</key> 
 +        <dict> 
 +            <!-- The root resource to target when uploading files. --> 
 +            <!-- DO NOT define this option unless needed. --> 
 +            <!-- This option supersedes any resource defined by "Region". --> 
 +            <key>Destination Resource</key> 
 +            <string>rootResc</string> 
 + 
 +            <!-- Controls whether deletion of an object permanently --> 
 +            <!-- removes or moves it into the trash collection. --> 
 +            <key>Delete Objects Permanently</key> 
 +            <string>no</string> 
 + 
 +            <!-- The size (in bytes) of a file that must be exceeded before --> 
 +            <!-- using parallel transfer. --> 
 +            <!-- The value must satisfy the range [1, 2^31-1]. --> 
 +            <key>Parallel Transfer Threshold</key> 
 +            <string>33554432</string> 
 + 
 +            <!-- The number of iRODS connections used for parallel transfer --> 
 +            <!-- of a single file.  Each transfer will use the specified --> 
 +            <!-- number of iRODS connections. The value must satisfy the --> 
 +            <!-- range [2, 10]. --> 
 +            <key>Parallel Transfer Connections</key> 
 +            <string>3</string> 
 + 
 +            <!-- The buffer size (in bytes) used for parallel transfer of --> 
 +            <!-- a single file. Applies to uploads and downloads.  The --> 
 +            <!-- value must satisfy the range [1, 128MB]. --> 
 +            <key>Parallel Transfer Buffer Size</key> 
 +            <string>4194304</string> 
 + 
 +            <!-- Secure communication options must be one of "CS_NEG_REQUIRE", --> 
 +            <!-- "CS_NEG_DONT_CARE", or "CS_NEG_REFUSE". --> 
 +            <!-- - CS_NEG_REQUIRE:   Demand TLS be used. --> 
 +            <!-- - CS_NEG_DONT_CARE: Let the server decide if TLS is used. --> 
 +            <!-- - CS_NEG_REFUSE:    Do not use TLS. --> 
 +            <key>Client Server Negotiation</key> 
 +            <string>CS_NEG_REQUIRE</string> 
 + 
 +            <!-- TLS options, when enabled. --> 
 +            <key>Encryption Algorithm</key> 
 +            <string>AES-256-CBC</string> 
 +            <key>Encryption Key Size</key> 
 +            <string>32</string> 
 +            <key>Encryption Salt Size</key> 
 +            <string>8</string> 
 +            <key>Encryption Hash Rounds</key> 
 +            <string>16</string> 
 +        </dict>
     </dict>     </dict>
 </plist> </plist>
Line 194: Line 304:
 ===== Transferring Data to and from the RDMS via Cyberduck ===== ===== Transferring Data to and from the RDMS via Cyberduck =====
  
-The instructions below give details on how to use the transfer dialogs to upload, download, and synchronize your data.  Be aware that drag-and-drop from/to file explorer is also supported with the same results.+The instructions below give details on how to use the transfer dialogs to upload, download, and synchronize your data.  Be aware that drag-and-drop from/to the file explorer is also supported with the same results.
 ==== Upload ==== ==== Upload ====
  
Line 210: Line 320:
 {{ :rdms:access:windows:cyberduck_step_2.png?direct&600 |}} {{ :rdms:access:windows:cyberduck_step_2.png?direct&600 |}}
  
-The upload will now start and the window shown in the picture will appear.+The upload will now start, and the window shown in the picture will appear.
 {{ :rdms:access:windows:cyberduck_step_3.png?direct&600 |}} {{ :rdms:access:windows:cyberduck_step_3.png?direct&600 |}}
  
Line 240: Line 350:
 ==== Synchronization ==== ==== Synchronization ====
  
-Apart from up- or downloading files or entire folders manually in Cyberduck, you can also give the client the command to synchronize one of your local folders to a collection on the RDMS. The advantage of using synchronizing rather than up- or downloading the data, is that the synchronization will not transfer every file but only act on files that have been changed or that don't exist in the target directory. This will reduce the amount of data you will transfer at any one time.+Apart from uploading or downloading files or entire folders manually in Cyberduck, you can also give the client the command to synchronize one of your local folders to a collection on the RDMS. The advantage of using synchronization rather than uploading or downloading the data is that the synchronization will not transfer every file, but only act on files that have been changed or that don't exist in the target directory. This will reduce the amount of data you will transfer at any one time.
  
 ++++ Click to display section | ++++ Click to display section |
-To synchronize your folder, simply right-click the collection you wish to sync and the following menu will be displayed.+To synchronize your folder, simply right-click the collection you wish to sync, and the following menu will be displayed.
 {{ :rdms:access:windows:sync_1.png?direct&600 |}} {{ :rdms:access:windows:sync_1.png?direct&600 |}}
  
-Click on ''Synchronize...'' (red underlined) and the next window will open. There you can navigate to the folder on your local machine that you wish to sync to the RDMS collection. Once you have selected it and confirmed, the transfer window will open and after a few seconds, this window will appear.+Click on ''Synchronize...'' (red underlined), and the next window will open. There, you can navigate to the folder on your local machine that you wish to sync to the RDMS collection. Once you have selected it and confirmed, the transfer window will open, and after a few seconds, this window will appear.
 {{ :rdms:access:windows:sync_2.png?direct&600 |}} {{ :rdms:access:windows:sync_2.png?direct&600 |}}
  
Line 252: Line 362:
 {{ :rdms:access:windows:sync_3.png?direct&600 |}} {{ :rdms:access:windows:sync_3.png?direct&600 |}}
  
-Finally, if you click the red box shown above, you will be given three options of how Cyberduck is going to handle your sync. Your options are:+Finally, if you click the red box shown above, you will be given three options for how Cyberduck is going to handle your sync. Your options are:
   * **Download**: Changes to the RDMS collection will be reflected in your local folder. Changes to your local folder will not be reflected in the RDMS collection.   * **Download**: Changes to the RDMS collection will be reflected in your local folder. Changes to your local folder will not be reflected in the RDMS collection.
   * **Upload**: Changes to your local folder will be reflected in the RDMS collection. Changes to the RDMS collection will not be reflected in your local folder.   * **Upload**: Changes to your local folder will be reflected in the RDMS collection. Changes to the RDMS collection will not be reflected in your local folder.
   * **Mirror**: Any difference between the folders will be transferred, no matter if it was changed in your local folder or in the RDMS.    * **Mirror**: Any difference between the folders will be transferred, no matter if it was changed in your local folder or in the RDMS. 
  
-We suggest that you either use "Upload" or "Download" when using the Sync option, as you have a better handle of what is going to be changed. Please also keep in mind that Cyberduck's synchronization feature is a one-time action. If you wish to sync your folder again, it will not happen automatically, but you will need to repeat the steps above.+We suggest that you either use "Upload" or "Download" when using the Sync option, as you have a better handle on what is going to be changed. Please also keep in mind that Cyberduck's synchronization feature is a one-time action. If you wish to sync your folder again, it will not happen automatically, but you will need to repeat the steps above.
 ++++ ++++
 ==== Transfer Preferences ==== ==== Transfer Preferences ====
  
-Cyberduck lets you edit the way your transfers happen through choosing certain preferences. Below we list the main preferences you might want to adjust before starting your first transfer.+Cyberduck lets you edit the way your transfers happen by choosing certain preferences. Below we list the main preferences you might want to adjust before starting your first transfer.
  
 ++++ Click to display section | ++++ Click to display section |
Line 271: Line 381:
 {{ :rdms:access:windows:pref_2.png?direct&600 |}} {{ :rdms:access:windows:pref_2.png?direct&600 |}}
  
-This is not a necessary change, but if you are running into connection timeout issues with Cyberduck, navigate the the "General" tab in the "Transfers" window. Changing the option under "Transfer Files" from "Open Multiple Connections" to "Open Single Connection" can help solve that problem.+This is not a necessary change, but if you are running into connection timeout issues with Cyberduck, navigate to the "General" tab in the "Transfers" window. Changing the option under "Transfer Files" from "Open Multiple Connections" to "Open Single Connection" can help solve that problem.
  
 Furthermore, be sure that you **disable the option for segmented downloads** as this can introduce issues with your downloads.  Furthermore, be sure that you **disable the option for segmented downloads** as this can introduce issues with your downloads.