NSR_ARCHIVE_REQUEST(5) Legato NetWorker 4.1.1 NSR_ARCHIVE_REQUEST(5)
NAME
NSR archive request - NetWorker resource type ``NSR archive request''
SYNOPSIS
type: NSR archive request
DESCRIPTION
Each NSR archive request is described by a single resource of type
NSR archive request (see nsrresource(5)). To edit the NSR archive
request resources for a NetWorker server type:
nsradmin -c "type:NSR archive request"
See the nsradmin(8) manual page for more information on using the
NetWorker administration program. The archive request resource may
also be edited using the command nwadmin(8).
This resource allows administrators to set up an archive to occur
later or to set up frequent archives of a set of data. The
administrator can run an archive on a specified client within the
next 24 hours. The archive is executed via the nsralist(8)) command.
ATTRIBUTES
The following attributes are defined for resource type NSR archive
request. 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. 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 by selecting the details
Menu Item in the View Menu for a particular window in nwadmin(8).
Dynamic attributes have values which change rapidly. Encrypted
attributes contain data that is not displayed in its original form.
The assumption is that the data is sensitive in nature and needs to
be protected from accidental disclosure. Several additional
attributes (e.g. administrator) are common to all resources, and are
described in nsrresource(5).
name (read/write)
This attribute specifies the name of this NetWorker archive
request.
Example: name: Product Source Tree;
annotation (read/write)
This attribute contains the annotation text associated with
the archive save set generated from this archive request.
Example: annotation: Product Release 4.1;
status (read/write, choice)
This attribute determines if an archive request should be run.
No value implies the archive request is not scheduled.
Selecting start now causes the archive request to be run
immediately. Selecting start later causes the archive request
to be run at the time specified by the start time attribute
Licensed material--property of copyright holder(s) 1
NSR_ARCHIVE_REQUEST(5) Legato NetWorker 4.1.1 NSR_ARCHIVE_REQUEST(5)
(see below).
Example: status:;
start time (read/write)
This attribute determines when the archive request will be
run. The status attribute (see above) must be set to start
later for the archive request to be scheduled. The 24 hour
clock format is "hours:minutes".
Example: start time: 3:33;
completion time (read/write, hidden)
This attribute indicates when the archive request completed.
The format is "day-of-week month day hours:minutes:seconds
year".
Example: "Thu Oct 22 17:00:37 1994";;
client (read/write)
This attribute indicates what NetWorker archive client the
archive request is to be executed on.
Example: client: neptune;
save set (read/write)
The save set attribute lists the path names to be archived on
the archive client. The names should be separated by a comma
and a space (", ").
Example: save set: /product/src, /accounting/db;
directive (read/write)
This attribute specifies the directive to use when running the
archive. The default value is nothing selected. The valid
choices for the directive resource are names of the currently
defined `NSR directive' resources, see nsrdirective(5).
Example: directive: Default with compression;
archive pool (read/write)
This attribute can be used to override the normal media pool
selection applied to the archive save set generated from the
archive request. Selecting a pool will direct the archive to
that media pool.
Example: archive pool: Archive;
verify (read/write, choice)
This attribute indicates the archive request should verify the
archive. See nsrarchive(5) for more information on
archiving. Selecting the Yes choice causes the verification
to occur. Selecting the No choice will not cause any
verification. If the user also requests that the archive save
set be cloned, the verification is done on the clone since the
cloning operation will have verified the original archive save
set.
Example: verify: Yes;
verified (read/write, hidden)
This attribute is unused.
Licensed material--property of copyright holder(s) 2
NSR_ARCHIVE_REQUEST(5) Legato NetWorker 4.1.1 NSR_ARCHIVE_REQUEST(5)
Example: verified: No;
clone (read/write)
This attribute controls whether the archive save set generated
by the archive request is to be cloned. A value of Yes
implies the archive save set should be cloned. A value of No
does not imply cloning.
Example: clone: No;
cloned (read/write, hidden)
This attribute is unsed.
Example: cloned: No;
archive clone pool (read/write)
This attribute indicates the archive clone media pool the
archive request should use when cloning the archive save set
generated by this archive request.
Example: archive clone pool: Archive clone;
grooming (read/write)
This attribute indicates any grooming actions to be taken once
the archive save set generated by the archive request has been
created, verified, and cloned. A value of none implies no
action. A value of remove implies the files and directories
specified in the save set attribute will be removed via the
rmdir(2) and unlink(2) system calls.
Example: grooming: none;
archive completion (read/write)
A notification action to be executed to send status of the
archive request to.
Example: archive completion: /usr/ucb/mail -s "Product
Archive" systemadmin;
log (read/write, hidden)
This attribute contains any information pertaining to the
execution of the nsralist command.
Example: log:;
EXAMPLE
Note: the hidden options are not shown in this example.
A resource to define an archive request, called Product:
type: NSR archive request;
name: Product Source;
annotation: Product Release 3.0;
status: Start later;
start time: "2:00";
client: space;
save set: /product/source;
directive: Default with compression;
archive pool: Archive;
Licensed material--property of copyright holder(s) 3
NSR_ARCHIVE_REQUEST(5) Legato NetWorker 4.1.1 NSR_ARCHIVE_REQUEST(5)
verify: Yes;
clone: Yes;
archive clone pool: Archive Clone;
grooming: none;
archive completion: mail -s Product Source Archive productteam;
SEE ALSO
nsr(5), nsrdirective(5), nsrresource(5), nsradmin(8), nwadmin(8),
rmdir(2), unlink(2).
Licensed material--property of copyright holder(s) 4