Chapter 4 HPSS Installation
212 September 2002 HPSS Installation Guide
Release 4.5, Revision 2
1. Log on asroot.
2. Change directory to the HPSS base source tree (the default location is/opt/hpss).
3. Review theMakefile.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

TheSSM Data Server and Gatekeeper Server each links with shared libraries. This allows the shared
librariesto be recompiled without causing the dynamic executables to be relinked. The pathname
tothe shared library that each server links with is stored in its dynamic executable file. The dynamic
executable will fail to load if the pathname of the shared library has been changed since the
dynamicexecutable was linked. The default location for all HPSS shared libraries is /opt/hpss/lib.
Siteswhich need to install their shared libraries in another location will need to modify the location
of the shared library stored in the dynamic executable. This can be achieved by modifying the
RUNLIBS_PATH macro inMakefile.macros and then relinking the dynamic executable.
TheRUNLIBS_PATH macro specifies the run-time top level directoryof the HPSS tree. It defaults
to"/opt/hpss". TheGatekeeper Server and SSM Data Server define their shared library locations in
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_SUPPORTin the Makefile.macros file is off. In order to enable MPI-IO, the following steps
must be performed:
Review theMakefile.macros file. Change MPIO_SUPPORT toon and select the appropriate
MPIO_MPIhost (MPICH,IBM_POE,orSUN_HPC).If no Fortran or C++ support is required, the
MPIO_FORTRAN_SUPPORT andMPIO_CPLUSPLUS_SUPPORT flags should be changed to
off.
Thesetting in Makefile.macros for DCE_SUPPORT affects how MPI-IO is built; the MPI-IO library
mustbe compatible with the HPSS API, with respect to DCE support. MPI-IO is extracted with the
othernon-DCE sources (see Section 4.5.2.1.3) and can be built with the other non-DCE components,
as desired.

4.5.2.2.3 Perform the Compilation

To compile the HPSS binaries, the following steps must be performed: