Getting Started with Shamu

Shamu is the Research Support Groups premier cluster consisting of many compute cores and GPU cores.

Connect to Shamu using SSH

You should connect to the Shamu cluster using your campus abc123 and campus passhrase via one of the two login nodes. This example is using "login" as the login node.

ssh -p1209

If you have successfully logged in, you should see something like:

Welcome to the Research Computing cluster Shamu.

Rules for using Shamu:

* Do *NOT* execute directly on the Shamu head node. Grab a compute node with
qlogin or script your jobs with qsub.

* Do *NOT* ssh directly to a compute node to run your code. Offending users will
be locked out temporarily.

We are now gathering statistics to help promote Shamu in the UTSA Research

We are looking for the following information:
  * Number of presentations and papers published
  * Number of grants, awards or funding
  * Number of patents, copyrights, etc...

If you have used the computational resources of Shamu for any of the above, please
email your information to Thanks!

Common Commands

Below are examples of the most commonly use commands you will be using on Shamu. They range from loading a module to checking the status of your jobs.
  • Seeing which modules are available
[abc123@login01 ~]$ module avail
-------------------------------------------------------- /cm/local/modulefiles --------------------------------------------------------
cluster-tools/7.3 freeipmi/1.5.2 ipmitool/1.8.17 null shared cmd gcc/6.1.0 module-git openldap slurm/16.05.8
dot gcc/7.3.0 module-info sge/2011.11p1
  • How to load a module
[abc123@login01 ~]$ module load gcc/6.1.0
[abc123@login01 ~]$ module list
Currently Loaded Modulefiles:
 1) gcc/6.1.0
  • Check the status of the cluster queues showing how many jobs are running and how many resources are available.
[abc123@login01 etc]$ qstat -g c
all.q           0.78 2077   0  252  2392       0   64
bigmem.q        0.93  137   0    7   144       0    0
dev.q           0.00    0   0   32    32       0    0
gpu.q           0.25    9   0   39    48       0    0
ids.q           0.00    0   0   64    64       0    0
millwater.q     0.00   11   0   21    32       0    0
plasmon.q       0.00    3   0  173   176       0    0

Shamu has a high speed Infiniband filesystem consisting of two (2) mounts, /work and /home-new.

/home-new is where your home directories are located

/work is where you should place all of your input or output files from your jobs. If you currently do not have a /work/abc123 directory, please contact the Research Support Group and request a directory to be created.

X Forwarding

X Forwarding is used to forward any X enabled (GUI) program you with to run on Shamu. There are two (2) SSH terminals for Windows that automatically provides the necessary X libraries to accomplish this. They are SmarTTY and MobaXTerm. If you are using Linux or a Mac desktop, you will need to connect to the login node with a special argument to enable X Forwarding:
ssh -Y -p1209

For Windows, we recommend MobaXTerm because it includes an X server and sets everything up automatically for you once you log in.

For Mac users, please follow the directions below:
  1. Install XQuartz on your Mac, which is the official X server software for Mac
  2. Run Applications > Utilities >
  3. Right click on the XQuartz icon in the dock and select Applications > Terminal. This should bring up a new xterm terminal windows.

  4. In this xterm windows, ssh into the linux system of your choice using the -X (or -Y) argument (secure X11 forwarding). For example, to log into you would run something like:

    ssh -Y

  5. Once you are logged into the linux system, you can just run the GUI program of your choice (ie. matlab, mathematics, etc) and it will display on your Mac.

-- AdminUser - 17 May 2016
Topic revision: r15 - 26 Jun 2019, AdminUser
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding UTSA Research Support Group? Send feedback