Starfire Agent Modules

This chapter provides specific information about the agent modules contained in the Starfire add-on components:

• Starfire Domain Config Reader (Config-Reader4u1D)
• Starfire Platform Config Reader (Config-Reader4u1P)
• SSP Status module ( sspStatus)

This chapter also provides specific information about how to change rule limits for the Starfire domain Config Reader and Starfire platform Config Reader.

Appendix D of the Sun Management Center 3.5 User's Guide describe the base Sun Management Center modules that monitor various components of your system, including your hardware, operating environment, local applications, and remote systems.

Chapter 10 in the Sun Management Center 3.5 User's Guide provides general information about how to use the Attribute Editor to set alarm limits.

---

Module Properties

The tables in this chapter provide brief descriptions of each property in a module. If a property is monitored by a Sun Management Center rule, the name of that rule is shown in the table. For descriptions of these rules, see Starfire Config Reader Rules.

A field-replaceable property means that the component can be replaced on-site.

A hot-plug property means that the component can be removed from the platform without shutting the system down.

Properties that can be graphed are noted in the property description. Refer to Chapter 9 of the Sun Management Center 3.5 User's Guide for more information about graphing properties.

---

Note - It is not always possible for Sun Management Center software to determine the value for a particular property. When the value is unknown, the property value is displayed as --.

---

---

Starfire Domain Config Reader Module

The Starfire Domain Config Reader module provides the hardware configuration for Starfire domains. During Starfire domain add-on setup, this module is configured for automatic loading into the Starfire domain agent and is displayed under the Browser hardware icon.

Module Refresh Intervals

Sun Management Center agent modules refresh their data at periodic intervals and the browser periodically retrieves the current value of agent data. This combination of periodic refreshes and updates provides a current view of module information from the Details window.

The Starfire domain Config Reader module is refreshed every minute, and the refresh of all module data is driven by the refresh of the System folder. When viewing the module data from the browser, you can request an immediate refresh of the module data. See To Refresh Starfire Domain Config Reader Data for more information.

You can also change the periodic interval at which the module refreshes its data. This periodic interval balances getting timely notification of changes to your system configuration with using system resources to accomplish this periodic refresh. See To Change the Starfire Domain Config Reader Refresh Interval for more information.

To Refresh Starfire Domain Config Reader Data

1. Open the Starfire domain Details window and select the Browser tab.

2. Select any property within the System folder and refresh that data.

This causes the Starfire domain Config Reader module to refresh all its data.

3. If you want to view information not contained in the System folder, select that property in the browser and refresh the data.

This updates the browser with the latest value of that property.

To Change the Starfire Domain Config Reader Refresh Interval

1. Open the Starfire domain Details window and select the Browser tab.

2. Select any property within the System folder and invoke the Attribute Editor.

---

Caution - Do not change the refresh interval to a value less than its default value.

---

3. Select the Refresh tab and change the refresh interval.

Starfire Domain Config Reader Properties

The tables in this section describe each of the visible properties for each Starfire Domain Config Reader object.

System

The following table provides a brief description of the properties for the Starfire Domain Config Reader System (TABLE 6-1):

TABLE 6-1 Starfire Domain Config Reader System

Property	Rule (if any)	Description
Name		"system"
Hostname		Starfire domain host name
Host ID		Host identification number
Operating System		Operating Environment running in the Starfire domain
OS Version		Version of the operating environment running
System Clock (MHz)		Clock frequency in megahertz
Architecture		Machine architecture (SPARC)
Machine Type		Machine type (sun4u)
Platform Type		Platform type (SUNW, Ultra Enterprise 10000)
Last Update		Time the configuration information was last updated
Total Disks		Number of disks present in the system
Total Memory (MB)		Total memory, in megabytes
Total Processors		Number of processors. This includes all processors allocated to the domain, including processors not configured by POST.
Total Tape Devices		Number of tape devices present in the system

Starfire Platform

The following table provides a brief description of the properties for the Starfire Domain Config Reader Platform (TABLE 6-2):

TABLE 6-2 Starfire Domain Config Reader Platform

Property	Rule (if any)	Description
Name		"starfire_platform"
Starfire Platform Name		Name of the Starfire platform of which this Starfire domain is a part
SSP Hostname		Name of the main SSP for the Starfire platform
SSP IP address		IP address of the main SSP for the Starfire platform
Total System Boards		Number of the system boards allocated to this Starfire domain
System Board List		A list of all system boards allocated to this Starfire domain

System Boards

The following table provides a brief description of the properties for Starfire Domain Config Reader System Boards (TABLE 6-3):

TABLE 6-3 Starfire Domain Config Reader System Boards

Property	Rule (if any)	Description
Name		system-board(n) where n is the system board number
System Board		System board number
POST Status	e10kpost	POST status for the entire system board
Memory (MB)		System board memory size in megabytes
Processors		Number of processors on this system board
I/O Adaptors		Number of I/O adaptors on this system board
Field Replaceable		"yes"
Hot Plug		"yes"

System Board ASIC POST Status

The following table provides a brief description of the properties for Starfire Domain Config Reader System Board ASIC POST Status (TABLE 6-4):

TABLE 6-4 Starfire Domain Config Reader System Board ASIC POST Status

