CHAPTER 12

Environmental Test (envtest)

---

envtest exercises the I2C bus on the Ultra^(TM) 4, Ultra Enterprise^(TM) 200, and Ultra Enterprise 400 product lines. Five subtests are in envtest to test and report on the power supply status, system temperature status, fan speed, disk LEDs, and front panel and keyswitch. envtest is not scalable.

---

envtest Options

FIGURE 12-1 envtest

TABLE 12-1 envtest

envtest Options	Description
Disk LEDs Test	Illuminates each LED on the disk backplane(s) to green, then amber, and then back to its original state. The test then illuminates all disk LEDs to green, then amber, and then back to their original state. This test is only enabled in Functional test.
Fan Test	Cycles each fanbank speed to low, medium, and high, then verifies the correct speed. Next, each fanbank is stopped, one at a time. The test then verifies that a fan fault has occurred. Next, the watchdog timer is invoked to simulate a catastrophic failure. The test verifies that the system set all fanbanks to high and then resets the fan speed to normal. This test is only enabled in Functional test.
Front Panel and Keyswitch Test	Flashes each individual LED on the front panel to ON (green or amber), then OFF, and then back to its original state. The test then illuminates all front panel LEDs then sets them back to their original state. The power on LED is Read Only and will not be cycled. The test then displays the current keyswitch position. This test is only enabled in Functional test.
Power Supply Status	Identifies the number of power supplies that are in the system, the state of each power supply, and verifies that the power supply temperatures are within normal operating parameters. This test is enabled in all modes.
Temperature Status	Identifies the current temperature of each CPU in the system, the ambient temperature of the system, and verifies that all temperatures are within normal operating parameters. This test is enabled in all modes.

---

envtest Test Modes

envtest supports Connection and Functional tests.

TABLE 12-2 envtest

Test Mode	Description
Connection Test	Reports the status of the power supplies, the temperature sensors within the system, and verifies normal operating parameters
Functional Test	Tests the disk back panel, front panel LEDs, and fan control circuitry. Also uses the same functionality as Online mode and connection test If you invoke SunVTS through SyMON, the following Functional Test description applies: Uses the same functionality as connection test (above)

---

envtest Command Line Syntax

/opt/SUNWvts/bin/envtest [standard arguments] [-o
dev=device name,diskleds=E/D,fans=E/D,fpanel=E/D,
psupply=E/D,temp=E/D

TABLE 12-3 envtest

Argument	Explanation
dev=raw_device_name	Specifies the name of the raw device to test
diskleds=enable|disable	Enables or disables diskleds test
fans=enable|disable	Enables or disables fans test
fpanel=enable|disable	Enables or disables front panel test
psupply=enable|disable	Enables or disables power supply test
temp=enable|disable	Enables or disables temperature test

Table 12-4 envtest

Error Message		Probable Cause(s)	Recommended Action
8000	Unable to open driver <driver name>: <sys	Device name is wrong or driver is not loaded	Check the device name (if entered) or load driver.
	error msg>
		Device busy	Kill all other processes accessing driver.

8001    kstat_open failed

No kernel resource available Consult /var/adm/messages file

System software error

for more information.

8002

kstat_lookup failed for <envtest

envtest module not found Check revision and reload envctrl driver.

structure> in <kstat

No kernel resource available

Consult /var/adm/messages file

System software error

for more information.

8003

kstat_read failed <envtest structure>

envtest module not found Check revision /reload envctrl driver.

in <kstat module>

No kernel resource available

Consult the /var/adm/messages

System software error

file for more information.

8004    Unable to close kstat

No kernel resource available Consult the /var/adm/messages

System software error

file for more information.

8005	Unable to set mode to DIAG using ioctl.: <sys error msg>	System software error	Consult the /var/adm/messages file for more information.
8006	Unable to set disk LEDs: <sys error msg>	System software error	Consult the /var/adm/messages file for more information.
8007	Unable to get disk LEDs: <sys error msg>	System software error	Consult the /var/adm/messages file for more information.
8008	Unable to set <fan type> fan speed to	Fan hardware failure	Manually check the fan speed and replace the fan.
	<speed>: <sys error msg>	System software error	Consult the /var/adm/messages file for more information.
8009	Unable to get <fan type> fan speed: <sys error msg>	System software error	Consult the /var/adm/messages file for more information.

Table 12-4 envtest(Continued)

Error Message		Probable Cause(s)	Recommended Action
8010	<fan type> fan speed <speed> out of range	Fan hardware failure	Manually check the fan speed and replace the fan.
		System software error	Consult the /var/adm/messages file for more information.
8011	Forced fan fault did	Hardware failure	Replace the hardware.
	not occur for <fan type> fanbank	System software error	Consult the /var/adm/messages file for more information.
8012	Forced fan fault did	Hardware failure	Replace the hardware.

not clear for <fan

System over temperature

Consult the /var/adm/messages

System software error

file for more information.

8013	Unable to set	Hardware failure	Replace the hardware.
	watchdog timer
		System software error	Consult the /var/adm/messages file for more information.
8014	Unable to set temperature to <temperature>	System software error	Consult the /var/adm/messages file for more information.
8015	Power Supply <supply> has failed: Limit <0=PASS|1=FAIL> Current Share <0=PASS|1=FAIL> Temperature <temperature>	Power supply hardware failure	Replace the power supply.
8016	Unable to allocate memory using malloc. : <sys error msg>	System software error	Consult the /var/adm/messages file for more information.
8017	Unable to set mode to NORMAL using ioctl. : <sys error msg>	System software error	Consult the /var/adm/messages file for more information.
8018	Error encountered during call to <function name>
8019	Unable to set front panel LEDs using ioctl.: <sys error msg>	System software error	Consult the /var/adm/messages file for more information.

Table 12-4 envtest(Continued)

Error Message		Probable Cause(s)	Recommended Action
8020	Unable to reset front panel LEDs to original state	System software error	Consult the /var/adm/messages file for more information.
8021	Unable to set front panel LEDs to <led mask>	System software error	Consult the /var/adm/messages file for more information.
8022	Ambient temperature <temperature> Celsius out of range	envctrl hardware error
8023	CPU <CPU #> temperature <temperature> Celsius out of range	envctrl hardware error
8024	Data Miscompare:	envctrl hardware error
	ioctl diskled mask = <diskled mask> kstat diskled mask = <diskled mask>	System software error	Consult the /var/adm/messages file for more information.
8025	Illegal options passed to envtest <option>	User error	Check usage by typing envtest -u.
8026	Unable to retrieve	I2C hardware failure	Replace power supply.
	power supply information.	I2C bus wedged	Check for other I2C devices that may be corrupting the I2C bus.
8027	Power Supply Over Temperature: PS Slot <slot> PS Temperature <temperature>.	Bad Power Supply	Replace Power Supply.