Background

The rsync program is a convenient utility for copying data from the instrument host to your laptop or to a remote machine. You can either pull or push data as explained below.

Procedures

Pulling to your computer from Keck

This method is appropriate for use on laptops.

Open an window on your laptop or remote computer.
Gain access through the Keck firewall as required; please consult your support astronomer for details. Note that this is not necessary when you are operating from a laptop connected to the Keck visitor network.
Issue the rsync command:
```
rsync -avz account@keckhost:/path/to/data .
```
where
- account is the name of the observing account
- keckhost is the name of the Keck computer. Please note that not all Keck computers can run rsync. Currently, hosts with rsync installed include puamana, hamoa, and mokulau.
- When referencing your summit data directory, include a leading /s; for example, /s/sdata1001/deimos1/2012jan01.
When prompted, supply the appropriate password for the observing account on the Keck host.

Pushing data from Keck to your computer

This method works best when transferring data to a machine at a remote site, when it would be tedious to log into the remote machine and then gain access through the Keck firewall.

Open an xterm window on a Keck computer.
Log into your instrument host, e.g., hiresserver, deimosserver, lrisserver... For example:
```
ssh hiresserver
```
Issue the rsync command:
```
rsync -avz /s/sdataNNN/account/dir user@host:/path/to/data
```
where
- account is the name of the observing account
- dir is the name of the observing directory
- user is the username on the remote host
- host is the remote host name
When prompted, supply the appropriate password for the remote user on the remote host.

Examples

Pull data from directory /s/sdata703/esi1/2011jan01 at Keck to the current directory on your laptop computer by issuing this command on the laptop (assuming the laptop is connected to visitor wireless at Keck):
```
rsync -avz esi1@puamana.keck.hawaii.edu:/s/sdata703/esi1/2011jan01 .
```
Pull data from directory /s/sdata1001/deimos1/2011jan01 at Keck to directory ~/deimos_data on remote machine foobar.ucolick.org by issuing this command on the remote machine (after gain access through Keck firewall):
```
rsync -avz deimos1@deimosserver.keck.hawaii.edu:/s/sdata1001/deimos1/2011jan01 ~/deimos_data
```
Push data from directory /s/sdata1001/deimos1/2011jan01 at Keck to directory ~/deimos_data on remote machine foobar.ucolick.org by logging into deimosserver as deimos1 and issuing this command:
```
rsync -avz /s/sdata1001/deimos1/2011jan01 wiseguy@foobar.ucolick.org:~/deimos_data
```

Notes

Use the --dry-run option to have rsync print which files will be transferred without actually copying files. Then repeat the command without the --dry-run option to transfer files.
Use the --delete option to remove from the destination directory any files which have been deleted from the source directory.