|C H A P T E R 5|
Using the rscadm Utility
The rscadm utility and its subcommands allow administration of Sun Remote System Control (RSC) from the host. You must log in to the server as root to use rscadm.
Installation places the rscadm utility in the following directory:
You can obtain the string to use for platform-name using the Solaris command
uname -i. For example:
Set your path to the rscadm utility so that you can use the command rscadm.
Most rscadm subcommands are also available using the RSC command shell, but rscadm is convenient for:
The rscadm utility uses the following subcommands.
This subcommand prints out a basic Help message including a list of rscadm subcommands and a short description of each.
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.
See date [[mmdd]HHMM|mmddHHMM[cc]yy][.SS] for a description of date formats.
Use the set subcommand to set an RSC configuration variable. See RSC Configuration Variables for descriptions of these variables.
You can use the null string ("") to set a variable to null. To set a variable to a string that includes spaces or UNIX shell special characters, enclose the string in double quotes. For example:
Use the show subcommand to display the value of one or more RSC configuration variables. If you do not specify a variable, RSC displays all configuration variables. See RSC Configuration Variables for descriptions of these variables.
The shownetwork subcommand displays the current network configuration.
Use the loghistory subcommand 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. This will return the log entries in reverse order, with the newest messages first.
This subcommand resets RSC immediately. To terminate all connections cleanly before the reset, use the -s option. If no argument is supplied, this subcommand performs a hard reset and drops all connections.
Note - When you reset RSC on a Sun Enterprise 250 server without also resetting the server, RSC time defaults to 1/1/70. To synchronize RSC time with server time, reset the server, use the rscadmcommand rscadm date -s, or run the script /usr/platform/platform-name/rsc/rsc-initscript. You can obtain the string to use for platform-nameusing the Solaris command uname -i.
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.
When the transfer completes, RSC resets itself. If the host keyswitch is in the Lock position, you cannot update RSC firmware, and an error message displays.
Use this subcommand to enter an event into the RSC event log. Use the -c option to also send an alert message that RSC forwards according to the alert configuration. The message is an ASCII string of no more than 80 characters. To use a string that includes spaces or UNIX shell special characters, enclose the string in double quotes.
See Appendix C for an example of a Perl script that uses this subcommand to send an alert.
Use this subcommand to change configuration of the RSC modem (or for Sun Enterprise 250 servers, the configuration of the modem connected to the RSC serial port). You can enter standard attention (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. By default, the escape character is tilde (~). For example:
The escape character for modem_setup is the same as the escape character used for the RSC shell console command, which is set using the escape_char configuration variable. See escape_char.
Note - For Sun Enterprise 250 servers, the escape sequence for rscadm modem_setupis always ~.(a tilde followed by a period). The RSC console has a configurable exit character, but the escape character for rscadm modem_setupis fixed.
This error occurs if you try to add a user account when RSC already has the maximum number of accounts configured. RSC supports only 16 user accounts (4 on the Sun Enterprise 250 servers). You must delete an account before you can add another.
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.
During execution of the set subcommand, you entered an invalid variable. See RSC Configuration Variables for correct values.
During execution of the set subcommand, you entered an invalid variable or value. See RSC Configuration Variables for correct values.