nsr_storage_node_resource(5)
nsr_storage_node_resource(5)
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 informa-
tion 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 uncon-
figured 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 val-
ues 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 num-
ber 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: name: 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: name: 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: name: 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: name: 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: name: 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 cor-
responding NSR device resource.
Example: name: 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: name: 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: name: 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 config-
ured libraries defined. This list will be updated every time a
library is added or deleted.
Example: name: 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 stor-
age 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: name: type of configured silos: ACSLS_SILO;
max active devices (read/write, single number)
This attribute indicates the maximum number of devices that Net-
Worker 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: name: 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: name: 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 dis-
covered by auto-detect program during the last device scannning.
The order corresponds to unconfig device names.
Example: name: 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: name: 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 corre-
sponding entry in NSR unconfigured library resouce. Default
value is `none'.
Example: name: 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 auto-
matically.
The order of each entry in this attribute will have its corre-
sponding 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: name: 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: name: 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: name: 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: name: 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: name: 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: name: 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: name: 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 differ-
ent 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: name: 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 Stor-
age Node to safeguard underlying file system interity, and con-
trol 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: name: 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: name: search all luns: Yes [No];
use persistent names (read/write, yes/no)
This attribute indicates whether NetWorker should use any avail-
able 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: name: 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 Net-
Worker-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: name: 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: name: 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: name: 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: name: 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-configu-
ration.
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 Net-
Worker'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 juke-
box itself being configured for NetWorker's use. No other stor-
age 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 Shar-
ing configuration for that library.
Device sharing mode set at this level will override device shar-
ing mode setting at the server level. Default value is set to
`Server default'.
Example: name: 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)
NetWorker 7.6.2 Jul 14, 11 nsr_storage_node_resource(5)