test

SunVTS 3.0 User's Guide

Chapter 3 Starting SunVTS

This chapter contains information that describes:

SunVTS Runtime Considerations

Requirements

Your system must meet the following requirement to run SunVTS:

Overview of SunVTS Procedures

The following table describes the process for testing your system with SunVTS. The table provides a brief description, and references to more detailed information that is presented in this book.

Table 3-1 SunVTS Procedures
 Step Procedure Description
 1 Become superuser

Either log in as root, or use su to become root (superuser).
 2 Prepare the devices for Testing

Load the required test media and loopback connectors. When testing your tape, CD-ROM, and diskette drives in Functional mode test media is required. Communication port tests require loopback connectors. 

Refer to "To Prepare Devices for Testing".

 3 Start your desired window environment

SunVTS can run in CDE, OPEN LOOK window environments or in TTY mode when no window environment is available. 
 4 Start SunVTS

There are several ways to start the SunVTS application. 

You can start it with the sunvts command and it will use a default interface, or use an option to specify a specific interface. You can start the SunVTS kernel and interface separately. You can use vtsprobe to have the kernel reprobe for devices. For more details refer to:

-"To Start SunVTS on a Local System "

-"To Start SunVTS on a Remote System"

-"The vtsprobe Utility"

 5 Set up SunVTS with the desired test configuration

The method for doing this depends on the SunVTS interface that you are using: 

-"CDE User Interface"

-"OPEN LOOK User Interface"

-"TTY Interface"

-"Running a Test From the Command Line"

For descriptions of configuration features refer to Chapter 5, SunVTS Test Environment".
 6 Run the tests

To run the tests, select the start button in the SunVTS interface.  

The testing process may take as little as one second, or run indefinitely, based on how SunVTS is configured. 
 7 Review the test resultsTest results are displayed real-time in the SunVTS interface, and logged in three log files. You can also configure SunVTS to notify you by email.
 8  Quit SunVTSRefer to "To Quit SunVTS" for more details.

To Prepare Devices for Testing

Several tests require media or loopback connectors. Install such requirements before the SunVTS kernel probes for devices (when SunVTS is started, or the reprobe function is run) to allow the SunVTS kernel to properly identify each device.

You must install media in these devices if you plan to test them in Functional Mode:

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.

To Start SunVTS on a Remote System

You can start, view, and control SunVTS testing sessions over a network. There are several ways to do it, but the desired effect is to have SunVTS display the SunVTS user interface on the local system (the system that you are on), while the SunVTS kernel is running and testing a remote system (connected via Ethernet, modem lines, and the like).

The following procedures are described in this section:

Requirements

In addition to the normal SunVTS requirements (refer to "Requirements"), the following requirements must be met to run SunVTS on a remote system:

To Connect the User Interface to a Remote System

  1. Type the following command:

    # /opt/SUNWvts/bin/sunvts -h remote_hostname

    Replace remote_hostname with the hostname or IP address of the remote system.

    The sunvts command starts the SunVTS kernel (vtsk) on the remote system, and starts the SunVTS user interface on the local system. The user interface connects to the kernel and the displays the test session of the remote system. Refer to Figure 3-1 below.

    The term system under test (SUT) refers to the system running the SunVTS kernel, which is the remote system in this example.

    Figure 3-1 Running sunvts With the -h Option

    Graphic

    Note -

    If the user interface is already running on your local system, you can use the "Connect to" button to connect to a remote machine's SunVTS kernel. See "To Use the Connect to Button".

  2. Configure SunVTS for the test session and start the tests as described in the following sections:

  3. Review the SunVTS logs for test results.

    You can view the remote system test logs through the local SunVTS interface. The log files are stored on the system under test (SUT).

To Run SunVTS Through a Remote Login

  1. Use the xhost command to allow the remote system to display on your local system.

    % /usr/openwin/bin/xhost + remote_hostname

    Replace remote_hostname with the name of the remote system.

  2. Log in to the remote system as superuser.

    Using a command such as rlogin.

  3. Start SunVTS:

    # /opt/SUNWvts/bin/sunvts -display local_hostname:0

    Replace local_hostname with the name of the local system.

    The SunVTS kernel starts on the remote system and the user interface displays on your system.

  4. Configure SunVTS for the test session and start the tests.

  5. Review the SunVTS logs for test results.

    You can view the remote system test logs through the local SunVTS interface. The log files are stored on the system under test (SUT).

To run SunVTS Through telnet or tip (TTY Interface)

You can run SunVTS on a remote system, with the TTY interface, through a telnet or tip session.

