C H A P T E R 1

Installation

This guide is designed for users who install and configure SRS Net Connect 3.1 through the Solaris^TM 9 Operating System (OS) 4/04 CD. SRS Net Connect 3.1 will be loaded onto new Sun systems during the manufacturing process. If you have a Sun system that was not loaded with Net Connect during manufacturing, you can load it through the Solaris 9 OS 4/04 Extra Value CD.

SRS Net Connect is a no-cost, self-monitoring Web-based application that uses programs (also called providers) to gather data and monitor your systems. SRS Net Connect helps you maximize system availability and reliability. You can add or remove other fee-based services, such as Sun^SM System Analysis, to meet your management needs.

SRS Net Connect 3.1 supports up to 500 monitored systems per group and 2000 monitored systems per company.

Typographic Conventions

This guide includes the following typographic conventions:

File and directory names appear in courier.

Keyboard input appears in bold courier.

Fields, window titles, and menu items that you select appear in Initial Capitals.

Button names and check boxes you click appear in Small Caps Bold.

Prompts and document titles appear in italic.

The # prompt indicates that you should be at a root prompt.

System Requirements

You must have a standard browser to view the SRS Net Connect 3.1 application. SRS Net Connect does not support browsers that use 56-bit encryption. For the Solaris Operating System (Solaris OS), standard browsers include Netscape trademark 4.79 or higher and Mozilla 1.2.1.

Meeting the Monitored System Requirements

Each monitored system must meet the following minimum requirements:

Approximately 30 Mbytes of available disk space to accommodate typical SRS Net Connect 3.1 installation files and other files. This space depends on the type of monitored system.

UltraSPARC® architecture-based system running on the Solaris 9 OS. The 32-bit linker patch 112963-08 or higher is required to run the monitored system proxy. If you have QLC drivers installed, you must install patch 113042-04.

The following packages are required:

SUNWscpu

SUNWlibC

SUNWadmc

SUNWadmfw

SUNWCreq metacluster package (installed with the Solaris OS) only on clustered systems

Average CPU utilization is less than .5 percent of the CPU on a single processor desktop system. Average RAM consumption (minus common shared libraries, such as libc and libnsl) is 5.8 Mbytes.

Meeting the Storage Automated Diagnostic Environment Requirements

If you install the optional Storage Automated Diagnostic Environment 2.3, the system on which Storage Automated Diagnostic Environment package is installed must meet the following minimum requirements:

The SUNWstade package requires 25 MBytes available disk space; the SUNWstadn package requires 21 MBytes. You will also need an additional 100 KBytes per device.

Perl 5.005 or higher.

Solaris 9 OS with the SUNWsan package and patch 113043-01 or higher.

Average CPU utilization is less than .5 percent of the CPU as measured with a 248 MHz single CPU system. Storage Automated Diagnostic Environment uses approximately 14 MBytes of the 128 MBytes of required RAM.

Installation Overview

Use the Solaris 9 4/04 Extra Value CD to install the SRS Net Connect software and then run an activation script to configure and activate Net Connect.

Installing SRS Net Connect 3.1 through the Solaris 9 4/04 Extra Value CD involves three steps:

1. Use the CD to install SRS Net Connect 3.1 on each monitored system. The SRS Net Connect 3.1 software contains the following components:

Providers - Collect data, events, and alarms about your operating system and hardware and send it to the monitored system proxy

Monitored system proxy - Formats, queues, and sends the provider data through HTTPS to the SRS Net Connect Data Center at Sun

Encryption support - Provides encryption for security certificates

2. Register and download your customized activation kit from the SRS Net Connect 3.1 web site.

3. Run the activation script on each monitored system.

After you install the Net Connect software from the CD, you must obtain an activation kit from the SRS Net Connect web site and run the activation script. The activation script guides you through the configuration and activation of the SRS Net Connect 3.1 software.

See the Sun^SM Remote Services Net Connect 3.1 Customer Planning Guide for more information on the SRS Net Connect architecture, monitored system, and providers.

Before you install SRS Net Connect 3.1 on the monitored system, complete the steps in the Installation Checklist in TABLE 1-1.

