InfoDoc ID   Synopsis   Date
17878   Install and Configure a E250 RSC-Software Ethernet Connection   22 Feb 1999

Status Issued

Description
This infodoc is useful to perform a quick and straight-forward
configuration of the Enterprise 250 RSC (Remote Service Control)
software facility.

The example provided in this infodoc uses the Ethernet connection
of the E250 onboard SSP (System Service Processor).

 
Table of Contents:

1. General Information about RSC
2. Determine and Upgrade the OBP-and POST-Version of the E250 Server
3. Install and Configure the RSC/Server Software
4. Install and Configure the RSC/Client Software on Solaris
5. Using the Character Interface to access the RSC-Host
6. Using the Java Client Software to access the RSC-Host
7. Redirect the Console and Diagnostic Messages to the RSC/Client
8  Reset a RSC configuration on a RSC Server
9. Additional Information to the RSC Software


1. General Information about RSC


RSC is a server management tool that allows you to monitor and control
your server over modem lines or over a network.The RSC software works with
the SSP (System Service Processor) on the E250 main logic board. 

You can access RSC from a workstation running the Solaris, Windows and Sun's
RSC Java application, or from an ASCII terminal. 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 the server,
power-on and off the server and display environmental status information
from a remote console.

The RSC firmware on the SSP runs independently and uses standby power from
the server. 


2. Determine and Upgrade the OBP-and POST-Version of the E250 Server

 
To determine your server's current version of it's OpenBoot and POST (Power
On Self Test) firmware, enter one of the following commands at the UNIX
command line:

     /usr/platform/sun4u/sbin/prtdiag -v | grep OBP

     or

     /usr/sbin/prtconf -V

You can also determine the version number at the system ok prompt with the
following command:

     .version 

If the version displayed is V3.7.6 or below, obtain patch 106503-01 and
perform the update of the E250 OBP-Firmware to V3.7.7 like this.

lab012# ls /patches/106503-01
802-3233-18a.ps          flash-update-250-latest
flash-update-250-01      README.106503-01
lab012# cp /patches/106503-01/flash-update-* /
lab012# chmod 755 /flash-update*
lab012# halt

{0} ok
{0} ok reset
Resetting ...

{0} ok
{1} ok boot 2.6:a /flash-update-250-latest (name of boot disk may differ!)
Resetting ... 

Can't open input device.
Keyboard not present.  Using ttya for input and output.

Sun (TM) Enterprise 250 (2 X UltraSPARC-II 296MHz), No Keyboard
OpenBoot 3.7, 1024 MB memory installed, Serial #10279194.
Ethernet address 8:0:20:9c:d9:1a, Host ID: 809cd91a.

Rebooting with command: boot 2.6:a /flash-update-250-latest           
Boot device: /pci@1f,4000/scsi@3/disk@8,0:a  File and args: /flash-update-250-latest
/

Standalone Flash PROM Update Utility, Rev. 1.14
                        Ultra(tm) 1
                        Ultra(tm) 2
                        Ultra(tm) 5/10
                        Ultra(tm) 30
                        Ultra(tm) 60
                        Ultra(tm) Enterprise(tm) 250
                        Ultra(tm) Enterprise(tm) 450

This utility allows you to interactively update the firmware
revisions in specific system Flash PROM components.

Type h for help, q to quit, Return or Enter to continue: 

Every precaution should be taken to prevent the loss of system
power during the Flash PROM programming process!

Type h for help, q to quit, Return or Enter to continue: 

       Firmware Release(s)                Firmware Release(s)
 Currently Existing in the System      Available for Installation  /  Install?
---------------------------------- -------------------------------------------
OBP 3.7.3 1998/05/07 17:24         OBP 3.7.7 1998/06/17 16:06           no
POST 6.0.2 1998/04/23 16:17        POST 6.0.4 1998/06/01 17:49          no

Type sa if you wish to select all available firmware releases for
installation.  Type h for help, quit to exit, or cont to continue: sa

Type sa if you wish to select all available firmware releases for
installation.  Type h for help, quit to exit, or cont to continue: sa

       Firmware Release(s)                Firmware Release(s)
 Currently Existing in the System      Available for Installation  /  Install?
---------------------------------- -------------------------------------------
OBP 3.7.3 1998/05/07 17:24         OBP 3.7.7 1998/06/17 16:06           YES
POST 6.0.2 1998/04/23 16:17        POST 6.0.4 1998/06/01 17:49          YES

Type sa if you wish to select all available firmware releases for
installation.  Type h for help, quit to exit, or cont to continue: cont

The Flash programming process is about to begin.

Type h for help, q to quit, Return or Enter to continue: 

100% Complete

**IMPORTANT**  As a consequence of the firmware upgrade that just took
place, it is very possible (but not certain) that the customized values
in the configuration variables will revert to their *default values*
upon the next system power-cycle or soft-reset. (The exception is that
"diag-switch?" may be automatically set to "true".)  If this happens
then it could have a significant affect on the behavior of the system
after the power-cycle/soft-reset.

