C H A P T E R 2 - Installing the Online CPU Diagnostics Monitor Software

C H A P T E R 2

Installing the Online CPU Diagnostics Monitor Software

This chapter describes how to install and remove the Online CPU Diagnostics Monitor (CDM) software, and includes the following sections:

CDM Packages

Installation Requirements

Installing the CDM Software

Detecting the Version of the Installation

Removing the CDM Software

CDM Packages

The following is a list of the CDM packages:

TABLE 2-1 CDM Packages
Package Name	Description
SUNWcdiar	CDM (root) package that contains the startup scripts and the default configuration file (`cpudiagd.conf`).
SUNWcdiax	CDM 64-bit package that contains the CPU diagnostics test, `cputst` and the CDM daemon, `cpudiagd`.
SUNWcdiam	CDM package that contains the online manual pages for `cputst`(1M), `cpudiagd`(1M) and `cpudiagd.conf`(4).

Installation Requirements

The CDM software is supported on SPARC 64-bit only and is not compatible with 32-bit platforms. The hardware platform must support UltraSPARC III or UltraSPARC IV families of processors and must support the sparcv9+vis2 instruction set. A Solaris 8, 9, or 10 Operating System must be installed (with core system support software group SUNWCreq at a minimum) before installing CDM. The operating system must support SPARC 64-bit. To verify that CDM is supported on your hardware platform, verify that the following command output includes sparcv9+vis2.

# /usr/bin/isalist

sparcv9+vis2 ...

You must be superuser to install the CDM software. There must be at least 2 Mbytes of available disk space in both root (/) and /usr partitions. There must be at least 1 Mbyte available disk space in the /var partition.

Installing the CDM Software

There are several utilities available for installing packages. This section describes how to use the pkgadd utility to install CDM from the file system directory containing the CDM packages:

To Install the CDM Software

1. Become superuser.

2. Use the pkgadd command to install the packages in the following order:

# pkgadd -d path_to_packages_directory SUNWcdiax SUNWcdiar SUNWcdiam

Note - SUNWcdiar depends on SUNWcdiax--thus, the packages must be installed in the above order.

Note - Installing CDM software also starts the online CPU diagnostics monitoring by starting the cpudiagd daemon.

Detecting the Version of the Installation

To verify the version of the installed software at any time, use one of the following methods.

To individually examine the version of cputst and cpudiagd binaries:

# /usr/platform/sun4u/sbin/sparcv9+vis2/cputst -v

The test verbose messages displayed should indicate the cputst version number as 2.0 if the latest version is installed.

The cpudiagd binary version number can be detected by examining the informational log file:

# tail /var/cpudiag/log/info.log

The entries in the informational log message file contain the version number of the installed software. The last message entry by cpudiagd should contain version 2.0 if the latest version is installed.

To use the pkginfo command to indicate the correct installed version of the packages (2.0 is the latest):

# /usr/bin/pkginfo -l SUNWcdiax SUNWcdiar SUNWcdiam

Removing the CDM Software

Use the pkgrm command to remove the installed CDM packages in the following order:

# pkgrm SUNWcdiam SUNWcdiar SUNWcdiax