Content-type: text/html Man page of NSR_STORAGE_NODE_RESOURCE

NSR_STORAGE_NODE_RESOURCE

Section: File Formats (5)
Updated: Dec 11, 08
Index Return to Main Contents
 

NAME

nsr_storage_node_resource - NetWorker resource type ``NSR storage node''

 

SYNOPSIS

type: NSR storage node

 

DESCRIPTION

Each NSR storage node defined to NetWorker is described by a single source of type NSR storage node (see nsr_resource(5)). To edit the NSR storage node resources for a NetWorker server type:
nsradmin -c "type:NSR storage node"

Be sure to include quotation marks and to insert a space among "NSR", "storage", "node". See the nsradmin(8) manual page for more information on using the NetWorker administration program. The Storage Node resource may also be edited using NetWorker Management Console.

This resource keeps track of the configured devices, configured libraries, unconfigured devices, and unconfigured libraries that can be seen on the storage node. Every time device auto-detection (ddmgr) program is started, all the entries in unconfigure devices and unconfigured libraries, and all of their corresponding entries in the related attributes will be removed. A set of newly detected devices and libraries entries will be updated in these attributes.

 

ATTRIBUTES

The following attributes are defined for resource type NSR storage node. The information in parentheses describes how the attribute values are accessed. Read-only indicates that the value can not be changed by an administrator. Read/write indicates the value can be updated by authorized administrators. Choice list means that any number of values can be chosen from the given list. Yes/no means only a yes or no choice is possible. Single string means that only a single value is allowed. Hidden indicates it is an attribute of interest only to programs or experts. These attributes can only be seen when the hidden option is turned on in nsradmin(8). Several additional attributes (for example, administrator) are common to all resources, and are described in nsr_resource(5).

name (create-only, single string)
This attribute specifies the name of this storage node.
Example: name: polarbear;
type of storage node (read/write, choice)
This attribute specifies the type of this storage node currently is configured. There are three types of storage node which are SCSI, NDMP, or SILO. Default is set to `scsi'.
Example: type of storage node: [scsi] ndmp silo ;
storage node is configured (read/write, yes/no)
This attribute indicates whether this storage node is currently configured. The value will be set to `yes' by the program if there is at least one device or library has been configured on this storage node. If the last device or library is removed, it will be set to `no'.
Example: storage node is configured: [Yes] No ;
date of registration (read-only, single string)
This attribute indicates the date and time when the storage node is registered/created, the date and time when the first device is created on this storage node, or the date and time when the last device configured on it is removed.
Example: date of registration: "Fri Nov 18 18:20:28 2005";
number of devices (read-only, single number)
This attribute indicates the count of the devices defined on this storage node. This number will be updated every time a device is added or deleted.
Example: number of devices: 4;
number of libraries (read-only, single number)
This attribute indicates the count of the libraries defined on this storage node. This number will be updated every time a library is added or deleted.
Example: number of libraries: 1;
list of configured devices (read-only, list of string)
This attribute indicates the devices currently defined for this storage node. This list will be updated every time a device is added or deleted. Each entry in this attribute must have a corresponding NSR device resource.
Example: list of configured devices:
                   "rd=polarbear:\\.\Tape3",
                   "rd=polarbear:\\.\Tape4",
                   "rd=polarbear:\\.\Tape5",
                   "rd=polarbear:\\.\Tape6";
list of configured libraries (read-only, list of string)
This attribute indicates the libraries currently defined for this storage node. This list will be updated every time a library is added or deleted. Each entry in this attribute must have a corresponding NSR jukebox resource.
Example: list of configured libraries:
                   "rd=polarbear:ADIC@7.7.0";
list of configured silos (read-only, list of string)
This attribute indicates the Silos currently defined for this storage node. This list will be updated every time a Silo is added or deleted.
Example: list of configured silos:
                   "rd=s6hp11fc:mysilo";
type of the configured libraries (read-only, list of string)
This attribute indicates the type of tape libraries defined on this storage node which is corresponding to the list of configured libraries defined. This list will be updated every time a library is added or deleted.
Example: type of the configured libraries:
                   Standard SCSI Jukebox;
