C H A P T E R  53

System Service Processor Test (ssptest)


ssptest Description

The ssptest exercises the Remote System Control (RSC) feature, which is integrated on the Sun Enterprise 250 and on the next-generation RSC 2.0 plug-in card introduced with the Sun Fire 280R line. ssptest also exercises the Advanced Lights-Out Management (ALOM) feature, which is integrated into the Sun Fire V210, V240, V215, V245, V440, and V445, and Sun Netra 240 and 440 systems.

The RSC or ALOM provides secure remote access for system monitoring, firmware updates, and failure recovery. The RSC or ALOM communicates with the host through two internal serial lines, the I2C bus, and reset lines.

The RSC 1.0 hardware consists of the controller, flash, SEEPROM, 10-MB Ethernet port, and an external console serial port.

The RSC 2.0 plug-in card hardware consists of the controller, flash, SEEPROM, 10MB Ethernet port, FRUSEEPROM, Time of Day (ToD) device, internal PCMCIA modem card, and battery backup.

The ALOM hardware consists of a Motorola MPC850 processor, flash, SEEPROM, 10MB/100MB Ethernet Port, FRUSEEPROM, Time of Day (ToD) device, Serial Transceiver, and battery backup.

ssptest is not scalable.


ssptest Subtests

The ssptest presents different subtests and options based on which type of hardware (RSC or ALOM) and which version of RSC hardware (1.0 or 2.0) it is testing.

The subtests common to RSC 1.0, RSC 2.0, and ALOM include:


TABLE 53-1 Subtests for Both RSC 1.0, RSC 2.0, and ALOM

Subtest

Description

Ethernet

Enables internal loopback testing, on the Ethernet device with user specified data, size, and number of packets.

Enables external loopback testing with user-specified data, size, and number of packets. This requires a connection to a 10MB hub or switch for RSC 1.0, or a passive loopback connector for RSC 2.0, and ALOM.

Enables a ping to be sent to a specified host and checks the response.

Flash CRC

Performs a checksum test on the flash device.

SEEPROM CRC

Performs a checksum test on the SEEPROM device.

Serial

Enables internal loopback testing with user-specified data and size on the two internal serial ports.

 

Enables internal and/or external testing on the external ttyu port. The external test requires a passive loopback connector.


ssptest also presents the following subtests when running on the RSC 2.0 hardware:


TABLE 53-2 Subtests for RSC 2.0 Only

Subtest

Description

FRU SEEPROM CRC

Performs a checksum test on the SEEPROM device.

I2C

Tests the I2c bus connection between the host and the RSC.

ToD

Performs multiple reads to the ToD device and verifies that the time is incrementing.

Modem

Verifies that the modem is installed. Displays the manufacture information, in Verbose mode. Performs AT inquiry commands.


ssptest presents the following subtests when running on the ALOM hardware:


TABLE 53-3 Subtests for ALOM Only

Subtest

Description

I2C

Tests the I2c bus connection between the host and the ALOM.

ToD

Performs multiple reads to the ToD device and verifies that the time is incrementing.

DOC

Performs the DOC (disk on chip) selftest. This subtest is only enabled on platforms supporting docselftest.

FRU SEEPROM CRC

Performs a checksum test on the SEEPROM device.

Note: The FRU SEEPROM CRC subtest is not enabled in ssptest on platforms using ALOM hardware with ALOM firmware. On these platforms, i2c2test performs the checksum test on the SEEPROM device in ALOM hardware.


The subtests call test modlets that are written in the native Real Time Operating System (RTOS) that resides in the RSC firmware. Using a test protocol on the host to RSC or ALOM internal serial lines, the ssptest subtests execute the test modlets, pass parameters, and retrieve results from the RSC or ALOM.


ssptest Options

To reach the following dialog box, right-click on the test name in the System Map and select Test Parameter Options. If you do not see this test in the System Map, you might need to expand the collapsed groups, or your system might not include the device appropriate to this test. Refer to the SunVTS User's Guide for more details.


FIGURE 53-1 ssptest Test Parameter Options Dialog Box (Top Section)

Screenshot of the top section of the ssptest Test Parameter Options dialog box



FIGURE 53-2 ssptest Test Parameter Options Dialog Box (Bottom Section)

Screenshot of the bottom section of the ssptest Test Parameter Options dialog box




Note - The Configuration field in the ssptest Test Parameter Options dialog box displays the type of software (RSC or ALOM) being tested. For RSC 1.0 and 2.0, Remote System Control is displayed. For ALOM, Advanced Lights-Out Management is displayed.




TABLE 53-4 ssptest Options

ssptest Options

Description

Enet test

Enables or disables RSC or ALOM Ethernet testing.

Data Pattern Type

Selects Sequential, Random, or both types of data patterns.

Packet Size

Defines the size of each data packet to be sent for all tests.

Num Packets

Specifies the number of data packets to send in one test loop.

