Content-type: text/html Man page of NSR_JUKEBOX

NSR_JUKEBOX

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

NAME

nsr_jukebox - NetWorker resource type ``NSR jukebox''  

SYNOPSIS

type: NSR jukebox  

DESCRIPTION

Each jukebox known to NetWorker is described by a single resource of type NSR jukebox. A jukebox keeps track of the resources, volumes and devices that are being managed by an external media management service and are available to this NetWorker server. An example of an external media management service is OpenVault. This resource describes the physical characteristics of a jukebox. See nsr_resource(5). To edit the NSR jukebox resources for a NetWorker server, type:
nsradmin -c "type:NSR jukebox"

or use NetWorker Management Console. See the nsradmin(8) manual page for more information on using the NetWorker Administration program.  

ATTRIBUTES

The following attributes are defined for resource type NSR jukebox. The information in parentheses describes how the attribute values are accessed. Create-only indicates that the value cannot be changed by an administrator, except when the resource is created. Read-only indicates that the value cannot be changed by an administrator. Read/write means the value can be set as well as read at any time. 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. Number means that only numeric values are allowed. Static attributes change values rarely, if ever. Dynamic attributes have values which change rapidly. Hidden means it is an attribute of interest only to programs or experts, and these attributes can only be seen when the hidden option is turned on in nsradmin(8). For example, an attribute marked (read-only, dynamic) has a value which cannot be changed by the administrator but which may change each time it is retrieved from the NetWorker server due to underlying state changes. 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 jukebox.
The value of this attribute may follow the "rd=hostname:" syntax of a remote device, when the jukebox is defined on a storage node. See nsr_storage_node(5) for additional detail on storage nodes.
Example: name: Huntington;
comment              (read/write)
This attribute is provided for the administrator to keep any explanatory
remarks or supplementary information about the jukebox.
description         (read/write)
This attribute is used to store a brief description about the jukebox. The
description is used to help administrators identify the jukebox, and it can be in any format.
Example: description: DLT Changer drive in Engineerning Lab;
model                (create-only, single string)
This attribute specifies the jukebox model.

Example: model: ADIC-VLS;
physical slots (read-only, list of numbers, hidden)
This attribute specifies the first and last physical slot numbers in the jukebox. The first slot number must be less than or equal to the last slot number. The numbers must also be specified as two separate attribute values.
For Silo Tape Libraries (STL), this attribute is equal to the number of volumes allocated to this NetWorker server, nsrjb(5) -a or -x. The number of physical slots changes as volumes are added or removed from the STL.
Example: physical slots: 1, 54;
control port (read/write, single string)
This attribute specifies the path of the control port for the
jukebox robotics. Control commands (load slot 47 into drive b, for example) are sent to the jukebox via the control port.
For an STL, this attribute specifies the information required to set up a connection to the STL server. Form and contents of the attribute depend on the type of the STL, but most often it merely contains the hostname of STL server.
The value of this attribute may follow the "rd=hostname:" syntax of a remote device, when the jukebox is defined on a storage node. See nsr_storage_node(5) for additional detail on storage nodes.
Example: control port: scsidev@0.6.0;
devices              (read/write, list of strings)
This attribute lists the device pathnames of the devices in the jukebox.
Each entry that appears in this attribute must have a corresponding NSR device resource. Unless any of the drives are being shared by multiple device resources, there must be the same number of entries in the devices attribute as there are physical drives in the jukebox. In addition, they must be listed in the same order as they are physically installed in the jukebox. The entries are specified as separate attribute values.
Example: devices: /dev/rmt/0mbn, /dev/rmt/1mbn;

This attribute is updated by jbedit when adding or deleting a shared device or a physical drive.
number devices (read/write, single number, hidden)
The number of configured devices in the jukebox. This value corresponds to the number of entries in the devices attribute.
Example: number devices: 2;

This attribute is incremented or decremented by jbedit depending on whether a device is being added to or deleted from the jukebox.
number drives (read/write, single number, hidden)
The number of unique physical drives configured in the jukebox. When multiple device resources share a physical drive, each drive is represented by a unique hardware ID attribute, that is specified in all of the device resources sharing the same drive.
Example: number drives: 2;

