ssi.sh - The configuration file for the StorageTek (STK) Client System Interface CSI.
SUNWsamfs
ssi.sh is a script that allows users to select values for several
dynamic environment variables used by the CSI.
The STK API code defines default values for these variables if they are
not defined dynamically. To allow the most flexibility in setting these
variables, a shell script
∕etc∕opt∕SUNWsamfs∕scripts∕ssi.sh, is used by
the sam-stkd (1m) daemon,
to start the ssi_so. In general, most sites do not need to change the
variables within this script.
An example script can be found in
∕opt∕SUNWsamfs∕examples∕ssi.sh.
This script, or a user created script, must be copied to
∕etc∕opt∕SUNWsamfs∕scripts∕ssi.sh
It is assumed that the site has the server daemons (CSI and ACSLM) configured and operating with the STK library.
The following environment variables are defined in the
shell script supplied in
∕opt∕SUNWsamfs∕examples∕ssi.sh:
CSI_TCP_RPCSERVICEThis variable is used to define whether the CSI operates as a TCP RPC Server. This environmental variable must be set to TRUE for the firewall-secure CSC. The firewall-secure ACSLS applications packets are all sent using the TCP network transport.
CSI_UDP_RPCSERVICEThis variable is used to define whether the CSI operates as a UDP RPC server. This environmental variable must be set to FALSE for the firewall-secure CSC. The firewall-secure ACSLS applications packets are all sent using the TCP network transport.
The CSI can operate as a TCP and a UDP server simultaneously.
CSI_CONNECT_AGETIMEThis defines the value of the maximum age of pending requests in the CSI's request queue. This variable is accessed as a "C" character array datatype, expressed as an integer number of seconds. A value of 172800 indicates two days.
Messages older than this value are removed from the queue and the CSI sends an entry to the Event Log when this happens.
CSI_RETRY_TIMEOUTThis defines the minimum amount of time, in seconds, that the CSI will wait between attempts to establish a network connection.
CSI_RETRY_TRIESThis variable defines the number of attempts the CSI will make to transmit a message. Pending messages are discarded if a connection cannot be established within the defined number of tries.
The CSI_RETRY_TIMEOUT and CSI_RETRY_TRIES together determine the minimum total time the CSI will attempt to send a message.
