SunVTS 5.0 User's Guide

Chapter 2 Installing and Removing SunVTS

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

SunVTS Packages

The SunVTS software is installed from the packages shown in Table 2-1.

Table 2-1 SunVTS packages

Package Name 

Description 

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 to run SunVTS. 

SUNWvtsx

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. This package cannot be installed on systems that do not have the 64-bit Solaris operating system installed. 

SUNWvtsmn

Contains the SunVTS man pages. These files are installed in the /opt/SUNWvts/man directory by default, and you may need to update your MANPATH variable (described in this chapter). Installing these man pages is optional; however, they provide helpful information about SunVTS commands.

Note 1: The configd packages (SUNWeswsa, SUNWsycfd, SUNWesnta, and SUNWeswga) are no longer needed, and no longer supplied, for physical mapping support.

 

Note 2: As of SunVTS 4.3, the SunVTS online testing capability that was initiated using the vtsui.online command no longer available. The SUNWodu package that provides this online testing functionality no longer provided.Online Diagnostic testing of Sun systems is now available through the Sun Management Center software using the Sun Hardware Diagnostic Suite add-on software. See http://www.sun.com/sunmanagementcenter for details.

Note 3: As of SunVTS 5.0, the SunVTS OPEN LOOK user interface (UI) is no longer supported. The SunVTS OPEN LOOK tests (sundials and sunbuttons) are discontinued. For full feature support, use the SunVTS CDE or TTY UI. Refer to the Solaris "End-of-Software Support Statements" section of the Solaris operating environment release notes for the latest end of support news.

 

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

Installation Requirements


Note -

Refer to Appendix B, Frequently Asked Questions for information about which revisions of SunVTS are supported on different Solaris operating environment releases.


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 other installation methods, see the Solaris 9 Sun Hardware Platform Guide.

To Install SunVTS With the pkgadd Command
  1. Login to the system and become superuser:


    % su
    

  2. Check to see if any SunVTS packages are currently installed on the system:


    # pkginfo -c sunvts
    
    • If the system does not display anything then no SunVTS packages are installed and you can proceed with the installation.

    • If you see any messages such as the following message, then SunVTS is installed and you should remove the existing SunVTS software before proceeding. See "Removing SunVTS".


      system      SUNWvts        SunVTS
      

  3. Load the Software Supplement for the Solaris Operating Environment CD (the Supplement CD) into the CD-ROM drive.

    Volume Manager automatically mounts the CD.

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

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


      # pkgadd -d /cdrom/cdrom0/SunVTS_5.0/Product SUNWvts
      

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


      # pkgadd -a none -d /cdrom/cdrom0/SunVTS_5.0/Product SUNWvts
      


      Note -

      If you install SunVTS in a directory other than the default (/opt) directory, you must set the VTS_PM_PATH variable before you use the SunVTS CDE interface. See "To Perform Additional Setup When SunVTS Is Installed in a Directory Other Than /opt".


  5. Answer the installation questions.

    You are asked if you want to enable the Kerberos-based, Sun Enterprise Authentication Mechanism (SEAM) security which provides the highest level of SunVTS security. You should only enable this if you have the SEAM software installed and the SEAM server and clients configured in your networked environment. Refer to "SunVTS Security". You can always answer no to this question, even when SEAM is configured in your environment.

    If you choose to run SunVTS with SEAM security, use the following SEAM assignments:

    • Principal--set to sunvts

    • Complete Service Name--set to sunvts@host, where host is the fully qualified domain name of the host where the SunVTS kernel is running.


    Note -

    You may see installation messages that inform you of other package requirements. These notifications do not prevent the successful installation or execution of SunVTS. The following steps explain how to install these other packages.


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

    Example:


    # pkgadd -d /cdrom/cdrom0/SunVTS_5.0/Product SUNWvtsx SUNWvtsmn SUNWvtsol
    


    Note -

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



    Note -

    The SUNWvtsx package only installs on systems that have the 64-bit Solaris Operating Environment installed.



    Note -

    The configd packages (SUNWeswsa, SUNWsycfd, SUNWesnta, and SUNWeswga) are no longer needed, and no longer supplied, for physical mapping support.


  7. Verify the presence of the packages:


    # pkginfo  SUNWvts SUNWvtsx SUNWvtsmn SUNWvtsol
    system      SUNWvts        SunVTS
    system      SUNWvtsmn      SunVTS Man Pages
    system      SUNWvtsx       64-bit SunVTS

