nsr_service(5)                                                        nsr_service(5)

NAME

       nsr_service - NetWorker server resource type 'NSR'


SYNOPSIS

       type: NSR


DESCRIPTION

       Each  NetWorker  server  is  described  by a resource of type NSR.  See
       nsr_resource(5) for general information  on  NetWorker  resources.   To
       edit the NSR resource use the command:
       
              nsradmin -c "type:NSR"
       
       See nsradmin(8) for information on using the NetWorker administration
       program.


ATTRIBUTES

       The following attributes are defined for the NSR resource.  The  infor-
       mation  in parentheses describes how the attribute values are accessed.
       Read-only indicates that the value cannot be changed by an  administra-
       tor.   Read/write  means  the  value  can be set and read.  Choice list
       means that any number of values can be  chosen  from  the  given  list.
       Static attributes change values rarely.  Dynamic attributes have values
       which can change rapidly.  Hidden means it is an attribute of  interest
       only to programs or experts, and these attributes can only be seen when
       the hidden option is turned on in nsradmin(8).   For  example, an
       attribute marked (read-only, static) has a value which is set when the
       resource is created and never changes, or is changed only by the server.

       name           (read-only, static)
              This  attribute specifies the hostname of this NetWorker server.
              Example name: mars;

       version             (read-only, dynamic)
              This is the software version of  the  NetWorker  server  daemon,
              nsrd(8).   This  includes a slash and the number of clients cur-
              rently licensed.
              Example: version: NetWorker 4.1 Turbo/110;

       comment             (read/write)
              This attribute is provided for the  administrator  to  keep  any
              explanatory remarks or supplementary information about this Net-
              Worker server.
              Example: comment: machine located in room 243;

       save totals    (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.
              Example: save totals: "37 sessions, 457 MB total";

       recover totals (read-only, dynamic, hidden)
              Recovery  statistics.   A  string containing the total number of
              recover sessions, the number of recovers with  errors  (if  any)
              and  the  total  number  of  bytes  recovered  (if  any).   This

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

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

       parallelism         (read/write, static)
              This attribute sets the number of concurrent save sessions  that
              this  server will allow.  The value can be set by an administra-
              tor.  Use higher values for better performance on a fast  system
              with  lots  of  main  memory and swap space. Use lower values to
              avoid overloading a slow system, or  systems  with  little  main
              memory  and/or swap space.  Warning: due to defects in some ver-
              sions of UNIX, high values of parallelism may cause  the  system
              to lock up.
              Example: parallelism: 4;

       session statistics  (read-only, dynamic, hidden)
              This  attribute  reports  the statistics of each active session.
              There are 14 values for each set of statistics, namely, id (ses-
              sion's  unique  identifier),  name (session's name), mode (read,
              write, browse), pool (current pool),  volume  (current  volume),
              rate kb (current data transfer rate for save session), amount kb
              (current amount read/written by session), total kb (total amount
              to  be  read  by session), amount files (current number of files
              recovered; to be implemented in a future release),  total  files
              (current  number  of  files  to  recover; to be implemented in a
              future release), connect time (time session has been connected),
              num  volumes  (number of volumes to be used by recover session),
              used volumes (number of volumes processed by  recover  session),
              and completion (running, complete, or continued)
              Example: sessions statistics: ;

       monitor rap                    (read/write, hidden)
              This  attribute  allows  the  administrator  to  enable  logging
              changes  made  to   the   configuration   resources   into   the
              /nsr/logs/rap.log.

       manual saves                    (read/write, hidden)
              This  attribute allows the administrator to disable manual back-
              ups to the server.  Scheduled backups continue to work normally.

       public archives		       (read/write)
              This  attribute  determines whether a user can retrieve archived
              files that are owned by another user.
	      
       volume priority                  (read/write)
              If  a  NetWorker server has volumes in locally managed jukeboxes
              and volumes being managed by SmartMedia, this  attribute  allows
              the administrator to assign a priority for volume selection when
              saving data. Determines whether the server has a preference  for
              volumes  being  managed  by  SmartMedia, SmartMedia Priority, or
              whether the server has a preference for  volumes  in  a  locally
              managed  jukebox, NearLine Priority.  The default value is Near-
              Line Priority.
              Example: volume priority: NearLine Priority;

       SmartMedia save mount                  (read/write)
              This  attribute  controls the form of the request made to Smart-
              Media to mount a volume for saving data.	Setting the  value  of
              this attributes to volume by characteristics causes NetWorker to
              request a volume meeting specified criteria, and lets SmartMedia
              select  an  appropriate  volume from all media which satisfy the
              criteria specified.  When this attribute's value is set to  vol-
              ume  by  name  ,	NetWorker  will request the volume by name and
              SmartMedia mounts the volume requested.  The  default  value  is
              volume by characteristics .
              Example: SmartMedia save mount: volume by characteristics;

       license server		       (read/write, hidden)
	      The  name	 of the server on which a NetWorker license manager is
	      installed and running.  This attribute used to be	 called	 "GEMS
	      server".	 You  can  set	the value to a GEMStation where a GEMS
	      license manager is running or to a  machine  where  a  NetWorker
	      license manager is running.
	      Example: license server: jupiter;

       update licenses (choice, read-only, dynamic, hidden)
              Set to 'Yes' if this server should attempt to re-synchronize its
              externally mananged licenses immediately.

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

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

       server message (read-only, dynamic, hidden)
              Lists  recent  concise  general messages about the status of the
              server.
              Example:  message:  "Tape  full,  mount   volume   mars.001   on
              /dev/nrst1";

       sequence number     (read-only, dynamic, hidden)
              The sequence number of the corrosponding server message.

       server message time  (read-only, dynamic, hidden)
              The time at which the server message was generated.

       server message priority (read-only, dynamic, hidden)
              The priority of the server message. Currently these are for Net-
              Worker internal use.

       server message source  (read-only, dynamic, hidden)
              This attribute gives the NetWorker component that generated  the
              message on the server. This can be a client, a device etc.

       server message category (read-only, dynamic, hidden)
              This  attribute  is  the category the server message belongs to.
              Currently these are for NetWorker internal use.

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

       session message     (read-only, dynamic, hidden)
              Concise   session   message  string  of  the  session  attribute
              described above.
              Example:
              session: "venus:/usr saving to mars.001",
			 "mars:/usr/src done saving";"

       session client name  (read-only, dynamic, hidden)
              The name of each client for which each session is active.

       session rate   (read-only, dynamic, hidden)
              The rate of data transfer for the active session.

       session rate label  (read-only, dynamic, hidden)
              Unit of data transfer for the active sessons.

       session device name  (read-only, dynamic, hidden)
              The name of the device on which the session is active.

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

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

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

       LSSV reg code	   (read-write, hidden)
              Customer registration code, for "EMC Single Server  Version  for
              Oracle".

       Job inactivity timeout   (read/write, static)
              Global  setting  for  the number of minutes since a job has been
              heard from last, after which it will be  declared  inactive  and
              will be terminated.
              This  setting  is  enforced  by nsrjobd and replaces environment
              variable NSR_UNRESPONSIVE_JOB_TIMEOUT.
              Unlike the group inactivity timeout which applies only  to  save
              processes maintaining connection to nsrmmd, this timeout applies
              to all processes throughout runtime.  For  example,  if  a  save
              process  were  to  hang in argument processing, group inactivity
              setting would never trigger its  termination,  however  if  this
              attribute is set, it will result in terminating such a hang pro-
              cess after number of minutes set in this attribute has passed.
              An empty string or a value of 0 indicates that no  such  timeout
              is in effect.

       Jobsdb retention in days	     (read/write, static)
              Minimum  time  to	 keep completed job records in the active jobs
              database, in days.  After this time, records will be purged  out
              of  the  active  jobs  database.	NMC server should retrieve job
              records within this  time	 for  long-term	 monitoring  purposes.
              Make  sure  that	the  NMC  server  does not stay off-line for a
              period of time  longer  than  the	 interval  specified  by  this
              attribute.
              Warning:	large  values  of  this attribute may cause the active
              jobs database to grow very large on  busy	 servers,  potentially
              causing performance problems.  Adjust with caution.

       Jobsdb maximum size	(read/write, static)
              Maximum  size  that  the active jobs database is allowed to grow
              to.  If the database size exceeds this value,  the  database  is
              purged  until  the size drops at least 10% below the maximum set
              by this attribute. Records are selected from oldest to youngest.
              This value supercedes the retention time. Setting this value too
              low will cause records to be purged prematurely.
              Warning: large values of this attribute  may  cause  the	active
              jobs  database  to  grow very large on busy servers, potentially
              causing performance problems.  Adjust with caution.

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

       administrator       (read/write, static)
              This  is a list of names (or netgroups) of users who are allowed
              to administer NetWorker. Users in this list are members  of  the
              Administrators  user  group.   This  list  is inherited from the
              Users attribute in the Administrators user group resource.  Only
              users  with  the  Change  Security Settings privilege can see or
              modify this attribute.  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,   user@domain,   group@host,    group@domain,
              host/user &netgroup, or user_attribute=value[, ...]

              where  user is a user name; host is a host name; group is a user
              group name; domain is a domain name; user_attribute can be user,
              group,  host,  domain, or domaintype (type of the domain, NIS or
              WINDOMAIN)

              The user attributes: nwinstname and nwinstancename are  used  to
              indicate	a  NetWorker  instance name.  The value that should be
              entered for either of these  attributes  is  the	value  in  the
              "name"  field  in	 the  NSRLA  resource  for the machine where a
              matched user is connecting from.

              value can be any string delimited by white space. If  the  value
              has  space in it, then it can be quoted with double quotes.  The
              value may contain wild cards, "*".  Entering just  a  user  name
              allows  that user to administer NetWorker from any host (equiva-
              lent to user@* or */user  or  user=user).   Netgroup  names  are
              always preceded by an "&".

              The following example grants NetWorker Administrators membership
              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".
              Example:	administrator:	root, operator@jupiter, mars/operator,
              admin@*, &netadmins;

              The following example grants NetWorker Administrator  membership
              to the user "root" on host "pluto", users in group "Backup Oper-
              ators" from windows domain "Accounting", and user "joe"  in  NIS
              domain "YP.fubar.COM".
              Example:  administrator: "user=root,host=pluto", "group=\"Backup
              Operators\",      domain=Accounting,      domaintype=windomain",
              "user=joe, domain=YP.fubar.COM, domaintype=NIS";

       contact name        (read/write, static)
              This  attribute  is used for product licensing/registration pur-
              poses.  It must be specified before  printing  the  registration
              information from the registration window.
              Example: contact name:   contact_name;

       company        (read/write, static)
              This  attribute  is used for product licensing/registration pur-
              poses.  Your company name must be specified before printing  the
              registration information from the registration window.
              Example: company:  EMC Corporation;

       street address      (read/write, static)
              This  attribute is used for product licensing/registration mail-
              ing purposes.  Specify your mailing street address.
              Example: street address:  176 South Street;

       city/town      (read/write, static)
              This attribute is used for product licensing/registration  mail-
              ing purposes.
              Example: city/town:  Hopkinton;

       state/province      (read/write, static)
              This  attribute is used for product licensing/registration mail-
              ing purposes.
              Example: state/province:  MA;

       zip/postal code          (read/write, static)
              This attribute is used for product licensing/registration  mail-
              ing purposes.
              Example: zip/postal code:  01748;

       country        (read/write, static)
              This  attribute is used for product licensing/registration mail-
              ing purposes.
              Example: country:  USA;

       phone          (read/write, static)
              This attribute is used for product  licensing/registration  pur-
              poses.   This attribute must to be specified before printing the
              registration information from the registration window.
              Example: phone:  877-534-2867;

       fax       (read/write, static)
              This attribute is used for product  licensing/registration  pur-
              poses.
              Example: fax:  650-745-1477;

       email address	   (read/write, static)
	      This  attribute  is used for product licensing/registration pur-
	      poses.
	      Example: email address:  support@emc.com;

       server OS type      (read/write, static)
              This  attribute  is used for product licensing/registration pur-
              poses.
              Example: server OS type:  Solaris;
              This  attribute  is used for product licensing/registration pur-
              poses.  It must be specified before  printing  the  registration
              information from the registration window.

       purchase date	   (read/write, static)
              This  attribute  is used for product licensing/registration pur-
              poses.  It specifies the purchase date of	 the  product  enabler
              code.  This attribute must be specified before printing the reg-
              istration information from the registration window.

       product serial number	(read/write, static)
              This attribute is used for product  licensing/registration  pur-
              poses.   It  must	 be specified before printing the registration
              information from the registration window.

       mm op message  (read/write, dynamic, hidden)
              This  attribute  lists  the  descriptive  message  for  the most
              recently completed  media  database  operation.   The  NetWorker
              program  (such  as nsrmm(8)) that requested the operation clears
              this attribute as soon as it has read the result.   An  adminis-
              trator should never change this attribute manually.

       mm operation value    (read/write, dynamic, hidden)
              This  attribute is used by programs such as nsrmm(8) to pass the
              desired media database operation location or flags to  the  Net-
              Worker  server.   The  value  is  automatically cleared when the
              operation completes.  An administrator should never change  this
              attribute manually.

       mm operation  (read/write, choice list, dynamic,
              hidden)
              This  attribute is used by programs such as nsrmm(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 location, specify
              volume flags, and specify save set flags.  The server serializes
              such  operations  and  performs the appropriate queries on
              nsrmmdbd(8).  The value is automatically cleared when the  operation
              completes.   An administrator should never change this attribute
              manually.

       mm operation id   (read/write, dynamic, hidden)
              This attribute is used by programs such as nsrmm(8) to pass  the
              desired  media  database  operation  identifier to the NetWorker
              server.  The value is automatically cleared when  the  operation
              completes.   An administrator should never change this attribute
              manually.

       nsrmon info    (read/write, dynamic, hidden)
              This attribute is used by programs such  as  nsrmon(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 nsr_storage_node(5) for a description of  storage
              nodes and remote daemons.

       nsrmmd count   (read-only, dynamic, hidden)
              This  attribute is used by programs such as nsrd(8) to track the
              number and location of the media daemons, nsrmmd(8).

       nsrmmd polling interval  (read/write, hidden)
              This attribute specifies the number of minutes  between  polling
              events  of a remote nsrmmd(8).  nsrd(8) polls a remote nsrmmd(8)
              at this interval, to determine whether it  is  running.   If  it
              determines  from this poll that the daemon is no longer running,
              it will restart the nsrmmd(8), with a delay set by  the  'nsrmmd
              restart  interval'; see the nsrmmd restart interval description.
              See nsr_storage_node(5) for additional details on this attribute
              and storage nodes.

       nsrmmd restart interval	(read/write, hidden)
              This attribute specifies the number of minutes  between  restart
              attempts	of a remote nsrmmd(8).	When nsrd(8) determines that a
              remote nsrmmd(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 nsr_stor-
              age_node(5) for additional details on this attribute and storage
              nodes.

       nsrmmd control timeout   (read/write, hidden)
              This attribute specifies the number of minutes nsrd(1) waits for
              storage node requests.

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

       vendor ID      (read/write, hidden)
              Identifier of the vendor that built and shipped this server.
	      
       SS cutoff size      (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 num-
              ber followed by KB, MB, or GB signifying  Kilobytes,  Megabytes,
              or  Gigabytes.   Note that this field only affects clients older
              than version 6.0.  Continuation save sets have  been  eliminated
              for version 6.0 and above.

       User ID             (dynamic, hidden)
              This attribute contains the user ID the NetWorker server authen-
              ticated  you  as.  The  user  ID  is  usually  in   the   format
              user/host@domain.

       Privileges          (dynamic, hidden)
              This attribute lists the privileges that you have.

       Member of      (dynamic, hidden)
              This attribute lists the user groups that you are a member of.

       hostname (read-only, hidden)
              This attribute gives the hostname of the machine	on  which  the
              service  that  controls  this  resource  is  running. It is used
              internally and cannot be changed by the administrator.

       ONC program number (read-only, hidden)
              The Open Network Computing (sunrpc)  identification  number  for
              the client to server protocol provided by this service.

       ONC version number (read-only, hidden)
              The version of the above protocol.

       ONC transport (choice, read-write, hidden)
              The  Open	 Network  Computing  (sunrpc) transport protocols sup-
              ported are TCP (Transport Control Protocol) or UDP  (User	 Data-
              gram Protocol).

       timezone offset (read-only, hidden)
              This attribute displays the server's timezone offset from GMT.


EXAMPLE

       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;
                     parallelism:  4;
                    manual saves:  Enabled;
                     Monitor RAP:  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:  "EMC Corporation";
                  street address:  176 South Street;
                       city/town:  Hopkinton;
                  state/province:  MA;
                 zip/postal code:  01748;
                         country:  USA;
                           phone:  877-534-2867;
                             fax:  650-745-1477;
                   email address:  support@emc.com;                             
                   purchase date:  ;
           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:  ;
                 timezone offset:  GMT-0800;


FILES

       /nsr/res/nsrdb  -  files  in  this  directory  should  never  be edited
       directly. Use nsradmin(8) instead.


SEE ALSO

       netgroup(5), nsr(5), nsr(8), nsr_device(5), nsr_group(5), 
       nsr_notification(5), nsr_resource(5), nsr_storage_node(5), nsradmin(8), 
	nsrd(8), nsrmm(8), nsrmmdbd(8), nsrmon(8), recover(8), save(8).

NetWorker 8.0.1 		Dec 02, 12 		nsr_service(5)