StorageTek

Modular Libraries SNMP Reference Guide

E35317-05

February 2016

StorageTek Modular Libraries SNMP Reference Guide

E35317-05

Copyright © 2012, 2016, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Contents

Preface

- Documentation Accessibility

1 SNMP Overview and Requirements

- Supported SNMP Versions

- SNMP Ports

- SNMP Configuration Requirements

- SNMP Configuration Methods

2 MIB Objects

- MIB Location and Object Name

- Downloading the MIB with SLC

- Type Definitions

- Object Definitions

- Cartridge Access Port (CAP) Objects

- Cell Objects

- Controller Objects

- Drive Objects

- Elevator Objects

- Embedded Agent Data Objects

- Fan Objects

- Host Interface Objects

- Library — Configuration Objects

- Library — Cleaning Objects

- Library — Date Objects

- Library — Global Elements Objects

- Library — Identification Objects

- Library — Location Objects

- Library — Media Event Objects

- Library — Network Objects

- Library — State Objects

- Library — Statistics Objects

- Library — Version Objects

- Media Validation Objects

- Pass-Thru Port (PTP) Objects

- Power Supply Objects

- Redundant Electronics Objects

- Robot Objects

- Safety Door Objects

- Tape Cartridge Objects

- Temperature Sensor Objects

- Test Trap Generation Objects

- Trap — Automatic Service Request (ASR) Objects

- Trap — Configuration Objects

- Trap — Device Objects

- Trap — Service Event Objects

- Trap — Test and Heartbeat Objects

- Turntable Objects

3 SNMP Traps

- Generic Traps from Log Entries (1-10)

- slTrapError (1)

- slTrapWarning (2)

- slTrapInformation (3)

- slTrapConfiguration (4)

- Event-Based Traps (11-102)

- slTrapAgentStart (11)

- slTrapAgentTest (13)

- slTrapAgentHeartbeatA (14)

- slTrapAgentHeartbeatB (15)

- slTrapLibStatusGood (21)

- slTrapLibStatusCheck (25)

- slTrapEnvHdwCheck (27)

- slTrapDrvStatusGood (41)

- slTrapDrvStatusCheck (45)

- slTrapCapStatusGood (61)

- slTrapCapStatusOpen (63)

- slTrapCapStatusCheck (65)

- slTrapPtpStatusGood (81)

- slTrapPtpStatusCheck (85)

4 Configuring SNMP with the CLI

- Configuration Process

- Variable Definitions

- Managing Ports

- Managing SNMP Users

- Managing Trap Recipients

- Configuring Service Information

Preface

This document contains Simple Network Management Protocol (SNMP) reference information for Oracle's StorageTek SL150, SL3000, and SL8500 libraries.

Listed MIB objects correspond to MIB version 2.18.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

1 SNMP Overview and Requirements

Simple Network Management Protocol (SNMP) is an application layer protocol that performs network management operations over Ethernet using the User Datagram Protocol/Internet Protocol (UDP/IP). With SNMP, administrators can query the library for information (configuration, operation, statistical) and the library can inform administrators of potential problems. The library can also send information to a StorageTek Tape Analytics (STA) server (for more information, see the STA documentation on OTN).

- Supported SNMP Versions

- SNMP Ports

- SNMP Configuration Requirements

- SNMP Configuration Methods

Supported SNMP Versions

- SNMP v3 — Both read and write support. Transmitted information is secure.

- SNMP v2c — Read-only support primarily for machine status queries. Transmitted information is not secure.

Note:
Configuring public or private as valid community strings is a major security risk.

Either SNMP v2c or SNMP v3 can retrieve object IDs in the MIB file and send traps to the trap recipient list. However, because SNMP v3 provides encryption capabilities and stronger user identification, you can change library properties only with SNMP v3.

SNMP Ports

Configure firewalls to allow communications over these ports:

- 161 — For transmittal of SNMP requests to read the MIB.

- 162 — For reception of SNMP traps (notifications of device problems, errors, or significant events).

SNMP Configuration Requirements

- Library firmware:

- SL8500 version FRS_3.12 or higher

- SL3000 version FRS_1.7 or higher

- SL150 version 1.0 or higher

Note:
STA has separate firmware requirements. See the STA documentation for more information.

- SLC version FRS_4.0 or higher.

- SNMP must be enabled on the library.

SNMP Configuration Methods

You can configure SNMP through the following methods:

- SL3000 and SL8500 — CLI (see Chapter 4, "Configuring SNMP with the CLI").

