IPnom Home • Manuals • Legato NetWorker

 EMC Legato NetWorker Commands Reference

Legato NetWorker Stuff:NetWorker Commands ReferenceNetWorker Links
NetWorker Command Live Search (15 results max):
 Type in part of a Legato NetWorker command in the search box.
Legato NetWorker Commands Index:
  ansrd
  ascdcode
  cdi_block_limits
  cdi_bsf
  cdi_bsr
  cdi_eod
  cdi_filemark
  cdi_fsf
  cdi_fsr
  cdi_get_config
  cdi_get_status
  cdi_inq
  cdi_load_unload
  cdi_locate
  cdi_offline
  cdi_rewind
  cdi_set_compression
  cdi_space
  cdi_ta
  cdi_tapesize
  cdi_tur
  changers
  dasadmin
  ddmgr
  EMASS_silo
  erase
  generate_test_tape
  hadump
  hafs
  hagentd
  hagetconf
  haprune
  hascsi
  hasubmit
  hasys
  hpflip
  IBM_silo
  ielem
  inquire
  jbconfig
  jbexercise
  jbverify
  ldunld
  lgtolic
  lgtolmd
  libcdi
  libscsi
  libsji
  libstlemass
  libstlibm
  libstlstk
  lrescan
  lreset
  lus_add_fp_devs
  lusbinfo
  lusdebug
  mini_el
  mm_data
  mminfo
  mmlocate
  mmpool
  mmrecov
  msense
  mt
  ndmpjbconf
  networker
  nsr (1)
  nsr (5)
  nsr_archive_request
  nsr_client
  nsr_crash
  nsr_data
  nsr_device
  nsr_directive
  nsr_getdate
  nsr_group
  nsr_ize
  nsr_jukebox
  nsr_label
  nsr_layout
  nsr_license
  nsr_migration
  nsr_notification
  nsr_policy
  nsr_pool
  nsr_regexp
  nsr_resource
  nsr_schedule
  nsr_service
  nsr_shutdown
  nsr_stage
  nsr_storage_node
  nsr_support
  nsr_usergroup
  nsradmin
  nsralist
  nsrarchive
  nsrcap
  nsrcat
  nsrck
  nsrclone
  nsrcnct
  nsrd
  nsrexec
  nsrexecd
  nsrhsmck
  nsrhsmclear
  nsrhsmd
  nsrhsmls
  nsrhsmnfs
  nsrhsmrc
  nsrhsmrecall
  nsrib
  nsriba
  nsrim
  nsrindexasm
  nsrindexd
  nsrinfo
  nsrjb
  nsrlic
  nsrls
  nsrmig
  nsrmm
  nsrmmd
  nsrmmdbasm
  nsrmmdbd
  nsrmon
  nsrndmp_clone
  nsrndmp_recover
  nsrndmp_save
  nsrpmig
  nsrports
  nsrretrieve
  nsrssc
  nsrstage
  nsrtrap
  nsrwatch
  nwadmin
  nwarchive
  nwbackup
  nwrecover
  nwretrieve
  pathownerignore
  pmode
  preclntsave
  pstclntsave
  read_a_block
  recover
  relem
  resource
  save
  savefs
  savegrp
  savepnpc
  scanner
  sjiielm
  sjiinq
  sjimm
  sjirdp
  sjirdtag
  sjirelem
  sjirjc
  sjisn
  sn
  ssi
  stk_eject
  STK_silo
  stli
  sym2xdm
  tapeexercise
  tur
  uasm
  writebuf
   
   - Windows Only
  mt
  nsrlpr
  nsrperf


STK_silo

ssi - StorageTek silo interface module (Unix only) mini_el - event logger for use with ssi (Unix only) libstlstk - shared library for communication to ssi

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 will be 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

Legato NetWorker 7.x

Man(1) output converted with man2html, sed, awk


 

Legato NetWorker Commands Reference • Legato NetWorker Links