To Set Up Access to the SunVTS Man Pages

The SunVTS man pages are installed in the SunVTS_install_dir/man directory (/opt/SUNWvts/man by default). To access them, add this directory to your MANPATH shell variable in the initialization file that corresponds to your login shell (usually .profile for the Bourne and Korn shells or .login for the C shell).


Note -

The steps that follow assume that the default SunVTS installation directory (/opt) was used when the SunVTS packages were installed. If this is not the case, adjust the instructions to use the directory where the man pages were installed.


  1. Using an editor, add the SunVTS man directory (/opt/SUNWvts/man by default) to the MANPATH variable in the appropriate initialization file.

    Bourne, Korn Shell example:


    MANPATH=/usr/share/man:/usr/man:/opt/SUNWvts/man;export MANPATH

    C shell example:


    setenv MANPATH /usr/share/man:/usr/man:/opt/SUNWvts/man
    

  2. Have the shell read the modified initialization file by sourcing it (with the . [dot] or source command) or log out and log back in.

  3. Verify that the SunVTS man directory is part of the MANPATH variable:


    # echo $MANPATH
    /usr/share/man:/usr/man:/opt/SUNWvts/man


    Note -

    For more information about customizing a user's work environment, shell variables, and initialization files, refer to your Solaris system administration guides.


To Perform Additional Setup When SunVTS Is Installed in a Directory Other Than /opt

When you install SunVTS in a directory other than the default directory (/opt), you must set the VTS_PM_PATH environment variable before you can use the SunVTS CDE user interface. This variable is used to locate graphic elements in the SunVTS CDE interface.


Note -

The VTS_PM_PATH variable is not required if SunVTS is installed in the default directory (/opt).


  1. Using an editor, open the appropriate initialization file such as .profile (for the Bourne or Korn shells) or .login (for the C shell).

  2. Add the VTS_PM_PATH variable as shown:

    Bourne or Korn Shell example:


    VTS_PM_PATH=your_base_install_dir/SUNWvts/bin/pm;export VTS_PM_PATH

    C shell example:


    setenv VTS_PM_PATH your_base_install_dir/SUNWvts/bin/pm
    

  3. Have the shell read the modified initialization file by sourcing it (with the . [dot] or source command) or log out and log back in.

SunVTS Security

SunVTS has two security mechanisms that you can choose from:

The SunVTS installation process prompts you to specify which security mechanism you want to use. You must use one or the other, and the SEAM security implementation is the default if you press the return key through the installation questions.

Basic Security

The SunVTS user interface (vtsui, vtsui.ol,and vtstty) must connect to the SunVTS kernel (vtsk) before it can be used to control testing. The SunVTS kernel selectively accepts "connect to" requests from the SunVTS interface based on entries in the SunVTS_install_dir/bin/.sunvts_sec file. Connection permission is governed by three categories in this file as follows:

A plus (+) entry in one of these categories means all hosts, groups, or users, are trusted.

The user password needed for authentication is the same password used to log in to the system under test.

The check for connection permission starts with the HOSTS category, then the GROUP category, and finally, the USERS category. A connection is granted as soon as the connection request matches an entry.

If a security file entry is invalid or if there is no entry in the file, all access except root is denied on the local machine. However, you can correct an entry in this file even while the SunVTS kernel is running.

When you specify the -e option while starting the SunVTS kernel, the kernel accepts "connect to" requests from any host, regardless of the entries in the .sunvts_sec file.


Note -

As of SunVTS 3.1, the .sunvts_sec file, by default, is configured for root on the system under test. All other "connect to" requests are rejected.



Note -

The .sunvts_sec file is bypassed if you enable the SEAM security.


The following shows the contents of the default .sunvts_sec file.

Code Example of the Security File (.sunvts_sec):


