SunVTS 5.0 User's Guide

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:


Note -

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:

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