type of configured silos (read-only, list of string)
This attribute indicates the type of Silos defined on this storage node which is corresponding to the list of configured silos defined. This list will be updated every time a silo is added or deleted.
Example: type of configured silos: ACSLS_SILO;
max active devices (read/write, single number)
This attribute indicates the maximum number of devices that NetWorker may use from this storage node.
unconfig device names (read/write, list of string, hidden)
This attribute indicates the device names that were discovered by auto-detect program during the last device scanning on this storage node. The order of each entry in this attribute will have its corresponding entries in the following attributes:

    unconfig device descriptions
    unconfig device model types
    unconfig device serial numbers
    unconfig device library names

Once a device is configured, its name and its corresponding entries in the above 4 attributes will be removed. Also at each device scanning, all the entries in the unconfig device names and the above 4 attributes will be removed so that an up-to-date detected devices will be updated in these attributes.


Example: unconfig device names:
                   "\\.\Tape0", "\\.\Tape1";

unconfig device descriptions (read/write, list of string,

                         hidden)
This attribute indicates the description of the devices that were discovered by auto-detect program during the last device scannning. The order corresponds to unconfig device names.
Example: unconfig device descriptions:
 <EXABYTE Mammoth2   v05e at SCSI Port 7 Target 2 LUN 0>,
 <EXABYTE Mammoth2   v05e at SCSI Port 7 Target 3 LUN 0>;
unconfig device model types (read/write, list of string,

                        hidden)
This attribute indicates the model of the devices that were discovered by auto-detect program during the last device scannning. The order corresponds to unconfig device names.
Example: unconfig device model types:
                   8mm Mammoth-2, 8mm Mammoth-2;
unconfig device serial numbers (read/write, list of string,

                           hidden)
This attribute indicates the serial numbers of the devices that were discovered by auto-detect program during the last device scannning. The order corresponds to unconfig device names.
Example: unconfig device serial numbers:
 "Serial Numbers:WWNN=100000D080001721:ATNN=EXABYTE Mammoth2  0062041830:WWPN=100000D080001722:0062041830",
 "Serial Numbers:WWNN=100000D0800012AC:ATNN=EXABYTE Mammoth2  0062034656:WWPN=100000D0800012AD:0062034656";
unconfig device library names (read/write, list of string,

                          hidden)
