C H A P T E R 6 - Platform-Specific Information

C H A P T E R 6

Platform-Specific Information

The chapter contains the following sections:

Containment Hierarchy

sunPlat Class Definitions

Logical and Log Table Population

For other related documentation see Related Documentation on page xv

Containment Hierarchy

The agent constructs a containment hierarchy for the discovered managed objects based both on the entPhysicalName of the component discovered and knowledge of how the components are related. For most objects, the location can be identified from entPhysicalName, which is typically of the form x/y/z where x, y and z identify other components within the system that form a hierarchy. In such a case sunPlatEquipmentLocationName would be x/y.

To provide a complete representation of the physical relationships, the agent applies the following rules to override the behavior described above:

Sun FireV210, V215, V240, V245 and V250 Systems

All memory banks are contained by the motherboard.

The CPU temperature and voltage sensors are contained by the processor.

The CPU fans are contained by the processor.

All power supply indicators and sensors are contained by the power supply module.

All SCSI disks and tape drives attached to the SCSI port on the chassis are contained by that SCSI port.

Drives external to the chassis connected to a PCI card are contained within the object representing the PCI slot in which the card is inserted.

The Sun Fire V250 system configuration card slot is contained within the system configuration card reader.

Sun Fire V440/V445 Systems

The CPU and memory module slots, PCI slots, and system controller are contained in the system board.

The CPU and memory banks are contained in the CPU module.

All power supply indicators and sensors are contained by the power supply module.

All SCSI disks and tape drives attached to the SCSI port on the chassis are contained by that SCSI port.

Netra 210/240 System

All memory banks are contained by the motherboard.

The CPU temperature and voltage sensors are contained by the processor.

All power supply indicators and sensors are contained by the power supply module.

All SCSI disks and tape drives attached to the SCSI port on the chassis are contained by that SCSI port.

Drives external to the chassis connected to a PCI card are contained within the object representing the PCI slot in which the card is inserted.

Netra 440 System

The CPU/memory module slots, PCI slots, and system controller slot are contained in the system board.

The CPU and memory banks are contained in the CPU/Memory module.

All power supply indicators and sensors are contained by the power supply module.

All SCSI disks and tape drives attached to the SCSI port on the chassis are contained by that SCSI port.

Drives external to the chassis connected to a PCI card are contained within the object representing the PCI slot in which the card is inserted.

Sun Fire V1280/E2900 and Netra 1280/1290 Systems

The current agent version provides fault monitoring for the power supplies and fans. When faults are detected, one or more sunPlatEquipmentAlarm or sunPlatEnvironmentalAlarm traps are issued.

Main system fans are contained in the fan tray module.

PCI card fans are contained within the I/O Assembly module.

Power supplies, fan tray, and I/O assembly are contained within the chassis.

sunPlat Class Definitions

This section contains platform-specific information relating to class definitions and attributes. For further information, see P A R T II - Technical Description and Functionality.

Equipment

sunPlatEquipmentAdministrativeState

The sunPlatEquipmentAdministrativeState is read-only and reports unlocked(2), except in the case of network interfaces for which it reports locked(1) until the interface has been appropriately configured.

sunPlatEquipmentUnknownStatus

For all slots, bays, and PCI cards, the precise operation state cannot be determined from available sensors or be derived from other components. Therefore, these all report sunPlatEquipmentUnknownStatus as true(1).

sunPlatEquipmentLocationName

For all objects this provides a string of the form:

<serial number>/<hostname>/<NAC Name>

where <serial number> is the serial number of the chassis. The <NAC Name> provides a unique name for each hardware component.

sunPlatEquipmentHolderPowered

Only read accesses are supported for this object.

Replaceable and Hotswappable Components

The following attributes are used to indicate a replaceable or hot-swappable component:

sunPlatCircuitPackReplaceable

sunPlatCircuitPackHotSwappable

isFRU

A component is replaceable if it can be removed and replaced with a physically different component.

A component is hotswappable if the power can be on when the component is removed or inserted. All hotswappable components are replaceable.

A component is a Field Replaceable Unit (FRU) if it is an identifiable part that can be obtained and replaced in the field.

Binary Sensors

Changes in binary sensors that result in sunPlatBinarySensorCurrent not taking the same value as that specified by sunPlatBinarySensorExpected generate an alarm with a sunPlatAlarmPerceivedSeverity of major(3). For example, when unplugging a cable from a power supply on the Sun Fire V240, an alarm is sent with a sunPlatAlarmPerceivedSeverity of major(3) and the value of sunPlatEquipmentAlarmStatus is set to major(2).

Numeric Sensors

TABLE 6-1 shows the mappings that exist between the configured threshold, the severity reported in the alarm (sunPlatAlarmPerceivedSeverity) and the severity (sunPlatEquipmentAlarmStatus) recorded against the related object for all numeric sensors.

TABLE 6-1 Numeric Sensor Mapping
Threshold	sunPlatAlarmPerceivedSeverity	sunPlatEquipmentAlarmStatus
`lowerThresholdNonCritical(0)`	`warning(5)`	`warning(5)`
`upperThresholdNonCritical(1)`	`warning(5)`	`warning(5)`
`lowerThresholdCritical(2)`	`major(3)`	`major(2)`
`upperThresholdCritical(3)`	`major(3)`	`major(2)`
`lowerThresholdFatal(4)`	`critical(2)`	`critical(1)`
`upperThresholdFatal(5)`	`critical(2)`	`critical(1)`

For numeric sensors, the following objects are not instrumented:

sunPlatNumericSensorNormalMin

sunPlatNumericSensorNormalMax

sunPlatNumericSensorAccuracy

sunPlatNumericSensorHysteresis

sunPlatNumericSensorThresholdResetAction

Note - sunPlatNumericSensorEnabledThresholds is read only.

Fan Tachometer Thresholds

The only threshold for fan tachometers configured is the lowerThresholdNonCritical(0). When the detected speed of the fan falls below the configured non-critical threshold, an alarm is raised and the sunPlatEquipmentAlarmStatus is assigned a severity of warning(5). As no further thresholds are set, no additional alarms are raised even if the speed of the fan drops further or stops.

Update Intervals

The agent initiates an update of its internal representation of the managed environment every 15 seconds.

Note - For the Sun Fire V1280/E2900 and Netra 1280/1290 systems, this interval is set for 10 seconds.

Logical and Log Table Population

In the current version of the agent, the following tables are not completely populated:

sunPlatWatchdogTable

sunPlatLogTable

For consistency, this table has entries where:

sunPlatLogAdministrativeState is locked(1)

sunPlatLogOperationalState is disabled(1)

RowStatus is notInService(2)

to indicate it is not in use.

sunPlatLogRecordTable

sunPlatLogRecordAdditionalTable

sunPlatLogRecordAlarmTable

sunPlatLogRecordChangeTable

sunPlatLogicalTable

sunPlatUnitaryComputerSystemTable

sunPlatInitialLoadInfoTable

Additionally, for the Sun Fire V1280/E2900 and Netra 1280/1290 servers, the following tables are not completely populated:

sunPlatEquipmentHolderTable

sunPlatCircuitPackTable