NSR_CLIENT(5) Legato NetWorker 3.0 NSR_CLIENT(5)
NAME
NSR client - NetWorker resource type ``NSR client''
SYNOPSIS
type: NSR client
DESCRIPTION
Each NSR client is described by a single resource of type NSR client
(see nsrresource(5)). To edit the NSR client resources for a Net
Worker server type:
nsradmin -c "type:NSR client"
See the nsradmin(8) manual page for more information on using the
NetWorker administration program.
This resource describes what should be saved on a given NetWorker
client. A client may have more than one resource describing it.
ATTRIBUTES
The following attributes are defined for resource type NSR client.
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.
name (read/write)
This attribute specifies the hostname of this NetWorker
client.
Example: name: mars;
server (read-only)
This attribute specifies the hostname of this client`s Net
Worker server. The client`s hostname will be used as the
default value.
Example: server: jupiter;
schedule (read/write)
This attribute specifies the name of the schedule controlling
the backup levels for the save sets listed in the `save set'
attribute. The default value is `Default'. Any currently
defined schedule names may be used, see nsrschedule(5).
Example: schedule: project accounting;
browse policy (read/write)
This attribute specifies the name of the policy controlling
how long entries will remain in this client's on-line file
index. The default value is `Quarter'. Any currently defined
policy name may be used as long as the period defined by the
policy is less than the retention policy's period, see
nsrpolicy(5).
Example: browse policy: quarter;
retention policy (read/write)
This attribute specifies the name of the policy controlling
how long entries will remain in the media index before they
Licensed material--property of copyright holder(s) 1
NSR_CLIENT(5) Legato NetWorker 3.0 NSR_CLIENT(5)
are marked as recyclable. The default value is `Year'. Any
currently defined policy name may be used as long as the
period defined by the policy is longer than the browse pol
icy's period, see nsrpolicy(5).
Example: browse policy: quarter;
directive (read/write)
This attribute specifies the directive file to use when back
ing up the client. The default value is `Default'. The valid
choices for the directive resource are names of the currently
defined `NSR directive' resources, see nsrdirective(5).
Example: directive: skip dot o;
group (read/write)
This attribute specifies the group this client is a member of.
The group controls the start time for automatic backups. The
value may be one of currently defined `NSR group' resources,
see nsrgroup(5). The default value is `Default'.
Example: backup group: engineering;
save set (read/write)
The save set attribute lists the path names to be saved for
this client. The names should be separated by spaces. The
default value is `All'. On Unix clients, `All' refers to the
mounted file systems. On DOS clients, `All' refers to file
systems that have been specified on the client via the `Change
Automatic Backup' selection of the NetWorker for DOS. By
default, all of a DOS client's hard disks are backed up.
When a client needs to have different file systems saved on
different schedules, a client resource is needed for each
group of file systems on a particular schedule. A given path
name may only appear once. When `All' is used, no other path
names may be used.
Example: save set: /, /usr, /usr/src;
recover access (read/write)
This attribute lists the hostnames and netgroups of machines
that may recover files backed up by this client. Netgroup
names must be preceded by an ampersand ('&'). A plus sign,
``+'' signifies that any client whose root user is trusted by
the server's remote command system is also allowed to recover
the client's files. An empty list signifies that only the
client itself may recover its files. The default list is
empty.
Example: recover access: mars;
rcmd user: (read/write, hidden)
This attribute specifies the user login name the NetWorker
server will use to run commands on the client. The default
value is NULL, implying that `root' should be used. When
savegroup -p (see savegroup(8)) is run on the NetWorker
server, the server runs commands on the client to determine
which files to save.
Licensed material--property of copyright holder(s) 2
NSR_CLIENT(5) Legato NetWorker 3.0 NSR_CLIENT(5)
Example: rcmd user: operator;
executable path (read/write, hidden)
This attribute specifies the path to use when the NetWorker
server is executing commands on the client. When no path is
specified, the "rcmd user's" $PATH is used.
Example: executable path: /etc/nsr;
index operation (update-only, hidden, dynamic)
This attribute contains the current index operation. It is
normally `idle'. Example:
index operation: reclaiming space;
index message (update-only, hidden, dynamic)
This attribute contains the ending status message for the pre
vious index operation. This attribute is typically blank,
indicating that the previous operation completed successfully.
Example:
index message: could not index;
index operation start (update-only, hidden, dynamic)
This attribute contains the starting time of the current index
operation. This attribute is blank when the operation is
`idle'. The format is weekday followed by hour and minutes.
Example:
index operation start: Wednesday 02:45;
index progress (update-only, hidden, dynamic)
This attribute contains the progress the index has made
towards finishing the current task. This attribute is blank
when the operation is `idle'. The progress is expressed as a
percentage. Example:
index progress: 45;
EXAMPLES
A resource to define a client, called venus, backing up all of its
files to the NetWorker server mars:
type: NSR client;
name: venus;
server: mars;
schedule: monthly fulls;
directive: skip dot o;
backup group: accounting;
save set: All;
recover access: venus;
rcmd user: root;
exectuable path: /etc/nsr;
index operation: idle;
index message: ;
index progress: ;
index operation start: ;
Licensed material--property of copyright holder(s) 3
NSR_CLIENT(5) Legato NetWorker 3.0 NSR_CLIENT(5)
The resources for a client backing up different file systems on dif
ferent schedules:
type: NSR client;
name: saturn;
server: mars;
schedule: monthly fulls;
directive: skip dot o;
backup group: engineering;
save set: / /usr /usr/src;
recover access: venus;
rcmd user: operator;
exectuable path: /etc/nsr;
index operation: idle;
index message: ;
index progress: ;
index operation start: ;
type: NSR client;
name: saturn;
server: mars;
schedule: weekly fulls;
directive: skip dot o;
backup group: engineering;
save set: /usr/src/archive;
recover access: venus;
rcmd user: operator;
exectuable path: /etc/nsr;
index operation: idle;
index message: ;
index progress: ;
index operation start: ;
SEE ALSO
ruserok(3), nsr(5), nsrschedule(5), nsrdirective(5), nsrgroup(5),
nsrpolicy(5), savegroup(8), savefs(8), nsradmin(8).
Licensed material--property of copyright holder(s) 4