User environment - The usage of module 2016

From HPC users
Revision as of 16:08, 11 April 2017 by JBrunken (talk | contribs) (→‎Hidden modules)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

We use the module environment, which has a lot of advantages, is very flexible (and user-friendly), and even allows one to use different versions of the same software concurrently on the same system. You can see a list of all available modules by typing

module avail

To load a given module:

module load <name of the module>

The modules system uses a hierarchical file structure, i.e., sometimes (whenever there are ambiguities) you may have to specify a path, as in:

module load intel/2016b

To revert all changes made by a given module (environment variables, paths, etc.):

module unload <name of the module>

You could also create a "state" of loaded modules that you prefer. Load every modules you want and safe the "state" with:

module store

If you loaded toomany, unneeded modules and want to go back to your safed "state", simply use following command:

module restore

You can unload all currently loaded modules with the command:

module purge

Keep in mind that you have to load "hpc-uniol-env", otherwise the paths to all available modules arent set!

A short overview of the options are given in following table (a full list you can get by module help)

Option Description
avail [<prefix>] Shows a list of all available modules. Optionally one can specify a prefix to limit the output, e.g. module avail netcdf will show only available modules of netcdf.
purge Remove all loaded modules.
help Returns a short help with all available options of the command module.
list Print a list with all loaded modules.
load <module_name> Loads the module module_name. If the name includes not the full module name (separated by /) then the latest version of the software is loaded.
show <module_name> Shows additional information about a specific module, e.g. pathen and environment variables set by the module.
unload <module_name> Remove the module module_name.

Hidden modules

You might have noticed that the output of the command

module avail

is pretty cleaned and organized. Its not flooded with modules that are only installed because they are a dependency of an other module. This is the fact because we have hidden many modules to keep the output of module avail clear.

These hidden modules are in a different, hidden path. If you need these modules, you will need to paste the following line of code once per login-session:

module use /cm/shared/uniol/modules/.hidden

Using the command module avail will now show you a long list of modules. You are now also able to load these modules with

module load