Chapter 16. Using modules with NQE

This chapter applies only to UNICOS and UNICOS/mk systems. It includes installation procedures and provides information about using modules with NQE.

If you plan to install the Cray Research modules package, it must be installed before you install NQE 3.3.

If you choose not to use or install the Cray Research modules package, the following warning message, which you can ignore, is produced during the installation of NQE 3.3:

The /opt/modules/modules/modulesfiles directory does not exist!
The nqe modulefiles were not installed into
/opt/modules/modules/modulesfiles. The complete modules package
must be installed into /opt before the nqe modulefiles
can be installed into /opt/modules/modules/modulesfiles.

Loading the modules Package

If you plan to install the Cray Research modules package, it must be installed before you install NQE 3.3.

If you already have the modules package loaded on the system, you do not need to reload it. To verify that the modules package is available, enter the following command:


ls /opt/modules
2.2 modules

If the /opt/modules directory exists, modules is already installed on the system, and you can now install NQE 3.3.

The NQE 3.3 release package includes the modules 2.2 package. If the version of modules shipped with NQE 3.3 is more current than the version loaded on your system, you should load the more current version; however, it does not matter if NQE 3.3 is loaded before or after the updated modules package.

If you do not have the modules package loaded on the system, install it as follows:

Procedure 16-1.

  1. If you are using the common installation tool (CIT), install the modules package by double-clicking on modules first, which installs this package first.

  2. If you are using the UNICOS Installation and Configuration Menu System interface, you are not able to select the order in which products are loaded from the distribution tape. Therefore, to ensure that the modules package is loaded first, you must deselect all products except Modules by setting the Load Subpackage ? option in the Distribution Package Contents menu to no. After the modules package is loaded, set all products to yes, except Modules , and complete the installation. This requirement will be eliminated with future (post 2.2) modules releases. For more information about using the UNICOS Installation and Configuration Menu System, see Chapter 11, “Installing on UNICOS 9.0.x Systems”.

Using the NQE Modules File

The use of modules files is described in the following online files:

  • /opt/modules/modules/doc/Modules-Paper.ps

  • /opt/modules/modules/man/man1/module.1

  • /opt/modules/modules/man/man4/modulefile.4

The NQE modules file is installed in the following location:

/opt/modules/modules/modulefiles


Note: You must tell your user community if you are using the modules interface and give them the information that is included in “Setting up Your User Environment”.


Setting up Your User Environment

If you use NQE frequently, you must add the appropriate statements to your .cshrc or .profile files to set up your user environment. If you already have the modules package loaded on your system, simply add nqe to the list of modules loaded. If the modules package has not been previously loaded, the statements to be added must follow all other path-setting code.

If you are a C shell user, add the following statements to your .cshrc file:

if (-f /opt/modules/modules/init/csh) then

       #Initialize modules

    source /opt/modules/modules/init/csh
    module load modules nqe
endif

If you are an sh or ksh shell user, add the following statements to your .profile file:

if [ -f /opt/modules/modules/init/ksh ] ; then

       #Initialize modules

    . /opt/modules/modules/init/ksh
    module load modules nqe
fi


Note: If you use NQE only occasionally, include the following line in your .cshrc or .profile file:
source /opt/modules/modules/init/csh



Then, before you use NQE, enter the following command from the command line:
module load modules nqe