3 SNMP Traps

This chapter lists the supported SNMP traps (also known as events or notifications) and the supporting data for the StorageTek Modular Libraries.

To obtain the information provided by a trap, users must be added to the recipients list.

Trap Numbering

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 are numbered 1-10. Trap numbers 11 and higher are specific, and contain distinct Object IDs (OIDs) within their messages. They are generated from events within the library rather than the log entries.

Generic Traps from Log Entries

Generic traps are generated from log entries and 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

Table 3-1 lists the generic traps available for the library.

Table 3-1 Generic Traps

Trap	#	Sent When:	SL150	SL500	SL3000	SL8500
slTrapError	1	Errors are posted in the log	x	x	x	x
slTrapWarning	2	Warnings are posted in the log	x	x	x	x
slTrapInformation	3	Information is posted in the log	x	x	x	x
slTrapConfiguration	4	Changes are made in a system property, such as network IP or Fibre mode	x	x

slTrapError

Reports a device condition critical to library operation. Errors are posted in the log.

Trap Number

1

MIB Objects

• slTrapLibrarySerialNumber

• slTrapDeviceId

• slTrapDeviceTime

• slTrapDeviceAddress

• slTrapDeviceUserName

• slTrapDeviceInterfaceName

• slTrapDeviceActivity

• slTrapDeviceRequestId

• slTrapDeviceSeverity

• slTrapDeviceResultCode

• slTrapDeviceFreeFormText

Example

Device inoperable

Refers to the entire system. Failure of a sub-unit or redundant component is not a Category 1.

slTrapWarning

Reports a device condition which may need attention. Warnings are posted in the log.

Trap Number

2

MIB Objects

• slTrapLibrarySerialNumber

• slTrapDeviceId

• slTrapDeviceTime

• slTrapDeviceAddress

• slTrapDeviceUserName

• slTrapDeviceInterfaceName

• slTrapDeviceActivity

• slTrapDeviceRequestId

• slTrapDeviceSeverity

• slTrapDeviceResultCode

• slTrapDeviceFreeFormText

Example

Device degraded

Refers to recoverable failures that may allow the system to remain in use, but only in a degraded mode.

slTrapInformation

Reports information for activity monitoring. Information is posted in the logs.

Trap Number

3

MIB Objects

• slTrapLibrarySerialNumber

• slTrapDeviceId

• slTrapDeviceTime

• slTrapDeviceAddres

• slTrapDeviceUserName

• slTrapDeviceInterfaceName

• slTrapDeviceActivity

• slTrapDeviceRequestId

• slTrapDeviceSeverity

• slTrapDeviceResultCode

• slTrapDeviceFreeFormText

Example

Device activity

A device has reported activity. This information is used to monitor normal activity and messages.

slTrapConfiguration

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

Trap Number

4

MIB Object Types

• slTrapLibrarySerialNumber

• slTrapDeviceId

• slTrapDeviceTime

• slTrapDeviceAddress

• slTrapDeviceUserName

• slTrapDeviceInterfaceName

• slTrapDeviceActivity

• slTrapDeviceRequestId

• slTrapDeviceSeverity

• slTrapDeviceResultCode

• slTrapConfigPropertyName,

• slTrapConfigNewPropertyValue

• slTrapConfigNewPropertyEffective

Example

Device configuration

A device has reported configuration activity.

Agent-Specific, Event-Based Traps

Specific traps 11 –85 are event-based and have distinct information within their trap messages, depending on the trap level. Consult each trap within the library's MIB for the specific data objects returned.

Specific trap number groups are:

• Agent-specific traps: 11-20

• Device-specific traps: 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 traps: 101 and above

Table 3-2 lists the agent-specific traps available within the library.

Table 3-2 Event-Based Traps