TABLE 1-1 Installation Che cklist
	Verify that your monitored system meets the requirements listed in System Requirements.
	If you have a version of Storage Automated Diagnostic Environment installed that is earlier than version 2.3, remove it before installing Storage Automated Diagnostic Environment 2.3 and SRS Net Connect 3.1. Your existing Storage Automated Diagnostic Environment settings will be saved. Follow the steps in the Sun^SM Remote Services Net Connect 3.1 Customer Installation Guide.
	If you have installed a version of CST that is earlier than 3.5, follow the special instructions in "Preparing for the CST Installation" in the Sun^SM Remote Services Net Connect 3.1 Customer Installation Guide.
	Determine if you will use an existing user account or create a new user account on the monitored system. The user name must belong to the user group. The user name and group that you enter are used to run all processes that do not require root access. For example, the monitored system proxy will run under the user name and group (since it does not need root privileges), while the trend and event providers must run as the root user. If you do not have a user name and group, the installation script will not run successfully.
	Verify that the user you specify during installation has a home directory.
	Verify that the user account has a shell associated with it, and that the user can interact with the crontab entries. The installation script checks for the existence of the user and group, verifies that the user account has a shell associated with it, and that the user can interact with the crontab entries.
	Verify that the user account you specify during installation does not allow login. You should also verify that the user account is not locked. A locked account contains LK as part of its password. Type the following for more information on the shadow file: `man` `shadow`. You can substitute NP (no password) for LK in the `/etc/shadow` file. Under Solaris 9 OS, the cron process will not work with a locked account.

Net Connect Installation

If SRS Net Connect has never been installed on your monitored system, follow the instructions in Installing Net Connect 3.1 for the First Time. If you are upgrading an existing version of Net Connect, follow the instructions in Upgrading to Net Connect 3.1.

SRS Net Connect 3.1 uses the follo wing default directories:

The activation kit script and uninstall script are located in the directory where you download and extract the installation package.

The package base directory is /opt.

Each configuration file is placed in a directory named the same as the package (for example: /etc/opt/<package name>). For example, the proxy configuration file (srsproxyconfig.cfg) is located in the /etc/opt/SUNWsrspx/ directory.

A message queue directory structure on the monitored system proxy holds data from the system if the data cannot be sent immediately to the SRS Net Connect Data Center. The default size for the message queue is 20 MBytes. The default directory for the message queue is /var/SUNWsrspx/SRSQueueStore. An SRS_IMAPISOCK file is also created in the PKG_INSTALL_ROOT/var/opt/SUNWsrspx/ directory.

Installing Net Connect 3.1 for the First Time

Perform the following steps to install SRS Net Connect 3.1 on a monitored system that did not have Net Connect installed at the factory:

1. Insert the Solaris 9 4/04 Extra Value CD in the monitored system's CD-ROM drive.

2. The Solaris Web Start Wizard^TM displays the License screen. Click the Accept check box and click Next.

3. At the Ready to Install screen, review the providers that will be installed and click Install Now. If your system is FRU-enabled, the FRU provider is also installed. See FIGURE 1-1.

FIGURE 1-1 The Providers Listed on the Ready to Install Screen Will be Installed

The Providers on the Ready to Install Screen Will be Installed.

4. The Installing screen appears. Do not click Stop unless you want to terminate the installation. The following packages are installed:

SUNWsrscp - Configuration

SUNWsrsvp - Event

SUNWsrstp - Trend

SUNWsrsrp - Reboot

SUNWsrshp - Hardware alarms

SUNWsrspx - Proxy

SUNWexplo and SUNWsrsep - If the existing SUNWexplo package is not a compatible version, Net Connect upgrades the latest SUNWexplo and SUNWsrsep packages for Sun^SM System Analysis

SUNWfrunc and SUNWsrsfp - If the monitored system is FRU enabled, both packages are installed

SUNWcstu - CST; this package is added to the /opt/SUNWcstu/ directory

5. At the Additional Information screen, review the information and click Next.

6. At the Installation Summary screen, you can click Details as shown in FIGURE 1-2 to see specific directory names and provider versions. Click OK to exit the Details screen and then click Exit.

FIGURE 1-2 Click Details to See More Information About the Installation

You can get more information about the installation by clicking Details.

7. After you install the SRS Net Connect software, the next step is to go to SRS Net Connect 3.1 to get your customized activation kit at the https://srsnetconnect.sun.com site. See Chapter 2 for instructions.

Upgrading to Net Connect 3.1

Perform the following steps to upgrade existing versions of SRS Net Connect to Net Connect 3.1:

1. Insert the Solaris 9 4/04 Extra Value CD in the monitored system's CD-ROM drive.

2. At the License screen, click the Accept check box and click Next.

Note - If you have already installed Net Connect 3.1 with the Solaris Web Start Wizard, you must click Exit and use the prodreg command to remove Net Connect. Follow the instructions in Uninstalling Net Connect.

