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
Shell Options
A-6 IB6054601-00 H
S
Shell Options
-shell shell-name
This option specifies the name of the program to use to log into remote hosts.
Default: ssh, unless $MPI_SHELL is defined.
-shellx shell-name
This option specifies the name of program to use to log into remote hosts with X11
forwarding. This option is useful when running with -debug
or in xterm.
Default: ssh, unless $MPI_SHELL_X is defined.
Debug Options
-debug
This option starts all the processes under debugger, and waits for the user to set
breakpoints and run the program. The gdb option is used by default, but can be
overridden using the -debugger argument. Other supported debuggers are
strace and the QLogic debugger pathdb.
-debug-no-pause
This option is similar to -debug, except that it does not pause at the beginning.
The gdb option is used by default.
-debugger gdb|pathdb|strace
This option uses the specified debugger instead of the default gdb.
-display X-server
This option uses the specified X server for invoking remote xterms. (-debug,
-debug-no-pause, and -in-xterm options use this value.)
Default: whatever is set in $DISPLAY
-in-xterm
This option runs each process in an xterm window. This is implied when -debug
or -debug-no-pause is used.
Default: write to stdout with no stdin
-psc-debug-level mask
This option controls the verbosity of messages printed by the MPI and InfiniPath
protocol layer. The default is 1, which displays error messages. A value of 3 displays
short messaging details such as source, destination, size, etc. A value of FFh prints
detailed information in a messaging layer for each message. Use this option with care,
since too much verbosity will negatively affect application performance.
Default: 1
-xterm xterm
This option specifies which xterm to use.
Default: xterm