NSR_SERVICE(5) Legato NetWorker 4.1.1 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"
or use the nwadmin(8) GUI. 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. Choice list means that any number of values can be chosen from
the given list. Static attributes change values rarely, if ever.
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) or details option is set in nwadmin(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
currently licensed.
Example: version: NetWorker 4.1 Turbo/110;
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";
Licensed material--property of copyright holder(s) 1
NSR_SERVICE(5) Legato NetWorker 4.1.1 NSR_SERVICE(5)
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
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. See sessions per
device, below, for information on side-effects. 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 of 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. This
value should never be larger than the total number of devices.
This attribute is not changeable (i.e. forced to have the
value one) unless the Concurrent Device Support (CDS) add-on
module is enabled. See sessions per device, below, for
information on side-effects.
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. A
good rule of thumb is to set sessions per device, active
devices, and parallelism such that sessions per device times
active devices equals parallelism.
Example: sessions per device: 3;
manual saves (read/write, hidden)
This attribute allows the administrator to disable manual
backups to the server. Scheduled backups continue to work
normally.
message (read-only, dynamic, hidden)
The last message of any kind logged. A time stamp is included
at the start of the string.
Licensed material--property of copyright holder(s) 2
NSR_SERVICE(5) Legato NetWorker 4.1.1 NSR_SERVICE(5)
Example: message: "Mon 12:25:51 Tape full, mount volume
mars.001 on /dev/rmt/1";
message list (read-only, dynamic, hidden)
A list of recent messages, with 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, 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,
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, hidden)
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";
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 (e.g.
savegroup) and list various features enabled in the running
server. The format is currently name=boolean (true or false).
The features listed, 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.
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. 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
Licensed material--property of copyright holder(s) 3
NSR_SERVICE(5) Legato NetWorker 4.1.1 NSR_SERVICE(5)
&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). Netgroup 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".
Example: administrator: root, operator@jupiter, mars/operator,
admin@*, &netadmins;
contact name (read/write, static)
This attribute is used for product licensing/registration
purposes. 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
purposes. Your comapny name must be specified before printing
the registration information from the registration window.
Example: company: Legato;
street address (read/write, static)
This attribute is used for product licensing/registration
mailing purposes. Specify your mailing street address.
Example: street address: 3145, Porter Drive;
city/town (read/write, static)
This attribute is used for product licensing/registration
mailing purposes.
Example: city/town: Palo Alto;
state/province (read/write, static)
This attribute is used for product licensing/registration
mailing purposes.
Example: state/province: CA;
zip/postal code (read/write, static)
This attribute is used for product licensing/registration
mailing purposes.
Example: zip/postal code: 94304;
country (read/write, static)
This attribute is used for product licensing/registration
mailing purposes.
Example: country: USA;
phone (read/write, static)
This attribute is used for product licensing/registration
information purposes. This attribute must to be specified
before printing the registration information from the
registration window.
Licensed material--property of copyright holder(s) 4
NSR_SERVICE(5) Legato NetWorker 4.1.1 NSR_SERVICE(5)
Example: phone: 415-812-6100;
fax (read/write, static)
This attribute is used for product licensing/registration
purposes.
Example: fax: 415-812-6031;
email address (read/write, static)
This attribute is used for product licensing/registration
purposes.
Example: email address: support@legato.com;
CompuServe address (read/write, static)
This attribute is used for product licensing/registration
purposes.
Example: ompuServe address: 76044,3423;
purchase date (read/write, static)
This attribute is used for product licensing/registration
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.
product serial number (read/write, static)
This attribute is used for product licensing/registration
purposes. 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
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
NetWorker 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
lcoation, 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.
Licensed material--property of copyright holder(s) 5
NSR_SERVICE(5) Legato NetWorker 4.1.1 NSR_SERVICE(5)
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.
enabler code (read/write, dynamic, hidden)
This attribute specifies the enabler code for the base enabler
of the server software.
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 Write Read Verify label Label ;
parallelism: 4;
active devices: 2;
sessions per device: 2;
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/rmt/11"
"Mon 07:10:33 /dev/rmt/11 mount operation in progress"
"Mon 07:11:15 /dev/rmt/11 mounted 8mm 5GB tape man.001
session: "mars:george browsing",
"mars:/home/mars starting recovery of 9K bytes";
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;
Licensed material--property of copyright holder(s) 6
NSR_SERVICE(5) Legato NetWorker 4.1.1 NSR_SERVICE(5)
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: ;
product serial number: ;
mm op message: ;
mm operation value: ;
mm operation: ;
mm operation id: ;
enabler code: ;
FILES
/nsr/res/nsr.res - this file should never be edited directly. Use
networker(1) or nsradmin(8) instead.
SEE ALSO
networker(1), nsrd(8), nsrdevice(5), nsrnotification(5),
nsrresource(5), nsrgroup(5), nsr(5), nsr(8), nsrmm(8), nsrmmdbd(8),
save(8), recover(8), nsradmin(8), netgroup(5).
Licensed material--property of copyright holder(s) 7