SunVTS 3.0 User's Guide

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