Trap	#	Sent When:	SL150	SL500	SL3000	SL8500
slTrapAgentStart	11	slAgentTrapTestLevel OID is written with a 13	x	x	x	x
slAgentTest	13	An SNMP agent has started.	x	x	x	x
slAgentTestHeartbeatA	14	Heartbeat is at frequency A (quick rate).	x	x	x	x
slAgentTestHeartbeatB	15	Heartbeat is at frequence B (slow rate).	x	x	x	x
slTrapLibStatusGood	21	Library has changed to normal mode.	x	x	x	x
slTrapLibStatusCheck	25	Library has changed from normal mode.	x	x	x	x
slTrapEnvHdwCheck	27	A device in the library has had an environmental check.	x	x	x	x
slTrapDrvStatusGood	41	Drive has changed to a normal mode.	x	x	x	x
slTrapDrvStatusCheck	45	Drive has changed from normal mode.	x	x	x	x
slTrapCapStatusGood	61	CAP has changed to a normal mode.	x	x	x	x
slTrapCapStatusOpen	63	CAP state has changed to open.	x	x	x	x
Figure 3-0slTrapCapStatusCheck	65	CAP status has changed from normal mode.	x	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

Sent when the agent starts.

Trap Number

11

MIB Objects

• slAgentBootDate

• slAgentLibStatusAtStartup

• slAgentHaState

• slAgentHaId

• slAgentHASlot

• slAgentHaAlternateIp

• slControllerFru

• slLibSerialNumber

slAgentTest

Sent when slAgentTrapTestLevel OID is written with a 13.

Trap Number

13

MIB Objects

• slTrapCount

• slTrapLibBootDate

• slTrapLibDateString

• slTrapLibSerialNumber

• slTrapLibTopLevelCondition

• slTrapHaState

• slTrapHaId

• slTrapHaSlot

• slTrapHaAlternateIp

slAgentTestHeartbeatA

Sent when at a heartbeat frequency A (quick rate).

Trap Number

14

MIB Objects

• slTrapCount

• slTrapLibBootDate

• slTrapLibDateString

• slTrapLibSerialNumber

• slTrapLibTopLevelCondition

• slTrapHaState

• slTrapHaId

• slTrapHaSlot

• slTrapHaAlternateIp

slAgentTestHeartbeatB

Sent when at a heartbeat frequency B (slow rate).

Trap Number

15

MIB Objects

• slTrapCount

• slTrapLibBootDate

• slTrapLibDateString

• slTrapLibSerialNumber

• slTrapLibTopLevelCondition

• slTrapHaState

• slTrapHaId

• slTrapHaSlot

• slTrapHaAlternateIp

slTrapLibStatusGood

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

Trap Number

21

MIB Objects

• slLibraryTopLevelCondition

• slLibStkBaseModel

• slLibSerialNumber

slTrapLibStatusCheck

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

Trap Number

25

MIB Objects

• slLibraryTopLevelCondition

• slLibStkBaseModel

• slLibSerialNumber

slTrapEnvHdwCheck

Sent when the library environment or hardware condition changes.

Trap Number

27

MIB Objects

• slTrapLibrarySerialNumber

• slTrapDeviceId

• slTrapDeviceTime

• slTrapDeviceAddress

• slTrapDeviceUserName

• slTrapDeviceInterfaceName

• slTrapDeviceActivity

• slTrapDeviceRequestId

• slTrapDeviceSeverity

• slTrapDeviceResultCode

• slTrapDeviceFreeFormText

slTrapDrvStatusGood

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

Trap Number

41

MIB Objects

• slLibSerialNumber

• slDriveState

• slDrivePhysicalAddressStr

• slDriveType

• slDriveVendor

• slDriveSerialNum

slTrapDrvStatusCheck

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

Trap Number

45

MIB Objects

• slLibSerialNumber

• slDriveState

• slDrivePhysicalAddressStr

• slDriveType

• slDriveVendor

• slDriveSerialNum

slTrapCapStatusGood

Sent when a cartridge access port (CAP) status changes to a normal mode.

Trap Number

61

MIB Objects

• slLibSerialNumber

• slCapState

• slCapPhysicalAddressStr

slTrapCapStatusOpen

Sent when a cartridge access port (CAP) status changes to Open.

Trap Number

63

MIB Objects

• slLibSerialNumber

• slCapState

• slCapAddress

slTrapCapStatusCheck

Sent when a cartridge access port (CAP) status changes from a normal mode, such as error, warning, or unknown.

Trap Number

65

MIB Objects

• slLibSerialNumber

• slCapState

• slCapPhysicalAddressStr

slTrapPtpStatusGood

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

Trap Number

81

MIB Objects

• slLibSerialNumber

• slPtpState

• slPtpPhysicalAddressStr

slTrapPtpStatusCheck

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

Trap Number

85

MIB Objects

• slLibSerialNumber

• slPtpState

• slPtpPhysicalAddressStr