Update Examples

From HPC Wiki
Jump to:navigation Jump to:search

There are a collection of examples showing how to run some common modules on the Magnolia cluster, the update-examples command is used to easily copy the collection into the home directory.

The Examples Directory

When first signing on the Magnolia cluster, the home directory will consist of the following two directories:

user $ls
examples  perl5

Changing to the examples directory, and listing its contents reveals a README.txt file.

user $cd examples
user $ls
README.txt

The contents of README.txt can be viewed using cat:

user $cat README.txt

Examples for submitting jobs on Magnolia Cluster
================================================

Examples will be saved, by default, in this
directory.

To get a copy of the newest version of job
submission examples, run the following command
at anytime:

          update-examples

The README.txt file directs up to run the update-examples command to get a copy of the examples.

Update Examples

Running the update-examples commands gives:

user $update-examples
Examples for submitting jobs on Magnolia Cluster
================================================

* CUDA        - Compiling CUDA programs
* Gaussian    - Electronic structure
* lammps      - Classical molecular dynamics
* migrate-n   - Population sizes and migration rates
* Molpro      - Electronic structure
* MPI         - Compiling MPI programs
* MrBayes     - Choosing phylogenetic and evolutionary models
* NAMD        - Molecular dynamics
* OpenMP      - Compiling OpenMP programs
* py-threads  - Using Threads in Python programs
* qe          - [Quantum ESPRESSO] Electronic-structure
* structure   - Investigate population structure
* compression - Convenience scripts to do compression on a compute node

See the README.txt file inside each directory for instructions on
how to run the examples (e.g., cat README.txt).

New examples saved to ${HOME}/examples/20210214-231213.

A list of all the examples are shown, and the last line shows where the examples are stored, ${HOME}/examples/20180208-135347. The directory 20180208-135347, created inside ${HOME}/examples, is a date-time stamp of the format YYYYMMDD-HHMMSS, indicating the date and time that update-examples was run. Therefore, every time update-examples is run, a new directory is created inside ${HOME}/examples with the current date and time.

Looking at the contents of the new directory shows:

user $ls ${HOME}/examples/20210214-231213
compression  Gaussian  migrate-n  MPI      NAMD    py-threads  README.txt
CUDA         lammps    Molpro     MrBayes  OpenMP  qe          structure

Where each listing is a new directory corresponding to an example listed in the output of update-examples, plus an additional README.txt. Each directory should have its own README.txt, which explains in detail how to run the example on the cluster.

Tweaking the Examples

It is recommended to tweak and play with various settings of the examples to learn how they affect the runs on the cluster. Do not worry about breaking the examples; if you need to get back to a clean set of examples, simply run update-examples again. The new set of examples will be saved in a date-time stamped directory, and your modified examples will still be available in the original directory, so you can compared the differences if you get lost.