EMC Legato NetWorker Commands Reference

libstlstk

SYNOPSIS

       ssi    [ ACSLS server ] [ socket ] [ retry count ] &
         mini_el [ -l logfile ] [ -d ] [ -h ] &
         libstlstk.so   (Solaris)
         libstlstk.so.a (AIX)
         libstlstk.sl   (HPUX)
         libstlstk.so.1 (SGI)
         libstlstk.so.1 (DYNIX/ptx)
         libstlstk.so   (DECAXP)
         libstlstk.dll  (NT i386)

DESCRIPTION

       NOTE:  in  this  document,  the  term  "ACSLS  server"  will be used to
       indicate the name of the system that is running any one of StorageTek's
       library  manager  programs:  ACSLS  on  a  Solaris or AIX host, Library
       Station on an MVS host, or Horizon Library Manager on a system  running
       Windows NT or Windows 2000.

      (Unix only)

       The  ssi  command  is  used  indirectly by nsrjb to communicate with an
       ACSLS server.  nsrjb loads libstlstk, which handles the  TCP  calls  to
       and  from  ssi.  ssi  then handles all of communication to and from the
       ACSLS server.  Starting with ACSLS version 5.3, it is possible  to  run
       NetWorker  (either  a  server  or a storage node) on the same host that
       ACSLS is running on.

       ssi and mini_el must be running on the system on which jbconfig was run
       to  create the jukebox resource.  ssi and mini_el are almost always run
       as background processes, and are usually started automatically  by  the
       system.

       In  addition  to ssi and mini_el, a shared library file (usually called
       libstlstk.xxx where xxx is an operating system-dependent extension)  is
       also  required.  An appropriate version of this library is installed as
       part of NetWorker.

      New in version 1.06 of ssi:

       ssi now supports communication to more than one  ACSLS  server  at  any
       given  time.  Previous versions of ssi were limited to a fixed TCP port
       for communication with NetWorker, and hence were limited to having only
       one  instance  running  at  a time.  In version 1.06, ssi and libstlstk
       have an added private communication channel that lets libstlstk ask any
       of  the  running  ssi instances which ACSLS server it is connecting to,
       and to select the proper ssi for the current NetWorker silo.   To  make
       it  easier to set up a configuration with the possibilility of many ssi
       processes running, the command line for ssi has changed.

       While you can still start ssi the  same  way  as  before  -  using  the
       allowed  range  will be selected.  If the port number is not specified,
       each successive instance of ssi  will  take  the  next  available  port
       starting from 50004 and going upwards.  If there are no available ports
       in the range, ssi will  fail  to  load  and  should  display  an  error
       message.  Note  that  specifying  the  port number is not necessary for
       normal operation.  You do not need to insure that a given ACSLS  server
       is  always  accessed over a given port.  NetWorker and ssi use the name
       of the ACSLS server to establish a connection on the fly.

       If there is not a hostname specified on the ssi  command  line,  before
       ssi is started, one environment variable MUST be set: CSI_HOSTNAME must
       be set to the name of the library server.   If  this  variable  is  not
       found, ssi will exit with an error message.

       mini_el  is  an  event  logger used by ssi to maintain a log of certain
       events.  It should be started before ssi.  Multiple  instances  of  ssi
       will  share  a  single instance of mini_el.  A header consisting of the
       ACSLS server name and the local TCP port that ssi will be listening  on
       is  included  at  the  start  of any message placed into the log by any
       instance of ssi

      (NT only)

       On NT, the software equivalent to ssi and mini_el must be obtained from
       StorageTek as their product "Library Attach for NT".  This package must
       be installed prior to configuring a Silo in NetWorker.

       NOTE: Library Attach version 1.1 includes a  portmapper  function  that
       will  only  install properly if the NetWorker services are not running.
       You should use Control Panel to stop the "NetWorker Backup and  Recover
       Server"  and  the  "NetWorker  Remote  Exec  Service" before installing
       Library Attach.  After Library Attach  is  installed,  you  should  use
       Control  Panel  to start "NetWorker Remote Exec Service" and "NetWorker
       Backup and Recover Server".

       NOTE: Since Legato does not supply "Library  Attach  for  NT",  we  are
       unable  to  add the multiple ACSLS host functionality to our NT version
       of NetWorker.

      (All platforms)

       libstlstk.xxx is  a  shared  library  that  handles  the  communication
       between  nsrjb  and ssi or Library Attach.   ssi or Library Attach then
       handles the communication  over  the  network  to  the  library  server
       (either  ACSLS, Library Station or Horizon Library Manager).  There are
       no  options,  parameters  or  environment  variables  that  affect  the
       operation  of  libstlstk.   The  correct  path  to  this file should be
       entered when an STK silo is configured  using  jbconfig.   The  default
       values specified by jbconfig match the default locations chosen for the
       installation program, and in most cases can be accepted.

