Product specifications
Table Of Contents
- Table of Contents
- 1 Introduction
- 2 Feature Overview
- 3 Step-by-Step Cluster Setup and MPI Usage Checklists
- 4 InfiniPath Cluster Setup and Administration
- Introduction
- Installed Layout
- Memory Footprint
- BIOS Settings
- InfiniPath and OpenFabrics Driver Overview
- OpenFabrics Drivers and Services Configuration and Startup
- Other Configuration: Changing the MTU Size
- Managing the InfiniPath Driver
- More Information on Configuring and Loading Drivers
- Performance Settings and Management Tips
- Host Environment Setup for MPI
- Checking Cluster and Software Status
- 5 Using QLogic MPI
- Introduction
- Getting Started with MPI
- QLogic MPI Details
- Use Wrapper Scripts for Compiling and Linking
- Configuring MPI Programs for QLogic MPI
- To Use Another Compiler
- Process Allocation
- mpihosts File Details
- Using mpirun
- Console I/O in MPI Programs
- Environment for Node Programs
- Environment Variables
- Running Multiple Versions of InfiniPath or MPI
- Job Blocking in Case of Temporary InfiniBand Link Failures
- Performance Tuning
- MPD
- QLogic MPI and Hybrid MPI/OpenMP Applications
- Debugging MPI Programs
- QLogic MPI Limitations
- 6 Using Other MPIs
- A mpirun Options Summary
- B Benchmark Programs
- C Integration with a Batch Queuing System
- D Troubleshooting
- Using LEDs to Check the State of the Adapter
- BIOS Settings
- Kernel and Initialization Issues
- OpenFabrics and InfiniPath Issues
- Stop OpenSM Before Stopping/Restarting InfiniPath
- Manual Shutdown or Restart May Hang if NFS in Use
- Load and Configure IPoIB Before Loading SDP
- Set $IBPATH for OpenFabrics Scripts
- ifconfig Does Not Display Hardware Address Properly on RHEL4
- SDP Module Not Loading
- ibsrpdm Command Hangs when Two Host Channel Adapters are Installed but Only Unit 1 is Connected to the Switch
- Outdated ipath_ether Configuration Setup Generates Error
- System Administration Troubleshooting
- Performance Issues
- QLogic MPI Troubleshooting
- Mixed Releases of MPI RPMs
- Missing mpirun Executable
- Resolving Hostname with Multi-Homed Head Node
- Cross-Compilation Issues
- Compiler/Linker Mismatch
- Compiler Cannot Find Include, Module, or Library Files
- Problem with Shell Special Characters and Wrapper Scripts
- Run Time Errors with Different MPI Implementations
- Process Limitation with ssh
- Number of Processes Exceeds ulimit for Number of Open Files
- Using MPI.mod Files
- Extending MPI Modules
- Lock Enough Memory on Nodes When Using a Batch Queuing System
- Error Creating Shared Memory Object
- gdb Gets SIG32 Signal Under mpirun -debug with the PSM Receive Progress Thread Enabled
- General Error Messages
- Error Messages Generated by mpirun
- MPI Stats
- E Write Combining
- F Useful Programs and Files
- G Recommended Reading
- Glossary
- Index

A–mpirun Options Summary
Spawn Options
A-2 IB6054601-00 H
S
-np np
This option specifies the number of processes to spawn. If this option is not set,
then the environment variable MPI_NPROCS is checked. If MPI_NPROCS is not
set, the default is to determine the number of processes based on the number of
hosts in the machinefile -M or the list of hosts -H.
-ppn processes-per-node
This option creates up to the specified number of processes per node.
By default, a limit is enforced that depends on how many InfiniPath contexts are
supported by the node (depends on the hardware type and the number of
InfiniPath cards present).
InfiniPath context (port) sharing is supported, beginning with the InfiniPath 2.0
release. This feature allows running up to four times as many processes per node
as was previously possible, with a small additional overhead for each shared
context.
Context sharing is enabled automatically if needed. Use of the full number of
available contexts is assumed. To restrict the number of contexts, use the
environment variable PSM_SHAREDCONTEXTS_MAX to divide the available
number of contexts.
Context sharing behavior can be overriden by using the environment variable
PSM_SHAREDCONTEXTS. Setting this variable to zero disables context sharing,
and jobs that require more than the available number of contexts cannot be run.
Setting this variable it to one (the default) causes context sharing to be enabled if
needed.
-rcfile node-shell-script
This is the startup script for setting the environment on nodes. Before starting
node programs, mpirun checks to see if a file called .mpirunrc exists in the
user’s home directory. If the file exists, it is sourced into the running remote
shell. Use -rcfile node-shell-script or .mpirunrc to set paths and other
environment variables such as LD_LIBRARY_PATH.
Default: $HOME/.mpirunrc
Spawn Options
-distributed [=on|off]
This option controls use of the distributed mpirun job spawning mechanism. The
default is on. To change the default, put this option in the global
mpirun.defaults file or a user-local file (see the environment variable
PSC_MPIRUN_DEFAULTS_PATH for details). When the option appears more than
once on the command line, the last setting controls the behavior.
Default: on.