Changes between Version 11 and Version 12 of cypress/FileTransfer

Timestamp:

09/30/19 16:34:27 (5 years ago)

Author:

cbaribault

Comment:

Added content for rclone - file transfers between Box and Cypress accounts. Changed "cluster" to "Cypress".

cypress/FileTransfer

@@ -3 +3 @@
 == Transferring Files ==
 === Linux and Mac Command Line ===
-You may transfer files between your workstation and the cluster on the command line using the ''scp'' command. This command behaves much like the basic Linux ''cp'' command, except you may use a remote address as the source or destination file. The syntax is as follows:
+You may transfer files between your workstation and Cypress on the command line using the ''scp'' command. This command behaves much like the basic Linux ''cp'' command, except you may use a remote address as the source or destination file. The syntax is as follows:
 {{{
 scp source_file destination_file
@@ -18 +18 @@
 }}}
 
+=== Tulane Box Accounts ===
+You may transfer files between your [https://tulane.box.com Tulane Box account] and Cypress on the command line using the ''rclone'' command. On Cypress, you can make the rclone command available for execution via the command {{{module load rclone}}} (see [[cypress/ModuleCommand|Module command]]).
+
+In order to use rclone on Cypress, you must first create the config file ''~/.config/rclone/rclone.conf'' on your Cypress account, which you can do most easily by first creating a reusable copy of it on your local machine and then copying the resulting local file to your Cypress account via the following.
+
+==== Configuring rclone on Cypress ====
+1. Download, install, and configure rclone on your local machine by following the instructions for Windows, Mac, or Linux as appropriate starting from the [https://rclone.org/install/ rclone installation site.]
+  a. During the above configuration, you will be prompted for a ''name'' for the Box remote system, e.g. ''!BoxRemote''.
+  b. Make note of your response for the name of the Box remote system for future reference to be used in your invocations of the rclone command.
+2. Once you've configured rclone on your local machine, locate the resulting file rclone.conf on your local machine.
+  a. On Mac and Linux, e.g., look for the file ~/.config/rclone/rclone.conf
+  b. On Windows 8 (or under) , e.g., look for the file %userprofile%\.config\rclone\rclone.conf
+3. Create as needed the directory ~/.config/rclone on your Cypress account.
+4. Copy the resulting local file rclone.conf to your Cypress directory ~/.config/rclone. See [[cypress/FileTransfer|File Transfer]].
+5. For security purposes, be sure to confirm that only you have ''exclusive'' read/write privileges to the resulting file ~/.config/rclone/rclone.conf on Cypress. See the ''ls'' and ''chmod'' commands under [[cypress/BasicLinuxComands|Linux Commands]]
+
+Once you have created the config file ''~/.config/rclone/rclone.conf'' on Cypress, you can run rclone via the following.
+
+==== Running rclone on Cypress ====
+1. The following command will list the contents of a top-level folder in your Box account with configured Box remote name !BoxRemote.
+{{{
+rclone ls BoxRemote:<top-level-folder>
+}}}
+2. The following command will copy the contents of a top-level folder in your Box account with configured Box remote name !BoxRemote to your current Cypress working directory.
+{{{
+rclone copy BoxRemote:<top-level-folder> .
+}}}
+3. The following command will copy the file test.txt in your current Cypress working directory to a top-level folder in your Box account with configured Box remote name !BoxRemote.
+{{{
+rclone copy test.txt BoxRemote:<top-level-folder>
+}}}
+4. The following command will simply list the available subcommands under rclone.
+{{{
+rclone --help
+}}}
+
 === Graphical Software ===
-There are many graphical file transfer solutions available. The following are the three most popular and are fairly intuitive. Be sure to set each to connect to the cluster using the Secure File Transfer Protocol (SFTP).
+There are many graphical file transfer solutions available. The following are the three most popular and are fairly intuitive. Be sure to set each to connect to Cypress using the Secure File Transfer Protocol (SFTP).
 
 ''Filezillla'' is available on all platforms. Be careful when downloading and installing as the hosting site, sourceforge, has begun to bundle bloatware with its downloads.