Chapter 2 Installing and Removing SunVTS

This chapter describes how to install and remove the SunVTS^TM diagnostic program.

• "SunVTS Packages"

• "Installing SunVTS"

• "Removing SunVTS"

SunVTS Packages

Sun delivers software products in a form called a package. There are four packages and a readme file that support SunVTS 3.0:

• SUNWvts--contains the SunVTS kernel, user interface, and the collection of 32-bit binary tests. This is the main diagnostic package. You must install it before running SunVTS.

• SUNWvtsx--an extention package that provides SunVTS 64-bit binary tests and kernel. This package should be loaded on systems that support 64-bit execution, but it is not necessary for SunVTS 32-bit functionality.

• SUNWodu--contains SunVTS online diagnostic utilities that work in conjunction with SyMON system monitoring software. This package should be loaded on systems that run SyMON, but it is not required for SunVTS execution outside of SyMON.

• SUNWvtsmn--contains the SunVTS man pages. These files are loaded in the standard /usr/man directory. They are optional; however, they provide helpful information to the SunVTS user.

• SunVTS README file--is a text file that can be found in the SUNWvts directory once the SUNWvts package is installed. It provides brief descriptions of issues related to each release of SunVTS.

These packages are located on the Sun Computer Systems Supplement CD that ships with the Solaris^TM release.

Installing SunVTS

There are several utilities available for installing packages. This chapter describes how to use the pkgadd utility to load SunVTS from a local CD-ROM drive. For information on how to install packages using swmtool, see the Solaris 7 Sun Hardware Platform Guide.

Installation Requirements

• Your Solaris environment must be installed and booted to the multiuser level. See note below)

• You must be superuser.

• There must be at least 32-Mbytes of available disk space in the partition where SunVTS will reside. The /opt directory is the default installation location.

SunVTS revision 3.0 was first introduced, and designed to run in the Solaris 7 operating environment.

To Install SunVTS With the pkgadd Command

1. Log in to the system and become superuser.

   At the prompt, type:

   ---

   ariela% su
   

   ---

2. Check to see if SunVTS is currently loaded on the system:

   At the prompt, type:

   ---

   # pkginfo | grep SUNWvts
   

   ---

   If the system does not display anything then SunVTS is not installed.

   If you see the following message, then SunVTS is installed:

   ---

   system      SUNWvts        Online Validation Test Suite
   

   ---

   ---

   Note -

   Multiple versions of SunVTS should never be installed in the same directory. Use pkgrm to remove existing installations of SunVTS before reinstalling SunVTS. See "Removing SunVTS".

   ---

3. Load the Sun Computer Systems Supplement CD into the CD-ROM drive.

   Volume Manager will automatically mount the CD.

4. Install SunVTS using pkgadd as shown in one of the examples below.

   • The following command will load SunVTS in the default directory (/opt):

     ---

     # pkgadd -d /cdrom/cdrom0/Product SUNWvts
     

     ---

   • The following command will prompt you to enter the directory where SunVTS will reside instead of using the default (/opt) directory.

     ---

     # pkgadd -a none -d /cdrom/cdrom0/Product SUNWvts
     

     ---

5. Answer the installation questions.

   ---

   Note -

   You may see this warning: Warning: The <SUNWsycfd> package "Sun Enterprise SyMON Agent" is a prerequisite package and should be installed.This warning will not prevent the successful installation or execution of SunVTS. This error indicates that the configd program (part of the SUNWsycfd) is not present. The configd program is necessary for the physical mapping feature of SunVTS. Load the SUNWsycfd package if the physical mapping feature is desired. SUNWsycfd is located on the Sun Computer Systems Supplement CD.

   ---

6. Install the SunVTS supporting packages that are appropriate for your configuration. (See "SunVTS Packages" for more details.)

   ---

   # pkgadd -d /cdrom/cdrom0/Product SUNWvtsx SUNWodu SUNWvtsmn
   

   ---

   ---

   Note -

   Use the -a none again if you used it for the installation of SUNWvts.

   ---

7. Verify the presence of the SunVTS packages:

   ---

   # pkginfo  SUNWvts SUNWvtsx SUNWvtsmn SUNWodu
   system      SUNWodu        online Diagnostic Utilities
   system      SUNWvts        Online Validation Test Suite
   system      SUNWvtsmn      Online Validation Test Suite
   Man Pages
   system      SUNWvtsx       64-bit Online Validation Test
   Suite
   

   ---

Removing SunVTS

It is necessary to remove SunVTS before installing a new version. The following instructions describe how to remove SunVTS using the pkgrm command.

To Remove SunVTS With the pkgrm Command

1. Log in to the system and become superuser.

   At the prompt, type:

   ---

   ariela% su
   

   ---

2. Remove the packages with pkgrm:

   ---

   # pkgrm  SUNWvtsx SUNWvtsmn SUNWodu SUNWvts
   

   ---

   Answer y (yes) to the removal questions.

   You should see Removal of <package_name> was successful.