Target Host

Specifies the IP address of a host to use for the ping test.

Enet Test Type

Selects any or all Internal, External, or ping tests.

Flash test

Enables or disables the flash checksum test.

SEEPROM test

Enables or disables the SEEPROM checksum test.

FRU SEEPROM test

Enables or disables the FRU SEEPROM checksum test. (RSC 2.0 and ALOM only).

TOD test

Enables or disables the Time Of Day test.

DOC

Enables or disables Disk On Chip test (ALOM only).

I2C test

Enables or disables the I2C test (RSC 2.0 and ALOM only).

Serial test

Enables or disables the RSC or ALOM serial test.

Data Size

Defines the data size to be sent.

Loopback Type

Selects Internal, External, or both. External requires a loopback plug.

Data Pattern Type

Selects Sequential, Random, or both types of data patterns.

Serial Test Type

Selects serial ports to be tested, u to u, c to c, or d to d.

TTYU_Baud

Select a fixed baud rate or all baud rates for testing the ttyu port. The valid baud rates under TTYU_Baud are: ALL, 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, 76800, 115200. The default is 9600.

Modem Test

Enables or disables the RSC PCMCIA modem test (RSC 2.0 only).



ssptest Test Modes

ssptest supports the following test modes as described in the table below.


TABLE 53-5 ssptest Supported Test Modes

Test Mode

Description

Connection

Reports the status of the RSC or ALOM.

Exclusive

Tests the RSC's and ALOM's Ethernet, flash, SEEPROM, ToD, I2C, and serial devices. All tests use the internal modes as defaults. The ssptest will not run the serial test on ttyc if the console has been redirected to the RSC. The ttu tests will not run if there is an open login on the ttyu.



ssptest Command-Line Syntax

RSC 1.0: /opt/SUNWvts/bin/ssptest standard-arguments -o enet=E/D, epattype=seq+rand,esize=packet-size,epkts=number-packets, target=IP-address, etest=I+E+P,flash=E/D,seeprom=E/D,serial=E/D,sdatsize=data-size, slb=I+E,spattype=seq+rand,stest=u-u+c-c+d-d,ttyubaud=baud-rate|all

RSC 2.0: /opt/SUNWvts/bin/ssptest standard-arguments -o enet=E/D, epattype=seq+rand,esize=packet-size,epkts=number-packets,target=IP-address, etest=I+E+P,flash=E/D,seeprom=E/D,fruseeprom=E/D,tod=E/D,i2c=E/D,serial=E|D,sdatsize=data-size,slb=I+E,spattype=seq+rand,stest=u-u+c-c+d-d,ttyubaud=baud-rate|all,rscmodem=E/D

ALOM: /opt/SUNWvts/bin/ssptest standard-arguments -o enet=E/D, epattype=seq+rand,esize=packet-size,epkts=number-packets,target=IP-address, etest=I+E+P, flash=E/D,seeprom=E/D,tod=E/D,doc=E/D,i2c=E/D,serial=E/D,sdatsize=data-size,slb=I, spattype=seq+rand, stest=d-d


TABLE 53-6 ssptest Command-Line Syntax

Argument

Description

enet=Enable|Disable

Enables or disables RSC or ALOM Ethernet test.

epattype=seq+rand

Predefined pattern options used for Enet test.

esize=packet-size

Data size for each packet in the Enet test.

epkts=number-packets

Number of packets to send for Enet test.

target=IP-address

IP address of target system for Enet ping test.

etest=Internal+External+Ping

Selects any or all Internal, External, or ping tests.

flash=Enable|Disable

Enables or disables RSC or ALOM Flash checksum test.

seeprom=Enable|Disable

Enables or disables RSC or ALOM SEEPROM checksum test.

fruseeprom=Enable|Disable

Enables or disables RSC FRU SEEPROM checksum test (RSC 2.0 and ALOM only).

tod=Enable|Disable

Enables or disables RSC or ALOM Time of Day test (RSC 2.0 and ALOM only)..

doc=Enable|Disable

Enables or disables ALOM Disk On Chip test.

i2c=Enable|Disable

Enables or disables RSC or ALOM I2c test (RSC 2.0 and ALOM only)..

serial=Enable|Disable

Enables or disables RSC or ALOM serial test.

sdatsize=data-size

Data size for the rsc or alom serial tests.

slb=Internal+External

Loopback type. External N/A on ports C and D.

spattype=seq+rand

Predefined pattern options used for RSC or ALOM serial test.

stest=u-u+c-c+d-d

Defines port and configuration to use for RSC or ALOM serial test.

ttyu-baud=ALL|specific-baud

Defines baud rates to be used in testing the RSC's console port. The valid baud rates under ttu_baud are: ALL, 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, 76800, 115200. The default is 9600.

rscmodem=Enable|Disable

Enables or disables the RSC PCMCIA modem test (RSC2.0 only).