Compute Canada

How do I Setup my Environment to use the Iris Explorer?

Please note: The FAQ pages at the HPCVL website are continuously being revised. Some pages might pertain to an older configuration of the system. Please let us know if you encounter problems or inaccuracies, and we will correct the entries.

The program requires the setting of the environment variable LM_LICENSE_FILE to work. Since it calls a Graphical User Interface, you will also have to set DISPLAY to make sure the graphics goes to your terminal. For csh:

setenv LM_LICENSE_FILE /opt/nag/license/license.dat
setenv DISPLAY ip_address:0

where ip_address stands for the IP address of your terminal, workstation, or PC.

Often it is necessary to set the following graphics variable to ensure proper operation:

setenv CXGLTYPE mesagl

This might not be necessary if your client machine has the proper graphic libraries installed. To be on the save side, it is best to include it.

It is also necessary to set several other enviroment variables. Those are collected in thesample.cshrc file in /opt/nag/explorer, and may be accessed by "sourcing" that file; in csh:

source /opt/nag/explorer/sample.cshrc

Then, the program can be started by typing
"/opt/nag/explorer/bin/explorer".

Alternatively to this sequence of setup commands, you may rely on the usepackagefacility to set up your system for Iris Explorer. By typing

use explorer

at the command prompt, or including this command in your .login or .profile file, the above setup commands will automatically be applied to your shell and Iris Explorer can then just be started by typing "explorer &". Note that the DISPLAY environment variable may still have to be set manually.