This attribute indicates the library names to which the devices that were discovered by auto-detect program during the last device scannning belong. The order corresponds to unconfig device names. If the device resides in a library, there will be an entry of the unconfigured library name corresponding to unconfig library name attribute, and which may have a corresponding entry in NSR unconfigured library resouce. Default value is `none'.
Example: unconfig device library names:
            DELL   PV-132T WWNN=205000604517079D, none;
unconfig library names (read/write, list of string, hidden)
This attribute indicates the unique unconfigured library names that were discovered by auto-detect program during the last device scannning on this storage node. Each entry may or may not have a corresponding entry in NSR unconfigured library resource. If the library returns serial number of itself, there will be an entry in the NSR unconfigured library resource. If the library does not return serial number, there will not be an entry in the NSR unconfigured library resource. And device auto-configuration program will not configure this library automatically.

The order of each entry in this attribute will have its corresponding entries in the following attributes:

    unconfig library reference names
    unconfig library descriptions
    unconfig library control ports
    unconfig library models
    unconfig library serial numbers

Once a library is configured, its name and its corresponding entries in the above 5 attributes will be removed. Also at each device scanning, all the entries in the unconfig library names and the above 5 attributes will be removed so that an up-to-date detected libraries will be updated in these attributes.


Example: unconfig library names:
          EXABYTE Exabyte X80 WWNN=100000D080001E9B;

unconfig library reference names (read/write, list of string,

                             hidden)
This attribute indicates the unique unconfigured library names that were discovered by auto-detect program during the last device scannning. The order corresponds to unconfig library names.
Example: unconfig library reference names:
          "rd=polarbear:EXABYTE@7.6.0";
unconfig library descriptions (read/write, list of string,

                          hidden)
This attribute indicates the description of the unconfigured libraries that were discovered by auto-detect program during the last device scannning. The order corresponds to unconfig library names.
Example: unconfig library descriptions:
       <EXABYTE Exabyte X80     3.03 at SCSI Port 7 Target 6 LUN 0>;
unconfig library control ports (read/write, list of string,

                           hidden)
This attribute indicates the control port of the unconfigured libraries that were discovered by auto-detect program during the last device scannning. The order corresponds to unconfig library names.
Example: unconfig library control ports:
       scsidev@7.6.0;
unconfig library models (read/write, list of string, hidden)
This attribute indicates the model of the unconfigured libraries that were discovered by auto-detect program during the last device scannning. The order corresponds to unconfig library names.
Example: unconfig library models:
       Exabyte Jukebox;
unconfig library serial numbers (read/write, list of string,

                            hidden)
This attribute indicates the serial number of the unconfigured libraries that were discovered by auto-detect program during the last device scannning. The order corresponds to unconfig library names.
Example: unconfig library serial numbers:
       WWNN=100000D080001E9B;
date of last scan (read/write, list of string)
This attribute indicates the date that auto-detect process was last run.
Example: date of last scan:
       "Mon Nov 28 18:41:06 2005";
skip scsi targets (read/write, list of string)
This attribute indicates the scsi addresses that need to be skipped by the auto-detect process. The targets are in the format of 'bus.target.lun', where the target and/or lun fields can be wildcards. When specify multiple scsi addresses, enter one address per line. The maximum number of scsi address can be excluded is 63. This attribute can be used for a lot of different reasons such as skipped detecting the broken hardware, skipped detecting devices owned by another application other than NetWorker, speeded up the device auto-detection process.
Example: skip scsi targets: 7.9.6;
AFTD Allowed Directories (read/write, list of string)
This attribute indicates what base directories are allowed to create AFTD for a given NSR Storage Node. If it's not empty, then any AFTD directory must be subdirectory of one of the listed base directories (including the base directory itself), and the base directory must be valid and exists, otherwise AFTD config will be rejected. Therefore system administrator should create those base directories first in order to create AFTD underneath. If the list is empty, then a given AFTD directory must be valid before it can be used. It's strongly encouraged to specifiy the list of AFTD Allowed Directories for each NSR Storage Node to safeguard underlying file system interity, and control AFTD backup directories. NetWorker will promptly notify you on any conflict that can exclude existing AFTD devices when list of AFTD Allowed Directories is changed.
Example: AFTD Allowed Directories: /backup/;
search all luns (read/write, yes/no)
This attribute indicates whether search all luns is enable. If set to `yes' NetWorker will search all the luns for every scsi target. It may cause device auto-detection taking a very long time to complete. By setting it to `no', NetWorker will stop searching for devices at the first un-used/empty lun. Default is set to `no'.
Example: search all luns: Yes [No];
use persistent names (read/write, yes/no)
This attribute indicates whether NetWorker should use any available persistent device names when it searches for tape drives and medium changers. If set to yes, and the storage node's platform supports persistent names that are usable by NetWorker, any detected and/or configured libraries or tape drives will be configured using those persistent names. Any devices that do not have persistent names but do have normal device names will be found and/or configured using the available normal names. Default is set to `no'.
Example: search all luns: Yes [No];



At this time, the only names that NetWorker can automatically find and use are on linux and are of these forms:

/dev/tape/by-id/<<tapeID>>-nst
/dev/tape/by-id/<<changerID>>-generic
/dev/tape/by-id/scsi-<<changerID>>
/dev/generic/by-id/<<changerID>>-generic
/dev/generic/by-id/scsi-<<changerID>>


