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 nsr_resource(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;

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/nrst8";

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.

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 nsr_pool(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.

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/nrst8;
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.

Museum

Related Articles