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 |
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 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). |
/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. |
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".
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. |
8031 | Communication to RSC failed. | RSC Hung | Reset RSC. |
8032 | Unable to get RSC's console port from library. |
RSC lib not installed. System software error. | Check for RSC lib on host. |
8033 | Unable to get RSC's control port from library. |
RSC lib not installed. System software error. | Check for RSC lib on host. |
8034 | Unable to negotiate loopback mode on RSC for serial loopback. |
Excessive RSC load. RSC data protocol error. |
Reduce RSC and system load. Reset RSC. |