Content-type: text/html Man page of NSR_UNCONFIGURED_LIBRARY.5

NSR_UNCONFIGURED_LIBRARY.5

Section: Misc. Reference Manual Pages (Dec 11, 08)
Updated: NetWorker 7.4.4
Index Return to Main Contents
 

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

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 example, 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 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 scsi, silo
 and  ndmp.
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",

 

EXAMPLE

A complete example follows:

                     type: NSR unconfigured library;
                     name: EXABYTE Magnum20        WWNN=200000D0803FF06F;
            library types: scsi, scsi;
             silo library: ;
          reference names: "rd=nash:[email protected]", [email protected];
            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 protected]", [email protected];
                    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)


 

Index

NAME
SYNOPSIS
DESCRIPTION
ATTRIBUTES
EXAMPLE
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:48 GMT, October 02, 2010