NSR_SERVICE(5) Legato NetWorker 3.0 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
nsrresource(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
information in parentheses describes how the attribute values are
accessed. Read-only indicates that the value cannot be changed by an
administrator. Read/write means the value can be set as well as
read. Static attributes change values rarely, if ever. Dynamic
attributes have values which can change rapidly. 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.
version (read-only, static)
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: 3.0 NetWorker / 200;
save totals (read-only, dynamic)
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)
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. Usually this is the
last time the NetWorker server has been rebooted.
Example: totals since: "Fri Jun 1 09:35:02 PDT 1992";
parallelism (read/write, static)
This attribute sets the number of concurrent save sessions per
savegroup that this server will allow. The value can be set
by an administrator. Use higher values for better performance
Licensed material--property of copyright holder(s) 1
NSR_SERVICE(5) Legato NetWorker 3.0 NSR_SERVICE(5)
on a fast system, and use lower values to avoid overloading a
slow system. Warning: due to bugs in some versions of Unix,
high values of parallelism may cause the system to lock up.
Example: parallelism: 4;
active devices (read/write, static)
This attribute sets the number concurrent devices this server
will allow. The value can be set by an administrator. Use
higher values for better performance on a fast system, and use
lower values to avoid overloading a slow system. Should never
be larger than the total number of devices. This attribute is
not available (forced to have the value one) unless the Multi
ple Simultaneous Device feature is enabled.
Example: active devices: 3;
sessions per device (read/write, static)
This attribute gives a target number of saves for each device.
Saves are allocated to each device in order, until this many
are assigned, then the next device is used. Once all devices
have this many assigned, they are allocated equally to each
device. The value can be set by an administrator. Use higher
values to multiplex many clients onto each tape; the value one
spreads out the clients over as many devices as possible.
Example: sessions per device: 3;
message (read-only, dynamic)
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/rmt/1";
message list (read-only, dynamic)
A list of recent messages, with a ten-digit sequence number, a
time stamp, and a string message for each value.
Example: message: "Mon 12:25:51 Tape full, mount volume
mars.001 on /dev/rmt/1";
session (read-only, dynamic)
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 num
ber of files. All sizes and rates are in bytes per second,
Kilobytes (1024), Megabytes (a thousand Kilobytes), etc.
Example:
session: "venus:/usr saving to mars.001 20MB of 90MB",
"mars:/usr/src done saving 24MB of 244MB";
pending (read-only, dynamic)
A list of events pending with the NetWorker event notification
system (see nsrnotification(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/rmt/1";
Licensed material--property of copyright holder(s) 2
NSR_SERVICE(5) Legato NetWorker 3.0 NSR_SERVICE(5)
statistics (read-only, dynamic)
A list of strings of the form name=number that give a number
of server statistics.
administrator (read/write, static)
This is a list of names (or netgroups) of users who area
allowed to administer NetWorker. Normally this list is inher
ited 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 deter
mines who can add and delete resources of the other NSR types.
Example: administrator: root;
EXAMPLE
A complete example follows:
type: NSR;
name: mars;
version: 3.0 NetWorker / 200;
parallelism: 4;
active devices: 2;
sessions per device: 4;
message: \
"Mon 15:27:25 media alert event: recover waiting for 8mm tape mars.001";
pending: \
"Fri 14:40:15 media alert: recover waiting for 8mm tape mars.001";
recover totals: 1 session;
save totals: "84 sessions, 3597 MB total";
session: "mars:george browsing",
"mars:/home/mars starting recovery of 9K bytes";
totals since: "Fri Jun 1 23:43:20 PDT 1992";
administrator: root;
FILES
/etc/nsr.res - this file should never be edited directly. Use nsrad
min(8) instead.
SEE ALSO
nsrd(8), nsrdevice(5), nsrnotification(5), nsrresource(5),
nsrgroup(5), nsr(5), nsr(8), save(8), recover(8), nsradmin(8), net
group(5).
Licensed material--property of copyright holder(s) 3