Following is a list of the system's NVRAM configuration variables which
have been customized (i.e. they are different than the default values).
You may wish to write down the values of the indicated configuration
variables so that they may be restored (if necessary) after the next
power-cycle or soft-reset.  (Type "help system" at the PROM monitor's
ok prompt to get information about setting the configuration variables.)

Variable Name           Customized Value
reboot-posc             4294582272
reboot-cmd              boot 2.6:a /flash-update-250-latest
auto-boot?              false
diag-device             2.5.1 2.6 2.7
boot-device             2.6:a 2.5.1 2.6 2.7
use-nvramrc?            true
nvramrc                 <type 'printenv nvramrc' to see full buffer contents>

*NOTE* The "use-nvramrc?" variable is active (true) and the "nvramrc"
       buffer is not empty, so you will want to evaluate whether or
       not to reinstall the code in nvramrc if the configuration
       variables are indeed reset to their default values - and if
       they are *not* reset to default values then you may also want
       to evaluate if the contents of nvramrc are still valid and
       necessary.  For help on restoring/modifying the contents of
       nvramrc, type "help nvram" at the PROM's ok prompt.

Program terminated
{0} ok boot

The new version of the servers OBP firmware should now V3.7.7 like in this
sample update.

lab012# /usr/platform/sun4u/sbin/prtdiag -v | grep OBP
  OBP 3.7.7 1998/06/17 16:06   POST 6.0.4 1998/06/01 17:49
lab012#


3. Install and Configure the RSC/Server Software 


After the RSC software has been obtained (either from the network or from
the E250 Supplement CD-ROM), the following script can be used, to install
the RSC server software.

lab012# sh RSC.sh     

Welcome to the SUN Remote System Control software installation utility

You may install:

 1. The SUNWrscu package to enable the Remote System Control hardware on
    this Sun Enterprise 250
 2. The SUNWrscj package to allow this Solaris system to control a Remote
    System Control device of a Sun Enterprise 250
 3. Both of the above
Enter 1, 2 or 3 for one of the above choices, or q to exit this
script without installing anything: 1  

Installing SUNWrsc.u ...
Copyright 1998 Sun Microsystems, Inc. All rights reserved.

Installation of <SUNWrsc> was successful.
lab012#

Once installed, we can configure now the RSC server software with the script
rsc-config in /usr/platform/sun4u/sbin.
  
lab012# rsc-config

Continue with RSC setup (y|n): y

Set RSC date/time now (y|n|?) [y]: y
Server Hostname [lab012]: lab012-rsc
Edit customer info field (y|n|?) [n]: y
   Customer Info (<= 8 char): testrsc
Enable RSC Ethernet Interface (y|n|s|?) [n]: y
   RSC IP Mode (config|dhcp|?) [dhcp]: config
   RSC IP Address: 129.157.141.15	   (not the IP address of the primary network interface!)
   RSC IP Netmask [255.255.255.0]: 
   RSC IP Gateway: 129.157.141.253
Enable RSC Alerts (y|n|s|?) [n]: y
   Enable Email Alerts (y|n) [n]: y
      SMTP Server's IP address: 129.157.141.22
      Setup Backup SMTP Server (y|n) [n]: 
      Email address: hermanns
   Enable Pager Alerts (y|n) [n]: 
Enable RSC Modem Interface (y|n|s|?) [n]: 
Setup RSC User Account (y|n|?) [y]: 
   Username: hermann
   User Permissions (c,u,a,r|none|?) [cuar]: 

--------------------
Verifying Selections
--------------------

General Setup
-------------
  Set RSC date now  = true
  Server Hostname   = lab012-rsc
  Customer Info     = testrsc

  Is this correct (y|n): y

Ethernet Setup
--------------
  IP Mode      = config
  IP Address   = 129.157.141.15
  IP Netmask   = 255.255.255.0
  IP Gateway   = 129.157.141.253

  Is this correct (y|n): y

Alert Setup
-----------
  Email Enabled      = true
  Email Address      = hermanns
  SMTP Server        = 129.157.141.22
  Paging Enabled     = false

  Is this correct (y|n): y

Modem Setup
-----------
- Modem disabled, ppp disabled

  Is this correct (y|n): y

User Setup
----------
  User Name        = hermann
  User Permissions = cuar

  Is this correct (y|n): y

This script will now update RSC, continue? (y|n): y
Updating flash, this takes a few minutes
........................................
........................................
........................................
........................................
........................................
........................................
........................................
...........................
Download completed successfully

RSC resetting (60 seconds): DONE
Setting up server to update RSC date on boot: DONE
Setting up server hostname: DONE
Setting up customer info field: DONE
Setting up ethernet interface: DONE
Setting up e-mail alerts: DONE
Disabling pager alerts: DONE
Disabling modem interface: DONE
Adding user to RSC:

A valid password is between 6 and 8 characters, has at least
two alphabetic characters, and at least one numeric or special
character.  The password must differ from the user's login name
and any reverse or circular shift of that login name.
Setting User Password Now ...

