Filter
Top Products
HPSS Installation Guide September 2002 413
Release 4.5, Revision 2
Chapter 7 HPSS User Interface
Configuration
7.1 Client API Configuration
The following environment variables can be used to define the Client API configuration:
The HPSS_LS_NAME defines the CDS name of the Location Server RPC Group entry for the HPSS
system that the Client API will attempt to contact. The default is /.:/hpss/ls/group.
The HPSS_MAX_CONN defines the number of connections that are supported by the Client API
within a single client process. If HPSS_MAX_CONN is set to zero, the number of connections is
equal to the default supported by the HPSS connection management software - currently 150. If
HPSS_MAX_CONN is nonzero, it is the number of connections to be used.
The HPSS_KTAB_PATH defines the name of the file containing the DCE security keys necessary
for successfully initializing the Client API. The default is /krb5/hpssclient.keytab.
The HPSS_HOSTNAME environment variable is used to specify the hostname to be used for
TCP/IP listen ports created by the Client API. The default value is the default hostname of the
machine on which the Client API is running. This value can have a significant impact on data
transfer performance for data transfers that are handled by the Client API (i.e., those that use the
hpss_Read and hpss_Write interfaces).
The HPSS_TCP_WRITESIZE environment variable is used to specify the amount of data to be
written with each individual request to write data to a network connection during a data transfer.
For some networks, writing less than the entire size of the client buffer has resulted in improved
throughput. This environment variable may not affect the actual value used, depending on the
HPSS network options file - see Section 6.10.2 for further details.
The HPSS_TRANSFER_TYPE environment variable is used to specify the data transport
mechanism to be used for data transfers handled by the Client API. The only valid value is TCP for
TCP/IP transfer. The default value is TCP.
The HPSS_PRINCIPALenvironment variable isused to specifythe DCE principal to beused when
initializing the HPSS security services. The default value is hpss_client_api. This variable is
primarily intended for use by HPSS servers that use the Client API.