Starting SunVTS on a Local System

This section describes the common ways to start SunVTS:

• "Using the sunvts Command"

• "Starting the SunVTS Kernel and Interface Separately"

• "Starting SunVTS to Test an Online System"

Using the sunvts Command

The typical way to start SunVTS is to use the sunvts command. This command starts the SunVTS kernel, either the 32-bit or 64-bit version, and one of the SunVTS user interfaces, based on your system environment.

The SunVTS UI that starts is determined by the following criteria:

• When the CDE window manager (DTWM) is running, the SunVTS CDE UI is started (vtsui).

• If no window manager is running, then the SunVTS TTY UI is started (vtstty).

The sunvts command starts SunVTS assuming that the system under test is in an offline state. All other system applications should be stopped.

To Start SunVTS with the sunvts command

1. Become superuser.

2. Run the sunvts command:

   # /opt/SUNWvts/bin/sunvts

   ---

   Note -

   If you receive an error message such as: connection to ":0.0" refused by server Xlib: Client is not authorized to connect to Server Error: Can't open display: :0.0 You may need to grant xhost permissions by typing: xhost display_hostname

   ---

3. Refer to one of the following chapters according to the SunVTS UI you are using:

   • Chapter 4, Using the SunVTS CDE User Interface

   • Chapter 5, Using the SunVTS TTY User Interface

To Use the sunvts Command With Options

You can use the sunvts command with a variety of options (Table 3-2) to control how SunVTS is started.

1. For example, the following command starts SunVTS with the TTY UI no matter what window environment you are using:

   # /opt/SUNWvts/bin/sunvts -t

   Table 3-2 The sunvts Command Syntax

   /opt/SUNWvts/bin/sunvts [-elpqstv] [-o options_file] [-f logfile_directory] [-h hostname] -display local_hostname:0
   Argument	Description
   -e	Disables the connection permission checking feature
   -p	Starts the SunVTS kernel, but does not probe the test system's devices
   -q	Automatically quits both the SunVTS kernel and the user interface when testing stops
   -s	Automatically starts testing a selected group of tests; the flag must be used with the -o options_file flag
   -t	Starts vtstty, a TTY-based program. If you do not specify this option, and the system is running CDE, sunvts starts vtsui.
   -v	Displays version information from the SunVTS kernel and UI
   -o options_file	Starts the SunVTS kernel with the test options loaded from the options_file; these options are saved by the user interface and are stored in the /var/opt/SUNWvts/options directory
   -f logfile_directory	Specifies an alternative logfile directory other than the default directory /var/opt/SUNWvts/logs
   -h hostname	Starts the user interface (vtsui or vtstty) on the local machine and tries to connect to the SunVTS kernel (vtsk) of the specified host machine. If hostname is the same hostname of the machine on which the tests are being run, sunvts starts the SunVTS kernel (vtsk). If vtsk is already running on the test system, the sunvts command ignores the -o, -f, -q, -p, and -s options
   -display local_hostname:0	When running SunVTS through a remote login, this option starts the SunVTS kernel on the remote system, and the user interface is displayed on the local machine designated as local_hostname:0

Starting the SunVTS Kernel and Interface Separately

The sunvts command starts both the SunVTS kernel and the user interface that is appropriate for your system. However, there are commands that you can use to start just the SunVTS kernel, or to specify a specific user interface.

To Start the SunVTS Kernel (vtsk)

1. The vtsk command starts the SunVTS kernel. You can use command-line options (see Table 3-3 below) to control the behavior of this command.

   • For systems running in the 32-bit Solaris environment, use the following command:

     # /opt/SUNWvts/bin/vtsk

   • For systems running in the 64-bit Solaris environment, use the following command:

     # /opt/SUNWvts/bin/sparcv9/vtsk

   The vtsk command-line syntax and options are listed below:

   Table 3-3 The vtsk Syntax

   /opt/SUNWvts/bin/vtsk [-epqsv] [-o options_file] [-f logfile_directory]
   Argument	Description
   -e	Disables the connection permission checking feature
   -p	Starts the SunVTS kernel, but does not probe test system devices
   -q	Quits both the SunVTS kernel and the user interface when testing is complete
   -s	Starts testing a selected group of tests; this flag must be used with the -o options_file flag
   -v	Displays only the version information from the SunVTS kernel, vtsk; this option does not start the vtsk daemon
   -o options_file	Starts the SunVTS kernel with the test options saved in the options_file; these options are saved and stored in the /var/opt/SUNWvts/options directory
   -f logfile_directory	Specifies an alternative to the default logfile directory (/var/opt/SUNWvts/logs)

To Start a Specific SunVTS User Interface

In most cases, when you use the sunvts command, the appropriate SunVTS user interface is started.

1. For situations when you want to start a specific user interface without starting the SunVTS kernel, use one of the following:

   • To start the CDE interface:

     # /opt/SUNWvts/bin/vtsui

   • To start the TTY interface:

     # /opt/SUNWvts/bin/vtstty

   In all cases, the user interface attempts to connect to the SunVTS kernel.

Starting SunVTS to Test an Online System

As of SunVTS 4.3, the SunVTS online testing capability that was initiated using the vtsui.online command is no longer available. The SUNWodu package that provides this online testing functionality is 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.

Before you start a SunVTS test session stop all user applications.