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.

A brief description of Environment Management with Modules is available in the Environment Management section of Building Synchronized Projects.
This section covers more additional details.

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, the information can be accessed in two places:

  1. From the project context menu (right-click on a C/C++ or Fortran project), select Synchronize > Manage ...


    This brings up the Manage Synchronize Configurations dialog.


  2. Alternatively, this is also available from the Project Properties dialog, on the Synchronize page.

Here we illustrate it from the first alternative, the Manage Synchronize Configurations dialog.

  • Check Use an environment management system to customize the remote build environment.


  • 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.

  • Within 10-15 seconds, one of one of the following will appear.
  • 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 list of available, and selected, modules, 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 the list of Selected Modules. Otherwise the text area will be blank.
    3. Enter Bash shell commands necessary to configure the environment, one per line.


    Back to Top | Back to Table of Contents