


NSR_SERVICE(5)                                     NSR_SERVICE(5)


NNAAMMEE
       nsr_service - NetWorker server resource type ``NSR''

SSYYNNOOPPSSIISS
       ttyyppee:: NNSSRR

DDEESSCCRRIIPPTTIIOONN
       Each  NetWorker  server is described by a resource of type
       NNSSRR.  See nnssrr__rreessoouurrccee(5) for general information on  Net-
       Worker  resources.   To edit the NNSSRR resource use the com-
       mand:
              nsradmin -c "type:NSR"
       or use the nnwwaaddmmiinn(8) GUI.  See nnssrraaddmmiinn(8)  for  informa-
       tion on using the NetWorker administration program.

AATTTTRRIIBBUUTTEESS
       The following attributes are defined for the NNSSRR resource.
       The information in parentheses describes how the attribute
       values  are  accessed.  RReeaadd--oonnllyy indicates that the value
       cannot be changed by an administrator.   RReeaadd//wwrriittee  means
       the  value  can be set as well as read.  CChhooiiccee lliisstt means
       that any number of values can be  chosen  from  the  given
       list.   SSttaattiicc  attributes  change values rarely, if ever.
       DDyynnaammiicc attributes have values which can  change  rapidly.
       HHiiddddeenn  means  it is an attribute of interest only to pro-
       grams or experts, and these attributes can  only  be  seen
       when  the  hidden  option  is  turned on in nnssrraaddmmiinn(8) or
       details option is set  in  nnwwaaddmmiinn(8).   For  example,  an
       attribute  marked ((rreeaadd--oonnllyy,, ssttaattiicc)) has a value which is
       set when the resource is created and never changes, or  is
       changed only by the server.

       nnaammee           (read-only, static)
              This  attribute specifies the hostname of this Net-
              Worker server.
              _E_x_a_m_p_l_e name: mars;

       vveerrssiioonn             (read-only, dynamic)
              This is  the  software  version  of  the  NetWorker
              server  daemon, nnssrrdd(8).  This includes a slash and
              the number of clients currently licensed.
              _E_x_a_m_p_l_e_: version: NetWorker 4.1 Turbo/110;

       ssaavvee ttoottaallss              (read-only, dynamic, hidden)
              Save statistics.  A  string  containing  the  total
              number  of  save sessions, the number of saves with
              errors (if any) and the total number of bytes saved
              (if  any).   This  attribute  is updated after each
              save session completes.
              _E_x_a_m_p_l_e_: save totals: "37 sessions, 457 MB total";

       rreeccoovveerr ttoottaallss           (read-only, dynamic, hidden)
              Recovery statistics.  A string containing the total
              number  of recover sessions, the number of recovers



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





NSR_SERVICE(5)                                     NSR_SERVICE(5)


              with errors (if any) and the total number of  bytes
              recovered  (if  any).   This  attribute  is updated
              after each recover session completes.
              _E_x_a_m_p_l_e_:  recover  totals:  "347  sessions,  48  MB
              total";

       ttoottaallss ssiinnccee             (read-only, dynamic)
              The  time  statistics  collection started.  This is
              usually the last  time  the  NetWorker  server  was
              rebooted.
              _E_x_a_m_p_l_e_: totals since: "Fri Jun  1 09:35:02 1992";

       NNSSRR ooppeerraattiioonn       (read-only, choice list, hidden)
              This  attribute is currently unused and is provided
              for backward compatibility.

       ppaarraalllleelliissmm              (read/write, static)
              This attribute sets the number of  concurrent  save
              sessions  that  this  server will allow.  The value
              can be set by an administrator.  Use higher  values
              for  better  performance on a fast system with lots
              of main memory and swap space, and use lower values
              to avoid overloading a slow system, or systems with
              little main memory and/or swap space.  WWaarrnniinngg: due
              to  bugs  in  some versions of Unix, high values of
              parallelism may cause the system to lock up.
              _E_x_a_m_p_l_e_: parallelism: 4;

       sseessssiioonn ssttaattiissttiiccss       (read-only, dynamic, hidden)
              This  attribute  reports  the  statistics  of  each
              active  session.   There are 14 values for each set
              of statistics, namely, iidd (session's unique identi-
              fier),  nnaammee  (session's  name), mmooddee (read, write,
              browse), ppooooll (current pool), vvoolluummee (current  vol-
              ume),  rraattee kkbb (current data transfer rate for save
              session), aammoouunntt kkbb (current amount read/written by
              session), ttoottaall kkbb (total amount to be read by ses-
              sion), aammoouunntt ffiilleess (current number of files recov-
              ered; to be implemented in a future release), ttoottaall
              ffiilleess (current number of files to  recover;  to  be
              implemented  in  a  future  release),  ccoonnnneecctt ttiimmee
              (time session  has  been  connected),  nnuumm  vvoolluummeess
              (number  of volumes to be used by recover session),
              uusseedd  vvoolluummeess  (number  of  volumes  processed   by
              recover  session),  and  ccoommpplleettiioonn  (running, com-
              plete, or continued)
              _E_x_a_m_p_l_e_: sessions statistics: ;

       mmaannuuaall ssaavveess                    (read/write, hidden)
              This attribute allows the administrator to  disable
              manual  backups  to  the server.  Scheduled backups
              continue to work normally.





NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





NSR_SERVICE(5)                                     NSR_SERVICE(5)


       vvoolluummee pprriioorriittyy                  (read/write)
              If a NetWorker server has volumes in  locally  man-
              aged  jukeboxes  and volumes being managed by Open-
              Vault, this attribute allows the  administrator  to
              set  a  priority  for  selecting volumes to be used
              while saving data. Determines  whether  the  server
              has a preference for volumes being managed by Open-
              Vault, OOppeennvvaauulltt PPrriioorriittyy ,, or whether  the  server
              has  a  preference for volumes in a locally managed
              jukebox, NNeeaarrLLiinnee PPrriioorriittyy ,, when selecting a  vol-
              ume  to  be  used to record data while saving.  The
              default value is NNeeaarrLLiinnee PPrriioorriittyy ..
              _E_x_a_m_p_l_e_: volume priority: NearLine Priority;

       SSmmaarrttMMeeddiiaa ssaavvee mmoouunntt                  (read/write)
              This attribute controls the  form  of  the  request
              made  to  SmartMedia  to  mount a volume for saving
              data.  Setting this attributes value to, vvoolluummee  bbyy
              cchhaarraacctteerriissttiiccss  ,,  causes  NetWorker  to request a
              volume meeting specified criteria, and lets  Smart-
              Media  select  an appropriate volume from all media
              which satisfy the criteria  specified.   When  this
              attribute's  value is set to, vvoolluummee bbyy nnaammee ,, Net-
              Worker will request the volume by name  and  Smart-
              Media  mounts  the  volume  requested.  The default
              value is vvoolluummee bbyy cchhaarraacctteerriissttiiccss ..
              _E_x_a_m_p_l_e_: SmartMedia save mount: volume  by  charac-
              teristics;

       mmeessssaaggee             (read-only, dynamic, hidden)
              The  last message of any kind logged.  A time stamp
              is included at the start of the string.
              _E_x_a_m_p_l_e_: message: "Mon 12:25:51  Tape  full,  mount
              volume mars.001 on /dev/nrst1";

       mmeessssaaggee lliisstt                  (read-only, dynamic, hidden)
              A list of recent messages, with a time stamp and  a
              string message for each value.
              _E_x_a_m_p_l_e_:  message:  "Mon  12:25:51 Tape full, mount
              volume mars.001 on /dev/nrst1";

       sseessssiioonn                  (read-only, dynamic, hidden)
              The value of this attribute is a  list  of  session
              information strings.  Each string includes the Net-
              Worker client  name,  type  of  operation  (saving,
              browsing,  or recovering) and information about the
              save set, including name, number of bytes, and num-
              ber of files.  All sizes and rates are in bytes per
              second, Kilobytes  (1024),  Megabytes  (a  thousand
              Kilobytes), etc.
              _E_x_a_m_p_l_e_:
              session: "venus:/usr saving to mars.001 20MB",
                         "mars:/usr/src done saving 24MB";"




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3