Property	Rule (if any)	Description
Name		ASIC(n) where n is the system board number
System Board		System board number
CIC0	e10kpost	POST status for the coherency interface controller 0 ASIC and, more generally, this system board's ability to operate with global address bus 0.
CIC1	e10kpost	POST status for the coherency interface controller 1 ASIC and, more generally, this system board's ability to operate with global address bus 1.
CIC2	e10kpost	POST status for the coherency interface controller 2 ASIC and, more generally, this system board's ability to operate with global address bus 2.
CIC3	e10kpost	POST status for the coherency interface controller 3 ASIC and, more generally, this system board's ability to operate with global address bus 3.
LDPATH0	e10kpost	POST status for the local data router lower 72 bits ASIC and, more generally, this system board's ability to operate with global data bus 0.
LDPATH1	e10kpost	POST status for the local data router upper 72 bits ASIC and, more generally, this system board's ability to operate with global data bus 1.
PC0	e10kpost	POST status for the port controller 0 ASIC
PC1	e10kpost	POST status for the port controller 1 ASIC
PC2	e10kpost	POST status for the port controller 2 ASIC
XDB0	e10kpost	POST status for the data buffer 0 ASIC
XDB1	e10kpost	POST status for the data buffer 1 ASIC
XDB2	e10kpost	POST status for the data buffer 2 ASIC
XDB3	e10kpost	POST status for the data buffer 3 ASIC

Processor Modules

The following table provides a brief description of the properties for Starfire Domain Config Reader Processor Modules (TABLE 6-5):

TABLE 6-5 Starfire Domain Config Reader Processor Modules

Property	Rule (if any)	Description
Name		cpu-unit(n), where n is the Processor ID
Processor Module		n.m where n is the system board number and m is the system board processor module number (0-3)
Processor ID		Processor identifier
POST Status	e10kpost	POST status for this processor
Processor Status	e10kproc	Processor on-line/off-line status
Clock (MHz)		Processor clock frequency in megahertz
Ecache Size (MB)		External cache size in megabytes
Dcache Size (KB)		Data cache size in kilobytes
Icache Size (KB)		Instruction cache size in kilobytes
Processor Type		Processor type
Model		Processor model type
Field Replaceable		"yes"

Memory Modules

The following table provides a brief description of the properties for Starfire Domain Config Reader Memory Modules (TABLE 6-6):

TABLE 6-6 Starfire Domain Config Reader Memory Modules

Property	Rule (if any)	Description
Name		mem-unit(n), where n is the memory module number
Memory Module		System board number this memory module is on
POST Status	e10kpost	POST status of this memory module
Size (MB)		Memory module size in megabytes
Field Replaceable		"yes"

Memory Groups

The following table provides a brief description of the properties for Starfire Domain Config Reader Memory Groups (TABLE 6-7):

TABLE 6-7 Starfire Domain Config Reader Memory Groups

Property	Rule (if any)	Description
Name		mem-group(n.m), where n.m is the memory group number
Memory Group		n.m where n is the memory module number and m is the memory group number (0-3)
POST Status	e10kpost	POST status of this memory group
Size (MB)		Memory group size in megabytes

DIMM Table

The following table provides a brief description of the properties for Starfire Domain Config Reader DIMM Table (TABLE 6-8):

TABLE 6-8 Starfire Domain Config Reader DIMM Table

Property	Rule (if any)	Description
Name		dimm(i.j.k), where i.j.k is the DIMM number
DIMM		i.j.k where i is the memory module number, j is the memory group number, and k is the DIMM number (0-7)
ECC Errors	e10kmerr	(graphable) Number of ECC errors detected in /var/adm/messages for this DIMM.
Size (MB)		DIMM size in megabytes
Board Reference		Part location silk-screened on the memory module mezzanine board
Field Replaceable		"yes"

I/O Modules

The following table provides a brief description of the properties for Starfire Domain Config Reader I/O Modules (TABLE 6-9).

TABLE 6-9 Starfire Domain Config Reader I/O Modules

Property	Rule (if any)	Description
Name		io-unit(n), where n is the I/O module number
I/O Module		System board number this I/O module is on
I/O Module Type		I/O module type is either SBus or PCI. The type is displayed as unknown (--) if no board I/O adaptors or controllers were configured by POST.
I/O Adaptors		Number of I/O adaptors on this I/O module
Field Replaceable		"yes"

I/O Controllers

The following table provides a brief description of the properties for Starfire Domain Config Reader I/O Controllers (TABLE 6-10):

TABLE 6-10 Starfire Domain Config Reader I/O Controllers

Property	Rule (if any)	Description
Name		When the I/O controller is configured by POST, the name is either sbus(n) or pci(n) where n is the kernel assigned instance number for the controller. If not configured by POST, the name is io-controller(n.m) where n.m is the I/O controller number
I/O Controller		n.m where n is the I/O module number and m is the host bus controller number (0-1)
POST Status	e10kpost	POST status for this I/O controller
UPA Portid		UPA portid for this I/O controller displayed in hexadecimal
Clock (MHz)		I/O controller clock frequency in megahertz
Model		Model name
Version Number		Version number

---

Note - I/O controllers for empty I/O adaptor slots are not included in the I/O Controllers table.

---

I/O Adaptors

The following table provides a brief description of the properties for Starfire Domain Config Reader I/O Adaptors (TABLE 6-11):

TABLE 6-11 Starfire Domain Config Reader I/O Adaptors

Property	Rule (if any)	Description
Name		io-adaptor(i.j.k), where i.j.k is the I/O adaptor number
I/O Adaptor		i.j.k where i is the I/O module number, j is the I/O controller number, and k is the adaptor slot number (0-1)
POST Status	e10kpost	POST status for this I/O adaptor
Model		If known, the model name for this I/O adaptor
Device Summary		Summary of I/O device drivers and devices supported by this I/O adaptor
Disk Count		Number of disks supported by this I/O adaptor
Network Count		Number of configured network interfaces supported by this I/O adaptor
Tape Count		Number of tape devices support by this I/O adaptor
Field Replaceable		"yes"

I/O Device Drivers

The following table provides a brief description of the properties for Starfire Domain Config Reader I/O Device Drivers (TABLE 6-12):

TABLE 6-12 Starfire Domain Config Reader I/O Device Drivers

Property	Rule (if any)	Description
Name		Device driver name and kernel assigned instance number, such as isp(2). If an instance number has not been assigned, the device name and register properties are used instead.
I/O Adaptor		I/O adaptor number for this device
Device Type		Device type, if known, such as SCSI or network.

Tape Devices

The following table provides a brief description of the properties for Starfire Domain Config Reader Tape Devices (TABLE 6-13):

TABLE 6-13 Starfire Domain Config Reader Tape Devices

Property	Rule (if any)	Description
Name		Device name and kernel assigned instance number, such as st(0)
Tape Name		/dev name for this tape device
I/O Adaptor		I/O adaptor number for this device
Status		Current status, such as "ok" or "drive present, but busy"
Tape Warnings	e10ktwrn	(graphable) Number of tape warnings detected in /var/adm/messages for this tape.
Model		Model name for this tape device, if known
Target Number		Tape target number
Field Replaceable		"yes"

Network Devices

The following table provides a brief description of the properties for Starfire Domain Config Reader Network Devices (TABLE 6-14):

TABLE 6-14 Starfire Domain Config Reader Network Devices

Property	Rule (if any)	Description
Name		Device name and kernel assigned instance number such as le(0). If an instance number has not been assigned, the device name and register properties are used instead.
Interface Name		Network interface name
I/O Adaptor		I/O adaptor number for this device
Symbolic Name		Host name associated with this network interface
Internet Address		IP address for the network interface
Ethernet Address		Ethernet address for the network interface

Disk Devices

The following table provides a brief description of the properties for Starfire Domain Config Reader disk devices (TABLE 6-15):

TABLE 6-15 Starfire Domain Config Reader Disk Devices

Property	Rule (if any)	Description
Name		Device name and kernel assigned instance number, such as sd(0)
Disk Name		/dev name for this disk
I/O Adaptor		I/O adaptor number for this device
Disk Warnings	e10kdwrn	(graphable) Number of disk warnings detected in /var/adm/messages for this disk.
Target Number		Disk target number
Field Replaceable		"yes"

---

Starfire Platform Config Reader Module

The Starfire Platform Config Reader module provides information about the hardware configuration for the entire Starfire platform. During Starfire platform add-on setup, this module is configured for automatic loading into the SSP platform agent and is displayed under the Browser Hardware icon.

This module is automatically disabled when the SSP becomes the spare SSP, and is enabled when the SSP becomes the main SSP. When the module is disabled, no platform information is available.

Module Refresh

The Starfire Platform Config Reader module gathers its data from two primary sources: the SSP snmpd agent and the Starfire domain Config Reader modules. SNMP traps are monitored by the module to get prompt notification of system configuration changes. In addition, the configuration information is updated at periodic intervals in case an SNMP trap is missed.

Gathering so much data at one time consumes too many system resources, so the platform agent does not gather it all at once. A complete refresh of the module data requires a span of 3-12 minutes, depending on the system configuration.

Using the browser from the platform Details window, you can refresh any module property, but doing so only retrieves the current value of the property from the platform agent. It does not force a recalculation of the data.

The Refresh Model properties described in Refresh Model enable you to start a refresh of the SSP or Starfire domain model data.

Starfire Platform Config Reader Properties

Platform Config Reader information gathered from the Starfire domain Config Reader is identified in the property description. Tables that have information gathered from the Starfire domain Config Reader have a Cache Updated property that is a time stamp of when this information was gathered from the Starfire domain.

---

Note - Since the Starfire domain configuration information is updated only when it changes and Starfire domain data changes infrequently, the Cache Updated time stamp may appear old even though the data is current.

---

If the Cache Updated property has a value of --, Starfire domain information for that table row is unavailable.

---

Note - A ∞C notation refers to temperatures measured in degrees Celsius.

---

System

The following table provides a brief description of the properties for the Starfire Platform Config Reader System (TABLE 6-16):

TABLE 6-16 Starfire Platform Config Reader System

Property	Rule (if any)	Description
Name		"system"
Platform Name		Name assigned to this Starfire platform during SSP software configuration
Ambient Temp (∞C)	e10ktemp	(graphable) Ambient temperature as measured by a sensor on the master control board
Total Starfire Domains		Number of Starfire domains configured
Total System Boards		Number of system boards
Total Processors		Number of processors
Total Control Boards		Number of control boards
Total Centerplane Boards		Number of centerplane boards
Total Centerplane Support Boards		Number of centerplane support boards
Total I/O Cabinets		Number of I/O cabinets
Total Fan Trays		Number of fan trays
Total 48V Power Supplies		Number of power supplies
Master Control Board		Master control board number
SysClk Control Board		System clock is provided by this control board
System Clock Frequency (MHz)		Clock frequency in megahertz
Last Update		Last time the configuration information for the System object was updated

System Boards

The following table provides a brief description of the properties for Starfire Platform Config Reader System Boards (TABLE 6-17):

TABLE 6-17 Starfire Platform Config Reader System Boards

Property	Rule (if any)	Description
Name		system-board(n) where n is the system board number
System Board		System board number
Power Status	e10kpowr	Indicates whether the board power is on or off.
Starfire Domain		Name of the Starfire domain this board is assigned to. A '--' is displayed if the board is not assigned to any Starfire domain.
POST Status	e10kpost	(Starfire domain) POST status for the entire system board
Memory (MB)		(Starfire domain) System board memory size in megabytes
Processors		Number of processors on this system board
I/O Adaptors		(Starfire domain) Number of I/O adaptors on this system board
CIC0 Temp (∞C)	e10ktemp	(graphable) Temperature of the CIC0 ASIC
CIC1 Temp (∞C)	e10ktemp	(graphable) Temperature of the CIC1 ASIC
MC Temp (∞C)	e10ktemp	(graphable) Temperature of the MC ASIC
XDB2 Temp (∞C)	e10ktemp	(graphable) Temperature of the XDB2 ASIC
XDB3 Temp (∞C)	e10ktemp	(graphable) Temperature of the XCB3 ASIC
Proc0 Temp (∞C)	e10ktemp	(graphable) Temperature of the processor unit 0
Proc1 Temp (∞C)	e10ktemp	(graphable) Temperature of the processor unit 1
Proc2 Temp (∞C)	e10ktemp	(graphable) Temperature of the processor unit 2
Proc3 Temp (∞C)	e10ktemp	(graphable) Temperature of the processor unit 3
3.3VDC Temp (∞C)	e10ktemp	(graphable) Temperature of the board 3.3VDC power supply
VDC Core Temp (∞C)	e10ktemp	(graphable) Temperature of the board VDC core power supply
5VDC Temp (∞C)	e10ktemp	(graphable) Temperature of the system board 5VDC power supply
3.3VDC Voltage (V)	e10kvolt	(graphable) Voltage level for the board 3.3VDC power
5VDC/HK Voltage (V)	e10kvolt	(graphable) Voltage level for the board 5VDC housekeeping power
5VDC Voltage (V)	e10kvolt	(graphable) Voltage level for the board 5VDC power
VDC Core Voltage (V)	e10kvolt	(graphable) Voltage level for the board VDC core power
3.3VDC/HK Voltage (V)	e10kvolt	(graphable) Voltage level for the board 3.3VDC housekeeping power
Serial Number		System board serial number. Due to the manner in which this information is collected, a -- is displayed if the system board has not been thermally calibrated
Cache Updated		Time the Starfire domain data was last updated
Field Replaceable		"yes"
Hot Plug		"yes"

System Board ASIC POST Status

The values in this table are retrieved from the corresponding Starfire domain Config Reader module. These properties are described in TABLE 6-4. An additional Cache Updated property in this table displays the time that the information was gathered from the Starfire domain.

Processor Modules

The following table provides a brief description of the properties for Starfire Platform Config Reader Processor Modules (TABLE 6-18):

TABLE 6-18 Starfire Platform Config Reader Processor Modules

Property	Rule (if any)	Description
Name		cpu-unit(n), where n is the Processor ID
Processor Module		n.m where n is the system board number and m is the system board processor module number (0-3)
Processor ID		Processor identifier
POST Status	e10kpost	(Starfire domain) POST status for this processor
Processor Status	e10kproc	(Starfire domain) Processor on-line/off-line status
Clock (MHz)		(Starfire domain) Processor clock frequency in megahertz
Ecache Size (MB)		(Starfire domain) External cache size in megabytes
Dcache Size (KB)		(Starfire domain) Data cache size in kilobytes
Icache Size (KB)		(Starfire domain) Instruction cache size in kilobytes
Processor Type		(Starfire domain) Processor type
Model		(Starfire domain) Processor model type
Cache Updated		Time Starfire domain data was last updated
Field Replaceable		"yes"

Memory Modules

When system board configuration information from a Starfire domain is unavailable, it is unknown whether the board has a memory module configured and a table entry is created for the memory module. The memory module properties have a value of
-- to indicate that the information is unavailable.

When this Starfire domain information becomes available, the table is updated. If the memory module is not present, the table entry for the memory module is removed.

The following table provides a brief description of the properties for Starfire Platform Config Reader Memory Modules (TABLE 6-19):

TABLE 6-19 Starfire Platform Config Reader Memory Modules

Property	Rule (if any)	Description
Name		mem-unit(n), where n is the memory module number
Memory Module		System board number this memory module is on
POST Status	e10kpost	(Starfire domain) The POST status of this memory module
Size (MB)		(Starfire domain) Memory module size in megabytes
Cache Updated		Time Starfire domain data was last updated
Field Replaceable		"yes"

Memory Groups

The values in this table are retrieved from the corresponding Starfire domain Config Reader module. These properties are described in TABLE 6-7. An additional Cache Updated property in this table displays the time the information was gathered from the Starfire domain.

DIMM Table

The values in this table are retrieved from the corresponding Starfire domain Config Reader module. These properties are described in TABLE 6-8. An additional Cache Updated property in this table displays the time the information was gathered from the Starfire domain.

I/O Modules

When system board configuration information from a Starfire domain is unavailable, it is unknown whether the board has an I/O module configured and a table entry is created for the I/O module. The I/O module properties have a value of -- to indicate that the information is unavailable.

When this Starfire domain information becomes available, the table is updated. If the I/O module is not present, the table entry for the I/O module is removed.

The following table provides a brief description of the properties for Starfire Platform Config Reader I/O Modules (TABLE 6-20):

TABLE 6-20 Starfire Platform Config Reader I/O Modules

Property	Rule (if any)	Description
Name		io-unit(n), where n is the I/O module number
I/O Module		System board number this I/O module is on
I/O Module Type		(Starfire domain) I/O module type is either SBus or PCI. Type is displayed as unknown (--) if no board I/O adaptors or controllers were configured by POST.
I/O Adaptors		(Starfire domain) Number of I/O adaptors on this I/O module
Cache Updated		Time Starfire domain data was last updated
Field Replaceable		"yes"

