Message Passing Toolkit (MPT) User's Guide

Document Number: 007-3773-018

Front Matter

| List of Examples | List of Tables |


Table of Contents

New Features in This Manual
Major Documentation Changes

About This Manual
Related Publications and Other Sources
Obtaining Publications
Conventions
Reader Comments

1. Introduction
MPI Overview

2. Administrating MPT
Finding the MPT Release Notes
MPT Installation
System Configuration

3. Getting Started
Compiling and Linking MPI Programs
Using mpirun to Launch an MPI Application
Running MPI Jobs with a Work Load Manager
Compiling and Running SHMEM Applications

4. Programming with SGI MPI
Job Termination and Error Handling
Signals
Buffering
Multithreaded Programming
Interoperability with the SHMEM programming model
Miscellaneous Features of SGI MPI
Programming Optimizations
Additional Programming Model Considerations

5. Debugging MPI Applications
MPI Routine Argument Checking
Using the TotalView Debugger with MPI programs
Using idb and gdb with MPI programs

6. PerfBoost
Using PerfBoost
Environment Variables
MPI Supported Functions

7. Checkpoint/Restart
BLCR Installation
Using BLCR with MPT

8. Run-time Tuning
Reducing Run-time Variability
Tuning MPI Buffer Resources
Avoiding Message Buffering - Enabling Single Copy
Memory Placement and Policies
Tuning MPI/OpenMP Hybrid Codes
Tuning for Running Applications Across Multiple Hosts
Tuning for Running Applications over the InfiniBand Interconnect
MPI on Altix UV 100 and Altix UV 1000 Systems
Suspending MPI Jobs

9. MPI Performance Profiling
Overview of perfcatch Utility
Using the perfcatch Utility
MPI_PROFILING_STATS Results File Example
MPI Performance Profiling Environment Variables
MPI Supported Profiled Functions
Profiling MPI Applications

10. Troubleshooting and Frequently Asked Questions
What are some things I can try to figure out why mpirun is failing?
My code runs correctly until it reaches MPI_Finalize() and then it hangs.
My hybrid code (using OpenMP) stalls on the mpirun command.
I keep getting error messages about MPI_REQUEST_MAX being too small.
I am not seeing stdout and/or stderr output from my MPI application.
How can I get the MPT software to install on my machine?
Where can I find more information about the SHMEM programming model?
The ps(1) command says my memory use (SIZE) is higher than expected.
What does MPI: could not run executable mean?
How do I combine MPI with insert favorite tool here ?
Why do I see “stack traceback” information when my MPI job aborts?

Index