Message Passing Toolkit: Release Notes Document Number 007–3689–003 St. Peter’s Basilica image courtesy of ENEL SpA and InfoByte SpA. Disk Thrower image courtesy of Xavier Berenguer, Animatica. Copyright © 1999 Silicon Graphics, Inc. All Rights Reserved. This manual or parts thereof may not be reproduced in any form unless permitted by contract or by written permission of Silicon Graphics, Inc. LIMITED AND RESTRICTED RIGHTS LEGEND Use, duplication, or disclosure by the Government is subject to restrictions as set forth in the Rights in Data clause at FAR 52.227-14 and/or in similar or successor clauses in the FAR, or in the DOD or NASA FAR Supplement. Unpublished rights reserved under the Copyright Laws of the United States. Contractor/manufacturer is Silicon Graphics, Inc., 2011 N. Shoreline Blvd., Mountain View, CA 94043-1389. The MPI implementation for the CRAY T3E system is derived from the implementation of MPI for the CRAY T3D system developed at Edinburgh Parallel Computing Centre. The software is supplied to Cray Research under license from The University of Edinburgh. PVM (Parallel Virtual Machine) is based on software that was developed by the Oak Ridge National Laboratory, the University of Tennessee, and Emory University. This work was supported in part by the Applied Mathematical Sciences subprogram of the Office of Energy research, U.S. Department of Energy, in part by the National Science Foundation, and in part by the State of Tennessee. Autotasking, CF77, CRAY, Cray Ada, CraySoft, CRAY Y-MP, CRAY-1, CRInform, CRI/TurboKiva, HSX, LibSci, MPP Apprentice, SSD, SUPERCLUSTER, UNICOS, and X-MP EA are federally registered trademarks and Because no workstation is an island, CCI, CCMT, CF90, CFT, CFT2, CFT77, ConCurrent Maintenance Tools, COS, Cray Animation Theater, CRAY APP, CRAY C90, CRAY C90D, Cray C++ Compiling System, CrayDoc, CRAY EL, CRAY J90, CRAY J90se, CrayLink, Cray NQS, Cray/REELlibrarian, CRAY S-MP, CRAY SSD-T90, CRAY SV1, CRAY T90, CRAY T3D, CRAY T3E, CrayTutor, CRAY X-MP, CRAY XMS, CRAY-2, CSIM, CVT, Delivering the power . ., DGauss, Docview, EMDS, GigaRing, HEXAR, IOS, ND Series Network Disk Array, Network Queuing Environment, Network Queuing Tools, OLNET, RQS, SEGLDR, SMARTE, SUPERLINK, System Maintenance and Remote Testing Environment, Trusted UNICOS, UNICOS MAX, and UNICOS/mk are trademarks of Cray Research, Inc., a wholly owned subsidiary of Silicon Graphics, Inc. DynaWeb is a trademark of Inso Corporation. IRIS, IRIX, and Silicon Graphics are registered trademarks and IRIS InSight and the Silicon Graphics logo are trademarks of Silicon Graphics, Inc. MIPS is a trademark of MIPS Technologies, Inc. Netscape is a trademark of Netscape Communications Corporation. PostScript is a trademark of Adobe Systems, Inc. TotalView is a trademark of Bolt Beranek and Newman Inc. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Limited. The X device is a trademark of The Open Group. X/Open is a registered trademark of X/Open Company Ltd. The UNICOS operating system is derived from UNIX® System V. The UNICOS operating system is also based in part on the Fourth Berkeley Software Distribution (BSD) under license from The Regents of the University of California. Contents Page Introduction [1] 1 MPT Components ........................ 2 MPT Software ......................... 3 Product Description . .................... 3 Distribution of These Release Notes ................... 5 Reader Comments ........................ 6 New Features [2] 7 MPI Scaling to Support 48x128 Clusters . ............... 7 Multiboard Adapter Selection .................... 7 Thread-Safe MPI ........................ 7 MPI Collectives Optimization .................... 7 Compile-time Interface Checking for Fortran MPI Subroutine Calls ......... 7 MPI Statistics ......................... 8 MPII/O........................... 8 XMPI and XPVM ........................ 8 Cray TotalView Support . .................... 9 Message Queue Display . .................... 9 MPI Usability Improvements . .................... 9 Compatibilities and Differences [3] 11 XMPI and XPVM Retired . .................... 11 Documentation [4] 13 Online Information Access . .................... 13 Documentation Included with the Release . ............... 14 007–3689–003 i Message Passing Toolkit: Release Notes Page Customer Services [5] 15 Support Policy ......................... 15 MPI Support Policy . .................... 15 PVM Support Policy . .................... 15 SHMEM Library Support Policy ................... 16 MPT World Wide Web Page . .................... 16 Training Support ........................ 16 Software Problem Reporting and Resolution Process . .......... 16 CRInform Program ........................ 17 Pipeline and the Pipeline Supercomputing Supplement .............. 18 Additional Resources . .................... 18 MPI Standard ......................... 18 News Groups ......................... 19 World Wide Web Servers . .................... 19 MPI User Group Meetings . .................... 19 PVM User Group Meetings .................... 19 PVM E-Mail Support . .................... 20 netlib Source ........................ 20 Release Package [6] 23 Hardware and Software Requirements . ............... 23 Licensing Information . .................... 24 Licensing contacts for customers in the U.S. and Canada . .......... 24 Licensing Contacts for Customers outside of the U.S. and Canada ........ 24 European Regional Contract Administrators/Specialists . .......... 25 Japan Contract Negotiators .................... 26 Release Package Contents . .................... 27 Ordering the MPT 1.3 Release Package . ............... 27 ii 007–3689–003 Contents Page Obtaining Publications . .................... 28 Appendix A Updated Release Information 31 Index 33 007–3689–003 iii Introduction [1] This document provides an overview of the Cray Message Passing Toolkit and Message Passing Toolkit for IRIX (MPT) 1.3 release. MPT is a software package that supports interprocess data exchange for applications that use concurrent, cooperating processes on a single host or on multiple hosts. Data exchange is done through message passing, which is the use of library calls to request data delivery from one process to another or between groups of processes. The MPT 1.3 release is supported on the following platforms: • Cray PVP systems running UNICOS release 10.0 or later. The MPT 1.3 release requires a bugfix package to be installed on UNICOS systems running release 10.0.0.0 or 10.0.0.1. The bugfix package, MPT12_OS_FIXES, is available through the getfix utility. It is also available from the anonymous FTP site ftp.cray.com in directory /pub/mpt/fixes/MPT12_OS_FIXES. • CRAY T3E systems running UNICOS/mk release 1.5 or later. • Silicon Graphics MIPS based systems running IRIX release 6.2 or later. IRIX 6.2 systems running Parallel Virtual Machine (PVM) require the POSIX patch set and any patches recommended by the patch set. IRIX 6.2 systems running Message Passing Interface (MPI) require the kernel rollup patch 1650 or later. IRIX 6.3 systems running MPI require the kernel rollup patch 2328 or later. IRIX systems running MPI applications must also be running Array Services software version 3.0 or later. IRIX systems using the Miser feature must be running IRIX 6.5 or later and Array Services version 3.1 or later. MPI jobs that use the checkpoint and restart feature require IRIX 6.4 plus kernel patch 2839 and CPR patch 2689, or IRIX 6.5. In addition, CPR patch 3017 fixes IRIX 6.4 and IRIX 6.5 problems that exist with the ash (array session handler) option of the cpr(1) command. Array Services 3.1 or later is also required for this feature. Activation of the MPI usability improvements feature is dependent on Array Services 3.2 plus patch 3532. 007–3689–003 1 Message Passing Toolkit: Release Notes These release notes include information about the following: • New features • Compatibilities and differences • Documentation • Customer services • Release package contents The remainder of this chapter discusses the following topics: • MPT components • MPT software • Product description • Distribution of these release notes • Reader comments 1.1 MPT Components The MPT 1.3 package contains the following components and accompanying documentation: • Parallel Virtual Machine (PVM) • Message Passing Interface (MPI) • Logically shared, distributed memory (SHMEM) message passing routines The PVM and MPI components of MPT are based on industry standards for the message passing programming model. These components also contain enhancements specific to Silicon Graphics and Cray Research systems. For a description of MPI, see the Message Passing Toolkit: MPI Programmer’s Manual. For a description of PVM, see the Message Passing Toolkit: PVM Programmer’s Manual. The SHMEM library is packaged with MPT on UNICOS and IRIX systems only. On UNICOS/mk systems, the SHMEM library is delivered with the CrayLibs package. SHMEM man pages are printed in the Application Programmer’s Library Reference Manual. 2 007–3689–003 Introduction [1] 1.2 MPT Software For UNICOS and UNICOS/mk systems, software included in MPT was designed to be used with the Cray Programming Environment 3.0 release or later. The Modules software package is used to support the installation of both the Programming Environment and MPT. To use the MPT software, load the mpt module in addition to loading the Programming Environment module. For information on using modules, see Installing