Hub/Switch Installation Guide

Chapter 4 HPSS Installation
212 September 2002 HPSS Installation Guide
Release 4.5, Revision 2
1. Log on as root.
2. Change directory to the HPSS base source tree (the default location is /opt/hpss).
3. Review the Makefile.macros file.
4. Ensure that the target directory tree (where the source tree will be constructed) is empty.
5. Issue the following command:
% make BUILD_ROOT=<Non-DCE source tree directory> build-nodce
4.5.2.2 Compile the HPSS Binaries
4.5.2.2.1 Define the HPSS Shared Libraries Location
TheSSMDataServerandGatekeeperServereachlinkswithsharedlibraries.Thisallowstheshared
libraries to be recompiled without causing the dynamic executables to be relinked. The pathname
tothesharedlibrarythateachserverlinkswithisstoredinitsdynamicexecutablefile.Thedynamic
executable will fail to load if the pathname of the shared library has been changed since the
dynamic executable was linked. The default location for all HPSS shared libraries is /opt/hpss/lib.
Siteswhich needto installtheir sharedlibrariesin anotherlocationwillneedtomodifythelocation
of the shared library stored in the dynamic executable. This can be achieved by modifying the
RUNLIBS_PATH macro in Makefile.macros and then relinking the dynamic executable.
The RUNLIBS_PATH macrospecifies the run-time top level directory of the HPSS tree. It defaults
to"/opt/hpss". The Gatekeeper ServerandSSM DataServer definetheirsharedlibrarylocationsin
terms of this macro, as $(RUNLIBS_PATH)/lib. Sites which install their run-time HPSS tree in a
location other than /opt/hpss should change RUNLIBS_PATH to reflect the name of their tree.
4.5.2.2.2 Configure the HPSS MPI-IO Component
The HPSS MPI-IO component source tree is included in the HPSS base source tree, but since this
component is dependent upon a host MPI that is not platform-dependent, the default setting for
MPIO_SUPPORT intheMakefile.macros fileisoff.Inordertoenable MPI-IO,thefollowing steps
must be performed:
Review the Makefile.macros file. Change MPIO_SUPPORT to on and select the appropriate
MPIO_MPI host (MPICH,IBM_POE,orSUN_HPC).IfnoFortran orC++ supportisrequired,the
MPIO_FORTRAN_SUPPORT and MPIO_CPLUSPLUS_SUPPORT flags should be changed to
off.
ThesettinginMakefile.macrosforDCE_SUPPORTaffectshowMPI-IOisbuilt;theMPI-IOlibrary
must be compatible with theHPSS API,with respectto DCEsupport. MPI-IO is extracted with the
othernon-DCEsources(seeSection4.5.2.1.3)andcanbebuiltwiththeothernon-DCEcomponents,
as desired.
4.5.2.2.3 Perform the Compilation
To compile the HPSS binaries, the following steps must be performed: