Quantum Scalar i2000 User manual

6-01159-03
Scalar i2000
Basic SNMP Reference Guide Basic SNMP Reference Guide
Quantum Scalar i 2000 Library
Quantum Scalar i2000 Library

Scalar i2000 Basic SNMP Guide, 6-01159-03, March 2007, Made in USA.
Quantum Corporation provides this publication “as is” without warranty of any kind, either express or implied, including
but not limited to the implied warranties of merchantability or fitness for a particular purpose. Quantum Corporation
may revise this publication from time to time without notice.
COPYRIGHT STATEMENT
Copyright 2007 by Quantum Corporation. All rights reserved.
Your right to copy this manual is limited by copyright law. Making copies or adaptations without prior written
authorization of Quantum Corporation is prohibited by law and constitutes a punishable violation of the law.
TRADEMARK STATEMENT
Quantum, DLT, DLTtape, the Quantum logo, and the DLTtape logo are all registered trademarks of Quantum
Corporation.
SDLT and Super DLTtape are trademarks of Quantum Corporation.
Other trademarks may be mentioned herein which belong to other companies
Published: March 2007 Document Number: 6-01159-03 Rev A

Scalar i2000Basic SNMP Reference Guide iii
Contents
1 About This Guide and Your Product 1
Explanation of Symbols and Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Other Documents you Might Need . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Getting More Information or Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2 Description 5
SNMP Functionality Available to External Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Accessing SNMP Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
SNMP Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
SNMP Queries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3 Library Identification 7
Product Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Logical Library Name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
4 Library Status and Health 9
Drive Online/Offline Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Drive Overall Health . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Physical Library Online/Offline State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Robotics Readiness. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Library Main Door Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Import/Export Station Door Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Partition Online/Offline Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Overall Library Health: RAS Subsystem Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
5 SNMP Traps 13
ADIC Intelligent Storage MIB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Trap # 500: startupSequenceCompleted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Trap # 501: shutdownSequenceInitiated. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
ADIC Management MIB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

iv Contents
Trap # 101: physLibraryOnlineStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Trap # 102: physLibraryDoorStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Trap # 103: ieStationDoorStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Trap # 110: rcuReady . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Trap # 111: rcuNotReady . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Trap # 204: logicalLibraryOnlineStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
RAS System Status Change Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Trap # 400: connectivityGroupStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Trap # 401: controlGroupStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Trap # 402: coolingGroupStatusChange. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Trap # 403: drivesAndMediaGroupStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Trap # 404: powerGroupStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Trap # 405: roboticsGroupStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
A MIBs Implemented 17
ADIC Intelligent Storage MIB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
ADIC Management MIB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
SANMgr Proxy MIB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Reference MIBs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
B Variables and Traps Quick Reference 19

Scalar i2000 Basic SNMP Reference Guide 1
About This Guide and Your Product
This reference guide describes the basic usage of the Simple Network Management Protocol (SNMP) to
acquire alert information from the Scalar® i2000 library. Focus is placed on the most critical information
available through Traps and Management Information Base (MIB) queries. For information about the Scalar
i2000 library, itself, refer to the Scalar i2000 User’s Guide. For information on integrating MIBs into a SNMP
management application, contact your software vendor.
The information presented in this document represents the most commonly requested MIB objects and
SNMP Traps needed to monitor the Scalar i2000 from a network management tool. For more information
about the Scalar i2000 MIBs, contact technical support.
This basic SNMP reference is written for library customers, partners, third party management software
developers, and other parties interested in integrating the Scalar i2000 library with commercial management
frameworks.
This document assumes the reader has a working knowledge of SNMP. The reader should be able to
compile a MIB on their specific framework application, perform SNMP GET operations, as well as
understand how to collect Traps and filter them for information.
Explanation of Symbols and Notes
The following symbols appear throughout this document to highlight important information.
WARNING
INDICATES A POTENTIALLY HAZARDOUS SITUATION WHICH, IF NOT
AVOIDED, COULD RESULT IN DEATH OR BODILY INJURY.
CAUTION
Indicates a situation that may cause possible damage to equipment, loss of
data, or interference with other equipment.
Note
Indicates important information that helps you make better use of your system.

2About This Guide and Your Product
Other Documents you Might Need
The following documents are also available for this product. These documents can be found on the product
CD or at www.quantum.com/support.
•Scalar i2000 User’s Guide (6-00421-xx)
•ADIC Management Console User’s Guide (6-00064-xx)
Note
Release Notes are also available for this product. The Release Notes describe changes
to your system or firmware since the last release, provide compatibility information, and
discuss any known issues and workarounds. The Release Notes can be found in the
product box or at www.quantum.com/support

Scalar i2000 Basic SNMP Reference Guide 3
Getting More Information or Help
More information about this product is available on the Service and Support website at
www.quantum.com/support. The Service and Support Website contains a collection of information,
including answers to frequently asked questions (FAQs). You can also access software, firmware, and
drivers through this site.
For further assistance, or if training is desired, contact Quantum:
For the most updated information on Quantum Global Services, please visit: www.quantum.com/support
Quantum Technical Assistance Center in the USA: www.quantum.com/osr
For additional contact information: www.quantum.com/support
To open a Service Request: www.quantum.com/esupport

4About This Guide and Your Product

Scalar i2000 Basic SNMP Reference Guide 5
Description
SNMP is a light-weight protocol designed for remote management and monitoring of infrastructure devices.
On the Scalar i2000, SNMP support is included for alert monitoring by means of framework applications.
SNMP should be used as an initial check for library events.
In-depth monitoring and alert management are handled using the Library Management Console (LMC). The
LMC provides access to descriptions of subsystem status and to the RAS ticket system, which gives
administrators the ability to diagnose specific subsystem events.
SNMP Functionality Available to External Applications
The Scalar i2000 provides standard SNMP functionality for monitoring library status. This includes GET
queries and unicast Traps (sent only to registered recipients). SET commands are not currently enabled on
the Scalar i2000.
The MIB variables described in this document are the only ones supported by Quantum for external
management of the library. All other variables in the MIB are for internal use only.
Specific Scalar i2000 SNMP characteristics include:
• Support for SNMP v1 and v2c
• Usage of well known ports for GETs (161)
• Default community read/Trap strings: public
• Trap Registration interface in the LMC to configure application IP addresses and user-configurable
UDP port numbers to receive Traps
Accessing SNMP Information
SNMP information is accessed from the Scalar i2000 through Traps and GET queries. Using the information
contained in this guide, an administrator can configure their framework application to receive Scalar i2000
SNMP information and generate alerts.
By default, SNMP information gathered will be an integer value (logical partition names will be string values).
For instance, the return value of Library Main Door might be 2. As outlined in this manual, a return value of
2 would indicate that the library door is closed.

6Description
It is possible to have the framework return a status value and a description of the status. To accomplish this,
the ADIC MIBs must be compiled and integrated with the framework application. In this case, the return
value of Library Main Door might be closed(2). The required MIBs are discussed in MIBs Implemented on
page 17 and are available from your Quantum representative.
SNMP Traps
Traps are automatically sent to registered hosts when specific events occur. You can only have one
application per port listening for traps, so if you have more than one application, make sure that you specify
a UDP port on which to send traps.
To receive Traps, you must perform two steps:
1Configure the framework application to collect Traps from the Scalar i2000.
2Using the LMC Trap Registration feature, register the host’s IP address and UPD port number on the
Scalar i2000.
Registration informs the Scalar i2000 that Traps should be sent to the host. For details on registering a host
with the Scalar i2000, see the Scalar i2000 User’s Guide or the LMC online help.
SNMP Queries
GET queries are initiated on a periodic basis by the framework application. By querying the MIB, hosts can
gather status information about specific components of the library. Frequent MIB queries are not required,
however, since the SNMP agent is event-driven.
GETs must also include an instance number. This instance ID tells the Scalar i2000 what specific device to
provide status information on. For example, to see if the 2nd logical library on a Scalar i2000 was online,
you would access the MIB variable for logical library online status and select the instance for logical library 2.
The format of each instance may vary depending on the subsystem component. This document provides a
listing of the instance format for each MIB variable you may need to query. You will notice that almost every
instance contains 8.0.0.0.0.0.1.0.59. This is the identifier for the Management Control Blade (MCB), the
device that manages the Scalar i2000.
Therefore, if you were querying logical library status, you might see the following two instances returned.
Selecting instance 8.0.0.0.0.0.1.0.59.2 would indicate if the second logical library was online or offline.
CAUTION
As with any SNMP device, excessive MIB queries can result in
performance degradation for the SNMP daemon, as well as for the
network.
Instance Number Description
1 8.0.0.0.0.0.1.0.59.1 the first logical library
2 8.0.0.0.0.0.1.0.59.2 the second logical library
Note
All Scalar i2000 MCB’s will have the same identifier: 8.0.0.0.0.0.1.0.59