NSR_SERVICE(5)                                     NSR_SERVICE(5)


       ppeennddiinngg             (read-only, dynamic, hidden)
              A  list  of events pending with the NetWorker event
              notification system (see nnssrr__nnoottiiffiiccaattiioonn(5)).  The
              first  three  fields  are  the  time, priority, and
              event name.
              _E_x_a_m_p_l_e_: pending: "Fri 14:40:15 alert: media  mount
              of mars.001 suggested on /dev/nrst1";

       ssttaattuuss              (read-only, dynamic, hidden)
              A  list  of  status flags for the NetWorker server.
              These flags are only for use by  NetWorker  server-
              side  programs  (e.g.   ssaavveeggrroouupp) and list various
              features enabled in the running server.  The format
              is  currently  _n_a_m_e=_b_o_o_l_e_a_n  (true  or false).  The
              features listed, and their states,  can  change  at
              any time.

       ssttaattiissttiiccss               (read-only, dynamic, hidden)
              A list of strings of the form _n_a_m_e=_n_u_m_b_e_r that give
              a number of server statistics.

       ttyyppeess ccrreeaatteedd            (read-only, static)
              A list of all the other resource  types  this  Net-
              Worker  server  can  create and about which clients
              can query.
              _E_x_a_m_p_l_e_: types created: NSR device, NSR group;

       aaddmmiinniissttrraattoorr            (read/write, static)
              This is a list of names (or netgroups) of users who
              are allowed to administer NetWorker.  Normally this
              list is inherited by all other  resources  on  this
              server,  although  each administrator attribute can
              be explicitly changed if  desired.   Administrators
              can   change  the  values  of  attributes  for  the
              resource which lists them.  The administrator  list
              also determines who can add and delete resources of
              the other NSR types.  The user "root" on the  local
              host  of  the  server  is  always an administrator.
              Entries specifying other administrators are of  the
              form,  user,  user@host,  host/user,  or &netgroup.
              The user name and/or host name may be a wild  card,
              "*"  (any  user and/or host).  Entering just a user
              name allows that user to administer NetWorker  from
              any  host  (equivalent  to user@* or */user).  Net-
              group names are always preceded  by  an  "&".   The
              following  example  grants NetWorker administrative
              privileges to,  "root"  from  any  host,  the  user
              "operator" from the hosts "jupiter" and "mars", the
              user "admin" from any host,  and  all  <user  name,
              user's  hostname,  server's domain> in the netgroup
              "netadmins".
              _E_x_a_m_p_l_e_:  administrator:  root,   operator@jupiter,
              mars/operator, admin@*, &netadmins;




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        4





NSR_SERVICE(5)                                     NSR_SERVICE(5)


       ccoonnttaacctt nnaammee             (read/write, static)
              This attribute is used for product licensing/regis-
              tration purposes.   It  must  be  specified  before
              printing the registration information from the reg-
              istration window.
              _E_x_a_m_p_l_e_: contact name:   contact_name;

       ccoommppaannyy             (read/write, static)
              This attribute is used for product licensing/regis-
              tration purposes.  Your comapny name must be speci-
              fied before printing the  registration  information
              from the registration window.
              _E_x_a_m_p_l_e_: company:  Legato;

       ssttrreeeett aaddddrreessss           (read/write, static)
              This attribute is used for product licensing/regis-
              tration mailing  purposes.   Specify  your  mailing
              street address.
              _E_x_a_m_p_l_e_: street address:  3145, Porter Drive;

       cciittyy//ttoowwnn           (read/write, static)
              This attribute is used for product licensing/regis-
              tration mailing purposes.
              _E_x_a_m_p_l_e_: city/town:  Palo Alto;

       ssttaattee//pprroovviinnccee           (read/write, static)
              This attribute is used for product licensing/regis-
              tration mailing purposes.
              _E_x_a_m_p_l_e_: state/province:  CA;

       zziipp//ppoossttaall ccooddee               (read/write, static)
              This attribute is used for product licensing/regis-
              tration mailing purposes.
              _E_x_a_m_p_l_e_: zip/postal code:  94304;

       ccoouunnttrryy             (read/write, static)
              This attribute is used for product licensing/regis-
              tration mailing purposes.
              _E_x_a_m_p_l_e_: country:  USA;

       pphhoonnee               (read/write, static)
              This attribute is used for product licensing/regis-
              tration information purposes.  This attribute  must
              to  be  specified  before printing the registration
              information from the registration window.
              _E_x_a_m_p_l_e_: phone:  415-812-6100;

       ffaaxx            (read/write, static)
              This attribute is used for product licensing/regis-
              tration purposes.
              _E_x_a_m_p_l_e_: fax:  415-812-6031;

       eemmaaiill aaddddrreessss            (read/write, static)
              This     attribute     is    used    for    product



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        5





