RSC Command Quick Reference Guide

Asset ID:	1-71-1006030.1
Update Date:	2011-05-10
Keywords:

Solution Type Technical Instruction Sure

Solution 1006030.1 : RSC Command Quick Reference Guide

Applies to:

Sun Fire V480 Server
Sun Fire V490 Server
Sun Fire V880 Server
Sun Fire V880z Visualization Server
Sun Fire V890 Server
All Platforms
***Checked for relevance on 10-May-2011***

Goal

Description:

RSC Commands at the rsc> prompt and from within Solaris.

Solution

Here is a list of rsc commands that can be used either on the RSC board, or run from within Solaris.

From RSC board:

environment Displays current environmental information

showenvironment (The showenvironment command is not available on Sun Enterprise[TM] 250 servers.)

shownetwork Displays the current network configuration

console Connects you to the server console

break Puts the server in debug mode

xir Generates an externally initiated reset to the server

bootmode Controls server firmware behavior, if followed by a server reset within 10 minutes (similar to L1-key combinations on Sun keyboards)

-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

reset Resets the server immediately

poweroff Powers off the server

poweron Powers on the server

loghistory Displays the history of all events logged in the RSC event buffer

consolehistory Displays the history of all console messages logged in the buffer

consolerestart Makes the current boot and run console logs "original"

set Sets a configuration variable

serial_baud	serial_stop	serial_data	serial_hw_handshake
ppp_local_ip_addr	ppp_remote_ip_addr	ppp_enabled	page_enabled
mail_enabled	page_info1	page_init1	page_password1
page_baud1	page_data1	page_parity1	page_stop1
page_info2	page_init2	page_password2	page_baud2
page_data2	page_parity2	page_stop2	customerinfo
hostname	mailuser	mailhost	ip_mode
ip_addr	ip_netmask	ip_gateway	escape_char
country_code +	page_verbose *	tpe_link_test

+rsc 2.0 and above

*not available for the 250

show Displays one or more configuration variables

date Displays or sets the current time and date

password Changes your RSC password

useradd Adds an RSC user account

userdel Deletes an RSC user account

usershow Shows characteristics of an RSC user account

userpassword Sets or changes a user's password

userperm Sets the authorization for a user

resetrsc Resets RSC immediately

help Displays a list of RSC shell commands and a brief description of each

version Displays the RSC firmware version

showsc (The showsc command is not available on Sun Enterprise 250 servers.)

logout Ends your current RSC shell session

setlocator Turn the system locator LED on or off (Sun Fire[TM] V480 servers only).

showlocator Show the state of the system locator LED (Sun Fire V480 servers only).

showdate Same as the date command without arguments. (Not available for Sun Enterprise 250 servers.)

setdate Same as the date command with arguments. (Not available for Sun Enterprise 250 servers.)

Solaris rscadm subcommands:

help Displays a list of rscadm commands and brief descriptions for each

date Displays or sets the current time and date

set Sets a configuration variable

show Displays one or more configuration variables

shownetwork Shows current RSC card network configuration (RSC 2.0 and above)

loghistory Returns the most recent log entries (RSC 2.0 and above)

resetrsc Resets RSC immediately

download Downloads firmware to the RSC flash PROM

send_event Logs an event; can also send an alert message

modem_setup Changes configuration of the modem connected to the RSC serial port

useradd Adds an RSC user account

userdel Deletes an RSC user account

usershow Shows characteristics of an RSC user account

userpassword Sets or changes a user's password

userperm Sets the authorization for a user

version Reports the RSC version on the host (RSC 2.0 and above)

status Same as the version -v command. (RSC 2.0 and above)

OBP Commands:

rsc-hard-reset Performs a hard reset of RSC; this is the same as using the command rscadm resetrsc.

rsc-soft-reset Performs a soft reset of RSC; this is the same as using the command rscadm resetrsc -s.

diag-output-to rsc*|rsc-console**|ttya Directs POST output to either RSC (1) or ttya (0). This command takes effect after the next server reset. (E250 only)

diag-console rsc * |rsc-console**|ttya This command directs power-on self-test (POST) output to either RSC (1) or ttya (0). This command takes effect after the next server reset. (Not available for the E250)

rsc-mac-update Updates the RSC Ethernet address from the contents of the server ID PROM. Use this command after replacing the server NVRAM module. (E250 only)

.rsc Displays RSC information, including the diag-output-to setting and the RSC POST status word.

Available for Sun Enterprise 250 servers only. For other supported workgroup servers, you must set input-device and output-device to rsc-console rather than to rsc.

**For Sun Enterprise 250 servers, you must set input-device and output-device to rsc rather than to rsc-console.

OBP Environment Variable Properties:

input-device rsc|rsc-console|ttya

output-device rsc|rsc-console|ttya

diag-out-console true|false ( only used on the SF280R, V480, V880, V490).

Steps to Follow
Download RSC software:
Download RSC software:

RSC download

Other RSC Infodocs:

Setup of RSC- Document 1011888.1

RSC Command Quick Reference Guide - Document: 1006030.1

Navigate between OS and RSC - Document: 1005997.1

RSC password reset - Document: 1007570.1

Troubleshooting document on RSC:

Capturing errors via RSC - Document: 1012454.1

Reset input/output-device (to get it temporarly back from rsc to ttya):

Resetting NVRAM on a Sun system - Document: 1010111.1

RSC, E250, 280R, V880, V480, remote system controller
Previously Published As
45504

Change History
Date: 2009-11-25
User name: Dencho Kojucharov
Action: Updated
Comments: Currency check, audited by Dencho Kojucharov, Entry-Level SPARC Content Lead
Product_uuid
2962179a-0a18-11d6-845c-9c8399e8b5f2|Sun Enterprise 250 Server
a2b9bc2b-52c6-45c2-a3e0-f19bd2c86953|Sun Fire V480 Server
29726712-0a18-11d6-8636-c7e996b581dc|Sun Fire V880 Server
e9eace0a-3e09-11d7-9809-a34d84026ec3|Sun Fire V880z Visualization Server
296f2476-0a18-11d6-86cf-c8096baa086c|Sun Fire 280R Server
5d2816fe-5e51-11d7-8de2-d7bc0dd226fc|Sun Fire V890 Server
5c71fc02-5e51-11d7-8add-8938754df22a|Sun Fire V490 Server

Attachments

This solution has no attachment