nsr_unconfigured_library(5)
nsr_unconfigured_library(5)
NAME
nsr_unconfigured_library - NetWorker resource type "NSR unconfigured
library"
SYNOPSIS
type: NSR unconfigured library
DESCRIPTION
Each medium changer that is discovered during a scan for devices
operation has information about it initially stored in the NSR uncon-
figured library
resource. This resource type is hidden, so it will not be diplayed in
any administrative application unless the appropriate options (if
available) are selected for that application to display hidden
resources.
This resource is, in effect, a holding pen for the information that
NetWorker needs to properly autoconfigure a tape library. We place all
of the relevent information that we can collect during the device
detection process into this resource before we attempt to actually con-
figure any devices for NetWorker's use. The resource is also modified
during the autoconfiguration process, so some values may change as
that process progresses.
See nsr_resource(5) for information on NetWorker resources. To edit
the NSR unconfigured library resources run:
nsradmin -c "type:NSR unconfigured library"
Be sure to include quotation marks and to insert a space between "NSR"
and "unconfigured" and "library". See nsradmin(8) for information on
using the NetWorker administration program.
ATTRIBUTES
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 indicates a value that can be set as well as
read.
Hidden indicates a hidden attribute of interest only to programs or
experts. These attributes can only be seen when the hidden option is
turned on in nsradmin(8). Static attributes change values rarely, if
ever. Dynamic attributes have values that change rapidly. For exam-
ple, an attribute marked (read-only, static) has a value that is set
when the attribute is created and never changes.
type (read-only)
This attribute indicates that this resource is for an unconfig-
ured library and the value is always NSR unconfigured library
name (read-only)
This attribute is an automatically generated unique name, usu-
ally derived from the SCSI inquiry data for the library along
with serial number information also retrieved from the library.
library types
This attribute is a listing of the connection method(s) used to
communicate with this library. There is one entry in the list
for each storage node that can see the library. They are
usually all the same, but that is not a requirement.
The possible values include scsi, silo
and ndmp.
silo library
This attribute is the filename of the (oddly enough, the dynami-
cally loaded) software library that is used by NetWorker to com-
municate with a silo controller (if this is a silo-type
library).
reference names (read-only)
This attribute is a listing of the names that will be used to
describe this library for the various storage nodes that are
able to see it.
storage nodes (read-only)
This attribute is a list of the storage nodes that have reported
to the NetWorker server that they were able to communicate with
this library.
descriptions (read-only)
This attribute is a list of descriptions of the library for each
storage node that can see the library. They are usually based
on inquiry data and SCSI addresses.
control ports (read-only)
This attribute is a list of the control ports that the various
storage nodes reported using to communicate with this library.
There may be more than one port for any given storage node due
to the existence of multiple communications channels between the
storage node and the library.
model (read-only)
This attribute is the model name used internally by NetWorker.
Most often it will be "Standard SCSI Jukebox" which is our
internal name for a library that behaves just as described in
the SCCI Medium Changer specification.
serial number (hidden, read-only)
This attribute is the serial number of the library itself. Only
the best choice identifier is used if the library reutrns multi-
ple identifiers. (i.e. World Wide Node Name is the "most pre-
ferred", followed by World Wide Port Name, IEEE Node Name, IEEE
Port Name, Vendor Unique Node Name, and VPD Page 0x80 serial
number)
drive count (hidden, read-only)
This attribute is the number of drives that the library reports
that it has.
drive base (hidden, read-only)
This attribute is the lowest SCSI element address for aany of
the drives in the library.
drive addrs (hidden, read-only)
This attribute is a list of the actual element addresses for any
drives that are present on the library. They are usually con-
tiguous, but that is no longer a requirement for use with Net-
Worker.
drive ids (hidden, read-only)
This attribute is a list of the tape drives' identifiers
returned to us by the library. These are used to match up the
drives with the various access paths (i.e. tape drive device
files) on all of the storage nodes that can see the drives in
this library.
to be configured devices (hidden, read-only)
This attribute is a working list of devices that will be config-
ured during the autoconfig process. It will change during the
configuration process so the contents are not terribly meaning-
ful.
unconfigured devices (hidden, read-only)
This attribute is a list of devices that are not yet matched to
device access paths by the autoconfig process. As with "to be
configured devices" this will change during the autoconfig pro-
cess and is therefore not terribly meaningful.
slot count (hidden, read-only)
This attribute is the number of slots (SCSI storage elements)
that the library reports that it contains.
slot base (hidden, read-only)
This attribute is the lowest SCSI element address for the slots
in this library.
ie count (hidden, read-only)
This attribute is the number if import/export elements that the
library reports that it contains.
ie base (hidden, read-only)
This attribute is the lowest SCSI element address for the
import/export elements in this library.
media transport count (hidden, read-only)
This attribute is the number of medium transports (a.k.a. robot,
gripper, the thing that moves the tapes around) that the library
reports. This is usually only one.
media transport base (hidden, read-only)
This attribute is the lowest SCSI element address for the medium
transport element(s) in this library.
feature list (hidden, read-only)
This attribute is a list of NetWorker's internal "features" that
are applicable for this library. Possible values include:
"elements_status", "no_init_elem_sts", "no_start_init_elem_sts",
"volume_tags", "barcode", "autoeject", "two_sided", "doorlock",
"init_inlet_rqd", "no_trnsport_source_dest", "has_range",
"no_ies_range", "need_align", "ies_no_barcode", "inter-
nal_ports", "display", "auto_cc_unload", "cc_eject", "recheck",
"stacker_import", "stacker_export", "read_elem_unload_fail",
"auto_inventory", "auto_allocate", "trust_compliant_jbox",
"multi_stack_import", "multi_stack_export",
EXAMPLES
A complete example follows:
type: NSR unconfigured library;
name: EXABYTE Magnum20 WWNN=200000D0803FF06F;
library types: scsi, scsi;
silo library: ;
reference names: "rd=nash:EXABYTE@110.8.0", EXABYTE@4.7.0;
storage nodes: nash, hal.devlab.emc.com;
descriptions: <EXABYTE Magnum20 2.6 at SCSI Bus 110 Target 8 LUN 0>,
<EXABYTE Magnum20 2.6 at SCSI Bus 4 Target 7 LUN 0>;
control ports: "rd=nash:scsidev@110.8.0", scsidev@4.7.0;
model: Exabyte Jukebox;
serial number: WWNN=200000D0803FF06F;
drive count: 2;
drive base: 851;
drive addrs: 851, 852;
drive ids: "Serial Numbers:ATNN=IBM ULTRIUM-TD2 1110081463",
"Serial Numbers:ATNN=IBM ULTRIUM-TD2 1110081756";
to be configured devices: "hal.devlab.emc.com:/dev/rmt4.1:000851",
"hal.devlab.emc.com:/dev/rmt5.1:000852",
"nash:/dev/rmt/c111t4d0BESTnb:000851",
"nash:/dev/rmt/c112t2d0BESTnb:000852";
unconfigured devices: ;
slot count: 143;
slot base: 1;
ie count: 5;
ie base: 801;
media transport count: 1;
media transport base: 901;
feature list: volume_tags, elements_status,
read_elem_unload_fail, barcode,
no_trnsport_source_dest;
hostname: hal.devlab.emc.com;
administrator: "user=root,host=hal.devlab.emc.com",
"user=administrator,host=hal.devlab.emc.com",
"user=system,host=hal.devlab.emc.com";
ONC program number: 390109;
ONC version number: 2;
ONC transport: [TCP] UDP ;
FILES
/nsr/res/nsrdb - files in this directory should never be edited
directly. Use nsrmm(8), nsradmin(8), or NetWorker Management Console
instead.
SEE ALSO
nsr_resource(5), nsradmin(8), nsr_storage_node_resource(5)
NetWorker 7.6.2 Jul 14, 11 nsr_unconfigured_library(5)