OPTIONS

   mini_el
       -l     logfile Specifies the filename of the logfile to be  created  by
              mini_el.   The  default  value  is  /nsr/logs/ssi_event.log.  If
              present, logfile must be the complete path to the  logfile.   If
              the  file  does not exist, it will be created.  If the file does

PARAMETERS

   ssi
       ACSLS  server  is required if the CSI_HOSTNAME environment variable has
              not  been  set  to  the  name  of  the  system  running   ACSLS,
              LibraryStation or Horizon.

       socket  is  only  required  if  you need to specify the socket used for
              communication between NetWorker and ssi

       retry count is only required if you need to increase  the  retry  count
              for  communication  between  ssi  and  the  ACSLS  server due to
              network problems.

       These parameters are not position sensitive.  The command line code  in
       ssi  uses  the  value  of  the  parameter  to decide which of the three
       acceptable parameters any given command line parameter actually is:

            If the input parameter evaluates to zero using the atoi  function,
            then  it  is  assumed to be the ACSLS server name.  Only the first
            parameter that evaluates to  zero  will  be  used  as  the  server
            hostname.

            If  the  parameter  evaluates to a number between 50004 and 50100,
            then it is assumed to  be  the  socket  value  to  be  used.   All
            parameters  that  fit this case will be saved as the socket value,
            so the last matching parameter on the command line will be the one
            actually used.

            If a parameter evaluates to a number between 1 and 500, then it is
            assumed to be the retry count. As with the socket  parameter,  the
            last matching parameter on the command line wins.

            Any  parameter  that  falls  outside of these cases will simply be
            ignored.