NSR_SERVICE(5)                                     NSR_SERVICE(5)


              licensing/registration purposes.
              _E_x_a_m_p_l_e_: email address:  support@legato.com;

       CCoommppuuSSeerrvvee aaddddrreessss            (read/write, static)
              This attribute is used for product licensing/regis-
              tration purposes.
              _E_x_a_m_p_l_e_: ompuServe address:  76044,3423;

       ppuurrcchhaassee ddaattee            (read/write, static)
              This attribute is used for product licensing/regis-
              tration purposes.  It specifies the  purchase  date
              of  the  product enabler code.  This attribute must
              be  specified  before  printing  the   registration
              information from the registration window.

       pprroodduucctt sseerriiaall nnuummbbeerr              (read/write, static)
              This attribute is used for product licensing/regis-
              tration purposes.   It  must  be  specified  before
              printing the registration information from the reg-
              istration window.

       mmmm oopp mmeessssaaggee            (read/write, dynamic, hidden)
              This attribute lists the  descriptive  message  for
              the  most  recently completed media database opera-
              tion.  The NetWorker  program  (such  as  nnssrrmmmm(8))
              that  requested the operation clears this attribute
              as soon as it has read the result.  An  administra-
              tor should never change this attribute manually.

       mmmm ooppeerraattiioonn vvaalluuee              (read/write, dynamic, hid-
       den)
              This attribute is used by programs such as nnssrrmmmm(8)
              to  pass the desired media database operation loca-
              tion or flags to the NetWorker server.   The  value
              is  automatically  cleared  when the operation com-
              pletes.  An administrator should never change  this
              attribute manually.

       mmmm ooppeerraattiioonn   (read/write, choice list, dynamic, hidden)
              This attribute is used by programs such as nnssrrmmmm(8)
              to pass the media database operation type currently
              desired  to  the  NetWorker  server.   The possible
              choices are: purge volume, purge save  set,  delete
              volume,  delete  save  set,  mark volume, mark save
              set, unmark volume, unmark save set, specify volume
              lcoation,  specify  volume  flags, and specify save
              set flags.  The server serializes  such  operations
              and  performs  the  appropriate  queries  on  nnssrrmm--
              mmddbbdd(8).  The value is automatically  cleared  when
              the  operation  completes.  An administrator should
              never change this attribute manually.

       mmmm ooppeerraattiioonn iidd          (read/write, dynamic, hidden)
              This attribute is used by programs such as nnssrrmmmm(8)



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        6





