NSR_DEVICE(5) Legato NetWorker 3.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 mm(8) and networker(8) pro
grams.
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. 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/1;
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;
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
Licensed material--property of copyright holder(s) 1
NSR_DEVICE(5) Legato NetWorker 3.0 NSR_DEVICE(5)
/dev/rmt/1"; The values may include information on the
progress or rate of the operation.
progress (read-only, dynamic, hidden)
The last report of the throughput of the device.
Example: progress: "writing, 143 MB of 256 MB at 120 KB/s";
volume name (read/write, 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 giga
byte 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 Kbytes, Mbytes or Gbytes.
Licensed material--property of copyright holder(s) 2
NSR_DEVICE(5) Legato NetWorker 3.0 NSR_DEVICE(5)
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 current capacity.
Example: volume current capacity: 19M;
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;
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/1;
administrator: root;
media family: tape;
media type: 8mm;
message: mounted 8mm tape mars.001;
NSR operation: recover;
progress: "writing at 17 KB/s, 5856 KB";
volume name: mars.001;
write enabled: yes;
volume label: mars.001;
volume default capacity: 5G;
volume current capacity: ;
volume expiration: ;
volume operation: ;
FILES
/etc/nsr.res - this file should never be edited directly. Use mm(8),
nsradmin(8) or networker(8) instead.
SEE ALSO
getdate(3), nsrresource(5), nsrgroup(5), nsrschedule(5),
nsrservice(5), nsr(8), nsrmmd(8), mm(8), networker(8), nsradmin(8).
Licensed material--property of copyright holder(s) 3