#This file should be <SunVTS 5.0 install directory>/bin/.sunvts_sec
#
#Any line beginning with a # is a comment line
#
# Trusted Hosts entry
# One hostname per line.
# A "+" entry on a line indicates that
ALL hosts are Trusted Hosts.
# No password authentication is done.
# The line with the label HOSTS: is required to have the
list of hosts
#
HOSTS:
#+
#host1
#host2
#
# Trusted Groups entry
# One groupname per line.
# A "+" entry on a line indicates that
ALL groups are Trusted Groups.
# User password authentication is done.
# The line with the label GROUPS: is required to have the
list of groups
#
GROUPS:
#group1
#
# Trusted Users entry
# One username per line.
# A "+" entry on a line indicates that
ALL users are Trusted Users.
# User password authentication is done.
# The line with the label USERS: is required to have the
list of users.
USERS:
root
#user1
#user2

SEAM Security

To use SEAM-based security with SunVTS, you must have the following:


Note -

Refer to the following documents for more information on SEAM: o Sun Enterprise Administration Mechanism 1.0.1 Guide o SEAM 1.0.1 Installation and Release Notes These documents are part of the Sun Enterprise Authentication Mechanism 1.0.1 AnswerBook Collection, and available at http://docs.sun.com. The SEAM software is part of the Solaris release.


The SunVTS SEAM security system is based on Kerberos V5 technology, which revolves around the concept of a ticket. A ticket is a set of electronic information that serves as identification for a user or a service. When you connect to another host through SunVTS, you transparently send a request for a ticket to a Key Distribution Center (KDC), which accesses a database to authenticate your identity. The KDC returns a ticket granting you permission to access the other machine. "Transparently" means that you do not need to explicitly request a ticket; it happens in the background as part of the remote connection. No user password is transmitted in the network. Only the authenticated client can get a ticket for a specific service; another client cannot gain access under an assumed identity.

If you choose to run SunVTS with SEAM security, use the following SEAM assignments:

Controlling SunVTS Security

To Control SunVTS Security mode at Installation Time

The best time to establish the SunVTS security mode is during the SunVTS installation.

  1. Decide which level of security you want to use with SunVTS.

    If you decide to use the SEAM security (highest level of security), make sure that your system is running SEAM.

  2. Install SunVTS as described in "Installing SunVTS".

    The installation program asks you if you want SEAM security enabled. Answer accordingly:

    • Yes (the default)--The Kerberos SEAM security is enabled for SunVTS. No additional action is required to administer SunVTS security. SunVTS uses the authentication as defined in the SEAM software configuration in your network environment to grant and deny access to SunVTS. Do NOT select this security scheme if you do not have the SEAM software installed and configured in your network environment.

    • No--The basic security file is used, and SEAM is not enabled. When the installation is complete, you can access SunVTS as superuser on the system under test, or modify the .sunvts_sec file to authorize other users.

To Switch SunVTS Security After Installation

If you need to switch the security from SEAM to basic, or vice-versa, after you have installed SunVTS, follow these steps:

  1. Become superuser.

  2. Make sure that SunVTS is not started.

  3. Change directories to the SunVTS binary directory:


    # cd /opt/SUNWvts/bin
    


    Note -

    If SunVTS is installed in a directory other than /opt, adjust your references accordingly.


  4. With an editor, open the .sunvts_sec_gss file.

    This file contains one line that is appended with one of the following:

    • ON--indicates SEAM security is enabled.

    • OFF--indicates SEAM security is disabled, and basic security is used.

  5. Change the ON (or OFF) value to the opposite value, save the change, and quit the editor.


    Note -

    The ON and OFF values are case sensitive. Make sure you specify them using capital letters.


  6. Start SunVTS.

    The security mechanism that you specified is enabled.

SunVTS Environmental Variables

Use environmental variables to control certain aspects of SunVTS as described in Table 2-2. Except for the MANPATH variable, you only use these variables when you need to alter the default characteristics of SunVTS.

Table 2-2 SunVTS Environmental Variables

Variable 

Description 

BYPASS_FS_PROBE

Used by disktest when you want to run subtests that require SunVTS to pre-mount all mountable partitions. Refer to the disktest chapter in the SunVTS 5.0 Test Reference Manual for details.

MANPATH

Append the MANPATH variable with the location of the SunVTS man page location (/opt/SUNWvts/man by default) so the man command can locate and display the SunVTS man pages. See "To Set Up Access to the SunVTS Man Pages".

VTS_CMD_HOST

Used by the vts_cmd command to specify the hostname for the SunVTS kernel to connect to. Refer to the vts_cmd man page for details.

VTS_OLD_MSG

