2 - C H A P T E R -

C H A P T E R 2

Installing and Uninstalling the Hardware Diagnostic Suite Software

This chapter covers the basics of installation concerns for the Hardware Diagnostic Suite. For further information about installation requirements, refer to the Sun Management Center 3.5 Software Installation and Configuration Guide.

Before You Install

Required Disk Space

The Hardware Diagnostics Suite requires 11 Mbytes if all components are installed. TABLE 2-1 shows the disk space used by each component:


Component	Package	Disk Space (approximate)
Server	`SUNWed`	350 Kbytes
Agent and tests	`SUNWedag`, `SUNWedagx`	8 Mbytes
Console	`SUNWhdrmi`	6 Kbytes
Common server and agent components	`SUNWedcom`	18 Kbytes
Help files, English only	`SUNWedh`	1.7 Mbytes
All components		11 Mbytes

Note - Additional space is needed to install localized help and message packages on top of the English packages. Each language is less than 2 Mbytes of additional space. Allow 13 Mbytes for a non-English installation.

System Load

When you run an additional application, such as a diagnostic application, on a system that is running day-to-day operations, you should consider the additional system load that is introduced.

TABLE 2-2 shows the typical system load on the CPU and memory resources when you run the Hardware Diagnostic Suite components. These measurements were made on an Ultra trademark 60 Workstation with 256 MB of memory.


Component¹	CPU Activity While Hardware Diagnostic Suite Is Idle	CPU Activity While Hardware Diagnostic Suite Is Running at Full Capacity	Memory Used (RAM/Swap in Kbytes)
Agent	0.05%	0.5-0.9%	3560/5888
Tests	N/A	0.2-0.9%	2000-4000/3000-5000
Server	0.04-0.09%	1-4%	12232/33120
Console	0.05-0.5%	4-8%	31216/45712

^{^1.Depending on which components are loaded on the system under test, you might only need to consider the added load of the Hardware Diagnostic Suite agent and tests (server and console components are typically loaded elsewhere in the network).}

Required Patches

TABLE 1 describes the Solaris trademark operating environment patches that must be installed on each system that runs the Hardware Diagnostic Suite agent.

The Hardware Diagnostic Suite installation script checks to see if these patches are installed on your system, and warns you if they are not present. In most cases, the installation script asks you if you want to install them, and if you answer "yes", they are installed for you. If you answer "no", the installation stops.

For Solaris 2.6, one of the required patches is not included in the Hardware Diagnostics Suite installation script because this patch is a comprehensive patch for the kernel that requires separate installation (see TABLE 1). Install this patch before you run the Hardware Diagnostic Suite installation script.


Solaris Release	Patches Included in the Hardware Diagnostic Suite Installation Script	Patches Not Included In The Installation Script
Solaris 2.6	105591-14 107733-10	105181-21 (see note below)
Solaris 7	106300-16 106327-15 106950-18	none
Solaris 8	none	none
Solaris 9	none	none

Note - For the Solaris 2.6 release, you need patch 105181-21 or later. The Sun Enterprise 10000 systems require a later version of patch 105181-21.

Downloading Hardware Diagnostic Suite

The Hardware Diagnostic Suite software is bundled with the core Sun Management Center software. You can obtain these programs either from the Sun Management Center 3.5 CDs, or from the Sun website at:

http://www.sun.com/sunmanagementcenter

Refer to the Sun Management Center 3.5 Installation and Configuration Guide for procedures and information about installation, including:

Installation requirements

Licensing Sun Management Center

System preparation

CD installation

Web-based installation

Installation and Removal

The Hardware Diagnostic Suite software is an add-on option when you install the Sun Management Center software with the es-inst script, and can be uninstalled using the Sun Management Center es-uninst script.

Hardware Diagnostic Suite can also be installed separately, after core Sun Management Center installation, using the GUI installation method. See the Sun Management Center 3.5 Software Installation and Configuration Guide for further details.

Note - If you do not plan to reinstall the Hardware Diagnostic Suite, answer yes to remove the crontab entries. When Hardware Diagnostic Suite schedule crontab entries remain, but the Hardware Diagnostic Suite agent is no longer installed, you might receive cron errors.

To Install Hardware Diagnostic Suite Using the es-inst Script

1. Run the es-inst script.

2. Choose the directory where you want the files to reside.

The default location is /opt.

3. Accept the appropriate core Sun Management Center packages.

The script asks you whether you want to use these as a production environment or a developer environment, and whether you want server, agent, or console components installed. It also gives you a choice of language to install. See the Sun Management Center 3.5 Software Installation and Configuration Guide for more information about the core software.

4. When you are prompted to select optional add-on features, accept the Advanced System Monitoring package.

This option includes all Hardware Diagnostic Suite packages.

5. Accept any packages designed for your specific platform.

For example, if you are installing this software on a Sun Fire^TM 15K, look for packages specific to that system type. See the documentation collection at http://www.sun.com/sunmanagementcenter for platform-specific information.

6. Accept any packages designed for the hardware you intend to test.

For example, if you intend to use Hardware Diagnostic Suite to test storage arrays, look for packages specific to that hardware type.

To Uninstall Hardware Diagnostic Suite Using the es-uninst Script

1. Run the es-uninst script from your Sun Management Center directory.

The default location is /opt/SUNWsymon/sbin.

2. Say No when asked if you want to uninstall your entire environment.

Choosing to uninstall your Production Environment, for example, would uninstall all of Sun Management Center, not just Hardware Diagnostic Suite.

3. Say Yes when asked if you want to uninstall Advanced System Monitoring.

This removes all Hardware Diagnostic Packages. You will also be asked whether you wish to retain the data from this version for later upgrades.

After Reinstalling Sun Management Center

If you reinstall the Sun Management Center software, you must reinstall the Hardware Diagnostic Suite software.

Refer to the Sun Management Center 3.5 Software Installation and Configuration Guide for:

System requirements

Supported systems

Preinstallation information

Installation and removal instructions

Reactivating Schedule Information After an Upgrade

Note that even if you have saved data from your previous version of Hardware Diagnostic Suite when upgrading, Hardware Diagnostic Suite 2.0 does not automatically recognize old schedules. The scheduling information remains, but the entries are no longer called as active cron jobs.

To make old schedules active again, you must transfer the information from the /var/opt/SUNWhwdiag/sched.cron file to your crontab file.

Note - If you want to reestablish old schedules, you must do so before creating any new ones. Creating a new schedule pushes the new crontab data to the sched.cron file and overwrites it, erasing the old unattached schedules.

Hardware Diagnostic Suite Packages

The installation of the Hardware Diagnostic Suite is performed by the Sun Management Center software installation script, never by installing individual packages. However, for general information, the following table lists the packages that make up the Hardware Diagnostic Suite.


Package Name	Description
`SUNWed`	Server package
`SUNWedag`	Agent and tests package
`SUNWhdrmi`	Console package
`SUNWedagx`	64-bit agent and tests package
`SUNWedcom`	Common components for server and agent
`SUNWedh`	Help package (English only)