6-01159-04A - I6ki2k - SNMP Guide PDF
6-01159-04A - I6ki2k - SNMP Guide PDF
6-01159-04A - I6ki2k - SNMP Guide PDF
Scalar Library
6-01159-04
Scalar i2000 / i6000 Basic SNMP Guide, 6-01159-04, May 2010, 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 2010 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
Contents
1 About This Guide and Your Product 1
1 2 2 3 Explanation of Symbols and Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Other Documents you Might Need . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Getting More Information or Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .................................................................................
2 Description
5
5 5 6 6
SNMP Functionality Available to External Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Accessing SNMP Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SNMP Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SNMP Queries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3 Library Identification
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
iii
ADIC Management MIB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trap # 101: physLibraryOnlineStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trap # 102: physLibraryDoorStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trap # 103: ieStationDoorStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trap # 110: rcuReady . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trap # 111: rcuNotReady . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trap # 204: logicalLibraryOnlineStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RAS System Status Change Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trap # 400: connectivityGroupStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trap # 401: controlGroupStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trap # 402: coolingGroupStatusChange. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trap # 403: drivesAndMediaGroupStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trap # 404: powerGroupStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trap # 405: roboticsGroupStatusChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
13 13 13 13 14 14 14 14 14 14 14 15 15 15
A MIBs Implemented
17
17 17 17 18
ADIC Intelligent Storage MIB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ADIC Management MIB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SANMgr Proxy MIB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reference MIBs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
19
iv
Contents
WARNING
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.
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
For the most updated information on Quantum Global Services, please visit: www.quantum.com/support
Description
SNMP is a light-weight protocol designed for remote management and monitoring of infrastructure devices. On the Scalar i2000 / i6000, 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.
The MIB files can be retreived using the Scalar i2000 / i6000 LMC option Tools > Retrieve MIBs.
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: 1 2 Configure the framework application to collect Traps from the Scalar i2000 / i6000. Using the LMC Trap Registration feature, register the hosts IP address and UPD port number on the Scalar i2000 / i6000.
Registration informs the Scalar i2000 / i6000 that Traps should be sent to the host. For details on registering a host with the Scalar i2000 / i6000, see the Scalar i6000 Users 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. As with any SNMP device, excessive MIB queries can result in performance degradation for the SNMP daemon, as well as for the network.
CAUTION
GETs must also include an instance number. This instance ID tells the Scalar i2000 / i6000 what specific device to provide status information on. For example, to see if the 2nd logical library on a Scalar i2000 / i6000 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 / i6000. Therefore, if you were querying logical library status, you might see the following two instances returned. Instance 1 2 Number 8.0.0.0.0.0.1.0.59.1 8.0.0.0.0.0.1.0.59.2 Description the first logical library the second logical library
Selecting instance 8.0.0.0.0.0.1.0.59.2 would indicate if the second logical library was online or offline.
Note
All Scalar i2000 / i6000 MCBs will have the same identifier: 8.0.0.0.0.0.1.0.59
Description
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.
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.
Library Identification
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 i6000 Users Guide. Alerted by Trap: 403
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 / i6000, 8.0.0.0.0.0.1.0.59. Alerted by Traps: 110, 111
10
11
12
SNMP Traps
This section describes the basic set of SNMP system status traps issued by the Scalar i2000 / i6000. These traps present the physical library point of view, not that of a particular partition.
13
14
SNMP Traps
15
16
SNMP Traps
MIBs Implemented
The MIBs implemented with the Scalar i2000 / i6000 library include the ADIC Intelligent Storage MIB, ADIC Management MIB, and the SANMgr Proxy MIB.
Library partitioning Advanced status information: Reliability, Availability and Serviceability (RAS) functionality
17
Reference MIBs
The Scalar i2000 / i6000 MIBs reference the following SNMP standard MIBs: RFC 1155-SMI RFC 1212 RFC 1213-MIB RFC 1215
These MIBs are necessary for accurate compilation of the Scalar i2000 / i6000 MIBs, and should be included with your framework application.
18
MIBs Implemented
Because the front portion of the MIB variable object ID (OID), 1.3.6.1.4.1.3764.1.1, is the same for all variables defined in the ADIC MIBs, it is omitted in the OID column to save space. For example, the actual OID of the Drive Online/Offline Status variable is: 1.3.6.1.4.1.3764.1.1.200.20.80.110.1.29. Event Drive Online / Offline Status Drive Overall Health OID ...200.20.80.110.1.29 Description Indicates if the drive is online or offline. Use the LMC to confirm the drive is varied on. Also, check power. Indicates the overall status of the drive. If the drive has a health status other than good, use the LMC to determine what RAS tickets have been generated for the drive. Indicates if the library is online or offline. Use the LMC to confirm the library is online and not being configured. Indicates the status of the library robotics. Make sure the module door(s) are closed and the robotics are online. Indicates if the front door(s) of the library modules(s) are closed and locked. Indicates if a specific IE station door is closed and locked. Indicates if a specific partition is online or offline. Use the LMC to confirm the partition is online and not being configured. Indicates the status of a particular subsystem of the library. If the value returned is anything but good, use the LMC to determine what events have been logged in the RAS ticket system.
...200.20.80.110.1.31
...200.20.80.10.1.5
...200.20.80.10.1.6
Library Main Door IE Station Door Status Logical Partition Online / Offline Status RAS Subsystem Status
...200.20.100.10.1.2
19
Table 5 Event
Status Traps Trap ID 101 102 103 110 111 Description Issued when the physical library is brought online or taken offline. Issued when the physical library door has been opened, closed, locked, or unlocked. Issued when a partition has been brought online or taken offline. Issued when the robotics go from not ready to ready state. Issued when the robotics go from ready to not ready state. Traps 110 and 111 may occur as part of a startup or shutdown procedure. If seen at another time, it may indicate that the front door is open. Issued when a logical library, also known as a partition, is brought online or taken offline. Issued when the status of the connectivity subsystem changes, which includes the I/O management unit, I/O blades, and other components. This may indicate a change to good status, so check the return value for required action. If the return value shows an issue, use the LMC to determine the corrective actions. Issued when the status of the control subsystem changes, which includes system firmware, the operator panel, and the MCB, RCU, and other control blades. If the return value shows an issue, use the LMC to determine the corrective actions. Issued when the status of the cooling subsystem changes. If the return value shows an issue, use the LMC to determine the corrective actions. Issued when the status of the drives and/or media (including drive brick firmware) changes. If the return value shows an issue, use the LMC to determine the corrective actions. Issued when the status of the power subsystem changes. If the return value shows an issue, use the LMC to determine the corrective actions. Issued when the status of the robotics subsystem changes. If the return value shows an issue, use the LMC to determine the corrective actions. Indicates the library startup sequence has completed. Indicates the library shutdown sequence has completed.
Physical Library Online Status Change Physical Library Door Status Change I/E Station Door Status Change RCU Ready RCU Not Ready
204 400
401
RAS Status Change: Cooling RAS Status Change: Drives and Media
402
403
RAS Status Change: Power RAS Status Change: Robotics Startup Sequence Completed Shutdown Sequence Completed
404
405
500 501
20
Index
C
connectivityGroupStatusChange . . . . . . . . . . . .14 contacting Quantum . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 controlGroupStatusChange . . . . . . . . . . . . . . . .14 coolingGroupStatusChange . . . . . . . . . . . . . . . .14 Customer Service Center website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 drive online/offline status . . . . . . . . . . . . . . . . 9 drive overall health . . . . . . . . . . . . . . . . . . . . 10 I/E station door status . . . . . . . . . . . . . . . . . . 11 library main door status . . . . . . . . . . . . . . . . 11 partition online/offline status . . . . . . . . . . . . . 12 physical library online/offline state . . . . . . . . 10 RAS sub-system status . . . . . . . . . . . . . . . . 12 robotics readiness . . . . . . . . . . . . . . . . . . . . . 10 logicalLibraryOnlineStatusChange . . . . . . . . . . . 14
D
documents additional . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 latest versions . . . . . . . . . . . . . . . . . . . . . . . . 2 release notes . . . . . . . . . . . . . . . . . . . . . . . . . 2 driveAndMediaGroupStatusChange . . . . . . . . . .15
M
MCB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
P
physLibraryDoorStatusChange . . . . . . . . . . . . . 13 physLibraryOnlineStatusChange . . . . . . . . . . . . 13 powerGroupStatusChange . . . . . . . . . . . . . . . . 15 productAgentInfoGroup . . . . . . . . . . . . . . . . . . . . 7
F
framework applications . . . . . . . . . . . . . . . . . 5, 18
G
GET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5, 6, 7
Q
Quantum contacting . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Quantum Intelligent Storage MIB . . . . . . .7, 13, 17 Quantum Management MIB . . . . . . . . . . . . . 13, 17
H
help contacting Quantum . . . . . . . . . . . . . . . . . . . 3 Customer Service Center . . . . . . . . . . . . . . . 3 Service Requests . . . . . . . . . . . . . . . . . . . . . 3
R
RAS . . . . . . . . . . . . . . . . . . . . . . . . . . . .12, 14, 20 rcuNotReady . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 rcuReady . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Reference MIBs . . . . . . . . . . . . . . . . . . . . . . . . . 18 release notes location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 roboticsGroupStatusChange . . . . . . . . . . . . . . . 15
I
ieStationDoorStatusChange . . . . . . . . . . . . . . . .13
L
library identification . . . . . . . . . . . . . . . . . . . . . . . .7 logical library name . . . . . . . . . . . . . . . . . . . . 7 product name . . . . . . . . . . . . . . . . . . . . . . . . 7 Library Management Console (LMC) . . . . 5, 6, 20 library status and health . . . . . . . . . . . . . . . . . . . .9
S
safety symbols and notes . . . . . . . . . . . . . . . . . . . . . 1 SANMgr Proxy MIB . . . . . . . . . . . . . . . . . . . . . . 17 Service Requests
21
opening . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 shutdownSequenceInitiated . . . . . . . . . . . . . . . .13 startupSequenceCompleted . . . . . . . . . . . . . . . .13 symbols and notes explained . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
T
training contact Quantum . . . . . . . . . . . . . . . . . . . . . . 3 Trap 101 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 Trap 102 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 Trap 103 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 Trap 110 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 Trap 111 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 Trap 400 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 Trap 401 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 Trap 402 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 Trap 403 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 Trap 404 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 Trap 405 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 Trap 500 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 Trap 501 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 Trap registration . . . . . . . . . . . . . . . . . . . . . . . .5, 6 Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
W
website Customer Service Center . . . . . . . . . . . . . . . 3
22
Index