NSR_SERVICE(5)                                     NSR_SERVICE(5)


              to  pass the desired media database operation iden-
              tifier to the NetWorker server.  The value is auto-
              matically cleared when the operation completes.  An
              administrator should never  change  this  attribute
              manually.

       nnssrrmmoonn iinnffoo         (read/write, dynamic, hidden)
              This  attribute  is  used  by programs such as nnssrr--
              mmoonn(8) to  pass  information  about  remote  daemon
              requests  to  the  NetWorker  server.  The value is
              automatically cleared when the  request  completes.
              An administrator should never change this attribute
              manually.  See nnssrr__ssttoorraaggee__nnooddee(5) for  a  descrip-
              tion of storage nodes and remote daemons.

       nnssrrmmmmdd ccoouunntt        (read-only, dynamic, hidden)
              This  attribute is used by programs such as nnssrrdd(8)
              to track the number and location of the media  dae-
              mons, nnssrrmmmmdd(8).

       nnssrrmmmmdd ppoolllliinngg iinntteerrvvaall       (read/write, hidden)
              This  attribute  specifies  the  number  of minutes
              between  polling  events  of  a  remote  nnssrrmmmmdd(8).
              nnssrrdd(8)  polls a remote nnssrrmmmmdd(8) at this interval,
              to determine whether it is running.  If  it  deter-
              mines  from  this poll that the daemon is no longer
              running, it will  restart  the  nnssrrmmmmdd(8),  with  a
              delay  set  by  the  `nsrmmd restart interval', see
              below.   See  nnssrr__ssttoorraaggee__nnooddee(5)  for   additional
              details on this attribute and storage nodes.

       nnssrrmmmmdd rreessttaarrtt iinntteerrvvaall       (read/write, hidden)
              This  attribute  specifies  the  number  of minutes
              between restart attempts  of  a  remote  nnssrrmmmmdd(8).
              When nnssrrdd(8) determines that a remote nnssrrmmmmdd(8) has
              terminated, it periodically attempts to restart the
              remote  daemon.  A value of zero for this attribute
              means the daemon should be  restarted  immediately.
              See  nnssrr__ssttoorraaggee__nnooddee(5)  for additional details on
              this attribute and storage nodes.

       nnssrrmmmmdd ccoonnttrrooll ttiimmeeoouutt        (read/write, hidden)
              This attribute  specifies  the  number  of  minutes
              nnssrrdd(8) waits for storage node requests.

       eennaabblleerr ccooddee        (read/write, dynamic, hidden)
              This  attribute  specifies the enabler code for the
              base enabler of the server software.

       SSSS ccuuttooffff ssiizzee      (read/write, hidden)
              This attribute sets the default "save set  cut  off
              size"  to  be used when saving.  A blank value uses
              the built in default value.  A non blank value  for
              this attribute consists of a number followed by KB,



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        7





NSR_SERVICE(5)                                     NSR_SERVICE(5)


              MB, or GB signifying Kilobytes, Megabytes, or Giga-
              bytes.

EEXXAAMMPPLLEE
       A complete example follows:

                          type:  NSR;
                          name:  mars;
                       version:  NetWorker 4.1 Turbo/110;
                   save totals:  "84 sessions, 3597 MB total";
                recover totals:  1 session;
                  totals since:  "Fri Oct 14 12:41:31 1994";
                 NSR operation:  Idle Write Read Verify label Label ;
                   parallelism:  4;
                  manual saves:  Enabled Disabled ;
                       message:  \
       "Mon 14:37:25 media alert event: recover waiting for 8mm tape mars.001";
                  message list:  \
       "Mon 07:10:12 media info: loading volume man.001 into /dev/nrst11"
       "Mon 07:10:33 /dev/nrst11 mount operation in progress"
       "Mon 07:11:15 /dev/nrst11 mounted 8mm 5GB tape man.001
                       session:  "mars:george browsing",
       "mars:/home/mars starting recovery of 9K bytes";
            session statistics:  ;
                       pending:  \
       "Mon 14:40:15 media alert:  recover waiting for 8mm tape mars.001";
                        status:  disabled=false, jukebox=true, dm=true,
                                 archive=true, cds=true, turbo=true,
                                 single=false;
                    statistics:  elapsed = 257415, saves = 1176, recovers = 12,
                                 save KB = 12050007, recover KB = 28272839,
                                 bad saves = 0, bad recovers = 0,
                                 current saves = 1, current recovers = 0,
                                 max saves = 12, max recovers = 1, mounts = 0,
                                 recover delays = 0, saving daemons = 0,
                                 recovering daemons = 0, idle daemons = 0;
                 types created:  NSR device, NSR group, NSR directive,
                                 NSR notification, NSR client, NSR policy,
                                 NSR schedule, NSR pool, NSR label, NSR jukebox,
                                 NSR license, NSR archive client,
                                 NSR archive list;
                 administrator:  root;
                  contact name:  Technical Support;
                       company:  Legato;
                street address:  3145, Porter Drive;
                     city/town:  Palo Alto;
                state/province:  CA;
               zip/postal code:  94304;
                       country:  USA;
                         phone:  415-812-6100;
                           fax:  415-812-6031;
                 email address:  support@legato.com;
            CompuServe address:  76044,3423;
                 purchase date:  ;



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        8





NSR_SERVICE(5)                                     NSR_SERVICE(5)


         product serial number:  ;
                 mm op message:  ;
            mm operation value:  ;
                  mm operation:  ;
               mm operation id:  ;
                   nsrmon info:  ;
                  nsrmmd count:  "mars:2";
       nsrmmd polling interval:  3;
       nsrmmd restart interval:  2;
        nsrmmd control timeout:  5;
                  enabler code:  ;
                SS cutoff size:  ;

FFIILLEESS
       //nnssrr//rreess//nnssrr..rreess  -  this  file  should  never  be  edited
       directly. Use nnwwaaddmmiinn(8) or nnssrraaddmmiinn(8) instead.

SSEEEE AALLSSOO
       nneettggrroouupp(5), nnssrr(5), nnssrr(8), nnssrr__ddeevviiccee(5), nnssrr__ggrroouupp(5),
       nnssrr__nnoottiiffiiccaattiioonn(5), nnssrr__rreessoouurrccee(5), nnssrr__ssttoorraaggee__nnooddee(5),
       nnssrraaddmmiinn(8), nnssrrdd(8), nnssrrmmmm(8), nnssrrmmmmddbbdd(8), nnssrrmmoonn(8),
       nnwwaaddmmiinn(8), rreeccoovveerr(8), ssaavvee(8).



































NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        9


