NSR_DEVICE(5) Legato NetWorker 4.0 NSR_DEVICE(5)
NAME
NSR device - NetWorker resource type ``NSR device''
SYNOPSIS
type: NSR device
DESCRIPTION
Each storage device used by a NetWorker server is described by a sin
gle resource of type NSR device. See nsrresource(5) for information
on NetWorker resources. To edit the NSR device resources run:
nsradmin -c "type:NSR device"
Be careful to include the quotes and the space between ``NSR'' and
``device''. See nsradmin(8) for information on using the NetWorker
administration program. Mounting and unmounting individual volumes
(tapes or disks), is done through the nsrmm(8), nsrjb(8), and net
worker(8) programs.
ATTRIBUTES
The following attributes are defined for resource type NSR device.
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 expert mode (-x) in net
worker(8). Static attributes change values rarely, if ever. Dynamic
attributes have values which change rapidly. For example, an
attribute marked (read-only, static) has a value which is set when
the attribute is created and never changes.
name (read-only, static)
The name attribute specifies the path name of the device.
Tape devices must be no-rewind. Optical disks are usually the
`c' partition of the raw device.
Example: name: /dev/rmt/8;
media type (read-only, static)
The type of media this device uses. Legal values and their
meaning and default capacities are: 4mm - 4mm digital audio
tape (1 GB); 8mm - 8mm video tape (2 GB); 8mm 5GB - 8mm video
tape (5 GB); qic - quarter inch data cartridge (150 MB); himt
- half inch magnetic tape (100 MB); tk50 - DEC TK50 cartridge
tape (94 MB); tk70 - DEC TK70 cartridge tape (296 MB). opti
cal - optical disks, either Write Once Read Many (WORM) or
Erasable Optical Disks (EOD) are supported.
Example: media type: 8mm 5GB;
enabled (read-write)
This attribute indicates whether the device is available for
use. The value can be yes or no. If the value is set to no,
no volumes may be mounted on the device. The value cannot be
changed if a volume is mounted.
Example: enabled: yes;
Licensed material--property of copyright holder(s) 1
NSR_DEVICE(5) Legato NetWorker 4.0 NSR_DEVICE(5)
media family (read-only, static, hidden)
The media family describes the class of storage media, as
determined from the media type. The only legal values are:
tape - tape storage device; disk - disk storage device.
Example: media family: tape;
message (read-only, dynamic, hidden)
The last message of any kind from the NetWorker server regard
ing this device.
Example: message: "Tape full, mount volume nsr.test on
/dev/rmt/1"; The values may include information on the
progress or rate of the operation.
volume name (read-only, dynamic, hidden)
This is used to monitor the mounting and unmounting of volumes
for this device. When a volume is mounted, the value is the
volume name, otherwise there is no value.
Example: volume name: mars.001;
write enabled (read/write, dynamic, hidden)
This is used to indicate if writing on the current volume is
allowed. The value can be yes or no. This can only be set
when no volume is mounted.
Example: write enabled: no;
volume operation (read/write, dynamic, hidden)
The volume operation manipulates the media volume currently in
the device. It may be one of the following values: Unmount,
Mount, Label, Label without mount, Eject or Verify label.
Each of these operations may require parameters in or set
attributes described below. When the value is Unmount, Net
Worker releases the device. The Unmount operation is asyn
chronous. When the value is Mount, NetWorker mounts the
loaded volume on the device. The Mount operation is asyn
chronous. When the value is Label or Label without mount, the
volume receives a new label as determined by the attributes
below. When the value is Label the volume is then mounted.
These operations are asynchronous. When the value is Verify
label, the volume's label is read and the attributes volume
label, and volume expiration are set. The Verify label opera
tion is synchronous and therefore may take a long time. When
the value is Eject, NetWorker ejects the volume from the
device. The Eject operation is asynchronous.
volume label (read/write, dynamic, hidden)
This attribute is set by the Verify label operation and may be
an input to the Label operation. If this attribute is blank
during labeling then the volume's current label is reused.
volume default capacity (read/write, static, hidden)
This attribute is used by the Label operation, but only if the
volume current capacity attribute is blank. A non-blank value
is used to override the the default capacity associated with
the media type. For example, to override the default 2
Licensed material--property of copyright holder(s) 2
NSR_DEVICE(5) Legato NetWorker 4.0 NSR_DEVICE(5)
gigabyte capacity of an 8mm device with a 5 gigabyte value,
set the value as follows:
volume default capacity: 5G;
The value of this attribute must end with K, M, or G signify
ing Kilobytes, Megabytes, or Gigabytes.
volume current capacity (read/write, dynamic, hidden)
If the attribute's value is non-blank, it determines the
capacity of a volume during the Label operation. Its format
is the same as volume default capacity.
Example: volume current capacity: 5G;
volume expiration (read/write, dynamic, hidden)
This attribute is set by the Verify label operation and may
also be used by the Label operation. The value is in get
date(3) format. A blank value causes the default expiration
to be used during labeling.
Example: volume expiration: next year;
volume pool (read/write, hidden)
If a volume is mounted, this attribute reflects the pool the
volume belongs to. If this attribute is set during a Label or
Label without mount operation, this value represents the pool
the volume is being assigned to. See nsrpool(5).
Example: volume pool: Default;
NSR operation (read-only, dynamic, hidden)
This attribute reflects the current operation being performed
by the device. The values are Idle, Save, Recover, Verify
label, or Label.
Example: NSR operation: Save;
volume message (read-only, dynamic, hidden)
This attribute reflects the result of the last volume opera
tion.
EXAMPLE
A complete example follows:
type: NSR device;
name: /dev/rmt/8;
message: mounted 8mm 5GB tape space.029;
volume name: ;
media family: tape;
media type: 8mm 5GB;
enabled: Yes;
write enabled: Yes;
volume label: space.029;
volume default capacity: ;
volume current capacity: 5000 MB;
volume expiration: "Thu Sep 21 17:23:37 1995";
volume pool: Default;
volume operation: ;
volume message: ;
Licensed material--property of copyright holder(s) 3
NSR_DEVICE(5) Legato NetWorker 4.0 NSR_DEVICE(5)
NSR operation: ;
statistics: elapsed = 15783, errors = 0, last rate = 0,
max clients = 0, file marks = 2, rewinds = 4,
files skipped = 2, records skipped = 0;
administrator: root;
FILES
/nsr/res/nsr.res - this file should never be edited directly. Use
nsrmm(8), nsradmin(8) or networker(8) instead.
SEE ALSO
getdate(3), nsrresource(5), nsrpool(5), nsrschedule(5),
nsrservice(5), nsr(8), nsrmmd(8), nsrmm(8), networker(8), nsrad
min(8).
Licensed material--property of copyright holder(s) 4