CHAPTER 13

Environmental Test (env2test)

---

env2test exercises and validates the I2C bus on systems that support the envctrltwo driver.

Five subtests are in env2test to test and report the status of the power supply, system temperature, fan speed, disk LEDs, front panel, and keyswitch.

env2test is not scalable.

---

env2test Options

FIGURE 13-1 env2test

TABLE 13-1 env2test

env2test Options	Description
Disk LEDs Test	Determines the number of disks that are present and the state of each disk. Illuminates each LED on the disk backplane to amber, and then back to its original state. The test then illuminates all disk LEDs to amber, and then back to their original state. This test is only enabled in Functional test.
Fan Test	Sets the fanbank speed to halfway between the current speed and max speed, then verifies the correct speed. Next, the fanbank speed is set to max speed, and the speed is verified. The fanbank speeds are then returned to normal, and then verified. This test is only enabled in Functional test.

TABLE 13-1 env2test

env2test Options	Description
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 and the state of each power supply. This test is enabled in all modes.
Temperature Status	Identifies the current temperature of each CPU in the system, the ambient temperatures of the system, the temperature on the SCSI and power distribution boards, and verifies that all temperatures are within normal operating parameters. This test is enabled in all modes.

---

env2test Test Modes

env2test supports Connection and Functional tests as descripbed in the table below.

TABLE 13-2 env2test

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)

---

env2test Command Line Syntax

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

TABLE 13-3 env2test

Argument	Explanation
dev=raw_device_name	Specifies the name of the raw device to test
diskleds=enable|disable	Enables or disables diskleds test
env_mon=poll_interval	Displays all system environmental statics every "poll_interval" seconds. (Display ONLY, Does not 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

---

env2test Error Messages

Table 13-4 env2test

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

8001    kstat_open failed

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

available.

for more information.

System software error

Table 13-4 env2test

Error Message		Probable Cause(s)	Recommended Action
8002	kstat_lookup failed for env2test structure	env2test module not found.	Check revision and reload envctrl driver.

in kstat module

No kernel resource available

Consult /var/adm/messages file

System software error.

for more information.

8003

kstat_read failed env2test structure in

env2test module not found.

Check revision /reload envctrl driver.

kstat module

No kernel resource

Consult the /var/adm/messages

available.........file for more information.

System software error.

8004    Unable to close kstat

No kernel resource	Consult the /var/adm/messages
available.	file for more information.

System software error.

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 speed to speed:	Fan hardware failure	Manually check the fan speed and replace the fan.
		sys error msg
System software error.	Consult the /var/adm/messages file for more information.
8009	Unable to get fan speed: sys error msg	System software error	Consult the /var/adm/messages file for more information.
8010	Fan speed speed out of range: MIN speed MAX	Fan hardware failure.	Manually check the fan speed and replace the fan.
		speed
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.
8015	Power Supply supply has failed: State state	Power supply hardware failure.	Replace the power supply.

Table 13-4 env2test

Error Message		Probable Cause(s)	Recommended Action
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.
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 get front panel LEDs.	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:	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 env2test option	User error.	Check usage by typing env2test -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.
8033	Temperature temperature celsius out of range.	Hardware error.	Check all thermistors.