I/O Controllers

The values in this table are retrieved from the corresponding Starfire domain Config Reader module. These properties are described in TABLE 6-10. An additional Cache Updated property in this table displays the time the information was gathered from the Starfire domain.

I/O Adaptors

The values in this table are retrieved from the corresponding Starfire domain Config Reader module. These properties are described in TABLE 6-11. An additional Cache Updated property in this table displays the time the information was gathered from the Starfire domain.

Centerplane Boards

The following table provides a brief description of the properties for Starfire Platform Config Reader Centerplane Boards (TABLE 6-21):

TABLE 6-21 Starfire Platform Config Reader Centerplane Boards

Property	Rule (if any)	Description
Name		centerplane(n), where n is the centerplane board number
Centerplane Board		Centerplane board number (0-1)
Temp 0 (∞C)	e10ktemp	(graphable) Temperature at sensor 0 on the centerplane
Temp 1 (∞C)	e10ktemp	(graphable) Temperature at sensor 1 on the centerplane
Temp 2 (∞C)	e10ktemp	(graphable) Temperature at sensor 2 on the centerplane
Temp 3 (∞C)	e10ktemp	(graphable) Temperature at sensor 3 on the centerplane
Temp 4 (∞C)	e10ktemp	(graphable) Temperature at sensor 4 on the centerplane
Temp 5 (∞C)	e10ktemp	(graphable) Temperature at sensor 5 on the centerplane
Temp 6 (∞C)	e10ktemp	(graphable) Temperature at sensor 6 on the centerplane
Temp 7 (∞C)	e10ktemp	(graphable) Temperature at sensor 7 on the centerplane
Temp 8 (∞C)	e10ktemp	(graphable) Temperature at sensor 8 on the centerplane
Temp 9 (∞C)	e10ktemp	(graphable) Temperature at sensor 9 on the centerplane
Field Replaceable		"yes"

Centerplane Support Boards

The following table provides a brief description of the properties for the Starfire Platform Config Reader Centerplane Support Boards (TABLE 6-22):

TABLE 6-22 Starfire Platform Config Reader Centerplane Support Boards

Property	Rule (if any)	Description
Name		centerplane-support-board(n), where n is the centerplane support board number
Centerplane Support Board		Centerplane support board number (0-1)
Power Status	e10kpowr	Indicates whether the board power is on or off
3.3VDC1 Temp (∞C)	e10ktemp	(graphable) Temperature of the 3.3VDC power supply (sensor 1)
3.3VDC 2 Temp (∞C)	e10ktemp	(graphable) Temperature of the 3.3VDC power supply (sensor 2)
5VDC/HK Voltage (V)	e10kvolt	(graphable) Voltage level for the board 5VDC housekeeping power
3.3VDC/HK Voltage (V)	e10kvolt	(graphable) Voltage level for the board 3.3VDC housekeeping power
3.3VDC Voltage (V)	e10kvolt	(graphable) Voltage level for the board 3.3VDC power
Field Replaceable		"yes"

Control Boards

The following table provides a brief description of the properties for the Starfire Platform Config Reader Control Boards (TABLE 6-23):

TABLE 6-23 Starfire Platform Config Reader Control Boards

Property	Rule (if any)	Description
Name		control-board(n), where n is the control board number
Control Board		Control board number (0-1)
Power Status	e10kpowr	Indicates whether the board power is on or off
Control Board Hostname		Host name associated with the IP address of the control board
5VDC Temp (∞C)	e10ktemp	(graphable) Temperature of the board 5VDC power supply
5VDC Peripheral Temp (∞C)	e10ktemp	(graphable) Temperature of the board 5VDC peripheral power supply
5VDC Fan Temp (∞C)	e10ktemp	(graphable) Temperature of the board 5VDC fan power supply
Sensor 0 Temp (∞C)	e10ktemp	(graphable) Ambient temperature at sensor 0
Sensor 1 Temp (∞C)	e10ktemp	(graphable) Ambient temperature at sensor 1
Sensor 2 Temp (∞C)	e10ktemp	(graphable) Ambient temperature at sensor 2
5VDC Voltage (V)	e10kvolt	(graphable) Voltage level for the board 5VDC power
5VDC/HK Voltage (V)	e10kvolt	(graphable) Voltage level for the board 5VDC housekeeping power
3.3VDC/HK Voltage (V)	e10kvolt	(graphable) Voltage level for the board 3.3VDC housekeeping power
5VDC Peripheral Voltage (V)	e10kvolt	(graphable) Voltage level for the board 5VDC peripheral power
5VDC Fan Voltage (V)	e10kvolt	(graphable) Voltage level for the board 5V fan power
Field Replaceable		"yes"

Fan Trays

The following table provides a brief description of the properties for the Starfire Platform Config Reader Fan Trays (TABLE 6-24):

TABLE 6-24 Starfire Platform Config Reader Fan Trays

Property	Rule (if any)	Description
Name		fantray(n), where n is the fan tray number
Fan Tray		Fan tray number
Power Status	e10kpowr	Indicates whether the fan power is on or off
Field Replaceable		"yes"
Hot Plug		"yes"

Fans

The following table provides a brief description of the properties for Starfire Platform Config Reader Fans (TABLE 6-25):

TABLE 6-25 Starfire Platform Config Reader Fans

Property	Rule (if any)	Description
Name		fanunit(n), where n is the fan unit number
Fan Tray		Fan tray number (0-15)
Fan		Fan number (0-1)
Status	e10kpowr	Indicates whether the fan power is on, off, or failed
Speed		Fan speed. Either Nominal (low speed) or Fast (high speed)

48V Power Supplies

