Hewlett-packard user guide printer printer (333 pages)
Summary of Contents for Sun Microsystems RSC
Page 1
Remote System Control ™ (RSC) User’s Guide Sun™ Enterprise™ 250 Server Sun Microsystems, Inc. 901 San Antonio Road Palo Alto, CA 94303-4900 USA 650 960-1300 Fax 650 969-9131 Part No.: 805-7398-10 March 1999, Revision A Send comments about this document to: docfeedback@sun.com...
Page 2
Sun. Sun, Sun Microsystems, the Sun logo, AnswerBook, SunVTS, Solstice SYMON. Java, the Java Coffee Cup logo, Solaris et Sun Enterprise sont des marques déposées ou enregistrées de Sun Microsystems, Inc. aux Etats-Unis et dans d’autres pays. Toutes les marques SPARC, utilisées sous licence, sont des marques déposées ou enregistrées de SPARC International, Inc.
Contents Preface xi Sun Remote System Control (RSC) Software 1 RSC Access 1 RSC Features 3 RSC Use 3 RSC Capabilities 6 Server Status and Control 6 View Logs RSC Configuration 7 User Interfaces 7 RSC Security 8 RSC Client Requirements 8...
Page 4
24 bootmode [-u] [normal|forth|reset_nvram|diag| skip_diag] 25 reset 26 poweroff 26 poweron 26 RSC View Log Commands 27 loghistory [index [+|-]n] [pause n] 27 index [+|-]n 27 pause n 28 Sun Remote System Control (RSC) User’s Guide • March 1999...
Page 5
[boot|run|oboot|orun] [index [+|-]n] [pause n] 28 pause n 29 consolerestart 29 RSC Configuration Commands 29 set variable value 30 show [variable] date [[mmdd]HHMM|mmddHHMM[cc]yy][.SS] password 32 useradd username 32 userdel username 33 usershow [username] userpassword username 33 userperm username [c][u][a][r] 34...
Page 6
40 page_password2 40 page_baud2 40 page_data2 40 page_parity2 page_stop2 customerinfo hostname mailuser mailhost 41 Ethernet Port Variables 42 ip_mode 42 ip_addr 42 ip_netmask 42 ip_gateway 42 Console Session Variable 43 Sun Remote System Control (RSC) User’s Guide • March 1999...
Page 7
[-s] 49 download [boot] file 49 send_event [-c] message 49 modem_setup 50 User Account Administration Subcommands 50 rscadm Error Messages 51 Using OpenBoot PROM Features That Support RSC 57 OBP Commands 57 rsc-hard-reset 57 rsc-soft-reset 57 diag-output-to rsc|ttya 57 rsc-mac-update 58 .rsc 58...
Page 8
No alerts received from RSC 61 RSC passwords are unknown 62 Times in RSC event log do not match times in server console logs 62 You can perform some RSC functions, but not others 62 RSC is not working after you replace the main logic board 62...
Page 9
Set Modem DIP Switches 76 Modify RSC Configuration Variables 77 Modify Modem Settings 78 Modem Reconfiguration Required After Changing RSC Serial Port Settings 79 Troubleshooting Modem Problems 80 Creating a Script That Sends an Alert Message or RSC Event 81 Contents...
Page 10
Sun Remote System Control (RSC) User’s Guide • March 1999...
Preface Sun Remote System Control (RSC) User’s Guide tells you how to configure and use Sun™ Remote System Control software. These instructions are designed for an experienced system administrator with networking knowledge. Using UNIX Commands This document does not contain information on basic UNIX® commands and procedures such as shutting down the system, booting the system, and configuring devices.
TABLE P-2 Shell Prompt C shell machine_name% C shell superuser machine_name# Bourne shell and Korn shell Bourne shell and Korn shell superuser Remote System Control shell rsc> OpenBoot PROM shell Sun Remote System Control (RSC) User’s Guide • March 1999...
Related Documentation Related Documentation TABLE P-3 Application Title Installation Sun Remote System Control (RSC) Installation Guide PPP configuration Configuring and Using Solstice PPP Clients Performing diagnostic tests SunVTS User’s Guide SunVTS Quick Reference Guide SunVTS Test Reference Manual Solstice SyMON User’s Guide...
Page 14
Sun Remote System Control (RSC) User’s Guide • March 1999...
The RSC software works with the System Service Processor (SSP) on the Sun™ Enterprise™ 250 main logic board. RSC and the SSP support both serial and Ethernet connections to a remote console.
Page 16
RSC Remote Access Paths FIGURE 1-1 Once RSC software is installed and configured to manage your server, you can use it to run diagnostic tests, view diagnostic and error messages, reboot your server, and display environmental status information from a remote console.
RSC also sends alerts to any clients that are currently logged in to RSC. RSC sends an alert message whenever any of the following occurs:...
Page 18
A server redundant power supply fails. A power outage occurs at the server site, if an uninterruptible power supply (UPS) is in use and it is configured to send an alert to RSC (see Appendix A). RSC receives a server-generated alert.
Page 19
Secure serial bus Secure Ethernet ASCII terminal ASCII terminal and modem and modem Company modem RSC modem pool Solaris workstation Windows PC RSC Remote Alert Paths FIGURE 1-2 Chapter 1 Sun Remote System Control (RSC) Software...
After receiving an alert message, you can connect to your RSC account for the server that caused the alert. Then you can check console messages to determine whether the server has recovered and is running, or whether the server operating system is down.
After installation, you run a script file that guides you through basic configuration. See the Sun Remote System Control (RSC) Installation Guide. If you want to be able to use RSC in case of a complete power failure, you should install and configure an uninterruptible power supply (UPS) for the server. See Appendix A.
After operating system software is installed on the server to be managed, you can install RSC software on the server. Note – After RSC software is installed on the host, it resides in the directory /usr/platform/sun4u. Until RSC host software is installed and configured, the system console is available as on any normal Sun computer.
After initial configuration, you can control configuration and add or modify user accounts by using the GUI or RSC shell commands. You can also log in to the host as root and use the rscadm utility to control RSC configuration and user accounts; see Chapter 5.
If point-to-point protocol (PPP) is enabled on the serial port, RSC supports multiple sessions, either shell or GUI, through one modem connection. If PPP is not enabled, only one session can be run over the modem, and it must be a shell session. RSC supports multiple sessions over its Ethernet port.
The GUI provides help for configuring RSC alerts. For help configuring RSC alert variables in the shell, see “Alert Variables” on page 38. RSC generates alert messages with the following format: $HOSTID $EVENT $TIME $CUSTOMERINFO $HOSTNAME message You can also use the rscadm subcommand send_event -c to send an alert. You can do this directly at the superuser prompt, and you can also create a command file that runs and sends the alert under special circumstances.
Use a meaningful file name that includes the name of the server that RSC controls. Later, you can refer to this file to restore the settings if you need to reinstall RSC software on the server or replace the server’s main logic board.
Page 28
Sun Remote System Control (RSC) User’s Guide • March 1999...
(GUI). This chapter gives an overview of how to access the RSC GUI, and use of RSC windows and dialog boxes. If you need to use RSC commands and the GUI is not available, you can use RSC shell commands. After you log in to your RSC account from a terminal window, the RSC shell prompt appears (rsc>), and you can enter commands.
Note – It is important that you enter the name or IP address of the RSC device, not the name or IP address of the server. To monitor or control more than one server, start a separate GUI session for each.
RSC Permissions Required for Access to GUI Functions All RSC users can look at RSC information. The table in the RSC User Administration dialog box shows additional permissions assigned to each user. These additional user permissions grant access to specific items in the GUI command tree.
Page 32
Show Environmental Status Change Password View Logs options (except Reset Console Logs) Help Topics About RSC Sun Remote System Control (RSC) User’s Guide • March 1999...
(GUI). Online Help is available when you use the GUI. If you need to use RSC and the GUI is not available, you can use the RSC command shell. The RSC command shell is a simple command-line interface that supports commands that allow you to administer or diagnose the server.
After RSC software is installed and configured and an account has been set up for you, you can connect to RSC and log in to your account using a Solaris workstation, Windows PC, standard ASCII character terminal, or a computer running ASCII terminal emulation software.
Page 35
You can enter RSC shell commands at the rsc> prompt. Logins are recorded in the RSC event log. In addition, RSC sends an alert if it detects five login failures within five minutes. You can also set RSC to disconnect a session connected to the serial port after ten minutes of inactivity;...
Server Status and Control Commands The following RSC commands show server status or control server operation: environment shownetwork console break bootmode reset poweroff poweron 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.
Page 37
DISK 3: [EMPTY] DISK [OK] DISK 4: [EMPTY] DISK [OK] DISK [OK] ================================= Fan Bank: --------- Bank Speed Status (0-255) ---- ----- ------ ================================= Power Supplies: --------------- Supply Status ------ ------ ================================= rsc> Chapter 4 Using the RSC Command Shell...
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” on page 43. break Use the break command to put the server into debug mode.
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>...
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.
Use the loghistory command without subcommands to display the history of all events logged in the RSC event buffer. These events include server reset events and all RSC commands that change the state of the system. You can also use the command abbreviation lhist.
16 Kbytes of information. When the first power-on boot begins, RSC fills the original boot (oboot) buffer with data from the server’s console. After that buffer fills up, it writes data to the original run (orun) log.
When RSC senses a server reset while in the orun log, it switches to the boot log. After that fills up, it switches to the run log. When the run log fills up, it overwrites old data in the run log.
See “RSC Configuration Variables” on page 35 for descriptions of these variables. Changes to some variables do not take effect until the SSP that RSC is running on is reset using the command resetrsc or rscadm resetrsc.
9:45 p.m. of the current month, day, and year. Note – Whenever the server boots, it sets the RSC current date and time. However, to keep RSC time in sync with server time, Sun Microsystems recommends that you implement a script that uses the command rscadm date -s to update RSC time periodically from the server time.
When used to change a password, RSC prompts for your current password, and if you enter it correctly, it prompts for the new password. RSC prompts again for the new password, and updates it if entered identically both times. For example: rsc>...
If these restrictions are not met, the system issues a warning and the command fails. userdel username Deletes an RSC user account. You must have U level user permission to use this command. usershow [username] Shows RSC user accounts.
The resetrsc command performs a hard reset of RSC. This terminates all current RSC sessions. You must have A level user permission to use this command. You can also reset RSC by using the rscadm resetrsc command. Sun Remote System Control (RSC) User’s Guide • March 1999...
RSC has non-volatile configuration variables you can use to change RSC behavior. The installer sets most configuration variables during installation. After installation, you can use the GUI, RSC shell, or the rscadm set command to set or change configuration variables.
You must have A level user permission to set configuration variables from the GUI or RSC shell; you must log in to the server as root to use the rscadm set command. Use the show command to show configuration variables, and use the set command to set a variable.
Changing RSC Serial Port Settings” on page 79. serial_data This variable sets the number of RSC data bits; valid values are 7 and 8. The default setting is 8. Changes to this variable take effect on the next login connection over the RSC serial port.
Use this variable to specify whether PPP is the default protocol on the RSC serial port. Valid values are true or false; the default is false. Changes to this variable take effect on the next login connection over the RSC serial port.
This variable specifies the number of RSC serial port data bits for sending an alert to pager 1. Valid values are 7 and 8. After RSC sends the page alert, the data bits revert to the setting specified in the serial_data variable.
This variable specifies the number of RSC serial port data bits for sending an alert to pager 2. Valid values are 7 and 8. After RSC sends the page alert, the data bits revert to the setting specified in the serial_data variable.
This variable specifies the number of RSC serial port stop bits for sending an alert to pager 2. Valid values are 1 and 2. After RSC sends the page alert, the stop bits revert to the setting specified in the serial_stop variable.
Ethernet Port Variables ip_mode Use this variable to control how RSC configures the IP address for its local Ethernet port. Choose the ip_mode value according to the services available on the network to which RSC is connected. The following list describes the available values.
This variable sets the escape sequence character for ending a console session and returning to the RSC shell. The escape sequence applies to all RSC users for the server. The escape sequence consists of the escape character followed by a period.
An error occurred during execution of the userpassword command; this message is followed by a more detailed message. Error changing password for <username> During execution of the userpassword command, a SEEPROM error occurred. Sun Remote System Control (RSC) User’s Guide • March 1999...
Page 59
During execution of the console command, RSC could not allocate enough memory to connect to the console. Failed to allocate memory! During execution of the show command, RSC could not allocate enough memory to show the variable’s value. Failed to get password for <username>...
Page 60
No free user slots This error occurs if you try to add a user account when RSC already has four accounts configured. RSC supports only four user accounts; you must delete an account before you can add another.
C H A P T E R Using the rscadm Utility The rscadm utility and its subcommands allow administration of RSC from the host. You must log in to the server as root to use rscadm. Most rscadm subcommands are...
Use the date subcommand to show the current date and time; use the -s option to synchronize RSC time to the server time. Supply a date with the subcommand to set RSC time to a time other than the server time.
This subcommand supports downloading new firmware residing in file into RSC. If you specify boot, the contents of file will be installed in the boot section of RSC non- volatile memory. If you do not specify boot, the contents of file will be installed in the main firmware section of RSC non-volatile memory.
Use this subcommand to change configuration of the modem connected to the RSC serial port. If the modem is properly connected, you can enter standard AT commands and see responses from the modem. At the beginning of a line, enter the escape character (~) followed by a period to exit from this subcommand.
If passwords do not match, you are prompted to enter again. rscadm: all user slots are full This error occurs if you try to add a user account when RSC already has four accounts configured; RSC supports only four user accounts. You must delete an account before you can add another.
Page 66
RSC encountered an internal error when trying to add a user account. The RSC SEEPROM may be faulty. rscadm: couldn’t change password RSC encountered an internal error when trying to change a user password. The RSC SEEPROM may be faulty.
Page 67
You cannot execute the download subcommand when the server keyswitch is in the Lock position. rscadm: either the RSC hardware was not detected or a lock file was found. Only one instance of rscadm can run at a given time.
Page 68
During execution of the download subcommand, RSC did not enter boot mode correctly. rscadm: RSC firmware not responding RSC main firmware is not responding. Perhaps RSC is booting, main firmware is corrupt, or RSC has a hardware problem. rscadm: RSC not responding to requests The response expected from RSC was not sent.
Page 69
RSC did not acknowledge data sent to it. Is RSC working? rscadm: user already exists The user you are trying to add already has an RSC account on this server. rscadm: username did not start with letter or did not contain lowercase letter You used an invalid username format when trying to add an RSC user account.
Page 70
USAGE: rscadm userdel <username> USAGE: rscadm userpassword <username> USAGE: rscadm userperm <username> [cuar] The user you are trying to add already has an RSC account on this server. USAGE: rscadm usershow [username] Sun Remote System Control (RSC) User’s Guide • March 1999...
Performs a soft reset of RSC; this is the same as using the command rscadm resetrsc -s. diag-output-to rsc|ttya Directs POST output to either RSC (1) or ttya (0). This command takes effect after the next server reset.
Updates the RSC Ethernet address from the contents of the server ID PROM. Use this command after replacing the server NVRAM module. .rsc Displays RSC information, including the diag-output-to setting and the RSC POST status word. OBP Environment Variable Properties Two environment variable properties are available to the user for specifying the RSC console to OBP.
Can’t log in to RSC Check the RSC device name you are connecting to (normally servername-rsc). Check that you are using your correct RSC username; it may not be the same as your system username. Check that you are using your correct RSC password.
First, log in to the server as root and see if the command rscadm status reports a good status. If it does, then RSC is working and there is an Ethernet configuration problem. Use the rscadm show command to check that Ethernet configuration variables are set correctly.
First, log in to the server as root and see if the command rscadm status reports a good status. If it does, then RSC is working. Log in to the server as root and use the rscadm show command to check that serial port configuration variables are set correctly.
Log in to the server as root and use the command rscadm date -s to synchronize RSC time to server time. Consider setting up a repetitive job to do this using the cron utility. You can perform some RSC functions, but not others Specific user permissions are required to perform functions;...
Troubleshooting Server Problems Using RSC RSC is useful for troubleshooting a server that is not responding. If the server is responsive, connect to it as usual and use standard tools such as Solstice SyMON, SunVTS, and OpenBoot Diagnostics. If the server is not responding, log in to your RSC account and: Check the RSC event log and server environmental status for problems.
Page 78
Sun Remote System Control (RSC) User’s Guide • March 1999...
1. Install the UPS as documented in the SmartUPS Quick Reference Guide. 2. Install and configure PowerChute plus monitoring software as documented in the SmartUPS document Software Installation: Instruction Sheet. 3. Connect the UPS to one of the server serial ports (not the RSC serial port).
You can use any message string in place of "UPS: UPS On Battery". Be sure to enclose the message string in double quotation marks. Use the -c option to send an alert and also record the event in the RSC event log. To log the event only, do not use the -c option.
Page 81
12. Choose Exit from the PowerChute plus System menu. Appendix A Installing and Configuring an Uninterruptible Power Supply (UPS)
Page 82
Sun Remote System Control (RSC) User’s Guide • March 1999...
To enable and set up the RSC modem, you should use the following configuration settings unless otherwise indicated. You can use the GUI to change configuration settings, or you can use the RSC shell or the rscadm utility to change configuration variables.
For sending pager alerts, RSC is designed to operate with any modem paging service that complies with the Telocator Alphanumeric Protocol (TAP). If you want to support both dial-in to the RSC modem and dial-out to pagers, you should set the RSC serial port baud rate and pager baud rates to 9600.
Page 85
Baud Rate: 9600 page_baud2 9600 Parity: even page_parity2 even Stop Bits: 1 page_stop2 1 Data Bits: 7 page_data2 7 Password: password page_password2 password Modem Init. String: see “Modem page_init2 Initialization Strings” on page 72 Appendix B Configuring the RSC Serial Port Modem...
Set the serial port to fixed baud rate for incoming calls. Modem Initialization Strings Use the modem initialization strings for pagers 1 and 2 to allow RSC to set modem parameters required by the paging service during modem setup. The initialization string consists of attention (AT) commands.
Dial-up operation: Up AT responses/MultiTech responses MultiTech responses: Down Asynchronous/synchronous operation Asynchronous operation: Down Speed switch 28,800-bps operation: Up Speed switch 28,800-bps operation: Up Carrier detect/DSR forcing CD and DSR normal: Up Appendix B Configuring the RSC Serial Port Modem...
Modify RSC Configuration Variables Using the RSC GUI or RSC shell, set the following configuration variables as shown. MultiTech Modem II RSC Settings TABLE B-4 GUI Setting Configuration Variable Setting Serial Port Settings Baud Rate: 9600 serial_baud 9600 Enable hardware handshaking serial_hw_handshake true Alert Settings->Pager->Pager 1->Advanced...
B1 E1 M1 Q0 R0 V1 X0 &E0 &E4 &E6 &E8 &E10 &E13 &E14 %C0 #C1 *C0 &C1 $MB9600 $SB9600 $BA0 &W0 After confirming settings, turn the modem off, reset RSC using the GUI or the resetrsc shell command, and then turn the modem on again.
Load the configuration that is stored in Load the configuration that is stored in non-volatile memory/load the &F0 non-volatile memory: Off configuration from read-only memory Sun Remote System Control (RSC) User’s Guide • March 1999...
Modify RSC Configuration Variables Using the RSC GUI or RSC shell, set the following configuration variables as shown. Courier V.Everything RSC Settings TABLE B-6 GUI Setting Configuration Variable Setting Serial Port Settings Baud Rate: 9600 serial_baud 9600 Enable hardware handshaking serial_hw_handshake true Alert Settings->Pager->Pager 1->Advanced...
AT&B1 (Set serial port to fixed rate) AT&W (Store current settings to modem NVRAM) After executing these AT commands, you can verify the modem settings in NVRAM by using the ATI5 command: Sun Remote System Control (RSC) User’s Guide • March 1999...
Modem Reconfiguration Required After Changing RSC Serial Port Settings If you change the RSC serial port baud rate after configuring the modem, you must reconfigure the modem to use the new baud rate. Use a similar procedure if you change the serial parity, data bits, or stop bits setting.
UNIX utility such as tip to connect to the TAP paging terminal. This allows you to check the modem independent of RSC. If you can connect successfully using this method, you know you are using the correct paging terminal number.
Alert Message or RSC Event You can embed the rscadm subcommand send_event in a script or command file to log an RSC event or send an alert when certain conditions occur. Use the -c option to send an alert. This appendix provides an example Perl script file named dmon.pl that sends an RSC alert when a specified disk partition exceeds a specified percent of its capacity.
Page 96
$nofify_msg = ‘mount point “‘.$mount.’” is at ‘. $capacity.’ of capacity’; exec (@notify_cmd, ‘send_event’, ‘-c’, $nofify_msg) || die “ERROR: $!\n”; if ($found != 1) print STDERR “ERROR: \””, $ARGV[0], “\” is not a valid mount point\n\n”; close(DF); Sun Remote System Control (RSC) User’s Guide • March 1999...
Need help?
Do you have a question about the RSC and is the answer not in the manual?
Questions and answers