NSR_DEVICE(5) Legato NetWorker 4.1.1 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
single 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
nwadmin(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 if the Details View option is
selected in the Media Devices window in nwadmin(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. On systems that optionally
support ``Berkeley style'' tape positioning on close, this the
BSD style tape device name should be used. Optical disks are
usually the `c' partition of the raw device.
Example: name: /dev/rmt/0hbn;
media type (read-only, static)
The type of media this device uses. The actual list varies
depending on the OS platform. Some potential 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); dlt - digital linear tape cartridge (10
GB); vhs - VHS data grade video tape (14 GB); 3480 - high-
speed cartridge tape (200 MB); 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). optical - optical disks, Write Once
Read Many (WORM), Erasable Optical Disks (EOD), or standard
UNIX files are supported.
Example: media type: 8mm 5GB;
Licensed material--property of copyright holder(s) 1
NSR_DEVICE(5) Legato NetWorker 4.1.1 NSR_DEVICE(5)
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;
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
regarding this device. The values may include information on
the progress or rate of the operation.
Example: message: "Tape full, mount volume mars.017 on
/dev/rmt/8";
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.017;
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, Verify label, Verify write time. Label, Label without
mount, or Eject. Each of these operations may require
parameters in or set attributes described below. When the
value is Unmount, NetWorker releases the device. The Unmount
operation is asynchronous. When the value is Mount, NetWorker
mounts the loaded volume on the device. The Mount operation
is 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 operation is synchronous
and therefore may take a long time. Verify write time is
similar to Verify label, but it also sets the volume write
time attribute. 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 Eject, NetWorker ejects the volume from the device. The
Eject operation is asynchronous.
Licensed material--property of copyright holder(s) 2
NSR_DEVICE(5) Legato NetWorker 4.1.1 NSR_DEVICE(5)
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. The value of this attribute must end with K,
M, or G signifying Kilobytes, Megabytes, or Gigabytes. This
hidden attribute can be modified by a user. This is useful
for overriding default sizes when using devices (and/or tapes)
with different capacities than the defaults. For example, to
override the default capacity of a tape drive to 10 Gb for all
future volume label operations, set the value as follows:
volume default capacity: 10G;
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
getdate(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) for more
information on volume pools.
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, Write, Read, Eject,
Verify label, or Label.
Example: NSR operation: Write;
statistics (read-only, dynamic, hidden)
This attribute reports the statistics for the operation of
this device. The statistics currently include the time of
operation, the number of errors, the last writing rate, the
max number of concurrent clients, the number of file marks
written, the number of rewinds, the number of files skipped,
and the number of records skipped.
Licensed material--property of copyright holder(s) 3
NSR_DEVICE(5) Legato NetWorker 4.1.1 NSR_DEVICE(5)
volume message (read-only, dynamic, hidden)
This attribute reflects the result of the last volume
operation.
volume write time (read-only, dynamic, hidden)
This attribute gives the time that a save set was first
written to the volume.
volume flags (read/write, hidden)
This attribute displays the new flags for the volume being
operated on. This attribute is used during a "Label" or
"Label without mount" operation.
jukebox device (read/write, dynamic, hidden)
This attribute indicates the media device is part of a jukebox
device. The value can be yes or no.
EXAMPLE
A complete example follows:
type: NSR device;
name: /dev/rmt/8;
message: writing, done
volume name: mars.017;
media family: tape;
media type: 8mm 5GB;
enabled: Yes;
write enabled: Yes;
volume label: mars.017;
volume default capacity: ;
volume current capacity: 5000 MB;
volume expiration: "Thu Sep 21 17:23:37 1996";
volume pool: Default;
volume flags: ;
volume operation: ;
volume write time: ;
volume message: ;
NSR operation: ;
jukebox device: Yes;
statistics: elapsed = 257572, errors = 0, last rate = 397,
max clients = 3, file marks = 22, rewinds = 4,
files skipped = 1976, records skipped = 0;
FILES
/nsr/res/nsr.res - this file should never be edited directly. Use
nsrmm(8), nsradmin(8) or nwadmin(8) instead.
SEE ALSO
getdate(3), nsrresource(5), nsrpool(5), nsrschedule(5),
nsrservice(5), nsr(8), nsrmmd(8), nsrmm(8), nsradmin(8), nwadmin(8).
Licensed material--property of copyright holder(s) 4