Storage/Data

You can store your files on your home, work, and/or scratch directory. All directories are mounted on both submit nodes and all compute nodes. Each directory is assigned a variable when you log in that you can use for quicker access to that space and reference in your scripts.

NOT BACKED UP: No data, anywhere, is backed up. We recommend using the Research File Storage for those purposes.

⚠Tailing output - Slow down
Due to the nature of the parallel file system used for the cluster, tailing the output of a job could cause the job to perform slower.
This is due to the file system having to update your tail as well as accept the writes from the job.
If your job is mostly CPU intensive, you may not notice a different. But if I/O intensive, you may see a performance drop.

To see any of the information below, run the command mystats

Home Directory ($HOME): Your home directory is a place only you have access to. If you wish to share your data, see $WORK directory below. You have a 100 GB disk and 100,000 file limit quota.
The path to your home directory is (replace username with your KU Online ID):
```
/home/username
```
Work Directory ($WORK): Your work directory is a shared space for you to collaborate with your group. 1 TB is given for free to all owner groups. The quota is based off how much storage the owner of the group has purchased directory or indirectly from purchasing nodes. Additional $WORK can be purchased for $100 per TB per year.

To find your $WORK directory, run the command mystats. The path to your $WORK directory is:
```
/panfs/pfs.local/work/groupname/username
```
Scratch Directory ($SCRATCH): Your scratch directory is a place for you to use as a temporary space for your data processing. The quota for scratch is a finite amount, but is set for the whole volume, which CRC staff will maintain.

Files equal to or greater than 60 days old will be deleted

To find your $SCRATCH directory, run the command mystats. The path to your $SCRATCH directory is:
```
/panfs/pfs.local/scratch/groupname/username
```

You can use $HOME, $WORK, and $SCRATCH in you submit scripts and make it easier to get around the file systems.

Quota

Location	Hard Quota	Hard File Limit
`$HOME`	100 GB	100,000
`$WORK`	Varies	No Limit
`$SCRATCH`	55 TB	No Limit

Each of the above locations, $HOME, $WORK, and $SCRATCH each have an enforced quota. To determine how much of your quota you are using for each of these volumes, login to the cluster and run mystats

This will produce output similar to the following:

------------------------------- Storage Variables ------------------------------
| Variable     Path                                                            |
| $HOME        /home/username                                                  |
| $WORK        /panfs/pfs.local/work/groupname/username                        |
| $SCRATCH     /panfs/pfs.local/scratch/groupname/username                     |
--------------------------------------------------------------------------------

--------------------------------- Disk Quotas ----------------------------------
| Disk         Usage (GB)     Limit    %Used   File Usage       Limit   %Used  |
| $HOME             33.51    100.00    33.51        99054      100000   99.05  |
| $WORK           6436.80  13969.84    46.08       296488           0       0  |
| $SCRATCH       39533.15  55879.35    70.75            1           0       0  |
--------------------------------------------------------------------------------

Violation

Users will receive an email from the Panasas File System when a quota for $HOME, $WORK, and $SCRATCH has been exceeded (Hard Quota) or is about to be exceeded (Soft Quota). They will all start with the information below:

PanActive Manager Warning: User Quota Violation Soft (bytes)

Date:        Wed Feb 07 00:00:16 CST 2018           
System Name: <name>                              
System IP:   <ip range>
Version      <version>                    
Customer ID: <custid>

Soft Quota: A warning email is sent to the user that the specified resource is about to exceed the size or file limit quota. The example below is for $HOME for the user and has crossed the 85 GB threshold.

User Quota Violation Soft (bytes):  Limit reached on volume /home for Unix User:   (Id:  uid:<uid>) Limit = 85.00 GB.

The above message applies to the following component:
    Volume: /home

This example is for a Soft Quota Violation of the file limit size in $HOME

User Quota Violation Soft (files):  Limit reached on volume /home for Unix User:   (Id:  uid:<uid>) Limit = 85.00 K.

The above message applies to the following component:
    Volume: /home

Hard Quota: The maximum allotted space has been reached for that volume. This could be for any of locations above, including the system-wide location of $SCRATCH. No further writes are allowed, and you must remove files before creating any new ones

User Quota Violation Hard (bytes):  Limit reached on volume /home for Unix User:   (Id:  uid:<uid>) Limit = 100.00 GB.  No further writes allowed for this Unix User in this volume unless it has at most 95.00 GB of data.