Scalar i2000 Basic SNMP Reference Guide 7
Library Identification
The two MIB variables below are available in the ADIC Intelligent Storage MIB from the
productAgentInfoGroup. The productAgentInfoGroup is a group of scalar objects that contains information
about the library as a whole. All objects in productAgentInfoGroup have instance ID “.0”. Unless otherwise
noted, all variables are defined in the ADIC Management MIB.
Product Name
OID: 1.3.6.1.4.1.3764.1.1.10.3
Name: productName (defined in the ADIC Intelligent Storage MIB)
Type: DisplayString
Values: Indicates the type of library.
Instance: There is one instance for this variable and it is unique for the entire library. Quantum recommends
querying the Product Name so that the framework application will list the type of library being monitored.
Logical Library Name
OID: 1.3.6.1.4.1.3764.1.1.200.20.90.20.1.3
Name: name
Type: DisplayString
Values: Returns the logical library name. Logical library is another name for a library partition.
Instance: There will be one instance for each partition configured on the library. Query the specific instance
that you need to access.
Logical libraries are listed using the format:
• 8.0.0.0.0.0.1.0.59.1
The final number (1 in this instance) is the partition number.
To determine the number of partitions, query the MIB variable:
• 1.3.6.1.4.1.3764.1.1.200.20.90.10.1.2
Query Logical Library Name so that the framework application will list the specific partition that is
monitored.

8Library Identification

Scalar i2000 Basic SNMP Reference Guide 9
Library Status and Health
You can poll the variables below to get library status and health information.
Drive Online/Offline Status
OID: 1.3.6.1.4.1.3764.1.1.200.20.80.110.1.29
Name: phDriveOnlineStatus
Type: INTEGER
Values: online(1), offline(2), shutdown(3). Currently the drive object never returns shutdown(3)
Description: This variable indicates whether a drive is varied on or varied off.
Instance: There will be one instance for every physical drive in the library. Query the specific instance that
you need to access. Drives are listed in sequential order.
See Table 1 for details on interpreting the format of a drive instance ID.
Table 1 Drive Instance ID Format
Instance Information Description
8.0.0.0.0.0.1.0.59.4.2.0.0.0.3.0.0 If this is the full instance name...
8.0.0.0.0.0.1.0.59--------IdentifiesthelibraryMCB
4-------Mediadomain
-2------Mediatype
--0-----Aisle
---0----Frame
----0---Rack
-----3--Section
------0-Column
-------0Row