You need to set the correct terminal type and number of columns and rows before starting the interface. The steps below describe this process.

  1. Use the echo command to display the value of the TERM variable:

    This example, the TERM variable is a Korn or Bourne shell variable and the value is sun-cmd. Your display device may be something else like a Wyse, TeleVideo, or other kind of terminal. In this case your TERM value will be something different. 

    $ echo $TERM
sun-cmd

  2. Use the stty command to display the settings of your terminal: 

    $ stty
speed 9600 baud; -parity hupcl 
rows = 60; columns = 80; ypixels = 780; xpixels = 568;
swtch = <undef>; 
brkint -inpck -istrip icrnl -ixany imaxbel onlcr 
echo echoe echok echoctl echoke iexten

    Note -

    You must have a minimum of 80 columns and 24 rows to run the SunVTS TTY interface.

  3. Write down the values of your TERM variable and rows and columns settings.

    You will need these values later.

  4. Connect to the remote system using either the telnet or tip commands.

    Refer to the telnet(1) and tip(1) man pages for more information about these commands.

  5. Become superuser on the remote system.

  6. Identify your terminal type and settings in the telnet (or tip) session window: 

    # TERM=sun-cmd
# stty rows 60
# stty columns 80

  7. Start SunVTS with the TTY interface: 

    # /opt/SUNWvts/bin/sunvts -t

  8. Configure SunVTS for the test session and start the tests.

    Refer to "Running SunVTS With the TTY Interface (Tutorial)" and "TTY Interface" for information on testing with the TTY interface.

  9. Review the SunVTS logs for test results.

    You can view the remote system test logs through the local SunVTS TTY interface. The log files are stored on the system under test (SUT).

To Quit SunVTS

Before quitting SunVTS, you must stop any tests that are running. Some of the tests, such as the tape tests, do not stop immediately because they require time to rewind. You can stop any tests that are running as follows:

  1. To stop testing from the CDE GUI toolbar, select the Stop button.

  1. To stop testing from the CDE GUI Commands pull-down menu, select Stop Testing.

  1. To quit SunVTS from the CDE GUI Commands pull-down menu, select the Quit SunVTS submenu and drag to display the following choices:

    • vts kernel and ui--terminates the user interface and the SunVTS kernel

    • vts kernel--terminates only the SunVTS kernel

    • vts ui--terminates only the user interface

The vtsprobe Utility

Use the vtsprobe utility to display the results of the SunVTS kernel hardware device probe. vtsprobe lists all of the test machine's devices, their configuration information, and their corresponding hardware tests.

Note -

The SunVTS kernel must be running on the test machine for the vtsprobe command to work. See "Starting the SunVTS Kernel and Interface Separately" for instructions on how to start the SunVTS kernel.

To Display the Devices for a Local System
Note -

The SunVTS kernel (vtsk) must be running on the system.

  1. Type the following command: 

    # /opt/SUNWvts/bin/vtsprobe

    Example 3-1 vtsprobe Example

    example% vtsprobe

Processor(s)
	fpu(fputest)
		Architecture: sparc
		Type: TI TMS390Z50 SuperSPARC chip
	system(systest)
		System Configuration: sun4m SPARCstation 10 (1 X 390Z50)
		System clock frequency: 40 MHz
		SBUS clock frequency: 20 MHz
Memory
	kmem(vmem)
		Amount: 233580KB
	mem(pmem)
		Physical Memory size:48 Mb
Network
	isdn0(isdntest)
	le0(nettest)
		Host_Name: example
		Host Address: 131.155.56.122
		Host ID: 12347f61
		Domain Name: widget.com
SCSI-Devices(esp0)
	c0t0d0(rawtest)
		Logical Name: c0t0d0
		Capacity: 510.23MB
		Controller: esp0
	c0t0d0(fstest)
		Logical Name: c0t0d0
		Controller:esp0
	tape0(tapetest)
		Drive Type: Exabyte EXB-8200 8mm Helical Scan
Comm.Ports
	zs0(sptest)
		term/a & term/b
Graphics
	cgsix0(cg6)
		5000KB required for testing.
OtherDevices
		Controller:Intel 82077
	diskette(fstest)
		Logical Name: diskette
		Controller: Intel 82077
	sound0(audio)
		Audio Device Type: DBRI Speakerbox
To Display Devices of a Remote System
Note -

The SunVTS kernel (vtsk) must be running on the remote system.

  1. Type vtsprobe -h hostname, where hostname is the host name of the remote machine.

    The vtsprobe utility connects to the remote machine and displays the remote machine's hardware devices.

The output is displayed on the window in which you invoke vtsprobe.