C H A P T E R  45

Remote System Control (rsctest)

The rsctest exercises the Remote System Control (RSC) feature, which is integrated on the Sun Enterprise 250 as well as the next-generation RSC 2.0 plug-in card introduced with the Sun Fire 280R line.

The RSC provides secure remote access for system monitoring, firmware updates, and failure recovery. The RSC 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, 10MB 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.

rsctest is not scalable.


rsctest Subtests

The rsctest will present different subtests and options based on which revision of the RSC hardware it is testing.

The subtests common to both RSC 1.0 and 2.0 include:

TABLE 45-1 Subtests for both RSC 1.0 and 2.0

Subtest

Description

Ethernet

Allows for internal loopback testing, on the Ethernet device with user specified data, size, and number of packets.Allows for 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.Allows for 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

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

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


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

TABLE 45-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.


The subtests call test modlets that are written in the native Real Time Operating System (RTOS) that resides in the RSC firmware. The rsctest subtests execute the test modlets, passes parameters, and retrieves results from the RSC using a test protocol on the host to RSC internal serial lines.


rsctest Options

To reach the dialog box below, 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 may not include the device appropriate to this test. Refer to the SunVTS User's Guide for more details.

FIGURE 45-1 rsctest Test Parameter Options Dialog Box

Screenshot of the rsctest Test Parameter Options dialog box.

TABLE 45-3 rsctest Options

rsctest Options

Description

Enet test

Enables or disables RSC 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 only).

TOD test

Enables or disables the Time Of Day test.

I2C test

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

Serial test

Enables or disables the RSC 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

Used to Enable or Disable the RSC PCMCIA modem test (RSC 2.0 only).



rsctest Test Modes

rsctest supports Connection and Functional tests as described in the table below.

TABLE 45-4 rsctest Supported Test Modes

Test Mode

Description

Connection

Reports the status of the RSC.

Functional

(Offline

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



rsctest Command-Line Syntax

RSC 1.0: /opt/SUNWvts/bin/rsctest 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/rsctest 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

TABLE 45-5 rsctest Command-Line Syntax

Argument

Description

enet=enable|disable

Enables or disables RSC 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 Flash Checksum test.

seeprom=enable|disable

Enables or disables RSC SEEPROM checksum test.

fruseeprom=E/D (RSC 2.0 ONLY)

Enables or disables RSC FRU SEEPROM checksum test.

tod=E/D (RSC 2.0 ONLY)

Enables or disables RSC Time Of Day test.

i2c=E/D (RSC 2.0 ONLY)

Enables or disables RSC i2c test.

serial=enable|disable

Enables or disables RSC serial test.

sdatsize=data_size

Data size for the rsc serial tests.

slb=Internal+External

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

spattype=seq+rand

Predefined pattern options used for RSC serial test.

stest=u_u+c_c+d_d

Defines port and configuration to use for RSC 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 ttyu_baud are: ALL, 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, 76800, 115200. The default is 9600.

rscmodem=E/D

Enables or disables the RSC PCMCIA modem test.




Note - 64-bit tests are located in the sparcv9 subdirectory: /opt/SUNWvts/bin/sparcv9/testname. If a test is not present in this directory, then it may only be available as a 32-bit test. For more information refer to 32-Bit and 64-Bit Tests.