test

Sun Remote System Control (RSC) User's Guide

Server Status and Control Commands

The following RSC commands show server status or control server operation:

environment

Use the environment command to display a snapshot of server environmental status, such as temperatures, power supply status, front panel LED status, keyswitch position, and so forth. The display uses similar format to that used for the UNIX command prtdiag(1m). For example:

rsc> environment
                

==================== Environmental Status ====================


System Temperatures (Celsius):
------------------------------
      CPU0    42
      CPU1    52
       MB0    33
       MB1    27
       PDB    29
      SCSI    25

=================================
Front Status Panel:
-------------------

Keyswitch position is in On mode.

System LED Status:  DISK ERROR      POWER 
                      [OFF]         [ ON]      
                POWER SUPPLY ERROR  ACTIVITY 
                      [OFF]         [ ON]      
                    GENERAL ERROR   THERMAL ERROR  
                      [OFF]         [OFF]      

=================================


Disk LED Status:    OK = GREEN  ERROR = YELLOW
        DISK  5: [EMPTY]    DISK  3: [EMPTY]    DISK  1:    [OK]
        DISK  4: [EMPTY]    DISK  2:    [OK]    DISK  0:    [OK]

=================================


Fan Bank:
---------

Bank      Speed     Status
         (0-255)    
----      -----     ------
 SYS       151        OK

=================================


Power Supplies:
---------------

Supply     Status
------     ------
  0          OK  
  1          OK  

=================================

rsc>

shownetwork

The shownetwork command displays the current network configuration, for example: 

rsc> shownetwork
RSC network configuration is:
DHCP server: 129.149.2.3
IP Address: 129.149.2.6
Gateway Address: 129.149.2.7, 129.149.2.8
Netmask: 255.255.255.0
Ethernet Address: ae:30:30:00:00:01
rsc>

console

Use the console command to enter RSC console mode and connect to the server console from the RSC shell. When you use this command, the system displays a standard Solaris login prompt. If RSC is not designated as the server console, nothing is displayed.

You must have C level user permission to use this command. An escape character sequence is used to return to the RSC prompt. The default escape sequence is ~. (tilde period). See "escape_char".

break

Use the break command to put the server into debug mode. You must have C level user permission to use this command. The server front panel keyswitch must not be in the Lock position, and the server serial port must be designated as the console (see Chapter 6, Using OpenBoot PROM Features That Support RSC). Debug mode can use either kadb or OBP.

xir

This command generates the equivalent of an externally initiated reset (XIR) of the server. You must have R level user permission to use this command. The server enters OBP mode and displays the ok prompt. This command is useful for driver or kernel debugging, as most of the contents of the server's memory and registers is preserved. To resume the system after using the xir command, you must reboot the server.

bootmode [-u] [normal|forth|reset_nvram|diag| skip_diag]

This command provides control over the server firmware behavior after a server reset. Functionality of this command is identical to that available on Sun keyboards using L1 key combinations. You must have R level user permission to use this command. If you use the bootmode command without arguments, RSC displays the current boot_mode.

The bootmode setting overrides the server's OBDiag diag-switch? setting immediately after the next reset only. If RSC does not detect a server reset within 10 minutes, the bootmode command is ignored. For example: 

rsc> bootmode forth
rsc> reset

To set the diag or skip_diag option, you must follow the bootmode command with the poweroff and poweron commands within 10 minutes. For example: 

rsc> bootmode skip_diag
rsc> poweroff
rsc> poweron

To force console input and output to RSC, use the -u option before specifying the boot mode.

The following table describes modes you can specify using the bootmode command.

Table 4-2 Modes Used With the bootmode Command

Mode 

Description 

-u

Force the server to direct the console to RSC; the -u option must precede any boot_mode you specify; requires server reset

normal

Normal boot; server runs low-level diagnostics; requires server reset 

forth

Enter Forth interpreter as soon as possible (equivalent to L1-F on keyboard); requires server reset 

reset_nvram

Reset all NVRAM variables to default values (equivalent to L1-N on keyboard); requires server reset 

diag

Force the server to run full diagnostics (equivalent to L1-D on keyboard); requires server power-off and power-on 

skip_diag

Force the server to skip diagnostics (equivalent to L1-S on the keyboard); requires server power-off and power-on 

Note -

The diag and skip_diag modes take effect only if you follow the bootmode command with the poweroff and poweron commands within 10 minutes.

reset

This command forcibly resets the server immediately. You must have R level user permission to use this command. The server reboots according to the server's designated boot_mode.

Note -

The default configuration of Sun Enterprise 250 firmware does not invoke POST when the server resets. However, you can change this behavior through NVRAM variable settings; for additional details, see Platform Notes: Sun Enterprise 250 Server.

poweroff

Use the poweroff command to power off the server. You must have R level user permission to use this command. This command has no effect if the server is already powered off. RSC remains available since it uses the server's standby power.

poweron

Use the poweron command to power on the server. You must have R level user permission to use this command. This command has no effect if any of the following is true: