CommandLineBox < Lab

---+ Copying files to/from UT Box at the command line

Follow the directions here to set up an _additional_ Box password that you will use for connecting:<br>
https://uisapp2.iu.edu/confluence-prd/display/SOICKB/Using+Box+under+Linux

You will need [[https://lftp.yar.ru/][LFTP]] installed on your system. *It is already installed on TACC*

Open the file =~/.lftp/rc= in a text editor. (You may need to first create the =~/.lftp= folder if it does not exist. Strictly speaking, this step is optional. You could run these commands every time you enter the LFTP shell to temporarily set the options.)

Add these lines to the =~/.lftp/rc= file.
<div style="border-color: grey; border-style: solid; border-width: 1px; padding:6px;"><verbatim>
set ftps:initial-prot ""
set ftp:ssl-force true
set ftp:ssl-protect-data true
</verbatim></div>

Now you can use these commands to connect to Box (The second one is run inside the LFTP shell and will prompt you for the password you created.)

<div style="border-color: grey; border-style: solid; border-width: 1px; padding:6px;"><verbatim>
lftp ftps://ftp.box.com:990
lftp ftp.box.com:~> user XXXX@XXX.utexas.edu
</verbatim></div>

LFTP commands are a dialect of FTP commands. If you are not familiar with these, here is a [[https://lftp.yar.ru/lftp-man.html][reference]]. 

Here are some useful commands for working with your local directory from within the LFTP shell:
   * =lcd= lets you change local directories.
   * =!ls= lets you list the contents of your local directory.

To recursively copy directories, you will need this command:

<div style="border-color: grey; border-style: solid; border-width: 1px; padding:6px;"><verbatim>
mirror -R {local dir} {remote dir}
</verbatim></div>

This *does not* delete a file from ={remote dir}= if it has been deleted in ={local dir}= since the last backup. You would need to add the =--delete= flag for that type of sync, but be very careful when doing so! You can use the =--dry-run= option to see what would have been deleted before running it.

*Note:* Sometimes you may get an error looking like this during a =mirror -R= call. The file has been successfully transferred despite this message!
<div style="border-color: grey; border-style: solid; border-width: 1px; padding:6px;"><verbatim>
mirror: Access failed: 550 Box: Item with the same name already exists (code=item_name_in_use, request_id=XXXXXXXXXXXXXXX). (FILENAME)
</verbatim></div>
This topic: Lab > ComputationList > CommandLineBox
Topic revision: r4 - 2019-08-17 - JeffreyBarrick