Setting Up Your Environment

C H A P T E R 3

This chapter provides miscellaneous information about the runtime environment that you should know before you begin to use it. It contains the following sections:

Prerequisites

Command and Man Page Paths

Core Files

Prerequisites

If your program uses Sun HPC ClusterTools components, compile and link it on a cluster that contains the Sun HPC ClusterTools software.

It is strongly suggested that you use the Sun HPC ClusterTools 8.2.1c compiler wrapper to compile applications. These compiler wrappers add the appropriate compiler and linker flags to the command line and call the underlying compiler and linker for you. Compiler wrappers are available for C, C++, Fortran 77, and Fortran 90.

For more information about compiling MPI applications, see the “Compiling MPI Applications” FAQ at:

http://www.open-mpi.org/faq/?category=mpi-apps

Command and Man Page Paths

Sun HPC ClusterTools commands typically reside in the following directories:

Solaris OS: /opt/SUNWhpc/HPC8.2.1c/sun/bin

Linux:

/opt/SUNWhpc/HPC8.2.1c/gnu/bin for the GNU compiled version

/opt/SUNWhpc/HPC8.2.1c/sun/bin for the Sun Studio compiled version

/opt/SUNWhpc/HPC8.2.1c/pgi/bin for the PGI compiled version

/opt/SUNWhpc/HPC8.2.1c/intel/bin for the Intel compiled version

/opt/SUNWhpc/HPC8.2.1c/pathscale/bin for the Pathscale compiled version

You can run the Sun HPC ClusterTools software from the directory in which your ClusterTools commands are installed, or you may add the directory to your PATH, or set the PATH environment variable.

The man pages for Sun HPC ClusterTools commands reside in /opt/SUNWhpc/HPC8.2.1c/compiler-name/man.

Note - The path examples in this manual refer to the default location for the Solaris and Sun Studio compiled Linux binaries. Be certain to use the path name that corresponds to your operating system and compiled version of ClusterTools.

Setting Up Your Path

You should set your path to include Sun HPC ClusterTools commands. If they are in a nonstandard location, you also need to set the OPAL_PREFIX environment variable. If you are uncertain whether this step is needed, setting the OPAL_PREFIX environment variable does no harm if the commands are in the standard location.

Use the following command line format for a standard installation on a system running the Solaris OS:

% setenv PATH /opt/SUNWhpc/HPC8.2.1c/sun/bin:${PATH}

The setenv command prefixes the PATH on both the local and remote hosts with /opt/SUNWhpc/HPC8.2.1c/sun/bin.

Use the following command line format for a standard installation on a system running a GNU-compiled Linux OS:

% setenv PATH /opt/SUNWhpc/HPC8.2.1c/gnu/bin:${PATH}

The setenv command prefixes the PATH on both the local and remote hosts with /opt/SUNWhpc/HPC8.2.1c/gnu/bin.

Use the following command line format for systems that have a nonstandard installation. In this example, the Sun HPC ClusterTools software is located in /my/clustertools/installation:

% setenv OPAL_PREFIX /my/clustertools/installation
% setenv PATH $OPAL_PREFIX/bin:$(PATH)

Core Files

Core files are produced as they normally are in the Solaris environment. However, if more than one process dumps core in a multiprocess program, the resulting core file may be overwritten in the same directory. Use coreadm(1M) to control the naming and placement of core files.

To disable the core dump, use the limit(1) command. You can use the following command in the C shell:

% limit coredumpsize 0