ENVIRONMENT VARIABLES

   ssi
       CSI_HOSTNAME  (text, up to 256 chars, there is no
              default)
              If an ACSLS server name is not found on the  command  line,  ssi
              will use the hostname specified by this variable.  It is limited
              to 256 characters, and should simply be the hostname running the
              library  server  program  that you are trying to connect to.  If
              neither the command line hostname nor this environment  variable
              specify  a  hostname for ssi to use, ssi will exit with an error
              message.

       SSI_HOSTNAME  (text, up to 256 chars, there is no
              default)
              This variable  is  intended  for  use  on  multi-homed  systems.
              Normally,   ssi   uses  the  gethostbyname  system  function  to
              determine the name to use for this side of the connection to the
              ACSLS  server.  On a system with several network interfaces, the
              name supplied by that function may not result in the use of  the
              network  interface  needed to communicate with the ACSLS server.
              On these systems, you can explicitly specify the exact  name  of
              the  network interface that ssi will use to connect to the ACSLS
              server.  This variable needs to be set before  ssi  is  started,
              on, this variable specifies the starting number for ssi  to  use
              when  it needs to open a socket to talk to the ACSLS server.  It
              appears that ssi will only open two sockets if this variable  is
              set.   The first, at SSI_BASE_SOCKET, will be used to connect to
              any host.  The second, at SSI_BASE_SOCKET + 1, will be used  for
              direct  communication  to the ACSLS server. Note that there will
              still be  the  default  sockets  at  50001  and  50004  used  to
              communicate  between  mini_el  and  ssi,  but  any communication
              between this host and the ACSLS server should  occur  using  the
              two sockets starting at SSI_BASE_SOCKET.

       TIME_FORMAT (time format string,
              default = "%m-%d-%y %H:%M:%S")
              If  you  wish  to see time values printed in a format other than
              the default  of  Month-Day-Year  Hour:Minute:Seconds,  use  this
              variable.
                  %m is replaced by the current month
                  %d is replaced by today's date
                  %y is replaced by the current year
                  %H is replaced by the current hour
                  %M is replaced by the current minute
                  %S is replaced by the current second

       CSI_CONNECT_AGETIME  (seconds, 0 < x < 31536000,
              default = 600)
              This  will  set  the number of seconds for network connect aging
              purposes.

       CSI_RETRY_TIMEOUT  (seconds, 0 < x < ??, default = 4)
              This will set how long ssi will wait before retrying  a  network
              request.

       CSI_RETRY_TRIES  (numeric, 0 < x < 100, default = 5)
              This  will  set  the  number  of  times ssi will retry sending a
              network message before reporting an error.

       CSI_TCP_RPCSERVICE  (boolean, default is TRUE)
              This sets whether ssi will use TCP sockets to connect  with  the
              library server.

       CSI_UDP_RPCSERVICE  (boolean, default is FALSE)
              This  sets  whether ssi will use UDP sockets to connect with the
              library server.  Setting CSI_UDP_RPCSERVICE to TRUE  will  allow
              ssi  to  communicate  with  a  csi  that  is running on the same
              system.

EXAMPLES

       Normal STK silo setup:
            mini_el &
            ssi acsls1 &
         - or -
            mini_el &
            setenv CSI_HOSTNAME acsls1
            ssi &

       Connect to 3 different ACSLS servers:
            mini_el &
            ssi acsls1 &
            setenv CSI_HOSTNAME acsls3
            ssi &

       Connect to 3 different ACSLS servers over 3 different
              network interfaces:
            mini_el &
            setenv SSI_HOSTNAME myhost_on_net1
            ssi acsls1 &
            setenv SSI_HOSTNAME myhost_on_net2
            ssi acsls2 &
            setenv SSI_HOSTNAME myhost_on_net3
            ssi acsls3 &

       Connect to ACSLS server on socket 50025
            mini_el &
            ssi acsls1 50025 &
         - or -
            setenv CSI_HOSTNAME acsls1
            mini_el &
            ssi 50025 &

       To have
              mini_el use /nsr/logs/ssi.log.today as its log file
            mini_el -l /nsr/logs/ssi.log.today &
            ssi acsls1 &

FILES

       /nsr/logs/ssi_event.log
              default logfile created/appended to by mini_el

SEE ALSO

       nsrjb(1), jbconfig(1), dasadmin(1), libstlemass(1), libstlibm(1)

DIAGNOSTICS

       Several startup and shutdown messages along with any errors in communi-
       cation  between the NetWorker server and the ACSLS server are logged in
       the logfile /nsr/logs/ssi_event.log (or other logfile as  specified  on
       the mini_el command line).  The messages from any one ssi instance will
       be preceded by the name of the ACSLS server that that instance will  be
       communicating  with  plus  the  local TCP port number that will be used
       between NetWorker and ssi.

       For example:
            10-12-00 12:31:44 SSI[0]:
            [devlab-acsls/50004] ONC RPC: csi_init(): Initiation Started
            source csi_init.c; line 165

            10-12-00 12:33:20 SSI[0]:
            [acsls2/50011] ONC RPC: csi_init(): Initiation Completed
            ONC RPC: csi_init(): ACSLS server acsls2 accessed through port 50011

ADVERTISEMENT