test

SunVTS 3.0 User's Guide

To Start SunVTS on a Local System

This section describes the common ways to start SunVTS:

Note -

Do not use the ampersand (&) to run SunVTS in the background.

Using the sunvts Command

The common way to start SunVTS is to use the sunvts command. This command has the ability to determine your window environment (CDE, OPEN LOOK, or none), and start the corresponding SunVTS interface. Or, if you use the sunvts command with various options, you can direct it to start with a specific SunVTS user interface (described below).

The sunvts command starts the 32-bit or 64-bit SunVTS kernel based on the operating system (32-bit or 64-bit) that is running.

The sunvts Command Syntax and Options

Table 3-2 The sunvts Syntax

/opt/SUNWvts/bin/sunvts [-tqpvsel] [-o options_file] [-f logfile_directory] [-h hostname]

Argument 

Description 

-e

Disables the connection permission checking feature 

-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

-l

Starts the OPEN LOOK user interface 

-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

-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, instead of a GUI. If you do not specify this option and the system is running CDE, sunvts starts vtsui; or, if the system is running OPEN LOOK, sunvts starts vtsui.ol

-v

Displays version information from the SunVTS kernel and GUI 

 

* If the -f argument is exercised when running SyMON, a logfile directory cannot be created.

To Start SunVTS With the Default Interface

Type the following command:

# /opt/SUNWvts/bin/sunvts

The sunvts command determines if the system is running 32-bit or 64-bit Solaristm and starts the corresponding 32-bit or 64-bit SunVTS kernel (vtsk).

As the kernel initializes, it probes the devices to determine the system configuration. It starts a user interface and passes the configuration information to the user interface.

The SunVTS user interface that starts is determined on the following criteria:

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 +

For a list of command line options that can be used with the sunvts command refer to Table 3-2.

To Start SunVTS With the CDE Interface

  1. Start CDE if it is not already running.

  2. Use the sunvts command as shown:

    # /opt/SUNWvts/bin/sunvts

To Start SunVTS With the OPEN LOOK Interface

Use the -l option:

# /opt/SUNWvts/bin/sunvts -l

To Start SunVTS With the TTY Interface

Use the -t option:

# /opt/SUNWvts/bin/sunvts -t

To View SunVTS Revision Information

Use the -v option:

# /opt/SUNWvts/bin/sunvts -v vtsui: SunVTS, 3.0

Starting the SunVTS Kernel and Interface Separately

The sunvts command starts both the SunVTS kernel and the user interface that is appropriate your a given configuration. 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)

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.

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 

-f logfile_directory*

Specifies an alternative to the default logfile directory (/var/opt/SUNWvts/logs)

-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

-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

 

* If the -f option is exercised when running SyMON, a logfile directory cannot be created.

To Start a Specific SunVTS User Interface

In most cases, when you use the sunvts command, the appropriate SunVTS user interface is started. 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 OPEN LOOK interface:

# /opt/SUNWvts/bin/vtsui.ol

To start the TTY interface:

# /opt/SUNWvts/bin/vtstty

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

Note -

You do not need to be superuser to start a SunVTS user interface.