NSR_ARCHIVE_REQUEST(5)NSR_ARCHIVE_REQUEST(5)NAMEnsr_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 nsr_resource(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 Net‐
Worker administration program. The archive request resource may also
be edited using NetWorker Management Console.
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 ar‐
chive 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 pro‐
grams or experts. Hidden attributes can only be seen when the hidden
option is turned on in nsradmin(8). Choice means that the value of the
attribute can only be one from a list specific to that attribute (for
example, status can be start now or start later). 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 (for example, administrator)
are common to all resources, and are described in nsr_resource(5).
comment (read/write)
This attribute is provided for the administrator to keep any
explanatory remarks or supplementary information about the ar‐
chive request.
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;
archive clone pool (read/write)
This attribute indicates the archive clone media pool the ar‐
chive request should use when cloning the archive save set gen‐
erated by this archive request.
Example: archive clone pool: Archive clone;
archive completion (read/write)
A notification action to be executed to send status of the ar‐
chive request to.
Example: archive completion: /usr/ucb/mail -s "Product Archive"
systemadmin;
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 ar‐
chive request. Selecting a pool will direct the archive to that
media pool.
Example: archive pool: Archive;
client (read/write)
This attribute indicates what NetWorker archive client the ar‐
chive request is to be executed on.
Example: client: neptune;
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 unused.
Example: cloned: No;
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";;
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 nsr_directive(5).
Example: directive: Default with compression;
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;
log (read/write, hidden)
This attribute contains any information pertaining to the execu‐
tion of the nsralist command.
Example: log:; name (read/write) This attribute specifies
the name of this NetWorker archive request.
Example: name: Product Source Tree;
save set (read/write)
This attribute lists the path names to be archived on the ar‐
chive client. The names should be separated by a comma and a
space (", ").
Example: save set: /product/src, /accounting/db;
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;
status (read/write, choice)
This attribute determines if an archive request should be run.
No value implies the archive request is not scheduled. Select‐
ing 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.
Example: status:;
verified (read/write, hidden)
This attribute is unused.
Example: verified: No;
verify (read/write, choice)
This attribute indicates the archive request should verify the
archive. See nsr_archive(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 ver‐
ification is done on the clone since the cloning operation will
have verified the original archive save set.
Example: verify: Yes;
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;
verify: Yes;
clone: Yes;
archive clone pool: Archive Clone;
grooming: none;
archive completion: mail -s Product Source Archive productteam;
SEE ALSOnsr(5), nsr_directive(5), nsr_resource(5), nsradmin(8), rmdir(2),
unlink(2).
NetWorker 7.3.2 Aug 23, 06 NSR_ARCHIVE_REQUEST(5)