The above message applies to the following component:
    Volume: /home

When you have removed enough files to drop below the Hard or Soft Quota violation, an Event CLEARED email will be sent to you. At the top of the email, you will notice the below:

Event CLEARED: PanActive Manager Warning: User Quota Violation Hard (bytes)

Transferring your files

There are many ways to transfer files in and out of the cluster. CRC recommends using either Globus or rsync.

Globus

Globus works through your internet browser, so therefore works on Windows, Linux, and MacOS.

To start using Globus, navigate to https://www.globus.org/app/transfer in your browser. From there, choose University of Kansas as your institution. You will be redirected to login with your KU ID.

You should then see a screen with two panels, if this is your first time using Globus, you'll need to set up your personal computer as a Globus endpoint.

To do this, click the link on the bottom right of the screen that says "Get Globus Connect Personal". Then follow the prompts, naming your computer, generating a key, downloading the client, and then entering the previously generated key into the client. Your computer is now an endpoint.

Back on the page with the two panels, you need to choose the two endpoints you'd like to copy between. The cluster endpoint is named KU CRC Data Transfer Node. The other endpoint will be whatever you named your computer in the previous step.

Now you should be able to see the files both on your computer as well as your cluster home directory. From here transferring is just a simple click and drag from source to destination.

Rsync

Rsync is a command for Linux and Mac only. It is used to transfer files back and forth using the Terminal and comes with no GUI.

You must be on KU's network or connected to KU Anywhere to access the Data Transfer Node (DTN).

The KU Community Cluster supports SCP, SFTP and Rsync for transferring files:

Host: transfer.hpc.crc.ku.edu
Port: 22

rsync -avP username@host1:~/file1 username@host2:~/file1_copy

For example, to copy a file from your home directory on your local computer (e.g., ~/foo.txt) to your home directory on the HPC, on the command line, enter (replace username with your KU Online ID username):

rsync -avP ~/foo.txt username@transfer.hpc.crc.ku.edu:~/foo.txt

SCP

Similar to rsync above, this is a command to be run in the Linux or Mac terminal. This command-line utility is included with OpenSSH.

You must be on KU's network or connected to KU Anywhere to access the Data Transfer Node (DTN).

The KU Community Cluster supports SCP, SFTP and Rsync for transferring files:

Host: transfer.hpc.crc.ku.edu
Port: 22

scp username@host1:~/file1 username@host2:~/file1_copy

scp ~/foo.txt username@transfer.hpc.crc.ku.edu:~/foo.txt

Recovering your files

One of the features of our cluster filesystem is the concept of snapshots. Snapshots are a daily capture of files in a given directory. All snapshots are user accessible, but only for volumes that are owned by a group the user is part of. Snapshots are read-only, but can be used for when you accidentally delete a file, you can retrieve that file up to seven days later.

Snapshots are stored in the .snapshot directory in the root of the your work or home directory, but this directory is hidden, and won't be displayed in listings (ls) of that directory. Snapshots are captured for $HOME and $WORK directories but not $SCRATCH

For example, say you're working in your work directory, (i.e. /panfs/pfs.local/work/groupname/username) and you accidentally delete a file named oops.txt. To restore that file from a previous snapshot, you can navigate to the .snapshot directory for your group's work and there you will find directories containing snapshots from the past seven days. Each of these directories contain a file structure similar to that of /panfs/pfs.local/groupname and has a snapshot of what was in those files when that snapshot was taken. You can navigate into those directories and copy the file(s) you accidentally deleted back to your work directory.

cd /panfs/pfs.local/work/groupname/.snapshot
ls
cd date-of-snapshot.automatic 
cd username
cp oops.txt /panfs/pfs.local/work/groupname/username

If one particular file was heavily modified, the snapshot may not recover the most recent change, but it will have the files that were in those directories when the snapshot was taken for that day.

Snapshots of home directories can also be found in

/home/.snapshot/date-of-snapshot.automatic/username

Due to the way that directory is set up you cannot ls inside the date-of-snapshot.automatic directory, instead you must go directly to your own home directory as shown above.

Snapshots are on a rolling seven day purge, so if you accidentally delete a file you will need to restore it within seven days or it will be gone forever.

Search form