NSR_GROUP(5) Legato NetWorker 3.0 NSR_GROUP(5)
NAME
NSR group - NetWorker resource type ``NSR group''
SYNOPSIS
type: NSR group
DESCRIPTION
Each NetWorker group is described by a single resource of type NSR
group (see nsrresource(5)). To edit the NSR group resources for a
NetWorker server type:
nsradmin -c "type:NSR group"
See the nsradmin(8) manual page for more information on using the
NetWorker administration program.
These resources control when a group of NetWorker clients begin sav
ing data and whether backups are started automatically each day.
Each NSR client resource (see nsrclient(5)) lists the groups of
which that client (or save sets for that client) is a member. Groups
can only be deleted if no clients are members of them.
ATTRIBUTES
The following attributes are defined for resource type NSR group.
The information in parentheses describes how the attribute values are
accessed. Create-only indicates that the value cannot be changed by
an administrator once the resource is created. Read/write means the
value can be set as well as read at any time. 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).
name (create-only)
This attribute contains the name of the group defined by this
resource. The name must be unique for this NetWorker server,
but otherwise can be anything that makes sense to the adminis
trator. This name will appear as a choice attribute of each
NSR client resource. The NSR group resource named `Default'
may be modified, but it may not be removed. The name can only
be specified when the group is created.
Example: name: marketing;
autostart (read/write)
The autostart attribute determines if this group will be saved
automatically every day. It may be one of three values:
Enabled, Disabled or Start now. When the value is Enabled,
the members of this group will start saving data at the time
specified in the start time attribute. When the value is Dis
abled, the member of this group will not automatically start
saving their data. When the Start now value is specified, the
member clients will start saving their data immediately. The
attribute will then return to its prior value.
Example: autostart: Enabled;
start time (read/write)
The start time attribute specifies the time of day when this
Licensed material--property of copyright holder(s) 1
NSR_GROUP(5) Legato NetWorker 3.0 NSR_GROUP(5)
group will start saving. The NetWorker server's local time is
used. The time is specified as "hours:minutes". Note that
the quotes may be necessary when using character-based admin
istration tools such as the nsradmin program because of the
colon in the value. The hours may range from 0 to 23 (using a
24 hour clock) and the minutes range from 0 to 59.
Example: start time: "4:53";
printer (read/write, static, hidden)
The printer to which the bootstrap save set information will
be printed, if one is generated by the run of this group.
Example: printer: computerroomprinter;
inactivity timeout (read/write, static, hidden)
The number of minutes that the savegroup command waits for any
kind of activity on the server before concluding that a save
group descendent is hung. Once a hang is detected, savegroup
prints a message indicating that a save is abandoned, and
savegroup moves on to its next task.
Example: inactivity timeout: 30;
options (read/write, static, hidden)
The value Restartable only has applicability when the group's
Autostart is enabled; it causes NetWorker to resume an aborted
savegroup(8) upon restarting after a crash. The remaining
values specify flags with which this group will be run. The
values No Monitor, No index save, No save, Verbose, Estimate,
and Preview map to the the savegroup command line flags -m,
-I, -n, -v, -E, and -p respectively.
Example: options: Restartable;
work list (read/write, dynamic, hidden)
The list of saves still not completed. These come in sets of
3 values: the client name, the level of save, and the path to
save.
Example: work list: mars, incr, /usr, mars, incr, /g, mars,
venus, /usr
completion (read/write, dynamic, hidden)
The status of each save set that has been completed. These
come in sets of 4 values: the client name, the path saved, a
status message (succeeded, failed, or unexpectedly exited),
and the output from the save.
Example: completion: "mars", "/usr", "succeeded", "mars: /
level=full, 6577 KB 00:06:41 625 files"
EXAMPLE
The default NSR group resource automatically starts its members at 33
minutes past 3 o`clock in the morning:
type: NSR group;
name: Default;
autostart: Enabled;
start time: "3:33";
Licensed material--property of copyright holder(s) 2
NSR_GROUP(5) Legato NetWorker 3.0 NSR_GROUP(5)
administrator: root;
A complete example follows, with the hidden attributes shown with
values reasonable for an active group:
type: NSR group;
name: Default;
autostart: Enabled;
start time: "3:33";
options: Restartable;
printer: lp2;
inactivity timeout: 30;
work list: mars, incr, /g, mars, incr, index,
venus, incr, /usr, venus, incr, index,
jupiter, full, /, jupiter, full, /usr,
jupiter, full, index
completion: mars, /, succeeded,
" mars: / level=incr, 31 KB 00:01:01 72 files
",
mars, /usr, succeeded,
" mars: /usr level=incr, 2 KB 00:00:48 5 files
",
venus, /, succeeded,
" venus: / level=incr, 7711 KB 00:04:37 29 files
";
administrator: root, &operator;
SEE ALSO
nsr(8), nsrresource(5), savegroup(8), networker(8), nsradmin(8).
Licensed material--property of copyright holder(s) 3