This attribute is updated by jbedit when adding or deleting a unique physical drive but left unmodified when changing a shared device.
device hardware ids (read-only, hidden)
The hardware ids of the jukebox's devices. For each entry in the
devices attribute of the jukebox resource, there will be a corresponding entry in the device hardware ids attribute. The hardware id entries of those devices sharing a physical drive will have the same value.
slot tags    (read-only, hidden)
The tags of the jukebox's slots as reported by the
nsrlcpd (8) process. This attribute will have a tag entry for each configured slot.
drive tags   (read-only, hidden)
The tags of the jukebox's drives as reported by the
nsrlcpd (8) process. For each entry in the devices attribute of the jukebox resource, there will be a corresponding entry in the drive tags attribute. The drive tags entries of those devices sharing a physical drive will have the same value.
idle device timeout  (read/write, hidden)
This attribute specifies the number of minutes to wait before unmounting a
volume in an idle device (both shared and unshared). Setting this attribute's value to zero disables unmounting idle volumes. The function of this attribute only applies to SmartMedia jukeboxes, or silo and native jukeboxes with device sharing enabled.
Example: idle device timeout: 10;
SmartMedia update interval (read/write, hidden)
This attribute specifies the number of hours between calls to update the SmartMedia server's database. The SmartMedia database contains information copied from the NetWorker media database. The information includes the pool to which a volume belongs, whether the volume is full, and so forth. This information is used by the SmartMedia server when selecting a volume for writing. Since this information may change over time, it is necessary to periodically make sure that the data replicated in the SmartMedia server's database is current. This attribute determines the time period between attempts to update the SmartMedia server's database. This attribute only applies to SmartMedia jukeboxes.
Example: SmartMedia update interval: 12;
write enabled        (read/write, yes/no, hidden)
This attribute indicates whether writing can be done to the mounted volume.
This attribute is only used during a jukebox ``Load'' operation. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: write enabled: Yes;
bar code reader      (read/write, yes/no)
This attribute indicates whether NetWorker should use the barcode
label from the media if the jukebox has a barcode label reader. This should only be enabled if the jukebox has a barcode label reader.
Example: bar code reader: No;
match bar code labels        (read/write, yes/no)
This attribute indicates whether NetWorker should use the barcode
label instead of a label template when labeling media volumes. This should only be enabled if the jukebox has a barcode label reader and the attribute "bar code reader" is enabled.
Example: match bar code labels: No;
verify label on unload (read/write, yes/no)
This attribute indicates whether NetWorker should verify that a label exists at the beginning of every tape before it is unloaded. If this attribute is set to Yes and this label does not exist, all savesets on the volume are marked suspect and the volume is marked full.
volume expiration (read/write, single string, hidden)
This attribute specifies the expiration time of a volume currently being labeled. For jukeboxes interacting with external media management services, this attribute specifies the minimum expiration time for the volume to be loaded. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
available slots      (read/write, list of numbers)
This attribute specifies the slots containing volumes available
to automatically satisfy NetWorker requests for writable volumes. When automatically selecting a writable volume, nsrjb(8) will only consider volumes from the list of available slots. The slots are specified as a list of ranges, one range per attribute value. A range may be a single slot number or a pair of slot numbers separated by a dash. The first number of a pair must be less than or equal to the second.
For Silo Tape Libraries, this attribute is automatically updated when adding or removing volumes, nsrjb(8) -a or -x.
When satisfying requests to mount a particular volume (that is, by its volume name) or slot, all of the volumes in the slots listed in physical slots can be used. This allows the jukebox to be partitioned, with saves restricted to a group of volumes while all of the volumes contained within the jukebox are accessible for recovers.
Example: available slots: 1-10;
enabler code (read-only, single string, hidden)
This attribute lists the enabler code for the
NSR license resource (see nsr_license(5)) corresponding to this jukebox resource. A jukebox cannot be used until a license enabler has been loaded to control that jukebox.
Example: enabler code: 123456-123456-123456;
enabled slots (read-only, single string, hidden)
The value of this attribute is the number of slots enabled for this jukebox. This attribute's value is set by the server when an enabler code is loaded to the jukebox.
Example: enabled slots: 8;
operation    (read/write, choice list, hidden)
This attribute shows the operation currently being performed on the jukebox.
This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation: Load;
command      (read-only, single string, hidden)
This attribute shows the command that caused the current operation to be
performed on the jukebox. If the operation was generated via a nsrjb command then this attribute shows the entire nsrjb command line, otherwise it shows a description of the operation. The attribute is used to pass information between NetWorker programs, and to help the administrator track the status of individual operations (see nsr_jbop(5)). This attribute should not be changed manually by the administrator.
Example: command: nsrjb -lnv -S 2;
operation message (read-only, single string, hidden)
This attribute displays an error message after a jukebox operation fails.
Example: operation message: ;
operation device (read/write, single string, hidden)
This attribute passes the name of the device to which the current operation refers. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation device: /dev/rmt/0mbn;
operation drive element address (read/write, hidden)
This attribute passes the element address of the drive to which the current operation refers. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation drive element address: D:082;
operation slots (read/write, single string, hidden)
This attribute passes the slots on which the current operation will be performed. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation slots: 1-10;
operation options (read/write, single string, hidden)
This attribute passes the mode of the volume used when the current operation will be performed, nsrjb(5) -o option. This attribute is used to pass information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation options: manual;
operation barcodes (read/write, list of strings, hidden)
This attribute passes the volume tags or barcodes on which the current operation will be performed. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator. This attribute is only used for Silo Tape Libraries and is only defined on platforms which provide support for Silo Tape Libraries.
Example: operation barcodes: A01B, A0/3-5/B;
operation response (read/write, choice list, hidden)
This attribute designates a default response to questions that may be asked while performing the operation. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation response: Yes;

operation report mode (read/write, choice list, hidden) This attribute designates the amount of output generated during the execution of the operation. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation report mode: verbose;

operation label state (read/write, choice list, hidden) This attribute designates whether a volume being labeled is to be recycled or is expected to be unlabeled. If a volume is to be recycled, it must already have a NetWorker label. You can recycle a volume while it is being mounted. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation label state: recycle;

operation volume capacity (read/write, single string, hidden) This attribute specifies the capacity of a volume being labeled. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation volume capacity: 10G;

operation volume type (read/write, choice list, hidden) This attribute specifies types of volumes that may be considered when allocating a volume. It is only used when interacting with an external media management service. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation volume type: 8mm, dlt;

operation ineligible (read/write, hidden)
This attribute specifies volumes which are ineligible for the current
operation. Only used when interacting with an external media management service. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation ineligible: ;
operation task (read/write, choice list, hidden)
This attribute designates a secondary task or operation to be performed with the current operation. For example, choosing the mount after label task will cause the volume to be mounted after it has been labeled. Currently, this attribute is only used when interacting with an external media management service. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation task: mount after label;
operation instance (read/write, single string, hidden)
This attribute designates an instance number to be associated with the operation. The instance must be unique for all current operations.
operation hostname (read/write, single string, hidden)
This attribute designates the name of the machine on which the operation is to be executed. This attribute is only used for those jukeboxes which support devices attached to multiple hosts. The host machine may be inferred from other attributes for the operation, such as operation device. If a device is specified, the operation will be executed on the host for the device. Otherwise the host will be inferred from the name of the jukebox, unless a value is specified for this attribute. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation hostname: host1;

operation dev hostname (read/write, single string,

hidden)
This attribute designates the name of the machine from which a device is to be selected for the operation. It applies to shared jukeboxes, which can have drives attached to multiple hosts. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation dev hostname: host1;
operation template (read/write, single string, hidden)
This attribute shows the template that the label operation will use. The verify operation sets this to the volume name found on a piece of media. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation template: Default;

operation volume pool (read/write, choice list, hidden) This attribute specifies the default volume pool to use when labeling. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation volume pool: NonFull;

operation source pool (read/write, choice list, hidden) This attribute specifies the pool from which a volume may be selected when recycling a volume. This attribute is only supported on jukeboxes for volumes being managed by an external media management package. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation source pool: Default;

operation uses left (read/write, single string, hidden) This attribute sets the number of times a cleaning cartridge may be used. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: operation uses left: 12;

volumes (read/write, list of strings, hidden)
This attribute contains a list of resident volume names. The order corresponds to the slot number. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: volumes: mars.001, mars.002, mars.003, mars.004;
volume ids (read/write, list of strings, hidden)
Every volume labeled by NetWorker is assigned a volume identifier, often referred to as a volid. This attribute contains a list of volume identifiers for the resident volumes. The volume identifiers stored could be the new long volume IDs or the older and shorter volume IDs. The type of volume identifiers stored depends on whether the storage node on which the device belonging to the jukebox resides on, supports the new long volume id or not. The order corresponds to the slot number.
This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: volumes: 24198, 24199, 24200, 24197;

volume cartridge ids (read/write, list of strings, hidden) Some jukeboxes track volumes that are managed by external media management services. There may be multiple volumes on the same media, for example, a volume on each side of an optical disk. This attribute is used to track the identifier for each cartridge on which a volume resides. The order corresponds to the slot number. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.

loaded volumes (read/write, list of strings, hidden)
This attribute contains the names of the volumes currently loaded on the jukebox devices. The order is with respect to the devices attribute. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
This attribute is updated by jbedit when adding or deleting a shared device or a physical drive.
Example: loaded volumes: mars.089, mars.003;
Using the names specified in the previous devices attribute, mars.089 is loaded in `/dev/rmt/0mbn' and mars.003 is loaded in `/dev/rmt/1mbn'.
loaded bar codes (read/write, list of strings, hidden)
This attribute contains the barcodes of the loaded volumes, if the use of barcodes is enabled for the jukebox. The order is with respect to the devices attribute. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
This attribute is modified by jbedit when a device is added to or removed from the jukebox resource.
Example: loaded barcodes: 12345, 67890;
Using the names specified in the previous devices attribute, the volume with barcode 12345 is loaded in `/dev/rmt/0mbn' and the volume with barcode 67890 is loaded in `/dev/rmt/1mbn'.
loaded slots (read/write, list of numbers, hidden)
This attribute contains the slot numbers of the loaded volumes. The order is with respect to the devices attribute. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
This attribute is modified by jbedit when a device is added to or removed from the jukebox resource.
Example: loaded slots: 48, 3;
Using the names specified in the previous devices attribute, the volume in slot 48 is loaded in `/dev/rmt/0mbn' and the volume in slot 3 is loaded in `/dev/rmt/1mbn'.
event tag    (read/write, single number, hidden)
This attribute contains the tag (unique identifier) of the last
notification event sent to the nsrd(8) daemon. The tag is used by nsrjb(8) to clear the previous event. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: event tag: 6319962287;
event message (read/write, single string, hidden)
This attribute contains the text of the last notification event sent to the nsrd(8) daemon. The nsrjb(8) command will send a notification event to nsrd when operator intervention is needed before nsrjb can proceed. This attribute passes information between NetWorker programs, and should not be changed manually by the administrator.
Example: event message: could not unload device /dev/rmt/1mbn into slot 4;
messages    (read/write, list of strings, hidden)
This attribute contains a log of messages reflecting previous operations
nsrjb(8) has done. Generally, an entry is made each time nsrjb is invoked and for each mechanical operation. Each entry is timestamped. This attribute is used to pass information between NetWorker programs, and should not be changed manually by the administrator.
Example: messages: 04/01/91 01:15:08 loaded slot 4 into drive a;
minimum space (read/write, single string, hidden)
This attribute contains the low water mark for remaining space. When the remaining space on the volumes contained in the available slots is less than the minimum space, irrespective of whether there is only one volume or more in the Jukebox, an alert notification is sent that states that the volumes in the named jukebox has passed the low water mark, the first time its noticed. After this, during subsequent checks, if the situation has not changed, that is, remaining space is still less than or equal to the limit specified in "minimum space", a notification is sent to nsrd about the available space on the volume(s). If there is just one volume, then, even if the limit has not been reached, the notification about the available space on the volume, is sent. This hidden attribute can be modified by a user. This hidden attribute can be modified by a user.
The minimum space may be specified as a number of gigabytes or megabytes. Either `G' or `g' may be used for gigabytes, `M' or `m' for megabytes.
Example: minimum space: 7g;
jukebox options (read-only, list of strings, hidden)
This attribute contains a list of the options for this jukebox. This option is automatically set after jukebox creation.
Example: jukebox options: two_sided;
auto clean  (read/write, yes/no)
This attribute specifies whether automatic cleaning of devices in the
the jukebox is enabled.
Example: auto clean: Yes;
cleaning slots      (read/write, list of numbers)
This attribute designates a range of slots in the jukebox that has
been set aside for cleaning cartridges. A range may be a single slot number or a pair of slot numbers separated by a dash. If a pair of slot numbers is given, the first number of the pair must be less than or equal to the second. Only one range of slots may be set aside for cleaning cartridges. If auto clean is set to no, the value of cleaning slots is ignored and these slots may contain regular volumes. When auto clean is set to yes, the range of slots specified for this attribute are assumed to contain cleaning cartridges, and the range of slots specified by available slots and this attribute must not overlap.
For Silo Tape Libraries this attribute should not be changed directly. This attribute is automatically updated, when adding (nsrjb -U) or removing (nsrjb -x) cleaning cartridges.


Example: cleaning slots: 9-10;

default cleanings   (read/write, single number)
This attribute designates the number of uses assigned to a new cleaning
cartridge during an inventory of a jukebox by nsrjb(8). A cleaning cartridge is considered to be new when a slot set aside for cleaning cartridges that was empty is discovered to be full during an inventory of a jukebox.
Example: default cleanings: 12;
auto media management       (read-write)
This attribute indicates whether automated media management for the jukebox
is enabled. The value can be yes or no. If the value is set to yes, then unlabeled volumes in the jukebox may be automatically labeled by NetWorker. NetWorker verifies that the volume is unlabeled before labeling the volume. A volume is considered to be unlabeled if the volume does not contain a label that may be read by the device in the jukebox into which the volume is loaded. Note that if the volume contains a label, but the label is written at a density that cannot be read by the device the volume is considered to be unlabeled. If the volume contains data written by an application other than NetWorker, it most likely does not have a label recognizable by NetWorker and the volume is considered to be unlabeled. With this attribute enabled, care should be taken when loading any volume considered to be unlabeled into the jukebox. The volume may be re-labeled and the data previously on the volume over-written by NetWorker. For devices in a jukebox the value of their auto media management attribute is always no.
Example: auto media management: yes;
STL device names     (read/write, list of strings)
This attribute lists the corresponding Silo device names of the devices
listed in the devices attribute. If several device resources are sharing the same physical Silo drive, as indicated by a common hardware ID value, this attribute will only have an entry for each of the physical drives. This attribute is only used for Silo Tape Libraries and is only defined on platforms which provide support for Silo Tape Libraries.
STL interface lib    (read/write, single string)
The pathname of the dynamically linked interface library.
This attribute is only used for Silo Tape Libraries and is only defined on platforms which provide support for Silo Tape Libraries.
Example: STL interface lib: /usr/lib/libstl.so.1;
STL device sharing   (read/write, single string)
This attribute specifies how to handle device sharing.
Device sharing means automatic, load dependent, device switching of devices in a Silo Tape Library between different hosts connected to the library. This feature can only be used if it is supported by the STL interface lib. Possible values for this attribute are an empty string (device sharing disabled) or "perm-max", where perm and max are numbers with perm < max. The perm value is the number of devices that can be reserved permanently (do not require releasing). The max value is the maximum number of devices that can be reserved. This attribute is only used for Silo Tape Libraries and is only defined on platforms which provide support for Silo Tape Libraries.
Example: STL device sharing: 2-4;
STL barcodes (read/write, list of strings, hidden)
The barcodes of the volumes in the library, which are available for NetWorker. This attribute maintains the volume names used by the Silo Tape Libraries for the corresponding volumes in the volumes attribute. This attribute is only used for Silo Tape Libraries and OpenVault virtual jukeboxes. The attribute is only defined on platforms which provide support for Silo Tape Libraries or OpenVault.

STL device reservation (read/write, list of strings,

hidden)
This list contains the reservation state of shared devices in a tape library. The possible states are "Yes" (device is reserved), "No" (device is not reserved) and "Error" (an error occurred during release of this device). The order of the reservation state matches the `devices' attribute. This attribute is only used for Silo Tape Libraries with device sharing enabled and is only defined on platforms which provide support for Silo Tape Libraries.
application name (read/write, encrypted, hidden)
This attribute is only used for OpenVault jukeboxes. OpenVault requires any application to identify itself when submitting a request. This is the name used by this server to identify itself to OpenVault when submitting a request to access resources listed in this jukebox.
application key      (read/write, encrypted, hidden)
This attribute is only used for OpenVault jukeboxes. OpenVault
requires any application to identify itself when submitting a request. This is the key used by this server to identify itself to OpenVault when submitting a request to access resources listed in this jukebox.
read hostname        (read/write, single string)
The hostname that is used in selecting a storage node for recover and
read-side clone requests. For recover requests, if the required volume is not mounted, and the client's "storage nodes" attribute does not match one of the owning hosts in the jukebox, then this attribute is used. For clone requests, if the required volume is not mounted, then this attribute is used.
NDMP jukebox (read-only, yes/no)
This attribute specifies that the jukebox robotics is controlled by the NDMP
Tape Server host.
NDMP type    (read-only, Choice list, hidden)
This attribute specifies the type of control that the NDMP jukebox provides. Other than
Celestra 1.6 on Solaris, all other jukeboxes that are controlled by NDMP Tape Server will have the value "Logical Handle Device".
NDMP hostname        (read-only, single string)
This attribute specifies the NDMP Tape Server hostname that is controlling
the jukebox robotics.
remote user  (read/write, single string, hidden)
This field is no longer used. The NDMP user name on the NDMP Tape Server host
is used from NSR storage node (5) resource.
password     (read/write, single string, hidden)
This field is no longer used. The password for the NDMP user on the NDMP Tape
Server host is used from NSR storage node (5) resource.
NDMP jukebox handle  (read-only, single string)
This attribute specifies the jukebox handle on the NDMP Tape Server host to control
the jukebox robotics.
NDMP bus number      (read-only, number, hidden)
This attribute specifies the BUS number of the Jukebox on the NDMP Tape Server
host. This field maintained for backward compitiability.
autodetect id        (read/write, hidden)
This attribute is for identifying autodetected devices.
It is used by NetWorker programs only, and should not be changed manually by the administrator.
server network interface (read/write, hidden)
This attribute defines the network address or the hostname which is used to communicate with nsrjb. This field is only relevant, if the jukebox is connected to a storage node.
jukebox serial number (read only)
This attribute indicates the serial number of the jukebox.
hardware id (read only, hidden)
This attribute indicates the hardware identifier for the auto-detected jukebox.
ASCAPI               (read/write, yes/no, hidden)
This attribute is kept for historical reasons only.
It has no affect.
debug trace level(read/write, single number, hidden)
The level of debug messages generated & displayed during a jukebox operation may be set on a per jukebox basis. The value default value is 0, which means no debug information collected or displayed. Higher values represent increasingly larger amounts of debug information being captured.
operation timeout(read/write, single number, hidden)
The time, in seconds, that a jukebox operation may sit idle before it is automatically cancelled. The default is 1800 seconds (30 minutes).
operation lifespan(read/write, single number, hidden)
The time, in seconds, that the jukebox operation resource (for a completed jukebox operation) is kept in nsrd before automatically being deleted. The default value is 1800 seconds (30 minutes)
ready                (read/write, yes/no, hidden)
Indicates whether the jukebox is ready to accept operations to
be executed. The value is automatically set to "No" when Networker is started, and will be changed to "Yes" once Networker determines that the jukebox has finished initializing, and is ready to begin work. Any reset of the jukebox will also change the ready attribute back to "No" until the rest has completed.
virtual jukebox              (read only, yes/no)
Indicates whether NetWorker has detected the jukebox as a virtual library
device. This value will be set to "Yes" if, and only if, NetWorker has detected that the configured library is a virtual library. A facility for NetWorker to determine whether a library is virtual must be provided by the VTL vendor. Default value is "No".
virtual jukebox frameid              (read/write, single string)
The unique identifier of the physical device providing the virtual library
services. Any number of virtual libraries are allowed to be created in a given virtual library server. For detected virtual libraries, the default value is "default vtl location". For non virtual libraries, the default value is an empty string.
unconfigured devices (read only, hidden)
Indicates the list of device names belongs to this jukebox, which are discovered by auto-detect during last scan however not yet configured in the library.
library drive base address (read only, hidden)
Indicates the base element address of the drives in the jukebox. The device detection program, dvdetect, updates the resource.
existing drive ids (read only, hidden)
Inidcates the serial numbers information of the currently existing drives in the jukebox. The device detection program, dvdetect, updates the resource.
existing drive addresses (read only, hidden)
Indicates the element addresses of the currently existing drives in the jukebox. The device detection program, dvdetect, updates the resource.
unconfigured drive ids (read only, hidden)
Indicates the serial numbers information of the unconfigured drives (detected in last scan however not yet configured) in the jukebox. The device detection program, dvdetect, updates the resource.
unconfigured drive addresses(read only, hidden)
Indicates the element addresses of the unconfigured drives (detected in last scan however not yet configured) in the jukebox. The device detection program, dvdetect, updates the resource.

 

