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
attribute is updated after each recover session completes.
Example: recover totals: "347 sessions, 48 MB total";
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 a lot 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. This attribute 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 NearLine 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 managed licenses immediately.
message (read-only, dynamic, hidden)
The last message of any kind logged. A timestamp 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 timestamp and a string message
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 corresponding 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 names the NetWorker component, such as a client
or device, 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 sessions.
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".
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, nwinstname, nwinstancename, 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;
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 pro‐
gram (such as nsrmm(8)) that requested the operation clears this
attribute as soon as it has read the result. An administrator
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
appropriate media database operation type 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 nsrm‐
mdbd(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(8) 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 Release 6.0. Continuation save sets have been eliminated
for Release 6.0 and above.
User ID (dynamic, hidden)
This attribute contains the user ID by which the NetWorker
server authenticated you. 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 ALSOnetgroup(5), nsr(5), nsr(8), nsr_device(5), nsr_group(5), nsr_notifica‐
tion(5), nsr_resource(5), nsr_storage_node(5), nsradmin(8), nsrd(8),
nsrmm(8), nsrmmdbd(8), nsrmon(8), recover(8), save(8).
NetWorker 7.3.2 Aug 23, 06 NSR_SERVICE(5)