The following table provides a brief description of the properties for Starfire Platform Config Reader 48V Power Supplies (TABLE 6-26):

TABLE 6-26 Starfire Platform Config Reader Power Supplies

Property	Rule (if any)	Description
Name		bulkpower(n), where n is the power supply number
Power Supply		Power supply number (0-15)
Status	e10kpowr	Power status is either Ok or Failed
Field Replaceable		"yes"
Hot Plug		"yes"

AC Power Input Modules

The following table provides a brief description of the properties for Starfire Platform Config Reader AC Power Input Modules (TABLE 6-27):

TABLE 6-27 Starfire Platform Config Reader AC Power Input Modules

Property	Rule (if any)	Description
Name		acpower(n), where n is the AC power input module number
AC Power Input Module		AC power input module number (0-7)

I/O Cabinet Table

The following table provides a brief description of the properties for the Starfire Platform Config Reader I/O Cabinet (TABLE 6-28):

TABLE 6-28 Starfire Platform Config Reader I/O Cabinet Table

Property	Rule (if any)	Description
Name		io(n), where n is the I/O cabinet number
I/O Cabinet		I/O cabinet number
Power Status	e10kpowr	Power status is either on or off
Field Replaceable		"yes"

SSP Information

The SSP Information table is only viewable from the Browser tab in the Starfire platform Details window. It is not part of the hardware tree displayed in the physical and logical views.

The following table provides a brief description of the properties for Starfire Platform Config Reader SSP Information (TABLE 6-29):

TABLE 6-29 Starfire Platform Config Reader SSP Information

Property	Rule (if any)	Description
SSP Hostname		Host name of the SSP associated with this platform object
SSP Status		Status, main or spare, of the SSP associated with this platform object. Platform information is not available from this platform object when its SSP status is spare; use the platform object associated with the main SSP.
snmpd Last Updated		Last time SNMP operations with the SSP snmpd process were successfully completed
snmpd Communication Errors	rCompare	(graphable) Number of consecutive SNMP communication errors which have occurred when accessing the SSP snmpd platform data. This error count may reflect a transient problem, such as increased SSP activity causing SNMP time-outs, or a more persistent problem with snmpd SNMP communications.
snmpd Traps Received		"yes" if SSP snmpd traps have been received, or -- if no traps have been received yet. A value of -- does not necessarily indicate an error in the SSP snmpd trap forwarding configuration.
Alternate SSP		Host name of the alternate SSP for this platform
SSP Software Version		SSP software version

Starfire Domains

The Starfire Domains table is only viewable from the Browser tab in the Starfire platform Details window. It is not part of the hardware tree displayed in the physical and logical views.

The following table provides a brief description of the properties for Starfire Platform Config Reader Starfire Domains (TABLE 6-30):

TABLE 6-30 Starfire Platform Config Reader Starfire Domains

Property	Rule (if any)	Description
Domain Name		Starfire domain host name
IP Address		IP address for this domain
Arbstop Count	e10kdtrp	(graphable) Number of arbstops detected for this domain
Recordstop Count	e10kdtrp	(graphable) Number of recordstop events detected for this domain
Watchdog Count	e10kdtrp	(graphable) Number of watchdog events detected for this domain
Total System Boards		Number of system boards allocated to this Starfire domain
System Board List		List of the system boards allocated to this Starfire domain
Configured System Board List		List of the system boards configured by POST for this Starfire domain
Boot Processor		Boot processor number for the Starfire domain. If the value is -1, the Starfire domain is not configured or booted.

Agent Status

The Agent Status information is only viewable from the Browser tab in the Starfire platform Details window. It is not part of the hardware hierarchy displayed in the physical and logical views.

The Starfire platform Config Reader module communicates with the Starfire domain Sun Management Center agent to determine the Starfire composite topology object type (Agent Host or ICMP Ping) for the Starfire domain and to gather the Starfire domain-resident system board configuration information. This agent status information is presented largely for diagnostic purposes and consists of the Starfire Domain Ports property and the Agent Status Table.

The following table provides a brief description of the properties for the Starfire Platform Config Reader Starfire Domain Ports (TABLE 6-31):

TABLE 6-31 Starfire Platform Config Reader Starfire Domain Ports

Property	Rule (if any)	Description
Starfire Domain Ports		List of Sun Management Center Agent network ports for the platform's Starfire domains. This list is supplied during the setup of the Starfire platform add-on component.

The following table provides a brief description of the properties for the Agent Status Table (TABLE 6-32):

TABLE 6-32 Agent Status Table

Property	Rule (if any)	Description
Hostname		Host name of the Starfire domain
Agent Port		Network port on which the Starfire domain Sun Management Center agent is configured. This port is determined by sending the agent a message and receiving a response. If this value is --, communication with the agent has not been established.
Status		If agent communication has been established, indicates the current status of communications.
SNMP Communication Errors	rCompare	(graphable) The number of consecutive SNMP communication errors which have occurred when accessing the Starfire domain Config Reader data. This error count may reflect a transient problem, such as increased system activity causing SNMP time-outs, or a more persistent problem with SNMP communications.
Last Update Time		Last time successful communications with the Starfire domain agent occurred

Values for the Status property are shown in TABLE 6-33:

TABLE 6-33 Status Property Values

Value	Description
--	Communication with the agent is not established
ok	Sun Management Center agent is present; no errors
Host Not Responding	Starfire domain is down or not responding
Agent Not Responding	Starfire domain is up; the agent is not present or not responding
Module Not Responding	Starfire domain is up and the agent is up; the requested module is not loaded or is not responding

Discovery Object

