Q: I can connect and list files with HSI, but file transfers fail.  Why?

A: This problem is usually caused by one of two things:

1. The wrong host interface is being used.

By default, HSI uses the network interface associated with the hostname command.

There are two ways to override this:

  A. Set the HPSS_HOSTNAME environment variable, in the HSI wrapper script,

      to the network interface name or IP address that HSI should send to the movers

      for inbound data connections.


  For example,

         export HPSS_HOSTNAME=clienthost32-e.mgleicher.us


         export HPSS_HOSTNAME=

  B. Create a "PFTP Client Interfaces" stanza in the HPSS.conf file.

      The HPSS.conf file is found in the directory whose path is obtained from the

       HPSS_CFG_FILE_PATH environment setting. 

       Links: HPSS.conf file settings [To be added]

2. A firewall is blocking inbound connections from the HPSS movers.

If this is the case, there are two options:

a. Open a port range to allow HPSS movers to connect, and set the HPSS_PFTPC_PORT_RANGE

environment variable to the range of ports:

export HPSS_PFTPC_PORT_RANGE=ncacn_ip_tcp[start-end]

For example, if a port range from 25000-25999 has been opened,

export HPSS_PFTPC_PORT_RANGE=ncacn_ip_tcp[25000-25999]

- Note that the syntax for this setting was adopted from the Distributed Computing Environment

(DCE) from the early days of HPSS.   In HPSS 7.4, this syntax will be simplified.

- Note also that in HSI version 5.0.0 and beyond, the new and preferred syntax for a restricted 

  port range is:


   for example:

         export HPSS_PORT_RANGE=25000-25999

  The older form is deprecated, but will continue to be supported for now.

b. If a port range cannot be opened, use the HSI "firewall" command to force store-and-forward

transfers, using a private data socket that is opened on the HSI Gateway Server and connected to

by the HSI client.   Note that firewall mode is not currently available for HTAR.