3. If an older Net Connect component (such as a version of Sun^TM Explorer prior to 4.2, or a version of CST prior to 3.5) is detected, click Uninstall when FIGURE 1-3 appears.

FIGURE 1-3 Old Components are Detected and Removed

The installation detects and removed old components.

Configuration files are copied to a file archive directory.

If you have an SRS Net Connect 2.x component installed, uninstalling removes the component. Uninstalling copies the following configuration information to a file archive directory called /var/OldSUNWncFiles/:

The /etc/opt/SUNWnc/alarm_rules file

The /etc/opt/SUNWnc/event_pvr.cfg file

The /etc/opt/SUNWnc/trend_pvr file

The SUNWnc01 package is removed from the monitored system.

If you have an SRS Net Connect 3.0.1, 3.0.2, 3.0.3, or 3.0.4 component installed, uninstalling removes the component and copy the following configuration information to the DISK_STORE_BASE/${pkginst}Update/ directory (for example, the /var/SUNWsrshpUpdate directory):

The /etc/opt/SUNWsrspx/srsproxyconfig.cfg file

The /etc/opt/SUNWsrsvp/alarm_rules file

The /etc/opt/SUNWsrsvp/event_pvr_config.cfg file

The /etc/opt/SUNWsrstp/trend_pvr_config.cfg file

The /etc/opt/SUNWsrshp/notify.rules file

The /etc/opt/SUNWsrshp/ssha_pvr_config.cfg file

The /etc/opt/SUNWsrshp/customer.patterns file

The SRSQueueStore directory and its contents are also copied to the archive directory. The location of the SRSQueueStore is controlled by the DISK_STORE_BASE value in the srsproxyconfig.cfg file. The following packages on the monitored system are removed:

SUNWsrscp - Configuration

SUNWsrsvp - Event

SUNWsrstp - Trend

SUNWsrsrp - Reboot

SUNWsrshp - Hardware alarms

SUNWsrspx - Proxy

SUNWsrsep - RAS

SUNWexplo - Explorer, if it was installed with a previous version of Net Connect

SUNWfrunc and SUNWsrsfp - FRU for Net Connect, if it was installed with a previous version of Net Connect

Not all the providers listed above are installed on every monitored system.

Note - If you have already installed SRS Net Connect 3.1 through the Net Connect installation script, the Solaris Web Start Wizard does not install Net Connect 3.1 again and prompts you to exit the wizard. If you want to use the Web Start Wizard, you must remove Net Connect 3.1 by running the uninstall script (for example, UninstallNetConnect.003.001.000.sh) from the directory where you installed.

If you have CST 3.5 or earlier installed and the CST middleware server is not running, you must uninstall CST. The CST package is removed, but the CST data is saved. If you have already installed CST 3.5, the wizard reinstalls CST 3.5.

If you choose to remove a previous version of CST with the wizard and have the wizard reinstall CST 3.5, CST is not automatically started. You must run the activation script as described in Chapter 2 before CST will begin collecting data again.

Run the activation script or perform the following steps to manually start CST 3.5 to begin collecting data:

a. Remove the file that blocks CST from starting by typing:

# rm /etc/opt/SUNWsrspx/cst_nostart

b. Start CST before a reboot by typing:

# etc/init.d/cst start

You can also wait for CST to start after the next reboot, but CST data will not be collected until CST starts. See the Sun^SM Remote Services Net Connect 3.1 Customer Installation Guide for additional CST upgrade instructions.

4. At the Ready to Install screen, click Install Now.

5. The Installing screen appears. Do not click Stop unless you want to terminate the installation. The following packages are installed:

SUNWsrscp - Configuration

SUNWsrsvp - Event

SUNWsrstp - Trend

SUNWsrsrp - Reboot

SUNWsrshp - Hardware alarms

SUNWsrspx - Proxy

SUNWexplo and SUNWsrsep - If the existing SUNWexplo package is not a compatible version, Net Connect upgrades the latest SUNWexplo and SUNWsrsep packages for Sun^SM System Analysis

SUNWfrunc and SUNWsrsfp - If the monitored system is FRU enabled, both packages are installed

SUNWcstu - CST; this package is added to the /opt/SUNWcstu/ directory

6. At the Additional Information screen, click Next.

7. At the Installation Summary screen, you can click Details to see specific directory names and provider versions. Click OK to exit the Details screen and then click Exit.

8. After you install the SRS Net Connect software, the next step is to log into SRS Net Connect 3.1 to get your customized activation kit. See Chapter 2 for instructions.