SunVTS 3.0 Test Reference Manual

Chapter 27 Remote System Control (rsctest)

The rsctest exercises the Remote System Control (RSC) feature on the Sun Enterprise 250.

The RSC provides secure remote access for system monitoring, firmware updates and failure recovery. The RSC hardware consists of the controller, flash, SEEPROM, 10MB Ethernet port and an external console serial port. The RSC communicates with the host through two internal serial lines, the I2C bus, and reset lines.

The rsctest consists of four subtests which test and report on the Ethernet, flash checksum, SEEPROM checksum, and the internal and external serial ports. The subtests call test modlets that are written in the native Real Time Operating System (RTOS) which 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. The rsctest is not scalable.

rsctest Options

Figure 27-1 rsctest Options Menu

Graphic

Table 27-1 rsctest Options

rsctest Options

Description 

Enet Test 

Used to Enable or Disable RSC Ethernet testing. 

Data Pattern Type 

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

Packet Size 

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

Num Packets 

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

Target Host 

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

Enet Test Type 

Select any or all Internal, External, or ping test. 

Flash Test 

Used to Enable or Disable the flash checksum test. 

seeprom Test 

Used to Enable or Disable the SEEPROM checksum test. 

Serial Test 

Used to Enable or Disable the RSC serial test. 

Data Size 

Used to define the data size to be sent. 

Loopback Type 

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

Data Pattern Type 

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

Test Type 

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

rsctest Test Modes

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

Table 27-2 rsctest Test Modes

Test Mode 

Description 

Connection Test 

Reports the status of the RSC.  

Functional Test 

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.

 

If you invoke SunVTS through SyMON, the following Functional Test description applies: rsctest uses the same functionality as connection test (above).

rsctest Command Line Syntax

/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

Table 27-3 rsctest Command Line Syntax

Argument 

Explanation 

enet=enable|disable

Enable or disables RSC Ethernet test. 

epattype=seq+rand

Predefined pattern options used for enet test. 

esize=packet_size

The data size for each packet in the enet test. 

epkts=number_packets

The number of packets to send for enet test. 

target=IP_address

IP Address of target system for enet ping test. 

etest=Internal+External+Ping

Test modes for RSC enet test. 

flash=enable|disable

Enables or disables RSC flash checksum test. 

seeprom=enable|disable

Enables or disables RSC SEEPROM checksum 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&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. 


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".


rsctest Error Messages

Table 27-4 rsctest Error Messages

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

Unable to allocate memory using malloc: sys err msg

System software error. 

Consult /var/adm/messages file for more information.

8002

Illegal options passed to rsctest option

User error. 

Check usage by typing rsctest -u.

8003

Error encountered during call to function name

 

 

8004

Error encountered during call to rsc_send(). Error Code: sys error msg

RSC Hardware is not responding. 

Reset RSC. 

8005

Error encountered during call to rsc_recv(). Error Code: sys error msg

RSC RTOS test timed out. 

Reset RSC. 

8006

Failing status received. Status:status

RSC's RTOS test returned a failing status. 

 

8007

Invalid message type received from rsc_recv(). Msg_type: msg type

RSC returned a unexpected message type. 

RSC RTOS/protocol error. 

8008

Error encountered during call to rsc_start(). Error Code: sys error msg

Unable to initialize RSC test protocol. 

RSC RTOS/protocol error. Reset RSC. 

8009

RSC's Internal|External enettest failed for pattern type= patt type

Internal: Bad hardware 

Improper RSC enet configuration. 

Check RSC configuration. 

Check 10 MB hub and cable. 

Replace mother board. 

External: Bad hardware, 

Improper RSC enet configuration, 

Missing 10 MB hub and cable. 

8010

RSC's PING test failed. Pattern type = patt type Target host= target IP.

Invalid RSC enet configuration. 

Check RSC's enet configuration. 

Missing/damaged cable 

Invalid target IP 

Hardware failure. 

Check cable connection. 

Check target IP address option. 

Replace mother board. 

8011

RSC's flash checksum test failed. Status: status

Corrupted flash firmware. 

Error on I2C bus. 

Bad flash hardware. 

Reflash firmware. 

Check I2C bus using env2test. 

Replace Hardware. 

8013

term setting failed for TERMIO.:sys error msg

RSC protocol error. 

 

System software error. 

Consult the /var/adm/messages file for more information.

8014

Read failed.: sys error msg

System software error. 

Consult the /var/adm/messages file for more information.

8015

Data read does not match data sent.

Bad hardware or 

System software error. 

 

8016

Data read exceeds data sent.

Bad hardware or 

System software error. 

 

8017

Select timedout for read.:sys error msg

System software error. 

Excessive load on RSC/system causing lost data. 

Reduce RSC and System load. 

Consult the /var/adm/messages file for more information.

8018

Write failed for num bytes bytes of data.:sys error msg

System software error. 

Consult the /var/adm/messages file for more information.

8019

Select timedout for write.: sys error msg

System software error. 

Consult the /var/adm/messages file for more information.

8020

RSC Serial test failed.

Test Name= testname Loopback= Loopback type

Pattern_Type= patt type Baud= baud rate.

Bad hardware or 

System software error. 

 

8021

OPEN of port failed.:sys error msg.

System software error. 

Consult the /var/adm/messages file for more information.

8022

RSC Status shows that the last run of POST failed.

Bad hardware or 

System Firmware error. 

 

8023

Unable to access lib rsc lib.: sys error msg.

System software error. 

 

Consult the /var/adm/messages file for more information.

8024

Unable to close lib.: sys error msg.

System software error. 

 

Consult the /var/adm/messages file for more information.

8025

Call to rsc_init() failed. Error Code: rsc error msg

System software error. 

 

Consult the /var/adm/messages file for more information.

8026

Unable to access function function name in lib.: sys error msg.

System software error. 

 

Consult the /var/adm/messages file for more information.

8027

RSC's SEEPROM checksum test failed. Status: status.

Corrupted Firmware or 

problem with I2C bus or 

system software error. 

 

8028

Select failed for [Write/Read].

Hung RSC. 

RSC data protocol error. 

Consult /var/adm/messages file for more information.
8029

Sending OFF to Serial test failed.

Test Name= test_name

Loopback= loopback_type

pattern_type=pattern_type

Baud=baud_rate

Hung RSC. 

RSC data protocol error. 

 Reset RSC.
8031Communication to RSC failed. RSC Hung Reset RSC.
8032Unable to get RSC's console port from library.

RSC lib not installed. 

System software error. 

 Check for RSC lib on host.
8033Unable to get RSC's control port from library.

RSC lib not installed. 

System software error. 

 Check for RSC lib on host.
8034Unable to negotiate loopback mode on RSC for serial loopback.

Excessive RSC load. 

RSC data protocol error. 

Reduce RSC and system load. 

Reset RSC.