computing

h1. Introduction to Moab for users

Moab is the workload management system that is used in FEUP's high performance computing clusters.

h2. Getting started

After gaining ssh accesh to a moab frontend, a user can see what resources are available and check the status of the queue by running

<pre>

mshow

</pre>

In order to submit jobs, one needs to create a submit script that defines the requirements and the command to be executed. A simple example to get started would be

h3. Example serial job submission script helloworld.submit

<pre>

#!/bin/bash                                                

#MOAB -l nodes=1:ppn=1                                    

#MOAB -l partition=torque1                                 

#MOAB -j oe                                          

cd $PBS_O_WORKDIR                                    

#!/bin/bash

echo "----------------------"

hostname

echo "----------------------"

date

echo "----------------------"

echo "Sleeping 20s"

sleep 20

echo "----------------------"

echo "Hello World!"

</pre>

h3. Example parallel job submission script helloworld.submit

<pre>

#!/bin/bash                                                

#MOAB -l nodes=2:ppn=2

#MOAB -l partition=torque1                                 

#MOAB -j oe                                          

cd $PBS_O_WORKDIR                                    

mpirun -np 4 -machinefile $PBS_NODEFILE ./command | tee $PBS_JOBID.output

</pre>

After creating this file, the job would be submitted by running

<pre>

msub helloworld.submit

</pre>

h2. Checking status

To see details about the status of each job in the queue, one would run

<pre>

mshow

</pre>

To check the status of a specific job,

<pre>

checkjob jobid

</pre>

To check the status of a specific node,

<pre>

checknode nodeid

</pre>

To cancel a job

<pre>

canceljob jobid

</pre>

h2. More Information

http://www.adaptivecomputing.com/resources/docs/