Hprc banner tamu.png


Revision as of 14:30, 1 November 2016 by Whomps (talk | contribs)
Jump to: navigation, search

Terra Usage Policies

Access to Terra is granted with the condition that you will understand and adhere to all TAMU HPRC and Terra-specific policies.

General policies can be found on the HPRC Policies page.

Terra-specific policies, which are similar to Ada, can be found on the Terra Policies page.

Accessing Terra

Most access to Terra is done via a secure shell session.

Users on Windows computers use either PuTTY or MobaXterm. If MobaXterm works on your computer, it is usually easier to use.

Users on Mac and Linux/Unix should use whatever SSH-capable terminal is available on their system.

The command to connect to Terra is as follows. Be sure to replace [NetID] with your TAMU NetID.

ssh [NetID]@terra.tamu.edu

Your login password is the same that used on Howdy. You will not see your password as your type it into the login prompt.

Navigating Terra & Quotas

When you first access Terra, you will be within your home directory. This directory has smaller quotas and should not be used for general purpose.

The home directory is located at:


You will want to navigate to your scratch directory. This directory is located at:


You can navigate to this directory easily with the following command:


Your scratch directory has a default (extendible) quota of 1TB/50,000 files. Your home directory has a default (non-extensible) quota of 10GB/10,000 files.

You can see the current status of your quota with:


If you need a quota increase, please contact us with justification and the expected length of time that you will need the extended quota.

Writing a Job

In order to properly run a program on Terra, you will need to submit a job.

The simple example below request 1 core on 1 node with 5GB of RAM for 1 hour. "ExampleModule" should be replaced or omitted based on your software needs.

#SBATCH --export=NONE
#SBATCH --get-user-env=L
#SBATCH -t 01:00:00
#SBATCH -J ExampleJob
#SBATCH -n 1
#SBATCH --mem=5G
#SBATCH -o ExJobOut.%j
module load ExampleModule

This job file should be written on a Linux/Unix environment.

If written on an older Mac or DOS workstation, you will need to use "dos2unix" to remove certain characters that interfere with parsing the script.

dos2unix myExJobFile.slurm

More information on job options can be found in the Building Job Files section of the Terra Batch page.

More information on dos2unix can be found on the dos2unix section of the HPRC Available Software page.

Submitting and Monitoring Jobs

The Terra Batch System page contains information on writing, submitting, and monitoring Slurm jobs on Terra.

Additional Topic: Finding Output

Additional Topic: Finding Software

Additional Topic: Graphic User Interfaces

Additional Topic: Translating Ada/LSF jobs to Terra/Slurm

The HPRC Batch Translation page contains information on converting between LSF, PBS, and Slurm.

Some LSF-Slurm translation examples have also been made available on the ADA-TERRA JOBS TRANSLATION PAGE. Our staff has also written some example jobs for specific software. These software-specific examples can be seen on the INDIVIDUAL SOFTWARE PAGES where available.