Skip Headers

StorageTek SL150/SL500/SL3000/SL8500 SNMP Reference Guide E35317-03 |
| Contents | Index

Previous | Next |

# 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-0 slTrapCapStatusCheck | 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