The Discovery Object table is only viewable from the Browser tab in the Starfire platform Details window. It is not part of the hardware hierarchy displayed in the physical and logical views.

The Discovery Object Table provides information used by the Discovery Manager and the Create Topology Object GUI to create Starfire composites. This information is presented largely for diagnostics purposes and contains information not directly relevant to the Sun Management Center software user. This information consists of a table identifier (the Magic Number), followed by a table containing information for each topology object created as part of the Starfire composite. A Magic Number value of 53444f54 identifies the following table as a valid Discovery Object Table.

The following table provides a brief description of the properties for the Starfire Platform Config Reader Discovery Object Table (TABLE 6-34):

TABLE 6-34 Starfire Platform Config Reader Discovery Object Table

Property	Rule (if any)	Description
Topology ID		Encoded topology identification
Topology Parent		Topology identification of the parent of this object
Discovery Type		Encoded discovery type
IP Address		IP address for this topology object
Agent Port		Network port number for this topology object
Family Type		Topology object family type
Label		Object label displayed in the Sun Management Center topology
Description		Optional description of the object

---

Note - A -1 value for the Agent Port indicates that the object is a Platform Group object.

---

Refresh Model

The two properties in this table describe the way the Starfire platform Config Reader module is refreshed. Using the browser, you can select a property and refresh it. This starts a refresh cycle for the selected information.

The following table provides a brief description of the properties for the Starfire Platform Config Reader Refresh Model (TABLE 6-35):

TABLE 6-35 Starfire Platform Config Reader Refresh Model

Property	Rule (if any)	Description
Refresh SSP Model		Number displayed is a count of SSP model refresh operations
Refresh Starfire Domain Model		Number displayed is a count of Starfire Domain model refresh operations

---

SSP Status Module

The SSP Status module monitors the main or spare status of the SSP. During Starfire platform add-on setup, this module is configured for automatic loading in the SSP agent and is displayed under the Browser local applications icon.

The following table provides a brief description of the properties for the SSP Status Module (TABLE 6-36):

TABLE 6-36 SSP Status Module

Property	Rule (if any)	Description
SSP Status	rSspStatus	Status, either main or spare, of the SSP
SSP Hostname		Host name of the SSP

The rSspStatus rule raises a disabled alarm if the status is spare SSP.

---

Discovery Table Module

The Discovery Table module provides information to the Discovery Manager and Create Topology Object GUI necessary to create composite objects. During Starfire platform add-on setup, this module is configured for automatic loading in the SSP agent and is displayed under the Browser local applications icon.

This information is presented largely for diagnostic purposes and contains information not directly relevant to the Sun Management Center software user. This information consists of a table identifier (the Magic Number), which is 534454, followed by a table containing information for each composite object hosted by this system (TABLE 6-37):

TABLE 6-37 Discovery Table

Property	Rule (if any)	Description
IP Address		IP address where the composite information table is located
Port		Network port used with the IP address
OID		SNMP OID used with the IP address
Method		Flag indicating how to decode the table
Version		Version indicating how to decode the table
Family		Type of object which is created
Object		Object label

---

Starfire Config Reader Rules

Appendix E of the Sun Management Center 3.5 User's Guide lists the Sun Management Center rules for base Sun Management Center modules. The following section describes the rules for the Config Reader modules contained in the Starfire add-on components.

POST Status Rule (e10kpost)

Power-on self-test (POST) occurs whenever the Starfire domain is booted. The POST status properties for components can have the following values, which generate alarms as noted (TABLE 6-38):

TABLE 6-38 POST Status Rule

POST Status	Alarm Level	Meaning
Good		Component was tested by POST and placed in the Starfire domain configuration.
Failed	Critical	Component was tested and failed POST. The configuration of subcomponents of the failed component is unknown.
Unused		Component is not needed in the Starfire domain configuration due to other components which are either not physically present or were not configured by POST.
Blacklisted	Caution	Component was blacklisted during POST configuration. The physical presence of blacklisted components is unknown.
Redlisted	Caution	Component was redlisted during POST configuration. The physical presence of redlisted components is unknown.

Processor Status Rule (e10kproc)

The Processor Status Rule raises a caution alarm if the processor status is offline.

Tape Warnings Rule (e10ktwrn)

The Tape Warnings Rule raises an alarm when the number of tape warnings detected in /var/adm/messages exceeds the given limits. The Tape Warnings property value for a tape device that generates an alarm is set to zero when the alarm is acknowledged. This property value is also cleared when the Sun Management Center agent is restarted.

Please examine the /var/adm/messages file to determine the exact cause of the warning.

The default limits for this rule are shown in TABLE 6-39. See Changing Config Reader Rule Limits for information about how to customize these alarm limits.

TABLE 6-39 Tape Warnings Rule Limits

Alarm Level	Number of Warnings
Caution	5

Disk Warnings Rule (e10kdwrn)

The Disk Warnings Rule raises an alarm when the number of disk warnings detected in /var/adm/messages exceeds the given limits. The Disk Warnings property value for a disk that generates an alarm is set to zero when the alarm is acknowledged. This property value is also cleared when the Sun Management Center agent is restarted.

Please examine the /var/adm/messages file to determine the exact cause of the warning.

The default limits for this rule are shown in TABLE 6-40. See Changing Config Reader Rule Limits for information about how to customize these alarm limits.

TABLE 6-40 Disk Warnings Rule Limits

Alarm Level	Number of Warnings
Alert	20
Caution	7

Memory ECC Errors Rule (e10kmerr)

The Memory ECC Errors Rule raises an alarm when the number of ECC errors detected in /var/adm/messages exceeds the given limits.