EXAMPLE

A resource defining a jukebox named Huntington is shown. The model attribute specifies a `Exabyte 210' jukebox. The control port attribute specifies the bus, target, and LUN ID for the robotics device `scsidev@0.6.0'. The device attribute lists the pathnames of the two tape devices in the jukebox, `/dev/rmt/0mbn' and `/dev/rmt/1mbn'. Since the jukebox has a bar code reader, the two bar code yes/no attributes are both set to `Yes'. The available slots attribute lists the slots to consider when automatically selecting a volume to load for writing. The available slots are 2 through 11. The hidden attributes are displayed. auto clean is yes so automatic cleaning of devices is enabled for this jukebox. cleaning slots is set to slot 1. This slot is reserved for a cleaning cartridge.




                             type:NSR jukebox;
                             name:Huntington;
                             model:EXB-210;
                             physical slots:1-11;
                             control port:scsidev@0.6.0;
                             devices:/dev/rmt/0mbn, /dev/rmt/1mbn;
                             number devices:2;
                             number drives:2;
                             device hardware ids:"", "";
                             idle device timeout: 10;
                             SmartMedia update interval: 12;
                             write enabled:Yes;
                             bar code reader:Yes;
                             match bar code labels:Yes;
                             volume expiration:;
                             available slots:2-11;
                             enabler code:012345-6789ab-cdef00;
                             operation:;
                             operation message:;
                             operation device:;
                             operation slots:;
                             operation ports:;
                             operation options:;
                             operation barcodes:;
                             operation response:;
                             operation report mode:;
                             operation label state:;
                             operation volume capacity:;
                             operation volume type:;
                             operation ineligible:;
                             operation task:;
                             operation instance:;
                             operation hostname:;
                             operation dev hostname:;
                             operation template:;
                             operation number uses:;
                             operation volume pool:;
                             operation source pool:;
                             volumes:-, -, -, -, -, -, -, -, -, -, -;
                             volume ids:"", "", "", "", "", "", "", "", "", "", "";
                             STL barcodes:;
                             STL device sharing:;
                             STL device reservation:;
                             STL interface lib:;
                             event tag:;
                             event message:;
                             messages:"09/12/03 11:50:56 CREATED";
                             minimum space:7g;
                             jukebox options:;
                             auto clean:Yes;
                             cleaning slots:1;
                             default cleanings:12;
                             auto media management:Yes;
                             reset class:initialize unload;
                             application name:;
                             application key:;
                             read hostname:hostname;
                             debug trace level:0;
                             operation timeout:1800;
                             ready:Yes;

 

SEE ALSO

nsr(5), nsr_device(5), nsr_storage_node(5), nsradmin(8), nsrd(8), nsrjb(8), dvdetect(8), NSR storage node(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