Password: 
Re-enter Password: 
User has been added to RSC

A RSC reset is required for some of the configuration variables
to take effect.
  Reset RSC now (y|n): y
Resetting RSC (60 seconds): DONE
Setting up RSC date: DONE

*******************************
RSC has been successfully setup
*******************************

lab012# 

We can easily verify and even modify this configuration with the utility
rscadm in /usr/platform/sun4u/sbin.

lab012# cd /usr/platform/sun4u/sbin
lab012# ls
eeprom          prtdiag         rsc-config      rsc-initscript  rscadm
lab012# rscadm show
page_enabled="false"
mail_enabled="true"
ip_mode="config"
ppp_enabled="false"
serial_hw_handshake="false"
serial_baud="9600"
serial_parity="none"
serial_stop="1"
serial_data="8"
customerinfo="testrsc"
ip_addr="129.157.141.15"
ip_netmask="255.255.255.0"
ip_gateway="129.157.141.253"
mailhost="129.157.141.22"
mailuser="hermanns"
page_info1=""
page_init1=""
page_password1=""
page_parity1="even"
page_stop1="1"
page_data1="7"
page_baud1="300"
page_info2=""
page_init2=""
page_password2=""
page_parity2="even"
page_stop2="1"
page_data2="7"
page_baud2="300"
ppp_local_ip_addr="0.0.0.0"
ppp_remote_ip_addr="0.0.0.0"
hostname="lab012-r"
escape_char="~"
lab012# 

 
4. Install and Configure the Java RSC/Client Software on Solaris


In order to access an RSC/Server host via the Java client software from a
Solaris workstation, the following conditions must be met.

	- the JDK V1.1.5 or higher must be installed on that system
	- the RSC/Server host must be known and accessible from that
	  system

To install the Java application client software on a workstation. 

# sh RSC.sh

Welcome to the SUN Remote System Control software installation utility

This machine is not a Sun Enterprise 250, so you may install:

 1. The SUNWrscj package to allow this Solaris system to control a Remote
    System Control device of a Sun Enterprise 250

Enter 1 to install the package, or q to exit this
script without installing anything: 1

Installing SUNWrscj ...
Copyright 1998 Sun Microsystems, Inc. All rights reserved.

Installation of <SUNWrscj> was successful.
#


5. Using the Character Interface to access the RSC-Host


It's possible to access the RSC-Host via telnet from any host in the network.

lab011# telnet 129.157.141.15	(or using the proper name of the RSC ethernet interface instead)
Trying 129.157.141.15...
Connected to 129.157.141.15.
Escape character is '^]'.

RSC version 1.8 (lab012-r)

Please login: hermann
Please Enter password:

rsc>
rsc> version -v
RSC Bootmon version: 0.22
RSC bootmon checksum: 1B024F08

RSC version: 1.8
RSC firmware checksum: FE914401

RSC firmware built Sep  8 1998, 16:00:28
rsc>
rsc> exit


6. Using the Java Client Software to access the RSC-Host

As soon the RSC GUI Java application is installed, it can be used to access
the RSC host. The GUI software rsc resides in /opt/rsc/bin and will need to
be started like this.

molokini/hermanns> /opt/rsc/bin/rsc

You have to fill out the form and specify the name or ip address of the RSC
host and provide a username and password to access the RSC software on that
server.


7. Redirect the Console and Diagnostic Messages to the RSC/Client

To enable RSC to receive and send console and diagnostics commands, set the
following OBP variables.

lab012# halt
Oct  5 15:09:48 lab012 halt: halted by root
syslogd: going down on signal 15
automountd not running, retrying
syncing file systems... done
Program terminated
{1} ok
{1} ok diag-output-to rsc
{1} ok setenv input-device rsc
input-device =        rsc
{1} ok setenv output-device rsc
output-device =       rsc
{1} ok boot

molokini/hermanns> telnet 129.157.141.15

Trying 129.157.141.15...
Connected to 129.157.141.15.
Escape character is '^]'.

RSC version 1.8 (lab012-r)

Please login:
Please login:
Please login: hermann
Please Enter password:

rsc>
rsc> console


8  Reset a RSC configuration on a RSC Server

To reset a RSC configuration, the utility rscadm can be used. First remove
any previous created RSC users and then, erase the RSC flash information.
After the next reboot, everything in terems of RSC should be  have been
cleared.

lab012# rscadm userdel hermann
lab012# rscadm resetrsc
lab012# reboot


9. Additional Information to the RSC Software

More and detailed information can be found at the following sources.

	- the Sun Remote System Control (RSC) Installation Guide
	- the Sun Remote System Control (RSC) Users Guide
INTERNAL SUMMARY:
9. Additional Information to the RSC Software

More and detailed information can be found at the following sources.

	- Website http://edist.Corp.Sun.COM/sunsoft/sw/E250/
APPLIES TO: Operating Systems/Solaris/Solaris 2.6 ATTACHMENTS:


Copyright (c) 1997-2003 Sun Microsystems, Inc.