The ECC Errors property value for a DIMM that generates an alarm is set to zero when the alarm is acknowledged from the Starfire domain Details window. This property value is also cleared when the Sun Management Center agent on the Starfire domain is restarted.

---

Note - The property value is not cleared when the alarm is acknowledged from the Starfire platform Details window.

---

ECC errors are not always generated due to hardware failures, but may instead indicate normal transient memory errors. In addition, the component cited in the ECC error may not be the cause of the problem, but only the component in which the problem was detected. Examine the cause of the ECC errors as reported in the Starfire domain's /var/adm/messages to determine if the reported DIMM ECC errors represent a component which is failing.

The default limits for this rule are shown in TABLE 6-41. See Changing Config Reader Rule Limits for information about how to customize these alarm limits.

TABLE 6-41 Memory ECC Error Rule Limits

Alarm Level	Number of ECC Errors
Caution	3

Starfire Domain Trap Rule (e10kdtrp)

The Starfire Domain Trap Rule raises an alarm when a domain trap of the appropriate type occurs. Critical alarms are raised for arbstop and watchdog traps. A caution alarm is raised for recordstop traps. The property value for the trap count is set to zero when the alarm is acknowledged. This property value is also cleared when the Sun Management Center agent is restarted.

Temperature Rule (e10ktemp)

The Temperature Rule monitors the temperature of the various hardware components and the ambient room temperature. For ASICs, processors, and power supplies, alarms are generated when the temperature exceeds the limits shown in TABLE 6-42:

TABLE 6-42 Temperature Rule Levels (Degrees Celsius)

Component	Caution	Alert	Critical
ASICs	80.0 ∞C	85.0 ∞C	90.0 ∞C
Processors	80.0 ∞C	85.0 ∞C	90.0 ∞C
Power Supplies	80.0 ∞C	85.0 ∞C	90.0 ∞C

The ambient temperature is monitored and a critical alarm is generated if it drops below 10.0 degrees Celsius or rises above 35.0 degrees Celsius.

Boards that have not been thermally calibrated report ASIC temperatures of -1, which raises a critical alarm. In the unlikely event that you experience this problem, contact your service provider.

If a component such as a processor is not present, its temperature is reported as 0 degrees.

---

Note - During setup of the Starfire platform (SSP) component, the SSP ssp_resource file is read to determine the rule levels shown in TABLE 6-42. The limit shown in this table may be different from your system configuration. Be sure to rerun the Starfire platform (SSP) setup if the limits in the ssp_resource file change.

---

---

Note - Temperature alarm limits cannot be modified from the Attribute Editor window.

---

Power Rule (e10kpowr)

The power status is monitored and an alarm is generated for the following situations (TABLE 6-43):

TABLE 6-43 Power Rule Levels

Power Status	Alarm Level
Off	Caution
Failed	Critical

Voltage Rule (e10kvolt)

Voltage levels are monitored and an alert alarm is generated if the voltage falls outside the following ranges:

TABLE 6-44 Voltage Rule Levels for System Boards

System Board Voltage	Minimum	Maximum
3.3VDC	3.130	3.470
3.3VDC/HK	3.130	3.470
5VDC	4.750	5.250
5VDC/HK	4.750	5.250
VDC Core	2.522	2.678
VDC Core (400 MHz processors)	1.843	1.957

TABLE 6-45 Voltage Rule Levels for Control Boards

Control Board Voltage	Minimum	Maximum
3.3VDC/HK	3.130	3.630
5VDC	4.750	5.250
5VDC/HK	4.750	5.250
5VDC Peripheral	4.949	5.460
5VDC Fan	4.850	5.350

TABLE 6-46 Voltage Rule Levels for Centerplane Support Boards

Centerplane Support Board Voltage	Minimum	Maximum
3.3VDC	3.130	3.470
3.3VDC/HK	3.130	3.630
5VDC/HK	4.750	5.250

---

Note - During setup of the Starfire platform (SSP) component, the SSP ssp_resource file is read to determine the rule levels shown in TABLE 6-44, TABLE 6-45, and TABLE 6-46. The limit shown in these tables may be different from your system configuration. Be sure to rerun the Starfire platform (SSP) setup if the limits in the ssp_resource file change.

---

---

Note - Voltage levels cannot be modified from the Attribute Editor window.

---

Comparison Rule (rCompare)

The comparison rule monitors a property for various standard comparisons such as greater than or less than. When examining the property in the browser display, you can also examine and edit the rule limits for each property, using the Sun Management Center Console Attribute Editor. See Changing Config Reader Rule Limits for information about how to customize these alarm limits.

---

Changing Config Reader Rule Limits

The rule limits shown for each rule are the default limits for that rule. If the property is contained within a table, these limits apply to all the rows in that table. Using the Sun Management Center console, you can change the limits for a row instance of the property as shown in To Edit Rule Parameters. If you want to change the default limits for all rows contained in a table, you can edit configuration files as shown in To Change Default Rule Limits.

To Edit Rule Parameters

You can use the Sun Management Center console Attribute Editor to change the rule limits for a specific instance of a property:

1. Display the Host Details Console.

2. Using the browser, select the property whose rule limits you want to change.

3. Open the Attributes Editor.

4. Click on the Alarms tab button.

5. Change and save the desired threshold values.

Refer to Chapter 10, "Attribute Editor" in the Sun Management Center 3.5 User's Guide for more specific instructions on using the Attribute Editor to modify alarm limits.

Changing Default Rule Limits

To change the default rule limits for all rows within a table, you must change the default limit in the appropriate configuration file. All rule limits are specified as alarmlimit variables. The following example sets the e10kmerr-info alarmlimit variable to 3: