summaryrefslogtreecommitdiffstats
path: root/release_docs/INSTALL_parallel
diff options
context:
space:
mode:
Diffstat (limited to 'release_docs/INSTALL_parallel')
-rw-r--r--release_docs/INSTALL_parallel177
1 files changed, 177 insertions, 0 deletions
diff --git a/release_docs/INSTALL_parallel b/release_docs/INSTALL_parallel
new file mode 100644
index 0000000..e2a0709
--- /dev/null
+++ b/release_docs/INSTALL_parallel
@@ -0,0 +1,177 @@
+ Installation instructions for Parallel HDF5
+ -------------------------------------------
+
+
+1. Overview
+-----------
+
+This file contains instructions for the installation of parallel
+HDF5. Platforms supported by this release are SGI Origin 2000, IBM SP2,
+Intel TFLOPs, and Linux version 2.4 and greater. The steps are kind of
+unnatural and will be more automized in the next release. If you have
+difficulties installing the software in your system, please send mail to
+
+ hdfparallel@ncsa.uiuc.edu
+
+In your mail, please include the output of "uname -a". Also attach the
+content of "config.log" if you ran the "configure" command.
+
+First, you must obtain and unpack the HDF5 source as described in the
+INSTALL file. You also need to obtain the information of the include and
+library paths of MPI and MPIO software installed in your system since the
+parallel HDF5 library uses them for parallel I/O access.
+
+
+2. Quick Instruction for known systems
+--------------------------------------
+
+The following shows particular steps to run the parallel HDF5
+configure for a few machines we've tested. If your particular platform
+is not shown or somehow the steps do not work for yours, please go
+to the next section for more detailed explanations.
+
+------
+TFLOPS
+------
+
+Follow the instuctions in INSTALL_TFLOPS.
+
+-------
+IBM SP2
+-------
+
+First of all, make sure your environment variables are set correctly
+to compile and execute a single process mpi applications for the SP2
+machine. They should be similar to the following:
+
+ setenv CC mpcc_r
+ setenv MP_PROCS 1
+ setenv MP_NODES 1
+ setenv MP_LABELIO no
+ setenv MP_RMPOOL 0
+ setenv RUNPARALLEL "MP_PROCS=2 MP_TASKS_PER_NODE=2 poe"
+ setenv LLNL_COMPILE_SINGLE_THREADED TRUE
+
+The shared library configuration for this version is broken. So, only
+static library is supported.
+
+An error for powerpc-ibm-aix4.3.2.0's (LLNL Blue) install method was
+discovered after the code freeze. You need to remove the following line
+from config/powerpc-ibm-aix4.3.2.0 before configuration:
+
+ ac_cv_path_install=${ac_cv_path_install='cp -r'}
+
+Then do the following steps:
+
+ $ ./configure --disable-shared --prefix=<install-directory>
+ $ make # build the library
+ $ make check # verify the correctness
+ $ make install
+
+
+---------------
+SGI Origin 2000
+Cray T3E
+(where MPI-IO is part of system MPI library such as mpt 1.3)
+---------------
+
+#!/bin/sh
+
+RUNPARALLEL="mpirun -np 3"
+export RUNPARALLEL
+LIBS="-lmpi"
+export LIBS
+./configure --enable-parallel --disable-shared --prefix=$PWD/installdir
+make
+make check
+make install
+
+
+---------------
+SGI Origin 2000
+Cray T3E
+(where MPI-IO is not part of system MPI library or I want to use my own
+ version of MPIO)
+---------------
+
+mpi1_inc="" #mpi-1 include
+mpi1_lib="" #mpi-1 library
+mpio_inc=-I$HOME/ROMIO/include #mpio include
+mpio_lib="-L$HOME/ROMIO/lib/IRIX64" #mpio library
+
+MPI_INC="$mpio_inc $mpi1_inc"
+MPI_LIB="$mpio_lib $mpi1_lib"
+
+#for version 1.1
+CPPFLAGS=$MPI_INC
+export CPPFLAGS
+LDFLAGS=$MPI_LIB
+export LDFLAGS
+RUNPARALLEL="mpirun -np 3"
+export RUNPARALLEL
+LIBS="-lmpio -lmpi"
+export LIBS
+
+./configure --enable-parallel --disable-shared --prefix=$PWD/installdir
+make
+make check
+make install
+
+
+---------------------
+Linux 2.4 and greater
+---------------------
+
+Be sure that your installation of MPICH was configured with the following
+configuration command-line option:
+
+ -cflags="-D_LARGEFILE_SOURCE -D_LARGEFILE64_SOURCE -D_FILE_OFFSET_BITS=64"
+
+This allows for >2GB sized files on Linux systems and is only available
+with Linux kernels 2.4 and greater.
+
+
+------------------
+HP V2500 and N4000
+------------------
+
+Follow the instructions in section 3.
+
+
+3. Detail explanation
+---------------------
+
+The HDF5 library can be configured to use MPI and MPI-IO for parallelism
+on a distributed multi-processor system. The easiest way to do this is to
+have a properly installed parallel compiler (e.g., MPICH's mpicc or IBM's
+mpcc) and supply that executable as the value of the CC environment
+variable:
+
+ $ CC=mpcc ./configure
+ $ CC=/usr/local/mpi/bin/mpicc ./configure
+
+If no such wrapper script is available then you must specify your normal
+C compiler along with the distribution of MPI/MPI-IO which is to be used
+(values other than `mpich' will be added at a later date):
+
+ $ ./configure --enable-parallel=mpich
+
+If the MPI/MPI-IO include files and/or libraries cannot be found by the
+compiler then their directories must be given as arguments to CPPFLAGS
+and/or LDFLAGS:
+
+ $ CPPFLAGS=-I/usr/local/mpi/include \
+ LDFLAGS=-L/usr/local/mpi/lib/LINUX/ch_p4 \
+ ./configure --enable-parallel=mpich
+
+If a parallel library is being built then configure attempts to determine
+how to run a parallel application on one processor and on many
+processors. If the compiler is `mpicc' and the user hasn't specified
+values for RUNSERIAL and RUNPARALLEL then configure chooses `mpirun' from
+the same directory as `mpicc':
+
+ RUNSERIAL: /usr/local/mpi/bin/mpirun -np 1
+ RUNPARALLEL: /usr/local/mpi/bin/mpirun -np $${NPROCS:=3}
+
+The `$${NPROCS:=3}' will be substituted with the value of the NPROCS
+environment variable at the time `make check' is run (or the value 3).