Configuring Environment Modules

Environment modules allow users to switch between different versions of compilers, libraries, and other installed software on a supercomputer. On the command line, environment modules are typically configured using commands like module load gcc/4.6.2 or module swap PrgEnv/cray PrgEnv/pgi.

PTP provides the ability to configure a set of modules to be loaded when a synchronized C/C++ or Fortran project is built. Module commands can be entered manually -- just as you would enter at the command line -- or they can be configured using a graphical interface.

Note: The following instructions apply only to synchronized projects. Currently, it is not possible to configure modules for local or remote projects.

To configure environment modules used to build a synchronized C/C++ or Fortran project:

  1. In the Project Explorer view, right-click on a C/C++ or Fortran project.
  2. In the context menu, select Properties. This will open the Project Properties dialog.
  3. In the tree on the left, navigate to C/C++ Build > Environment Management.


  4. Select Use an environment management system to customize the remote build environment.
  5. If a message appears reading The remote environment (connection name) is not connected, click the Connect button. If no such message appears, proceed to the next step.


  6. Within 10-15 seconds, one of one of the following will appear.
     
  7. After you have configured the environment modules for your build, click the OK button to save the configuration and close the Project Properties dialog.

Configuring Environment Modules Using the Module List

PTP allows modules to be configured using a check list when the remote machine runs one of the following environment management systems:


The module configuration area contains the following elements.

Using the Filter List Text Field

The Filter List text field can be used to temporarily display only modules with a particular name. (Entering text in this field does not affect what modules are selected; it simply hides some entries from view until the filter text is cleared.)

Configuring Environment Modules Manually

To configure environment modules manually:

  1. Select Manually specify environment configuration commands.
  2. A text box will appear. If the check list was previously visible, the text box will contain the commands needed to configure the modules according to what was selected in the checklist.
  3. Enter Bash shell commands necessary to configure the environment, one per line.

 

Back to Top | Back to Table of Contents