10 Library Status and Health
The numbers associated with the aisle, frame, rack, section, column, and row combine to form a location
coordinate. For more about the library location coordinates and how they can tell you where a drive is
located in the physical library, refer to the Scalar i2000 User’s Guide.
Alerted by Trap: 403
Drive Overall Health
OID: 1.3.6.1.4.1.3764.1.1.200.20.80.110.1.31
Name: phDriveRasStatus
Type: INTEGER
Values: good(1), failed(2), degraded(3), warning(4), informational(5), unknown(6), invalid(7)
Description: The overall health of the drive is indicated by the phDriveRasStatus object.
Instance: There will be one instance for every physical drive in the library. Query the specific instance that
you need to access. Drives are listed in sequential order. See Table 1 on the previous page for details on
interpreting the format of a drive instance ID.
Alerted by Trap: 403
Physical Library Online/Offline State
OID: 1.3.6.1.4.1.3764.1.1.200.20.80.10.1.5
Name: onlineStatus
Type: INTEGER
Values: online(1), offline(2), shutdown(3)
Description: The online/offline state of the entire library is returned by the onlineStatus object.
Instance: There will be one instance for the Scalar i2000, 8.0.0.0.0.0.1.0.59.
Alerted by Trap: 101
Robotics Readiness
OID: 1.3.6.1.4.1.3764.1.1.200.20.80.10.1.6
Name: readiness
Type: INTEGER
Values: ready(1) or notReady(2).
Description: The readiness state of the library robotics is returned by the readiness object.
Instance: There will be one instance for the Scalar i2000, 8.0.0.0.0.0.1.0.59.
Alerted by Traps: 110, 111

Scalar i2000 Basic SNMP Reference Guide 11
Library Main Door Status
OID: 1.3.6.1.4.1.3764.1.1.200.20.80.10.1.16
Name: physLibDoorStatus
Type: INTEGER
Values: open(1), closed(2), closedAndLocked(3), closedAndUnlocked(4), controllerFailed(5).
Description: The state of the library’s main door is returned by the physLibDoorStatus object.
Instance: There will be one instance for the Scalar i2000, 8.0.0.0.0.0.1.0.59. This refers to a front door on
any module.
Alerted by Trap: 102
Import/Export Station Door Status
OID: 1.3.6.1.4.1.3764.1.1.200.20.80.75.1.2
Name: physLibIeStationDoorStatus
Type: INTEGER
Values: open(1), closed(2), closedAndLocked(3), closedAndUnlocked(4), controllerFailed(5).
Description: The state of the Import/Export station door is returned by the phIeStationDoorStatus object.
Instance: There will be one instance for each frame of the library containing an I/E station. You will need to
query for the instance. It will be of the format: 8.0.0.0.0.0.1.0.59.1.1.1.1
See Table 2 for details on interpreting the format of an I/E station instance ID.
Alerted by Trap: 103
Table 2 I/E Station Instance ID Format
Instance Information Description
8.0.0.0.0.0.1.0.59.1.1.1.1 If this is the full instance name...
8.0.0.0.0.0.1.0.59----IdentifiesthelibraryMCB
1---Aislecoordinate
- 1 - - Frame coordinate
- - 1 - Rack coordinate
---1I/EstationIDnumber

12 Library Status and Health
Partition Online/Offline Status
OID: 1.3.6.1.4.1.3764.1.1.200.20.90.20.1.12
Values: online(1), offline(2)
Instance: There will be one instance for every logical partition defined on the library. Query the specific
instance that you need to access. Partitions are listed using the format: 8.0.0.0.0.0.1.0.59.1
Where the final number (1 in this instance) is the partition number. To determine the number of partitions,
query the MIB variable: 1.3.6.1.4.1.3764.1.1.200.20.90.10.1.2. Names of the partitions can be found using
OID 1.3.6.1.4.1.3764.1.1.200.20.90.20.1.3. Refer to Logical Library Name on page 7 for more information.
Alerted by Trap: 204
Overall Library Health: RAS Subsystem Status
The Reliability, Availability and Serviceability (RAS) system status table provides a concise way to assess
the health of the library's subsystems. The library functionality is divided into six status groups: connectivity,
control, cooling, drives and media, power, and robotics.
Querying this variable will give the status of the last state transition (i.e. a subsystem has changed its status
to good.) Determining the precise reason for a status setting other than "good" can be accomplished using
the LMC and accessing the subsystem RAS tickets.
OID: 1.3.6.1.4.1.3764.1.1.200.20.100.10.1.2
Values: good(1), failed(2), degraded(3), warning(4), informational(5), unknown(6), invalid(7)
Instance: There will be one instance for each of the 6 key subsystems monitored by the library. Query the
specific instance that you need to access. Subsystem instances are listed using the format:
8.0.0.0.0.0.1.0.59.1
Where the final number (1 in this example) is the subsystem. connectivity(1), control(2), cooling(3), drives
and media(4), power(5), robotics(6)
Alerted by Traps: 400, 401, 402, 403, 404, 405

