Man page of NSR_UNCONFIGURED_LIBRARY.5
Section: Misc. Reference Manual Pages (Dec 11, 08)
Updated: NetWorker 7.4.4
Return to Main Contents
- NetWorker resource type "NSR unconfigured library"
type: NSR unconfigured library
Each medium changer that is discovered during a
scan for devices
operation has information about it initially stored in the
NSR unconfigured 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 configure any devices for NetWorker's use. The resource is also modified during the autoconfiguration process, so some values may change as that process progresses.
for information on NetWorker resources.
To edit the
NSR unconfigured library
nsradmin -c "type:NSR unconfigured library"
Be sure to include quotation marks and to insert a space between
"NSR" and "unconfigured" and "library".
for information on using the NetWorker administration program.
The information in parentheses describes how the attribute values are accessed.
indicates that the value cannot be changed by an administrator.
indicates a value that can be set as well as read.
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
attributes change values rarely, if ever.
attributes have values that change rapidly.
For example, an attribute marked
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 unconfigured library and the value is always
NSR unconfigured library
- name (read-only)
This attribute is an automatically generated unique name, usually 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
- silo library
This attribute is the filename of the (oddly enough, the dynamically loaded) software library that is used by NetWorker to communicate 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 multiple identifiers. (i.e. World Wide Node Name is the "most preferred", 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 contiguous, but that is no longer a requirement for use with NetWorker.
- 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 configured during the autoconfig process. It will change during the configuration process so the contents are not terribly meaningful.
- 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 process 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", "internal_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",
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:email@example.com", firstname.lastname@example.org;
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",
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,
ONC program number: 390109;
ONC version number: 2;
ONC transport: [TCP] UDP ;
- files in this directory should never be edited directly. Use
NetWorker Management Console
- SEE ALSO
This document was created by
using the manual pages.
Time: 02:39:48 GMT, October 02, 2010