HomeArchiver Procedure:

***HomeArchiver* is a Cshell script that uses the Linux *rsync* command
to REPEATEDLY update a copy of your entire *Home* directory on a local
FireWire or USB disk.**

1.  **Prepare your disk AT HOME!**

```{=html}
<!-- -->
```
a.  **format your disk with an "ext3" filesystem**

b.  **change permissions on your disk adding "rwx" for "other"
    (everyone!)**

c.  **TEST YOUR DISK AT HOME as a non-root user**

d.  **Clean off your disk at home so that you have as much space
    available as possible for your SBC data**

```{=html}
<!-- -->
```
2.  **Attach your disk to an SBC Linux Workstation**

```{=html}
<!-- -->
```
a.  **choose a Linux system in your assigned "WORKAREA" rather than the
    "OPS" area so you will have access throughout your entire visit**

b.  **login using the username of the account assigned to you**

c.  **open a terminal window and list the contents of the /media
    directory (command: ls /media)**

d.  **power ON your disk and connect a Firewire or USB cable between
    your disk and the SBC Linux Workstation (ports may be on front or
    back of workstations)**

e.  **list the contents of the /media directory once again, identify the
    new directory where your disk is mounted (command: df --hTl ) and
    record the MOUNTPATH to your disk here: MOUNTPATH=
    [/media/\_\_\_\_\_\_\_\_\_]{.underline}**

```{=html}
<!-- -->
```
3.  **Run the HomeArchiver command**

```{=html}
<!-- -->
```
a.  **run the HomeArchiver command in a terminal window in your home
    directory following the syntax:**

> **HomeArchiver \<MOUNTPATH\> \<BASE_NAME\>**

MOUNTPATH: full path to your disk from step 2e above

> BASE_NAME: a PREFIX for HomeArchiver to use for naming the three
> control described below. HomeArchiver creates them in your home
> directory.

BASE_NAME.excluded (list of files,directories NOT to copy)

BASE_NAME.log (record of each successive rsync command)

> **BASE_NAME.enabled (removing this will initiate a "[normal
> exit]{.underline}" of the script in between rsync commands)**

4.  **Monitor the status of your backup**

```{=html}
<!-- -->
```
a.  **Periodically check space available on your disk ( df --hTl )**

b.  **Periodically check that HomeArchiver has run rsync in the past 10
    minutes by examining the output written to the terminal by the
    HomeArchiver script**

c.  **Periodically check that the files on your disk correspond to the
    files in your home directory. (some useful commands are "ls --axl"
    and "du --sh \*" )**

```{=html}
<!-- -->
```
5.  **Terminate the script and remove your disk when you are prepared to
    leave**

```{=html}
<!-- -->
```
a.  **remove your BASE_NAME.enabled control file from your home
    directory (rm BASE_NAME.enabled)**

b.  **answer "y" when HomeArchiver prompts about unmounting the disk**

c.  **verify that your disk is no longer mounted (df --hTl)**

d.  **disconnect and power off your disk**

```{=html}
<!-- -->
```
6.  **CHECK YOUR DATA AT HOME**

```{=html}
<!-- -->
```
a.  **verify that you have all of your data as soon as possible when you
    return home**

b.  **be aware that your SBC TimeBomb date indicates when your data will
    be deleted from SBC data space. After this date we cannot help
    recover your data.**