- SL150 — Browser user interface with user role of either administrator or service (see the SL150 User's Guide).

2 MIB Objects

The management information base (MIB) is an ASCII text file containing the object identifiers (OIDs) that define the characteristics of a managed device (such as an Oracle StorageTek tape library). These characteristics are the functional elements for that device and can be monitored using SNMP software. When a manager requests information, or a managed device generates a trap, the MIB translates the numeric strings into readable text that identifies each data object within the message.

- MIB Location and Object Name

- Downloading the MIB with SLC

- Type Definitions

- Object Definitions

MIB Location and Object Name

The MIB is included with the library firmware and stored on the library processor card. The object name is:

STREAMLINE–TAPE–LIBRARY–MIB:streamlineTapeLibrary ==
1.3.6.1.4.1.1211.1.15

Where:

- 1 = iso

- 3 = identified-organization

- 6 = dod

- 1 = internet

- 4 = private

- 1 = enterprise

- 1211 = storagetek

- 1 = products

- 15 = slseriesTapeLibrary

Downloading the MIB with SLC

1. Log into the library.

2. Select Tools > Diagnostics.

3. Select Library in the device tree.

4. Click the TransferFile tab.

5. Select SNMP MIB, and then click Transfer File.

6. Save the file with a .txt suffix.

Type Definitions

Type Definition

Description

SlLibraryId

Library identifier (n of Max) within a complex

SlLibraryIdMax

Maximum library identifier within a complex

SlComplexId

Library complex identifier

SlSnmpPort

SNMP ports allowed

SlSnmpTrapPort

SNMP trap ports allowed

SlCmdClear

The SNMP trap ports allowed (1=no action, 2=clear)

SlDeviceStatus

Device status (ok=0, error=1, warning=2, info=3, trace=4)

SlLibraryCondition

Condition of library (normal=0, degraded=1, not operative=2)

SlMediaEventType

Type of media error (load=1, unload=2, error=3, load retry=4, drive error=5, media end of life=6, drive end of life=7, decryption error=8, unknown=9)

SlHaState

State of RE controller (simplex=0, duplex=1, nonRE=2)

SlHaId

Identifier of RE controller (active=0, standby=1, nonRE=2)

SlHaSlot

Slot of RE controller (side A =0, side B =1, nonRE =3)

SlDriveFibreLoopId

Fibre loop ID of drive

SlDriveFibreSpeed

Drive Fibre and SAS port speed (unknown=1, FC one Gbit=2, FC two Gbit=3, FC four Gbit=4, FC eight Gbit=5, FC 10 Gbit=6, SAS 1.5 Gbit=8, SAS three Gbit =9, SAS six Gbit=10, FC 16 Gbit=13)

SlDriveFibreAddressing

Drive fibre addressing (hard=1, soft=2)

SlDriveStatus

Status of drive (unknown=0, initializing=1, empty=2, cartridge present=3, loading=4, loaded=5, cleaning=6, rewinding=7, unloading=8, inoperative=9, not loadable=10, not unloadable=11)

SlPartitionType

Type of partition (hli=1, scsi=2, other=3)

SlCellHostTypeTC

Cell host type (invalid /unknown cell =0, storage slot =1, tape drive =2, CAP or mailslot =3, playground /system cell =4, intransit /reserved cell =5, PTP =6, hand /robotic cell =7)

SlSeverityTC

Severity level that a trap can have (ok=0, heartbeat/verification=1, telemetry/metrics=2, configuration=3, trace/debugging=4, information/nominal behavior=5, warning/degraded behavior=6, error/non-operational=7, critical/system fault=8, fatal/system unusable=9, other=10)

SlDiagEntityTC

The entity that diagnosed the fault (fault manager/dedicated on-board fault detection software=1, library app other than fault manager=2, operating system=3, primitive/driver or other low-level firmware=4, other=5)

SlFaultTypeTC

Fault type based on servicing importance (heartbeat/i'm alive or test event=0, automatically recovered=1, suspicious/transient or contributing factor=2, routine/well known=3, escalated/requires more scrutiny=4, critical/overall system behavior affected=5, alert/imminent customer impact=6, dire/customer impacted=7, emergency/immediate service required=8)

SlCountTC

Amount of items counted

SlFruStatusTC

Status of an FRU (other=1, suspected=2, faulted=3, repaired=4, replaced=5, acquitted=6)

Object Definitions

Note:
Some listed MIB objects may not be implemented at time of publication.

MIB Category

Object Prefixes Used

"Cartridge Access Port (CAP) Objects"

slCap

"Cell Objects"

slCell

"Controller Objects"

slController

"Drive Objects"

slDrive

"Elevator Objects"

slElevator

"Embedded Agent Data Objects"

slAgent

"Fan Objects"

slFan

"Host Interface Objects"

slHostInterface

"Library — Configuration Objects"

slLibLSMConfig

"Library — Cleaning Objects"

slLibClean

"Library — Date Objects"

slLibDate

"Library — Global Elements Objects"

slLib
slLibrary

"Library — Identification Objects"

slLib
slLibLibrary

"Library — Location Objects"

slLibLocat

"Library — Media Event Objects"

slLibMediaEvent

"Library — Network Objects"

slLibNetwork

"Library — State Objects"

slLibLSM
slLibLSMState
slLibLSMStatus

"Library — Statistics Objects"

slLibStats

"Library — Version Objects"

slLibVersion

"Media Validation Objects"

slMV

"Pass-Thru Port (PTP) Objects"

slPtp

"Power Supply Objects"

slPowerSupply

"Redundant Electronics Objects"

slAgentHA
slAgentHa

"Robot Objects"

slRobot

"Safety Door Objects"

slSafetyDoor

"Tape Cartridge Objects"

slTape

"Temperature Sensor Objects"

slTempSensor

"Test Trap Generation Objects"

slAgentTrapTest

"Trap — Automatic Service Request (ASR) Objects"

slTrapAsrSuspect

"Trap — Configuration Objects"

slTrapConfig

"Trap — Device Objects"

slTrap
slTrapDevice

"Trap — Service Event Objects"

slTrapSvc

"Trap — Test and Heartbeat Objects"

slTrap
slTrapLib
slTrapHa

"Turntable Objects"

slTurntable
slTurntables

Cartridge Access Port (CAP) Objects

CAP OID

Description

slCapCount

Amount of CAPs in the CAP table

slCapTable

Table of cartridge access ports (CAPs)

slCapEntry

A cartridge access port (CAP)

slCapIndex

Integer index into the CAP table

slCapPhysicalAddressStr

String for CAP's physical address

slCapAccessibility

Accessibility of a CAP (for example, open allow/prevent)

slCapAccessStateEnum

Access state of the CAP, presented as an enumeration

slCapState

Physical state of the CAP

slCapStatusEnum

Operational status of the CAP presented as an enumeration

slCapName

Name of CAP

slCapRotations

Rotation count of CAP

slCapRotationRetries

Number of rotation retries performed by the CAP

slCapRotationFails

Number of rotation failures performed by the CAP

slCapIPLs

Number of IPLs performed by the CAP

slCapSerialNumber

Serial number of the CAP

slCapCodeVer

Code version of the CAP

slCapVersion

Version of the CAP

slCapFirmwareVer

Firmware version of the CAP

slCapReserved

The reserved state of the CAP

slCapSize

The size of the CAP

slCapAddressRange

The CAP address range (not applicable to the SL150 library)

slCapUsageStr

The CAP usage string (not applicable to the SL150 library)

slCapModeStr

The CAP mode string (not applicable to the SL150 library)

slCapMagazineBits

The number of magazines (not applicable to the SL150 library)

slCapEnabled

The enabled state of the CAP (not applicable to the SL150 library)

Cell Objects

Cell OID

Description

slCellCount

Amount of storage elements in the cell table

slCellStorageFreeCells

Amount of available (empty) storage cells in the library

slCellStorageRestrictedFreeCells

Amount of available restricted (empty) storage cells in the library

slCellTable

Table of storage elements in the library

slCellEntry

Storage element

slCellIndex

Integer index into the storage cell table

slCellElementID

Element ID or translated logical HLI address of the storage cell

slCellHostAccessible

Indication of host accessible status

slCellContentStatus

Status of the cell (unknown, empty, readable, not_readable, cap_magazine_not_present, drive_not_present, drive_not_available)

slCellContentLabel

Label of the cartridge in the cell (zero length string if empty, '??????' if unreadable)

slCellContentType

Type of the cartridge in the cell (zero length string if empty) which is a text string based on enumerated domain and type values derived from the VOLSER label

slCellGetRetryCount

Amount of get retries performed from this cell

slCellPutRetryCount

Amount of put retries performed to this cell

slCellHostType

The type of cell (0=invalid/unknown cell, 1=storage slot, 2=tape drive, 3=customer access port or mail slot, 4=playground/system cell, 5=intransit/reserved or recovery cell, 6=pass thru port, 7=robotic cell)

slCellPhysicalAddressStr

Physical address string of storage cell

slCellLogicalAddressStr

Logical address string of storage cell

slCellPartition

Partition ID of storage cell

slCellPartitionType

Partition type of storage cell

slCellCapacityEnabled

Whether the storage cell is enabled (1) or disabled (0)

slCellCapacityAllowed

The number of cells licensed for use.

slCellCapacityUsed

The number of cells being used.

Controller Objects

Controller OID

Description

slControllerCount

Count of the controllers in the controller table

slControllerTable

Table of controllers

slControllerEntry

Controller entry (HBC, RLC, HBT, and so forth)

slControllerIndex

Index of controller card

slControllerPhysicalAddressStr

String for physical address of controller

slControllerSerialNum

Serial number of controller card

slControllerTopLevelCondition

Top-level condition of controller (normal, degraded, not operative)

slControllerFaultLED

Fault LED state of controller

slControllerSafetoRemoveLED

Safe to remove LED state of controller

slControllerStatusEnum

Operational of controller status in enumerated form

slControllerCodeVer

Code version of controller

slControllerVersion

Version of controller

slControllerFirmwareVer

Firmware version of controller

slControllerHAState

High Availability Status of controller (active=0 and Standby=1)

slControllerHaId

RE controller identifier (active=0, standby=1)

slControllerHaSlot

RE controller slot (sideA=0, sideB=1)

slControllerHaAlternateIp

IP address of alternate RE controller

slControllerFru

Field Replaceable Unit (FRU)-based serial number of controller

Drive Objects

Drive OID

Description

slDriveCount

Amount of the drives in the drive table

slDriveTable

Table of drives

slDriveEntry

Tape drive

slDriveIndex

Integer index into the drive table

slDriveHashedPhysAddr

Physical address of the drive

slDriveType

Type of drive (for example, STK10000) derived from manufacturer and make of drive

slDriveVendor

Vendor of drive (for example, STK, HP and IBM)

slDriveSerialNum

Electronic serial number of drive

slDriveInterfaceType

Physical data transport type of drive (1=unknown, 2=scsi, 3=fibre, 4=sas, 5=other, 6=escon, 7=fcoe, 8=ficon)

slDriveID

SCSI ID or Fibre port assignment of drive

slDriveState

State of drive (for example, empty, loaded, needs cleaning)

slDriveLED

State of drive tray LED (0 =off, 1 =on)

slDriveStatusEnum

Operational status of drive in enumerated form

slDriveCodeVer

Code version (software or firmware) of drive

slDriveVersion

Hardware version of drive

slDriveGetRetries

Amount of mount retries performed to the drive

slDrivePutRetries

Amount of dismount retries performed to the drive

slDriveCommandClean

Signal to start or cancel cleaning of the drive

slDriveCellStatusEnum

Status of drive cell presented as an enumeration

slDriveCellStatusText

Status of drive cell

slDriveCellContentLabel

Label of the cartridge in the drive (a zero length string =empty, ?????? =unreadable)

slDriveCellContentType

Type of cartridge in the drive (a zero length string =empty)

slDriveIdleSeconds

Amount of seconds the drive has been idle (unmounted)

slDriveNumMounts

Amount of mounts to the drive

slDriveFibreNodeName

Fibre node name (node WWN) of drive

slDriveFibrePortCount

Amount of active ports in the drive

slDriveFibrePortAWWN

World Wide Name (WWN) of port A

slDriveFibrePortAAdressingMode

Addressing mode of port A

slDriveFibrePortAPortEnabled

Port A enabled (2) or disabled (1)

slDriveFibrePortALoopId

Loop ID of port A

slDriveFibrePortAPortSpeed

Port speed of port A

slDriveFibrePortBWWN

World Wide Name (WWN) of port B

slDriveFibrePortBAdressingMode

Addressing mode of port B

slDriveFibrePortBPortEnabled

Port B enabled (2) or disabled (1)

slDriveFibrePortBLoopId

Loop ID of port B

slDriveFibrePortBPortSpeed

Port speed of port B

slDriveWWNEnabled

World Wide Name (WWN) option for the drive is enabled (can only be set using the command line interface)

slDrivePhysicalAddressStr

Physical address string of drive

slDriveTraySerialNumber

Serial number of drive tray

Elevator Objects

Elevator OID

Description

slElevatorCount

Amount of elevators in elevator table

slElevatorTable

Table of elevators

slElevatorEntry

Elevator

slElevatorIndex

Elevator index

slElevatorPhysicalAddressStr

Physical address string for elevator

slElevatorPositionOn

Physical position of elevator (not implemented, but defined for backward compatibility for non-SL libraries)

slElevatorHandCartStatus

Elevator hand state (cartridge =1, no cartridge =0)

slElevatorSerialNum

Serial number of elevator

slElevatorState

State of elevator (such as idled, moving, inoperative)

slElevatorFaultLED

Fault LED state of elevator

slElevatorStatusEnum

Operational status of elevator in enumerated form

slElevatorCodeVer

Code version of elevator

slElevatorVersion

Version of elevator

slElevatorFirmwareVer

Firmware version of elevator

slElevatorGetRetries

Number of mount retries performed to the elevator

slElevatorPutRetries

Number of dismount retries performed to the elevator

slElevatorGetFails

Number of mount fails for the elevator

slElevatorPutFails

Number of dismount fails for the elevator

slElevatorGetTotals

Sum of all mount operations of the elevator

slElevatorPutTotals

Sum of all dismount operations of the elevator

Embedded Agent Data Objects

Embedded Agent Data OID

Description

slAgentRevision

Firmware version of the embedded agent

slAgentLibStatusAtStartup

Condition of the library at agent start (normal, degraded, not-operational)

slAgentBootDate

Date and time when the agent initialized

slAgentURL

URL for Web based management

slAgentTrapPort

UDP port number where the agent will send traps

slAgentPort

UDP port number where the agent is listening

slAgentCommunity

The agent default community

Fan Objects

Fan OID

Description

slFanCount

Amount of monitored fans in the library

slFanTable

Table of the library's fans

slFanEntry

Fan

slFanIndex

Integer index into the fan table

slFanName

Name of the fan

slFanOperational

Operational state of the fan

Host Interface Objects

Host Interface OID

Description

slHostInterfaceCount

Count of interface cards

slHostInterfaceTable

Table of host interfaces

slHostInterfaceEntry

Host interface entry (such as Fiber or SCSI)

slHostInterfaceIndex

Integer index into the table of host interface cards

slHostInterfaceFibreCount

Amount of active fibres in this host interface card

slHostInterfaceAWWN

Fibre A World Wide Name (WWN)

slHostInterfaceA1AddressingMode

Addressing mode for Port A1

slHostInterfaceA1PortEnabled

Port enabled for Port A1

slHostInterfaceA1LoopId

Loop ID for Port A1

slHostInterfaceA1PortSpeed

Port speed for Port A1

slHostInterfaceA2AddressingMode

Addressing mode for Port A2

slHostInterfaceA2PortEnabled

Port enabled for Port A2

slHostInterfaceA2LoopId

Loop ID for Port A2

slHostInterfaceA2PortSpeed

Port speed for Port A2

slHostInterfaceBWWN

Fibre B World Wide Name

slHostInterfaceB1AddressingMode

Addressing mode for Port B1

slHostInterfaceB1PortEnabled

Port enabled for Port B1

slHostInterfaceB1LoopId

Loop ID for Port B1

slHostInterfaceB1PortSpeed

Port speed for Port B1

slHostInterfaceB2AddressingMode

Addressing mode for Port B2

slHostInterfaceB2PortEnabled

Port enabled for Port B2

slHostInterfaceB2LoopId

Loop ID for Port B2

slHostInterfaceB2PortSpeed

Port speed for Port B2

slHostInterfaceElementID

Element ID /address of the controller

slHostInterfaceSerialNum

Serial number for controller card

slHostInterfaceStatus

State of controller (OK, error, warning)

slHostInterfaceFaultLED

Fault LED state for controller

slHostInterfaceSafeToRemoveLED

Safe to remove LED state for controller

slHostInterfaceStatusEnum

Operational status for controller in enumerated form

slHostInterfaceCodeVer

Code version for controller

slHostInterfaceVersion

Hardware version for controller

slHostInterfaceFirmwareVer

Firmware version for controller

Library — Configuration Objects

Library — Configuration OID

Description

slLibLSMConfigCount

Amount of LSMs installed

slLibLSMConfigTable

A table of LSM configurations

slLibLSMConfigEntry

LSM configuration entry

slLibLSMConfigIndex

LSM configuration index

slLibLSMConfigNumPanels

Amount of physical panels

slLibLSMConfigNumHandCells

Amount of physical hands

slLibLSMConfigMinHandAddr

Minimum Element ID or address of physical hands

slLibLSMConfigMaxHandAddr

Maximum Element ID or address of physical hands

slLibLSMConfigNumSystemCells

Amount of system and reserved cells

slLibLSMConfigNumRestrictedCells

Amount of customer restricted cells

slLibLSMConfigMinSystemAddr

Minimum Element ID or address of system cells

slLibLSMConfigMaxSystemAddr

Maximum Element ID or address of system cells

slLibLSMConfigNumCaps

Amount of cartridge access ports (CAPs)

slLibLSMConfigNumCapColumns

Amount of columns within CAPs

slLibLSMConfigNumCapCells

Amount of CAP cells

slLibLSMConfigMinCapAddr

Minimum Element ID or address of CAP cells

slLibLSMConfigMaxCapAddr

Maximum Element ID or address of CAP cells

slLibLSMConfigNumDriveColumns

Amount of drive columns

slLibLSMConfigNumDrives

Amount of tape drives

slLibLSMConfigMinDriveAddr

Minimum Element ID or address of tape drives

slLibLSMConfigMaxDriveAddr

Maximum Element ID or address of tape drives

slLibLSMConfigNumStorageCells

Amount of storage cells

slLibLSMConfigMinStorageAddr

Minimum Element ID or address of storage cells

slLibLSMConfigMaxStorageAddr

Maximum Element ID or address of storage cells

slLibLSMConfigNumPtps

Amount of pass-thru ports (PTPs)

slLibLSMConfigNumPtpColumns

Amount of columns within the PTPs

slLibLSMConfigNumPtpCells

Amount of PTP cells

slLibLSMConfigMinPtpAddr

Minimum Element ID or address of PTP cells

slLibLSMConfigMaxPtpAddr

Maximum Element ID or address of PTP cells

Library — Cleaning Objects

Library — Cleaning OID

Description

slLibCleanEnabled

Auto clean feature configuration (not supported on all libraries)

slLibCleanNumCartTypes

Number of unique cartridge types supported

slLibCleanWarnTable

Table of clean count warning thresholds

slLibCleanWarnEntry

Table entry for clean count warning threshold

slLibCleanWarnIndex

Index into clean warning threshold table

slLibCleanWarnCartType

Cleaning cartridge type (for example, SDLT, 9840, LTO and T10000)

slLibCleanWarnCount

Configured warning count threshold

slLibCleanNumCarts

Count of the clean cartridges in the library

slLibCleanCartTable

Table of cleaning cartridges in the library

slLibCleanCartEntry

Cleaning cartridge

slLibCleanCartIndex

Integer index into the cleaning cartridge table

slLibCleanCartLabel

Clean cartridge label

slLibCleanCartType

Cleaning cartridge type

slLibCleanCartLocationElementID

Clean cartridge location: SCSI Element ID or translated HLI Address

slLibCleanCartHostAccessible

Indication of host accessible status

slLibCleanCartUsageCount

Number of times that the cartridge has been used to clean a tape drive

Library — Date Objects

Library — Date OID

Description

slLibDateString

Library date and time, in the following format: YYYY:MM:DD HH:MM:SS

Library — Global Elements Objects

Library — Global Elements OID

Description

slLibStkBaseModel

StorageTek Library model name (see vendor specific model data)

slLibSerialNumber

Serial number of library frame

slLibWWNNumber

Library World Wide Number (WWN) (a 64-digit hexadecimal number)

slLibraryTopLevelCondition

Library overall condition (normal, degraded, not-operational)

slLibraryState

The status of the library (online, offline)

Library — Identification Objects

Library — Identification OID

Description

slLibLibraryId

Library identifier (n of Max) within a library complex

slLibLibraryIdMax

Maximum library identifier within a library complex

slLibComplexId

Identifier of library complex

slLibMibVer

Version of the MIB supported by the library

Library — Location Objects

Library — Location OID

Description

slLibLocatContact

Primary contact for administration of the library

slLibLocatStreet

Street address of location site

slLibLocatState

State /province of location site

slLibLocatZip

ZIP code or other data of location site

slLibLocatCountry

Country of location site

slLibLocatDescr

Description or other data of location site

slLibLocatCity

City of location site

Library — Media Event Objects

Library — Media Event OID

Description

slLibMediaEventCount

Amount of media statistics in the table

slLibMediaEventTable

Table of media statistics

slLibMediaEventEntry

Statistic about media error

slLibMediaEventIndex

Index into the media error statistic table

slLibMediaEventVolid

Volume ID of the optical barcode

slLibMediaEventMediaDomain

The domain field of the optical barcode detected from the VOLSER label

slLibMediaEventMediaType

The type of the optical barcode detected from the VOLSER label (1=load, 2=unload, 3=error, 4=loadRetry, 5=driveError, 6=mediaEndOfLife, 7=driveEndOfLife, 8=decryption error, 9=unknown)

slLibMediaEventDriveSerialNum

Electronic serial number of the drive

slLibMediaEventDriveType

Type of tape drive

slLibMediaEventDateTime

Log entry date and time in this format:
MM:DD:YYYY HH:MM:SS

slLibMediaEventEnum

Type of media error, reported as an enumeration

slLibMediaEventOccurrenceCount

Occurrence count for media statistic

Library — Network Objects

Library — Network OID

Description

slLibNetworkCount

Count of all the Ethernet ports

slLibNetworkTable

Table of network interfaces

slLibNetworkEntry

Network interface entry

slLibNetworkIndex

Index into the table

slLibNetworkInterfaceName

Interface name used by the library software

slLibNetworkIpAddr

IP address of library

slLibNetworkGateway

Internet gateway of library network

slLibNetworkEthAddr

Physical 48 bit Ethernet address of library

slLibNetworkName

Host name of library network

slLibNetworkNetmask

Internet address netmask of library network

slLibNetworkDhcpEnabled

DHCP IP address /name client lookup service status (NA)

slLibNetworkDomainName

Network domain name of library network

slLibNetworkPrimaryDNS

Primary DNS server of library network

slLibNetworkSecondaryDNS

Secondary DNS server of library network

slLibNetworkRXPackets

Amount of packets received

slLibNetworkTXPackets

Amount of packets transmitted

slLibNetworkErrors

Amount of errors on this interface

slLibNetworkDropped

Amount of dropped packets on this interface

slLibNetworkOverruns

Amount of overrun packets on this interface

slLibNetworkFrame

Amount of frame packets on this interface

slLibNetworkCollisions

Amount of collisions on this interface

Library — State Objects

Library — State OID

Description

slLibLSMCount

LSM count

slLibLSMStateTable

A table LSM states

slLibLSMStateEntry

Entry of an LSM state

slLibLSMStateIndex

Index of LSM state

slLibLSMStatus

LSM operational state reported as a string (for example, offline, online, or offline pending) — a hardware-based state and derived from robot state

slLibLSMStatusEnum

LSM operational state, reported as an enumeration (online =0, offline =1, offlinePending =2)

Library — Statistics Objects

Library — Statistics OID

Description

slLibStatsNumBoots

Amount of library initializations

slLibStatsNumDoorOpens

Amount of occurrences when the service door has been opened

slLibStatsNumGetRetries

Total of get retries

slLibStatsNumGetFails

Total of get failures

slLibStatsNumPutRetries

Total of put retries

slLibStatsNumPutFails

Total of put failures

slLibStatsNumLabelRetries

Total of label read retries

slLibStatsNumLabelFails

Total of label read failures

slLibStatsNumTargetRetries

Total of target read retries

slLibStatsNumTargetFails

Total of target read failures

slLibStatsNumMoves

Total of cartridge moves

slLibStatsNumMounts

Total of mounts

slLibStatsNumTargetReads

Total of target reads

slLibStatsNumEmptyReads

Total of empty cell reads

slLibStatsNumLabelReads

Total of label reads

slLibStatsGetTotals

Sum of all Get operations of individual robots

slLibStatsPutTotals

Sum of all Put operations of individual robots

slLibStatsCumMachUptime

Cumulative machine up time in seconds

slLibStatsUpTimeSinceLastBoot

In seconds

Library — Version Objects

Library — Version OID

Description

slLibVersionFirmRev

Embedded firmware revision of library, per engineering change (EC) field releases

slLibVersionFirmDate

Embedded firmware build date of library

slLibVersionBootRev

Boot software/OS version of library

slLibVersionHardware

Controller hardware version of library

Media Validation Objects

Media Validation OID

Description

slMVDriveCount

Amount of drives currently assigned to the media validation pool

slMVDriveTable

A table of media validation drives

slMVDriveEntry

A media validation tape drive

slMVIndex

Integer index into the media validation drive table

slMVDrivePhysicalAddressStr

Physical address of drive assigned to media validation pool

slMVDriveType

Make and manufacturer of drive assigned to media validation pool

slMVDriveSerialNum

Electronic serial number of drive assigned to media validation pool

slMVDriveState

State of drive assigned to media validation pool (includes empty, loaded, needs cleaning)

slMVDriveCodeVer

Firmware or software of drive assigned to media validation pool

slMVDriveCellStatusStr

Status of the cell of the drive assigned to media validation pool

slMVDriveCellContentLabel

Label of the cartridge in the drive assigned to media validation pool (0 if empty, ?????? if unreadable)

slMVReservationId

0 indicates the drive assigned to media validation pool is available for use

slMVTapeVolserLabelStr

Physical address of drive assigned to media validation pool

slMVTypeEnum

Type of validation applied to cartridge (0 = no validation, 1 = basic verify, 2 = complete verify from beginning of tape, 3 = complete verify resume, 4 = complete verify divbot, 5 = complete verify divresume, 6 = standard verify, 7 = rebuild MIR, 8 = stop)

slMVOriginatorStr

Test initiator of media validation

slMVStatusStr

Status of media validation test

slMVCompletionStatusStr

Percentage that media validation is completed or that validation has been stopped

slMVErrorCodeStr

Error code for media validation

Pass-Thru Port (PTP) Objects

PTP OID

Description

slPtpCount

Amount of pass-through ports in the library

slPtpTable

Table of pass-thru ports

slPtpEntry

Pass-thru port

slPtpIndex

Integer index into the PTP table

slPtpPhysicalAddressStr

PTP device address

slPtpSerialNum

Serial number of PTP

slPtpState

State of the PTP (online, offline)

slPtpFaultLED

Fault LED state of PTP

slPtpStatusEnum

PTP operational state reported as an enumeration

slPtpCodeVer

Code version of PTP

slPtpVersion

Hardware version of PTP

slPtpFirmwareVer

Firmware version of PTP

slPtpMoveRetries

Amount of move retries performed by PTP

slPtpMoveFails

Number of move Fails performed by the Pass-thru Port

slPtpMoveTotals

Number total moves performed by the Pass-thru Port

Power Supply Objects

Power Supply OID

Description

slPowerSupplyCount

Amount of power supplies installed in the library

slPowerSupplyTable

Table of the library power supplies

slPowerSupplyEntry

Power supply

slPowerSupplyIndex

Integer index into the power supply table

slPowerSupplyName

Name of the power supply

slPowerSupplyInstalled

Indicates if the supply is installed (2) or not (1)

slPowerSupplyOperational

Indicates if the supply is OK (2) (meaningless if power supply not installed)

Redundant Electronics Objects

Redundant Electronics OID

Description

slAgentHAState

State of RE controller (simplex =0, duplex/switchable =1)

slAgentHAId

Identifier of RE controller (active =0, standby =1)

slAgentHaSlot

Slot of RE controller (sideA =0, sideB =1)

slAgentHaAlternateIp

IP address of alternate RE controller

Robot Objects

Robot OID

Description

slRobotCount

Amount of robot mechanisms

slRobotTable

A table of robots

slRobotEntry

Robot

slRobotIndex

Robot index

slRobotPhysicalAddressStr

Physical address string of robot

slRobotPosition

Physical position of the robot (continued to be defined for backward compatibility with robot table)

slRobotHandCartStatus

State of the robot hand regarding a cartridge (cartridge =1, no cartridge =0)

slRobotSerialNum

Card serial number of robot

slRobotState

Sate of the robot (such as empty, loaded, moving)

slRobotFaultLED

Fault LED stats of robot (off =0, on =1)

slRobotStatusEnum

Operational status of robot in enumerated form

slRobotCodeVer

Code version of robot

slRobotVersion

Hardware version of robot

slRobotFirmwareVer

Firmware version of robot

slRobotGetRetries

Number of mount retries performed by robot

slRobotPutRetries

Number of dismount retries performed by robot

slRobotGetFails

Amount of Get fails for robot

slRobotPutFails

Amount of Put fails for robot

slRobotGetTotals

Sum of all Get operations from robots

slRobotPutTotals

Sum of all Put operations from robots

Safety Door Objects

Safety Door OID

Description

slSafetyDoorCenterCount

The number of times the safety door has returned to the center (home) position

slSafetyDoorRetries

Amount of total safety door retries

slSafetyDoorIPLs

Amount of IPLs performed by the safety door

Tape Cartridge Objects

Tape Cartridge OID

Description

slTapeCount

Amount of the cartridges in the inventory table

slTapeTable

Table of data cartridges (tapes) in the library

slTapeEntry

Cartridge

slTapeIndex

Integer index into the inventory table

slTapeLabel

Cartridge label

slTapeType

Cartridge type (text string based on the enumerated domain and type values that are derived from the volser label)

slTapeLocationElementID

Element ID or translated logical HLI address of the tape cartridge

slTapeHostAccessible

Indication of host accessible status

slTapePhysicalAddressStr

Physical address string of cartridge

slTapeLogicalAddressStr

Logical address of cartridge

slTapePartition

Partition ID of cartridge

slTapePartitionType

Partition type of cartridge

Temperature Sensor Objects

Temperature Sensor OID

Description

slTempSensorCount

Amount of temperature sensors in the library

slTempSensorTable

Table of the library's temperature sensors

slTempSensorEntry

Temperature sensor

slTempSensorIndex

Integer index into the temperature sensor table

slTempSensorName

Name of the temperature sensor

slTempSensorCurrentTemp

Current /present temperature reading

slTempSensorHighTemp

Storage area peak temp since last machine boot

slTempSensorWarnThreshold

Temperature threshold for automated warning

slTempSensorFailThreshold

Temperature threshold for automated library shutdown

Test Trap Generation Objects

Test Trap Generation OID

Description

slAgentTrapTestLevel

Set to a trap level to generate a trap test for that level. When this is read, the last written value is returned. If a trap level is not implemented, an error will be returned when writing.

slAgentTrapTestCount

Amount of times slAgentTrapTestLevel has been written to.

Trap — Automatic Service Request (ASR) Objects

Trap — ASR OID

Description

slTrapAsrSuspectCount

Number of FRU call-outs to follow in this trap (max 5)

slTrapAsrSuspectTable

Table of diagnosted fault suspects

slTrapAsrSuspectEntry

Suspect table entry

slTrapAsrSuspectIndex

Sequence number for suspect FRUs

slTrapAsrSuspectFaultCertainty

Percentage of likelihood that the component is the source of the problem (object has a value of 0 if the system does not support this information)

slTrapAsrSuspectDevice Address

Location of the suspect FRU (either a 5-tuple or 4-tuple physical address

slTrapAsrSuspectFruName

Name of the suspect FRU

slTrapAsrSuspectFruChassisId

Text string containing serial number of chassis (unambiguous identification of system when combined with slTrapProductName)

slTrapAsrSuspectFruManufacturer

Name of manufacturer of this FRU /CRU

slTrapAsrSuspectFruPn

Replacement part number used to order this FRU /CRU

slTrapAsrSuspectFruSn

Serial (entitlement) number for this FRU /CRU

slTrapAsrSuspectFruRevision

Revision level of this FRU /CRU

slTrapAsrSuspectFruReserved

Placeholder for future content

slTrapAsrSuspectFruStatus

Status of FRU /CRU

Trap — Configuration Objects

Trap — Configuration OID

Description

slTrapConfigLibrarySerialNumber

Frame serial number of the library

slTrapConfigDeviceId

Device's FRUI ID, needed for high availability

slTrapConfigDeviceTime

Device's date and time in UTC standard format

slTrapConfigDeviceAddress

Device address of the component associated with the log entry.

slTrapConfigDeviceUserName

User name on the device that identifies the access level that originated the activity

slTrapConfigDeviceInterfaceName

Name representing the interface on the device that was used to request the activity

slTrapConfigDeviceActivity

Short text name representing the device activity being performed

slTrapConfigDeviceRequestId

Device request ID associated with the activity with this trap

slTrapConfigDeviceSeverity

Device log severity

slTrapConfigDeviceResultCode

Device result code

slTrapConfigPropertyName

Device property name that is being configured

slTrapConfigNewPropertyValue

New value that has been changed (only success is reported)

slTrapConfigNewPropertyEffective

Condition when the new property value will be effective

Trap — Device Objects

Trap — Device OID

Description

slTrapLibrarySerialNumber

Frame serial number of the library

slTrapDeviceId

FRU ID of device (generally component model +serial number)

slTrapDeviceTime

Device's date and time in UTC standard format

slTrapDeviceAddress

Device address of the component associated with the log entry.

slTrapDeviceUserName

User name on the device that identifies the access level that originated the activity

slTrapDeviceInterfaceName

Name representing the interface on the device that was used to request the activity

slTrapDeviceActivity

Short text name representing the device activity being performed

slTrapDeviceRequestId

Device request ID associated with the activity with this trap

slTrapDeviceSeverity

Device log severity

slTrapDeviceResultCode

Device result code

slTrapDeviceFreeFormText

Freeform text area, usually from subsystems that led to log entry

Trap — Service Event Objects

Trap — Service Event OID

Description

slTrapSvcEventTime

Time stamp of when the service event occurred

slTrapSvcLibProductManufacturer

Product manufacturer of library

slTrapSvcLibProductName

Product name of library

slTrapSvcLibProductSn

Product serial (entitlement) number of library

slTrapSvcLibStatus

Condition of the overall system at the time of the event (normal, degraded, not-operational)

slTrapSvcLibEntity

Software component (diagnostic entity) that generated this fault event

slTrapSvcEventId

Underlying local library event ID that was the catalyst behind this service event

slTrapSvcFaultEventUUID

Universal unique identifier that was assigned to this fault (will have a value of NULL if the system does not support this information)

slTrapSvcFaultEventType

Fault event type based on servicing importance

slTrapSvcFaultEventCount

Amount of equivalent fault events since last boot

slTrapSvcFaultEventDescription

Textual description of the fault event

slTrapSvcDeviceEventSeverity

Fault severity of device or system

slTrapSvcDeviceEventActivity

Short text name representing what activity the device was last commanded to perform

slTrapSvcDeviceEventOpCode

Device operational code, indicating state of FRU/CRU

slTrapSvcDeviceEventResultCode

The device result code based upon last command completed

slTrapSvcServiceData

Descriptive text string of this particular service event

slTrapSvcLocalization

Localization string for current service event

Trap — Test and Heartbeat Objects

Trap — Test and Heartbeat OID

Description

slTrapCount

Amount of traps generated since last boot

slTrapLibBootDate

Date & time when the agent initialized

slTrapLibDateString

Date and time of library in format: YYYY:MM:DDTHH:MM:SS

slTrapLibSerialNumber

Serial number of library frame

slTrapLibTopLevelCondition

Overall condition of the library (normal, degraded, not-operational)

slTrapHaState

State of RE controller (simplex=0, duplex/switchable=1)

slTrapHaId

Identifier of RE controller (active=0, standby=1)

slTrapHaSlot

Slot of RE controller (sideA=0, sideB=1)

slTrapHaAlternateIp

IP address of alternate RE controller

Turntable Objects

Turntable OID

Description

slTurntableCount

Count of the turntables in the turntable table

slTurntableTable

A table of turntables

slTurntableEntry

A turntable entry

slTurntableIndex

A turntable index

slTurntablePhysicalAddressStr

Physical address string of a turntable

slTurntablePosition

Physical LSM position of the turntable (0=left, 1=right)

slTurntableHandCartStatus

The turntable's hand state (cartridge=1, no cartridge=0)

slTurntableSerialNum

Serial number of the turntable

slTurntableState

State of the turntable (idled, moving, in-op, and so forth)

slTurntableFaultLED

Fault LED state

slTurntableStatusEnum

Operational status of the turntable, in enumerated form

slTurntableCodeVer

Code version of the turntable

slTurntableVersion

Hardware version of the turntable

slTurntableFirmwareVer

Firmware version of the turntable

slTurntablesRotations

Rotation count of the turntable

slTurntablesRotationRetries

Number of rotation retries performed by the turntable

slTurntablesRotationFails

Number of rotation failures performed by the turntable

slTurntablesIPLs

Number of IPLs performed by the turntable

3 SNMP Traps

An SNMP trap is assigned a number that corresponds to its type. An embedded SNMP agent can distinguish and filter trap recipients based on the trap numbers for which they are registered.

Generic traps (1-10) are generated from log entries. Event-based traps (11 and higher) are generated from library events and contain object IDs (OIDs).

- Generic Traps from Log Entries (1-10)

- Event-Based Traps (11-102)

Generic Traps from Log Entries (1-10)

Generic traps contain:

- Severity codes, for indications such as an error or a warning

- Result codes, such as 0000 =success, or 5010 =robotic position error

- Activity string, such as HLI move or CLI version print

- A descriptive text string

- Date and time

- Other information, such as:

- Device address associated with the event

- User name associated with the activity

- Interface-specific request identifier

Generic Trap

Sent When

SL150

SL3000

SL8500

slTrapError (1)

Errors are posted in the log

x

x

x

slTrapWarning (2)

Warnings are posted in the log

x

x

x

slTrapInformation (3)

Information is posted in the log

x

x

x

slTrapConfiguration (4)

Changes are made in a system property, such as network IP or Fibre mode

x

slTrapError (1)

Reports a device condition critical to library operation.

MIB Objects:

- slTrapLibrarySerialNumber

- slTrapDeviceId

- slTrapDeviceTime

- slTrapDeviceAddress

- slTrapDeviceUserName

- slTrapDeviceInterfaceName

- slTrapDeviceActivity

- slTrapDeviceRequestId

- slTrapDeviceSeverity

- slTrapDeviceResultCode

- slTrapDeviceFreeFormText

slTrapWarning (2)

Reports a device condition which may need attention, such as a recoverable device failure that places the system in a degraded mode.

MIB Objects:

- slTrapLibrarySerialNumber

- slTrapDeviceId

- slTrapDeviceTime

- slTrapDeviceAddress

- slTrapDeviceUserName

- slTrapDeviceInterfaceName

- slTrapDeviceActivity

- slTrapDeviceRequestId

- slTrapDeviceSeverity

- slTrapDeviceResultCode

- slTrapDeviceFreeFormText

slTrapInformation (3)

Reports information for normal activity monitoring.

MIB Objects:

- slTrapLibrarySerialNumber

- slTrapDeviceId

- slTrapDeviceTime

- slTrapDeviceAddres

- slTrapDeviceUserName

- slTrapDeviceInterfaceName

- slTrapDeviceActivity

- slTrapDeviceRequestId

- slTrapDeviceSeverity

- slTrapDeviceResultCode

- slTrapDeviceFreeFormText

slTrapConfiguration (4)

Reports changes made to a system property or configuration, such as an IP address.

MIB Objects:

- slTrapLibrarySerialNumber

- slTrapDeviceId

- slTrapDeviceTime

- slTrapDeviceAddress

- slTrapDeviceUserName

- slTrapDeviceInterfaceName

- slTrapDeviceActivity

- slTrapDeviceRequestId

- slTrapDeviceSeverity

- slTrapDeviceResultCode

- slTrapConfigPropertyName,

- slTrapConfigNewPropertyValue

- slTrapConfigNewPropertyEffective

Event-Based Traps (11-102)

Messages for traps 11-102 contain information specific to the agent, device, or media. Consult each trap within the library's MIB for the specific data objects returned.

Event-based traps are divided into the following groups:

- Agent-specific: 11-20

- Device-specific: 21-100

- Library status: 21-27

- Drive status: 41-45

- Cartridge access port (CAP) status: 61-65

- Pass-thru port (PTP) status: 81-85

- Media-specific: 101 and above

Trap

Sent When

SL150

SL3000

SL8500

slTrapAgentStart (11)

An SNMP agent has started.

x

x

x

slTrapAgentTest (13)

slAgentTrapTestLevel OID is written with a 13.

x

x

x

slTrapAgentHeartbeatA (14)

Heartbeat is at frequency A (quick rate).

x

x

x

slTrapAgentHeartbeatB (15)

Heartbeat is at frequency B (slow rate).

x

x

x

slTrapLibStatusGood (21)

Library has changed to normal mode.

x

x

x

slTrapLibStatusCheck (25)

Library has changed from normal mode.

x

x

x

slTrapEnvHdwCheck (27)

A device in the library has had an environmental check.

x

x

x

slTrapDrvStatusGood (41)

Drive has changed to a normal mode.

x

x

x

slTrapDrvStatusCheck (45)

Drive has changed from normal mode.

x

x

x

slTrapCapStatusGood (61)

CAP has changed to a normal mode.

x

x

x

slTrapCapStatusOpen (63)

CAP state has changed to open.

x

x

x

slTrapCapStatusCheck (65)

CAP status has changed from normal mode.

x

x

x

slTrapPtpStatusGood (81)

PTP status has changed to good (normal mode)

x

slTrapPtpStatusCheck (85)

PTP status has changed from a normal mode.

x

slTrapTbiEvent (100)

Proprietary

slTrapSvcEvent (101)

Proprietary

slTrapAsrEvent (102)

Proprietary

slTrapAgentStart (11)

Sent when the agent starts.

MIB Objects:

- slAgentBootDate

- slAgentLibStatusAtStartup

- slAgentHaState

- slAgentHaId

- slAgentHASlot

- slAgentHaAlternateIp

- slControllerFru

- slLibSerialNumber

slTrapAgentTest (13)

Sent when slAgentTrapTestLevel OID is written with a 13.

MIB Objects:

- slTrapCount

- slTrapLibBootDate

- slTrapLibDateString

- slTrapLibSerialNumber

- slTrapLibTopLevelCondition

- slTrapHaState

- slTrapHaId

- slTrapHaSlot

- slTrapHaAlternateIp

slTrapAgentHeartbeatA (14)

Sent at heartbeat frequency A (quick rate).

MIB Objects:

- slTrapCount

- slTrapLibBootDate

- slTrapLibDateString

- slTrapLibSerialNumber

- slTrapLibTopLevelCondition

- slTrapHaState

- slTrapHaId

- slTrapHaSlot

- slTrapHaAlternateIp

slTrapAgentHeartbeatB (15)

Sent at heartbeat frequency B (slow rate).

MIB Objects:

- slTrapCount

- slTrapLibBootDate

- slTrapLibDateString

- slTrapLibSerialNumber

- slTrapLibTopLevelCondition

- slTrapHaState

- slTrapHaId

- slTrapHaSlot

- slTrapHaAlternateIp

slTrapLibStatusGood (21)

Sent when the library status changes to good (normal mode).

MIB Objects:

- slLibraryTopLevelCondition

- slLibStkBaseModel

- slLibSerialNumber

slTrapLibStatusCheck (25)

Sent when the library condition changes from a normal mode, such as degraded or not-operative.

MIB Objects:

- slLibraryTopLevelCondition

- slLibStkBaseModel

- slLibSerialNumber

slTrapEnvHdwCheck (27)

Sent when the library environment or hardware condition changes.

MIB Objects:

- slTrapLibrarySerialNumber

- slTrapDeviceId

- slTrapDeviceTime

- slTrapDeviceAddress

- slTrapDeviceUserName

- slTrapDeviceInterfaceName

- slTrapDeviceActivity

- slTrapDeviceRequestId

- slTrapDeviceSeverity

- slTrapDeviceResultCode

- slTrapDeviceFreeFormText

slTrapDrvStatusGood (41)

Sent when a drive status changes to good (normal mode).

MIB Objects:

- slLibSerialNumber

- slDriveState

- slDrivePhysicalAddressStr

- slDriveType

- slDriveVendor

- slDriveSerialNum

slTrapDrvStatusCheck (45)

Sent when a drive status changes from a normal mode to a check condition, such as error, warning, or unknown.

MIB Objects:

- slLibSerialNumber

- slDriveState

- slDrivePhysicalAddressStr

- slDriveType

- slDriveVendor

- slDriveSerialNum

slTrapCapStatusGood (61)

Sent when a CAP status changes to a normal mode.

MIB Objects:

- slLibSerialNumber

- slCapState

- slCapPhysicalAddressStr

slTrapCapStatusOpen (63)

Sent when a CAP status changes to Open.

MIB Objects:

- slLibSerialNumber

- slCapState

- slCapAddress

slTrapCapStatusCheck (65)

Sent when a CAP status changes from a normal mode, such as error, warning, or unknown.

MIB Objects:

- slLibSerialNumber

- slCapState

- slCapPhysicalAddressStr

slTrapPtpStatusGood (81)

Sent when a PTP status changes to good (normal mode).

MIB Objects:

- slLibSerialNumber

- slPtpState

- slPtpPhysicalAddressStr

slTrapPtpStatusCheck (85)

Sent when a PTP status changes from a normal mode, such as an error, warning, or unknown.

MIB Objects:

- slLibSerialNumber

- slPtpState

- slPtpPhysicalAddressStr

4 Configuring SNMP with the CLI

You use the CLI to configure SNMP on SL3000 and SL8500 libraries. To configure SNMP on the SL150 library, see the SL150 User's Guide. To configure SNMP for STA, see the STA Installation and Configuration Guide.

- Configuration Process

- Variable Definitions

- Managing Ports

- Managing SNMP Users

- Managing Trap Recipients

- Configuring Service Information

Configuration Process

Use the following process for general library SNMP configuration.

1. Obtain the IP address of the host that will receive traps.

2. Enable library ports to use SNMP (see "Managing Ports").

3. Obtain or create an SNMP user name (see "Managing SNMP Users").

4. Configure trap recipients (see "Managing Trap Recipients").

5. Configure service information (see "Configuring Service Information").

Variable Definitions

Listed CLI commands use the following variables. Enclose some variables in single quotes, as indicated in the command syntax and examples.

Variable

Definition

trapLevelString

Specified trap levels. Can be single digit or several digits separated by commas.

hostAddr

IP address of the host. Cannot be the DNS name.

userName
trapUserName

Name assigned to the SNMP user. All libraries monitored by a single server must have the same v3 user name. Oracle recommends that you create a new, unique user for this purpose.

auth_protocol

MD5 (Message Digest 5) or SHA (Secure Hash Algorithm) authentication protocol for users and hosts receiving traps.

authPassPhrase

Authorization password. Must be at least eight characters in length and cannot contain commas, semicolons, or equal signs.

privacy_protocol

DES or AES. Privacy protocol type, Data Encryption Standard (DES) or Advanced Encryption Standard (AES).

privPassPhrase

Encryption password that is the private key for encryption. Must be at least eight characters in length, and cannot contain commas, semicolons, or equal signs.

engineIdString

A string of hexadecimal characters (31 maximum), preceded with 0x. The authoritative engine ID is from the SNMP agent that sends the traps (such as the library). Required on SNMPv3 traps.

communityString

Agent community string. Can contain a maximum of 31 alphanumeric characters (a-z, A-Z, 0-9). Special characters are not allowed. For SNMPv3 there are no community strings.
Use of the names public or private for the communityString is strongly discouraged for security reasons. These names are commonly used and easily guessed by a potential attacker.

index

Index number of either the SNMP user name or trap recipient, depending on the command.

portID

port2A or port2B. These are the public interface ports.

contactString

Name of contact for service

streetAddrString

Street address

cityString

City

stateString

State

countryString

Country

zipString

ZIP

descriptionString

Any description you want to enter

phoneString

Phone number for service

Managing Ports

By default, the SNMP agent is disabled. You enable or disable SNMP for a specified library port (2B = standard, public port and 2A = optional, redundant port).

CLI Commands to Manage Ports

Description

snmp ports print

Shows the SNMP port status.

snmp enable portID

Enables SNMP on a port.
Example: > snmp enable port2B

snmp disable portID

Disables SNMP on a port.
Example: > snmp disable port2A

Managing SNMP Users

You can specify a maximum of 20 SNMP users.

Note:
You should not remove an existing SNMP v2c public user without consulting Oracle support. In some cases, an SNMP v2c public user is required for Oracle Service Delivery Platform (SDP).

CLI Commands to Manage SNMP Users

Description

snmp listUsers

Lists SNMP users.

snmp addUser version v3 name 'userName' auth auth_protocol authPass 'authPassPhrase' priv privacy_protocol privPass 'privPassPhrase'

For SNMP v3. Adds an SNMP user.
Example: > snmp addUser version v3 name 'TESTsnmp' auth SHA authPass 'authpwd1' priv DES privPass 'privpwd1'

snmp addUser version v2c community communityString

For SNMP v2c. Adds an SNMP user.
Example: > snmp addUser version v2c community public

Use of the names public or private for the communityString is strongly discouraged for security reasons. These names are commonly used and easily guessed by a potential attacker.

snmp deleteUser id index

Deletes a user by index number. Use snmp listUsers to obtain the index number.
Example: > snmp deleteUser id 4

snmp deleteUser version v3 name 'userName'

For SNMP v3. Deletes a user by user name.
Example: > snmp deleteUser version v3 name 'TESTsnmp'

snmp deleteUser version v2c community communityString

For SNMP v2c. Deletes a user by community name.

Managing Trap Recipients

You can specify up to 20 trap recipients with no duplicate entries. Specified recipients will receive trap notifications from the library.

CLI Commands to Manage Trap Recipients

Description

snmp engineId print

Shows the library engine ID.

snmp listTrapRecipients

Lists trap recipients.

snmp addTrapRecipient trapLevel trapLevelString host hostAddr version v3 name 'trapUserName' auth auth_protocol authPass 'authPassPhrase' priv privacy_protocol privPass 'privPassPhrase' engineId engineIdString

For SNMP v3. Adds a trap recipient.
Example: > snmp addTrapRecipient trapLevel 1,2,3,4,11,13,14,21,25,27,41,45,61,63,65,81,85,100 host 192.0.2.20 version v3 name 'TESTsnmp' auth SHA authPass 'authpwd1' priv DES privPass 'privpwd1' engineId 0x80001f880430000000000000000000

snmp addTrapRecipient trapLevel trapLevelString host hostAddr version v2c community communityString

For SNMP v2c. Adds a trap recipient.
Example: > snmp addTrapRecipient trapLevel 1,2,3,4,11,13,14,21,25,27,41,45,61,63,65,81,85,100 host 192.0.2.20 version v2c community public

Use of the names public or private for the communityString is strongly discouraged for security reasons. These names are commonly used and easily guessed by a potential attacker.

snmp deleteTrapRecipient id index

Deletes a trap recipient by index number. Use snmp listTrapRecipients to obtain the index number.
Example: > snmp deleteTrapRecipient id 3

snmp deleteTrapRecipient host hostAddr version v3 name 'trapUserName'

For SNMP v3. Deletes a trap recipient by host.
Example: > snmp deleteTrapRecipient host 192.0.2.20 version v3 name 'TESTsnmp'

snmp deleteTrapRecipient host hostAddr version v2c community communityString

For SNMP v2c. Deletes a trap recipient by host.

Configuring Service Information

Enter up to 80 characters for any or all of the variables. Enclose all variables in single quotes, as indicated in the command syntax and examples.

CLI Commands to Configure Service Information

Description

config serviceInfo print

View service information.

config serviceInfo set contact 'contactString' streetAddr 'streetAddrString' city 'cityString' state 'stateString' country 'countryString' zip 'zipString' description 'descriptionString' phone 'phoneString'

Modify service information.
Example: > config serviceInfo set contact 'Justin Case' streetAddr '1600 Pennsylvania Ave' city 'Washington' state 'DC' country 'USA' zip '20500' description 'None' phone '(123) 456-7890'

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2018, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Pre-General Availability Draft Documentation Notice

If this document is in public or private pre-General Availability status:

This documentation is in pre-General Availability status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Private Pre-General Availability Draft Documentation Notice

If this document is in private pre-General Availability status:

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your pre-General Availability trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.