Only used when you want SunVTS to display test messages in a pre-SunVTS 4.0 format, usually because a script relies on the older format. This variable should only be used temporarily until your script is updated to recognize the new message format. This variable, and the old message format will no longer be supported in a future version of SunVTS. See question 22 in Appendix B, Frequently Asked Questions.

VTS_PM_PATH

Only used when SunVTS is not installed in the default directory (/opt). Set VTS_PM_PATH to vts_install_dir/SUNWvts/bin/pm for proper operation of the SunVTS CDE UI. See "To Perform Additional Setup When SunVTS Is Installed in a Directory Other Than /opt".

Additional Instructions for Localized Environments

SunVTS software is available in English, and is Internationalization (I18N) compliant, which means it is structured in a way that a user who is familiar with internationalization can take advantage of this feature to run SunVTS in a localized environment.

In a localized environment, you can run SunVTS in English or with localized fonts. Perform one of the two following procedures based on how you want SunVTS to run.

To Run SunVTS in English, in a Non-English Environment

Set the LANG variable to English before you start SunVTS. The following is an example using the C shell:

  1. Set the LANG variable:


    # setenv LANG C
    

To Set Up the GUI resource File for Localized Environments
  1. As superuser, create a directory as follows:


    # mkdir -p /opt/SUNWvts/lib/locale/LANG/app-defaults
    

    Where LANG is the language code (for example, ja for Japan EUC, or fr for French) for the language that you are using.

  2. Copy the SunVTS Xresource (Vtsui) file into the directory you just created:


    # cp  /opt/SUNWvts/lib/Vtsui  /opt/SUNWvts/lib/locale/LANG/app-defaults
    


    Note -

    The example above is based on installing SunVTS in the default (/opt) directory. If SunVTS is installed in different directory, adjust the pathnames accordingly.


  3. Customize the font definitions in the Vtsui file to accommodate font specifications required by your localized environment.

Adding a Custom Test

Developers can add their own custom tests to the SunVTS environment. This book does not describe custom test development, but does list the tasks necessary to add a custom test into the SunVTS environment.

To Add a Custom Test
  1. Copy your custom test binary to the SunVTS bin directory based on the 32-bit or 64-bit functionality of your binary test:

    • 32-bit: /opt/SUNWvts/bin

    • 64-bit: /opt/SUNWvts/bin/sparcv9

  2. Modify one of the following .customtest files based on the 32-bit or 64-bit functionality of your binary test:

    • 32-bit: /opt/SUNWvts/bin/.customtest

    • 64-bit: /opt/SUNWvts/bin/sparcv9/.customtest

    The format of the .customtest file is described in "The .customtest File Format".

  3. Restart SunVTS or reprobe the system.

When invoked, SunVTS displays the custom test in the SunVTS user interface.

The .customtest File Format

The .customtest file defines the test options and the default option values for your custom test. The tester can change these options using the option dialog boxes through the SunVTS user interface. However, the Reset button returns the options to the default settings as defined in the .customtest file.

Each line in this file is made up of two or more fields that are separated by a semicolon where:

Examples:

SunVTS invokes the above test as follows:


% ./test_name -s[vq..] [-i n] 

-o dev=user[0,1..],Command_Line_Option=Value...

You cannot use the .customtest file when a test has a probe attached. You must ensure that the binaries are compatible with the version of the Solaris kernel on which SunVTS is currently running.


Note -

If .customtest is renamed as .customtest-group, all of the associated tests will appear under the specified group.


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.


    % su
    
  2. Remove the packages with the pkgrm command:


    # pkgrm  SUNWvtsx SUNWvtsmn SUNWvtsol [As of SunVTS
    4.3, the SUNWodu package is an obsolete SunVTS
    package that will only be present if you have an older version of
    SunVTS installed. If you have this package installed, you should
    remove it before reinstalling any version of SunVTS.]  SUNWodu [As of SunVTS 5.0, the SUNWvtsol package is obsolete. You should
    remove it if it is installed on the system for which you plan to
    install SunVTS 5.0.]  SUNWvts
    															
    


    Note -

    As of SunVTS 4.3, the SUNWodu package is an obsolete SunVTS package that will only be present if you have an older version of SunVTS installed. If you have this package installed, you should remove it before reinstalling any version of SunVTS.


    Answer y (yes) to the removal questions.

    You should see Removal of package_name was successful.