Scalar i2000 Basic SNMP Reference Guide 13
SNMP Traps
This section describes the basic set of SNMP system status traps issued by the Scalar i2000. These traps
present the physical library point of view, not that of a particular partition.
ADIC Intelligent Storage MIB
Traps defined in the Intelligent Storage MIB are issued with enterprise OID “intelligent”, which resolves to
1.3.6.1.4.1.3764.1.1.
Trap # 500: startupSequenceCompleted
This trap indicates that the library has completed its boot sequence.
Trap # 501: shutdownSequenceInitiated
This trap indicates that the library has started its shutdown sequence, which includes reboot and shutdown.
ADIC Management MIB
These informational traps are defined in the ADIC Management MIB. Each is issued with enterprise OID
“management”, which resolves to 1.3.6.1.4.1.3764.1.1.200.20.
Trap # 101: physLibraryOnlineStatusChange
This trap is issued when the physical library is brought online or taken offline.
Trap # 102: physLibraryDoorStatusChange
This trap is issued when the physical library door has been opened, closed, closed and locked, closed and
unlocked, or when the controller has failed.
Trap # 103: ieStationDoorStatusChange
This trap is issued when an I/E station door has been opened, closed, locked or unlocked.
Trap # 110: rcuReady
This trap is issued whenever the i2000’s robotics transitions from the “not ready” state to the “ready” state.

14 SNMP Traps
Trap # 111: rcuNotReady
This trap is issued whenever the i2000’s robotics transitions from the “ready” state to the “not ready” state.
For example, this trap will be issued if the front door is opened or the robotics are disabled.
Trap # 204: logicalLibraryOnlineStatusChange
This trap is issued when a logical library, also known as a partition, is brought online or taken offline.
RAS System Status Change Traps
The i2000 issues a trap whenever the aggregate state of one of the six RAS status groups changes.
Listening for these traps is the preferred method of monitoring the health of the Scalar i2000. The payload
of each of these traps is very similar; it is summarized in the table below.
Table 3 RAS System Status Change Trap Payload Description
Trap # 400: connectivityGroupStatusChange
The state of the connectivity hardware/software has changed.
Trap # 401: controlGroupStatusChange
The state of the control hardware/software has changed.
Trap # 402: coolingGroupStatusChange
The state of the cooling hardware/software has changed.
Trap # 403: drivesAndMediaGroupStatusChange
The state of the drives and media hardware/software has changed.
Payload Element Description
componentId Identifies the management control blade which is hosting the
RAS system. For i2000, the varbind value is always set to
8.0.0.0.0.0.1.0.59.
trapSequenceNumber This integer uniquely identifies the Trap.
trapSeverity Not Used
trapSummaryText Not Used
rasStatusGroupIndex RAS group whose status has changed; connectivity(1),
control(2), cooling(3), drivesAndMedia(4), power(5), and
robotics(6)
rasStatusGroupStatus New state; good(1), failed(2), degraded(3), warning(4),
informational(5), unknown(6), or invalid(7)
rasTicketId This is beyond the scope of this document.
rasReportId This is beyond the scope of this document.

Scalar i2000 Basic SNMP Reference Guide 15
Trap # 404: powerGroupStatusChange
The state of the power hardware/software has changed.
Trap # 405: roboticsGroupStatusChange
The state of the robotics hardware/software has changed.

16 SNMP Traps