Setting this attribute to `yes' on a platform that does not have NetWorker-usable persistent names will have no effect.
visible silo controllers (read/write, list of string, hidden)
This attribute contains all the Silo controllers being tested or configured as visible from this storage node.
Example: visible silo controllers: acsls2;
silo controller types (read/write, list of string, hidden)
This attribute contains all the Silo controller types being tested or configured as visible from this storage node. Each silo controller type in the list is corresponding to the visible silo controllers defined. The values can be: ACSLS_SILO, DAS_SILO, or 3494_SILO
Example: silo controller types: ACSLS_SILO;
silo connection status (read/write, list of string, hidden)
This attribute indicates the status of the Silo connections being tested Each silo connection status is corresponding to the visible silo controllers defined. The value of each of them will be updated at each phase as the silo connection test is requested, running, and finished. The values can be: Do Test, Testing, OK, or Failed
Example: silo connection status: OK;
silo names (read/write, list of string, hidden)
This attribute contains the user assigned Silo library names during silo auto configuration. Each Silo library name in the list is corresponding to the visible silo controllers defined.
Example: silo names: mysilo;
silo das client names (read/write, list of string, hidden)
This attribute contains the user input Das client names during silo auto configuration. This value will only appear to the corresponding Das Silo in the visible silo controllers defined.
last error number (read/write, single string)
This attribute contains the error number, if any, logged by the detection (dvdetect) process during the last time device auto-detection was run on this storage node.
remote user (read/write, single string)
This attribute contains the user name used to connect to the NDMP server. This value inputs by the user either via Storage node properties, or duing device auto-detection or auto-configuration.
password (read/write, single string)
This attribute contains the password for the user name used to connect to the NDMP server.
last error message (read/write, single string)
This attribute contains the error message, if any, logged by the detection (dvdetect) process during the last time device auto-detection was run on this storage node.
device sharing mode (read/write, choice list)
This attribute contains a list of choices for the device sharing at the storage node level. Device sharing controls what NetWorker's autoconfiguration code will do when it encounters a tape library where the tape drives in the library are visible to more than one Storage Node.

If the value is set to 'server default' then whatever value is set in the server's Device Sharing Mode attribute will be used by this storage node as described below.

If the value is 'no sharing' then autoconfig will do its best to configure the jukebox as an un-shared jukebox with any drives visible from the storage node that can see and control the jukebox itself being configured for NetWorker's use. No other storage nodes will have access to the drives in that library.

If the value is 'maximal sharing' then autoconfig will configure all storage nodes that can see any drive in the library to use that drive resulting in the maximum possible Dynamic Drive Sharing configuration for that library.

Device sharing mode set at this level will override device sharing mode setting at the server level. Default value is set to `Server default'.
Example: device sharing mode:
       no sharing    maximal sharing
       [server default];;

 

EXAMPLE

A complete NSR Storage node resource follows: 



                        type: NSR Storage Node;
                        name: polarbear;
        type of storage node: [scsi]   ndmp    silo ;
  storage node is configured: [Yes]   No ;
        date of registration: "Fri Nov 18 11:10:22 2005";
           number of devices: 4;
         number of libraries: 1;
  list of configured devices: "rd=polarbear:\\.\Tape3",
                              "rd=polarbear:\\.\Tape4",
                              "rd=polarbear:\\.\Tape5",
                              "rd=polarbear:\\.\Tape6";
list of configured libraries: "rd=polarbear:ADIC@7.7.0";
    list of configured silos: ;
types of the configured libraries: Standard SCSI Jukebox;
   types of configured silos: ;
          max active devices: ;
       unconfig device names: "\\.\Tape0", "\\.\Tape1";
unconfig device descriptions: 
<EXABYTE Mammoth2        v05e at SCSI Port 7 Target 2 LUN 0>,
<EXABYTE Mammoth2        v05e at SCSI Port 7 Target 3 LUN 0>;
 unconfig device model types: 8mm Mammoth-2, 8mm Mammoth-2;
unconfig device serial numbers: 
"Serial Numbers:WWNN=100000D080001721:ATNN=EXABYTE Mammoth2 0062041830:WWPN=100000D080001722:0062041830",
"Serial Numbers:WWNN=100000D0800012AC:ATNN=EXABYTE Mammoth2 0062034656:WWPN=100000D0800012AD:0062034656";
unconfig device library names: none, EXABYTE Exabyte X80 WWNN=100000D080001E9B;
      unconfig library names: EXABYTE Exabyte X80 WWNN=100000D080001E9B;
unconfig library reference names: "rd=polarbear:EXABYTE@7.6.0";
unconfig library descriptions: 
<EXABYTE Exabyte X80     3.03 at SCSI Port 7 Target 6 LUN 0>;
unconfig library control ports: scsidev@7.6.0;
     unconfig library models: Exabyte Jukebox;
unconfig library serial numbers: WWNN=100000D080001E9B;
           date of last scan: "Wed Nov 30 20:28:08 2005";
           skip scsi targets: 7.9.6;
             search all luns:  Yes   [No];
    visible silo controllers: ;
       silo controller types: ;
      silo connection status: ;
                  silo names: ;
       silo das client names: ;
           last error number: 0;
                 remote user: ;
                    password: ;
          last error message: ;
         device sharing mode:  no sharing    maximal sharing   [server default];
 

SEE ALSO

nsr(5), nsr_device(5), nsr_jukebox(5), nsr_resource(5), nsr_unconfigured_library(5), nsradmin(8)

 

Index

NAME
SYNOPSIS
DESCRIPTION
ATTRIBUTES
EXAMPLE
SEE ALSO
This document was created by man2html, using the manual pages.
Time: 02:39:48 GMT, October 02, 2010