diff options
author | Albert Cheng <acheng@hdfgroup.org> | 2008-05-28 21:32:32 (GMT) |
---|---|---|
committer | Albert Cheng <acheng@hdfgroup.org> | 2008-05-28 21:32:32 (GMT) |
commit | 3aa5d8b987b8b40c86d79be421ac12de19518e2a (patch) | |
tree | a136833c9e32a66ddfd37dd1c8f83ae543d674c5 /release_docs | |
parent | b0fe33f2435054abe9aaa718e99b1eae40cf9e2f (diff) | |
download | hdf5-3aa5d8b987b8b40c86d79be421ac12de19518e2a.zip hdf5-3aa5d8b987b8b40c86d79be421ac12de19518e2a.tar.gz hdf5-3aa5d8b987b8b40c86d79be421ac12de19518e2a.tar.bz2 |
[svn-r15083] INSTALL_parallel:
Added and updated instructions for Red Storm serial and parallel build.
RELEASE.txt:
Added Red Storm information. Also, rearranged order of entries according
to more recent first.
Diffstat (limited to 'release_docs')
-rw-r--r-- | release_docs/INSTALL_parallel | 62 | ||||
-rw-r--r-- | release_docs/RELEASE.txt | 64 |
2 files changed, 106 insertions, 20 deletions
diff --git a/release_docs/INSTALL_parallel b/release_docs/INSTALL_parallel index e8f8bad..f9ab51c 100644 --- a/release_docs/INSTALL_parallel +++ b/release_docs/INSTALL_parallel @@ -104,6 +104,30 @@ Linux kernels 2.4 and greater. 2.4. Red Storm (Cray XT3) (for v1.8 and later) ------------------------- +Both serial and parallel HDF5 are supported in Red Storm. + +2.4.1 Building serial HDF5 for Red Storm +------------------------------------------ +The following steps are for building the serial HDF5 for the Red Storm +compute nodes. They would probably work for other Cray XT3 systems but have +not been verified. + +# Assume you already have a copy of HDF5 source code in directory `hdf5' and +# want to install the binary in directory `/project/hdf5/hdf5'. + +$ cd hdf5 +$ bin/yodconfigure configure +$ env RUNSERIAL="yod -sz 1" \ + CC=cc F9X=ftn CXX=CC \ + ./configure --prefix=/project/hdf5/hdf5 +$ make +$ make check + +# if all is well, install the binary. +$ make install + +2.4.2 Building parallel HDF5 for Red Storm +------------------------------------------ The following steps are for building the Parallel HDF5 for the Red Storm compute nodes. They would probably work for other Cray XT3 systems but have not been verified. @@ -115,15 +139,47 @@ not been verified. $ cd hdf5 $ bin/yodconfigure configure $ env RUNSERIAL="yod -sz 1" RUNPARALLEL="yod -sz 3" \ - CC="mpicc -DRED_STORM" F9X=mpif90 \ - ./configure --disable-hl --without-zlib --disable-stream-vfd \ - --enable-parallel --prefix=/project/hdf5/phdf5 + CC=mpicc F9X=mpif90 \ + ./configure --enable-parallel --prefix=/project/hdf5/phdf5 $ make $ make check # if all is well, install the binary. $ make install +2.4.3 Red Storm known problems +------------------------------ +For Red Storm, a Cray XT3 system, the yod command sometimes gives the +message, "yod allocation delayed for node recovery". This interferes with +test suites that do not expect seeing this message. To bypass this problem, +I launch the executables with a command shell script called "myyod" which +consists of the following lines. (You should set $RUNSERIAL and $RUNPARALLEL +to use myyod instead of yod.) +==== myyod ======= +#!/bin/sh +# sleep 2 seconds to allow time for the node recovery else it pops the +# message, +# yod allocation delayed for node recovery +sleep 2 +yod $* +==== end of myyod ======= + +For Red Storm, a Cray XT3 system, the tools/h5ls/testh5ls.sh will fail on +the test "Testing h5ls -w80 -r -g tgroup.h5" fails. This test is +expected to fail and exit with a non-zero code but the yod command does +not propagate the exit code of the executables. Yod always returns 0 if it +can launch the executable. The test suite shell expects a non-zero for +this particular test, therefore it concludes the test has failed when it +receives 0 from yod. To bypass this problem for now, change the following +lines in the tools/h5ls/testh5ls.sh. +======== Original ========= +# The following combination of arguments is expected to return an error message +# and return value 1 +TOOLTEST tgroup-1.ls 1 -w80 -r -g tgroup.h5 +======== Skip the test ========= +echo SKIP TOOLTEST tgroup-1.ls 1 -w80 -r -g tgroup.h5 +======== end of bypass ======== + 3. Detail explanation --------------------- diff --git a/release_docs/RELEASE.txt b/release_docs/RELEASE.txt index c86184e..bd3042c 100644 --- a/release_docs/RELEASE.txt +++ b/release_docs/RELEASE.txt @@ -4,7 +4,7 @@ HDF5 version 1.8.1-rc1 currently under development INTRODUCTION ============ -This document describes the differences between the HDF5-1.8.x release series +This document describes the differences between the HDF5-1.8.1 release series and HDF5 1.8.0, and contains information on the platforms tested and known problems in HDF5-1.8.1. For more details, see the files HISTORY-1_0-1_8_0_rc3.txt and HISTORY-1_8.txt in the release_docs/ directory @@ -56,14 +56,17 @@ New Features Configuration ------------- - - Configuration suite now uses Autoconf 2.61, Automake 1.10.1, and - Libtool 2.2.2 (MAM - 2008/05/01) + - The lib/libhdf5.settings file contains much more configure + information. (AKC - 2008/05/18) - The new configure option "--disable-sharedlib-rpath" disables embedding the '-Wl,-rpath' information into executables when shared libraries are produced, and instead solely relies on the information in LD_LIBRARY_PATH. (MAM - 2008/05/15) + - Configuration suite now uses Autoconf 2.61, Automake 1.10.1, and + Libtool 2.2.2 (MAM - 2008/05/01) + Source code distribution ======================== @@ -77,17 +80,17 @@ New Features Tools ----- - - h5dump, in output of the -p option: Added effective data compression - ratio to the dataset storage layout output when a compression filter - has been applied to a dataset. (PVN - 2008/05/01) - - h5dump: Added an option, -m, to allow user-defined formatting in the - output of floating point numbers. (PVN - 2008/05/06) - - h5dump: Added support for external links, displaying the object that - an external link points to. (PVN - 2008/05/12) - h5repack: Reinstated the -i and -o command line flags to specify input and output files. h5repack now understands both the old syntax (with -i and -o) and the new syntax introduced in Release 1.8.0. (PVN - 2008/05/23) + - h5dump: Added support for external links, displaying the object that + an external link points to. (PVN - 2008/05/12) + - h5dump: Added an option, -m, to allow user-defined formatting in the + output of floating point numbers. (PVN - 2008/05/06) + - h5dump, in output of the -p option: Added effective data compression + ratio to the dataset storage layout output when a compression filter + has been applied to a dataset. (PVN - 2008/05/01) F90 API ------ @@ -104,6 +107,8 @@ New Features Support for New Platforms, Languages, and Compilers =================================================== +Both serial and parallel HDF5 are supported for the Red Storm machine which is +a Cray XT3 system. - The Fortran library will work correctly if compiled with the -i8 flag. This has been tested with the g95, PGI and Intel Fortran @@ -129,7 +134,7 @@ Bug Fixes since HDF5-1.8.0 target file's pathname is an absolute or a relative path. Please see the H5Lcreate_external description in the "HDF5 Reference Manual" (http://hdfgroup.org/HDF5/doc/RM/RM_H5L.html). - (VC - 4/8/08) + (VC - 2008/04/08) - Fixed possible file corruption bug when encoding datatype descriptions for compound datatypes whose size was between 256 and 511 bytes and the file was opened with the "use the @@ -177,8 +182,7 @@ Bug Fixes since HDF5-1.8.0 Platforms Tested ================ - -The following platforms and compilers have been tested for for this release. +The following platforms and compilers have been tested for this release. AIX 5.2 (32/64-bit) xlc 8.0.0.11 xlC 8.0 @@ -186,6 +190,12 @@ The following platforms and compilers have been tested for for this release. mpcc_r 6.0.0.8 mpxlf_r 8.1.1.7 + Cray XT3 (2.0.41) cc (pgcc) 7.1-4 + (red storm) ftn (pgf90) 7.1-4 + CC (pgCC) 7.1-4 + mpicc 1.0.2 + mpif90 1.0.2 + FreeBSD 6.2-STABLE i386 gcc 3.4.6 [FreeBSD] 20060305 (duty) g++ 3.4.6 [FreeBSD] 20060305 gcc 4.2.1 20080123 @@ -301,6 +311,7 @@ Linux 2.6 SGI Altix ia64 Intel (3) y y y y y y Linux 2.6 RHEL C Lustre Intel (5) y(4) y y(4) y y n +Cray XT3 2.0.41 y y y y y n Platform Shared Shared Shared Thread- @@ -332,6 +343,7 @@ Linux 2.4 SGI Altix ia64 Intel y n Linux 2.6 RHEL C Lustre Intel (5) y y y n +Cray XT3 2.0.41 n n n n n Notes: (1) Using mpich2 1.0.6. (2) Using mpich2 1.0.7. @@ -358,6 +370,28 @@ Linux 2.6 RHEL C Known Problems ============== +* For Red Storm, a Cray XT3 system, the yod command sometimes gives the + message, "yod allocation delayed for node recovery". This interferes with + test suites that do not expect seeing this message. See the section of "Red + Storm" in file INSTALL_parallel for a way to deal with this problem. + AKC - 2008/05/28 + +* For Red Storm, a Cray XT3 system, the tools/h5ls/testh5ls.sh will fail on + the test "Testing h5ls -w80 -r -g tgroup.h5" fails. This test is + expected to fail and exit with a non-zero code but the yod command does + not propagate the exit code of the executables. Yod always returns 0 if it + can launch the executable. The test suite shell expects a non-zero for + this particular test, therefore it concludes the test has failed when it + receives 0 from yod. To bypass this problem for now, change the following + lines in the tools/h5ls/testh5ls.sh. + ======== Original ========= + # The following combination of arguments is expected to return an error message + # and return value 1 + TOOLTEST tgroup-1.ls 1 -w80 -r -g tgroup.h5 + ======== Skip the test ========= + echo SKIP TOOLTEST tgroup-1.ls 1 -w80 -r -g tgroup.h5 + ======== end of bypass ======== + AKC - 2008/05/28 * We have discovered two problems when running collective IO parallel HDF5 tests with chunking storage on the ChaMPIon MPI compiler on tungsten, a @@ -386,10 +420,6 @@ Known Problems use -mp -O1 compilation flags to build the libraries. A higher level of optimization causes failures in several HDF5 library tests. -* For SNL, Red Storm: Only parallel HDF5 is supported. The serial tests pass - when run against the parallel library; the parallel tests also pass, but - with lots of non-fatal error messages. - * For LLNL, uP: both serial and parallel tests pass. Zeus: Serial tests pass but parallel tests fail with a known problem in MPI. ubgl: Serial tests pass but parallel tests fail. |