Update Examples
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.