CHAPTER 3

User Interfaces

---

SunVTS can be accessed using either the Common Desktop Environment (CDE) interface, the OPEN LOOK interface, or the TTY interface. These interfaces are described below.

---

CDE User Interface

SunVTS can now be used with the Common Desktop Environment (CDE). CDE is an easy-to use graphical user interface (GUI) that provides a consistent look and feel across UNIX environments. When you start SunVTS using vtsui command, the SunVTS CDE main window displays (FIGURE 3-1).

FIGURE 3-1

CDE Menu Bar

The Menu Bar is located below the Main window title bar. The Menu Bar has a row of buttons and each button has a pull-down menu (FIGURE 3-2):

FIGURE 3-2

• Commands menu--contains a list of SunVTS control commands
• View menu--expands or contracts the system map hierarchy
• Options menu--contains a list of the system option categories: see TABLE 3-4 on page 86 for a description of system options
• Reports menu--lists the two types of viewable reports
• Help menu--provides online help

Detailed information about the CDE Menu Bar follows.

CDE Commands Menu

From the Commands menu, you can set a variety of test parameters and functions (FIGURE 3-3).

FIGURE 3-3

TABLE 3-1 describes each item in the Commands menu.

TABLE 3-1

Menu Item	Description
Start Testing Start Testing with Record	Starts all enabled tests Starts testing and records SunVTS
Replay	kernel events Replays the previous test session
Stop Testing	Stops all tests
Reset	Resets all pass and error counts
Suspend	Suspends all tests

TABLE 3-1

Menu Item	Description
Resume	Resumes testing
Connect to Host	Connects user interface to the SunVTS kernel on another machine
Trace Test	Creates a log of every system call made by a specific test
Reprobe System	Reprobes the system
Quit SunVTS UI and kernel UI only Kernel only	Terminates the SunVTS user interface and/or the SunVTS kernel

· To Use the Reprobe Button

· Click the Reprobe button to reprobe the hardware devices on the test system (FIGURE 3-4).

For example, if you forgot to insert a blank tape into a tape drive before you started the SunVTS kernel, you may need to reprobe the system. By reprobing the system, you can use the tapetest command to test the tape drive.

---

Note - When you click the Reprobe button, a pop-up window is displayed. Select Yes to continue or No to stop.

---

FIGURE 3-4

If you add SCSI devices to your test system, you need to perform a reconfiguration boot on the system so these devices can be probed by the SunVTS kernel.

Using the Trace Test

From a TTY command line, you can use the UNIX truss(1) command on any test while running SunVTS. Use the Trace test to create a log of every system call made when a test is running. This feature logs the system calls using the standard UNIX command truss. The trace messages logged by this feature give you a powerful debugging tool when isolating the specific cause of an error. (See the truss(1) man page for more information.) You can also start the Trace test from the GUI.

· To Enable Tracing

· Click Commands on the Menu Bar and pull down to Trace test...

The Trace Test pop-up is displayed.

FIGURE 3-5

· Choose one or more tests to be traced from the scrollable list of test names and then select Apply, or double-click a test name to enable tracing and dismiss the pop-up window.

When you select a test, system call tracing is enabled immediately. If the test is already running when you select it, tracing begins immediately and the Trace Test messages appear in the SunVTS console window.

· Select File and Apply to write the Trace Test messages to a file on disk.

· To Disable Tracing

· Bring up the Trace Test pop-up window again and select the highlighted test name and Apply.

This action removes the highlighting and disables tracing.

CDE View Menu

Use the View pull-down menu (FIGURE 3-6) to choose the devices that you want to view in the system map display.

FIGURE 3-6

· Select Open system map to expand and show all the devices in the system map.

· Select Close system map to decrease so that only major categories are displayed.

CDE Options Menu

The Options pull-down menu is where you set global SunVTS kernel and test options. See FIGURE 3-7 for the various option categories available for SunVTS.

FIGURE 3-7

• To display the SunVTS Options pull-down menu, select Options. Each category brings up a pop-up window of specific options. Select and change the options, then click the Apply button.
• To reset the options to their default settings, click the Reset button.

The option file category displays a pop-up window that lets you create, load, and delete option files.

TABLE 3-2 describes the SunVTS global and system options.

TABLE 3-2

Global Options	System Option	Description
Thresholds...	Max System Passes	States the maximum number of system passes before stopping all tests (0 causes the SunVTS kernel to run the tests until you click the Stop button)
	Max System Errors	States the maximum number of system errors before SunVTS stops all tests (0 causes the SunVTS kernel to continue testing regardless of errors)
	Max System Time	Specifies the maximum number of minutes that SunVTS continues testing (0 makes the SunVTS kernel run the selected tests until you click the Stop button)

TABLE 3-2 (Continued)

Global Options	System Option	Description
Notify...	Send Email	Determines when and if you want the test status messages sent to you by email. From this menu, you can choose: - Disabled (never send email) - Now (send email immediately) - On Error (send email when an error occurs) - Periodically (send email with a time period set in the Log Period option) - On Error & Periodically (send email periodically as well as when an error occurs)
	Email Address	Indicates the email address where the test status messages are sent (the address is root by default)
	Log Period	Specifies the time, in minutes, between sending test status email messages
Schedule...	Auto Start	Eliminates the need to use the Start button to start a SunVTS testing session. To use this option: 1. Enable the Auto Start setting. 2. Save the System options and Test options to an option file (see "To Use the Option Files Button" on page 88 for more information). 3. Starts SunVTS from the command line, specifying the option file. SunVTS begins testing soon after the main window is displayed.
	Single Pass	Runs only one pass of each selected test
	System Concurrency	Sets the maximum number of test instances that can be run concurrently in the machine being tested
	Group Concurrency	Sets the number of tests you want to run at the same time in the same group
Test Execution...	Stress	Runs certain tests in stress mode, working the system harder than normal
	Verbose	Displays verbose messages in the SunVTS Console window
	Core File	Creates a core file. If the <SunVTS bin> directory is writable; core.<testname>.xxxxxx is the Core File name, where <testname> is the test that dumped core, and where xxxxxx is a character string generated by the system in order to make the file name unique. When Core File is disabled, a message is displayed and logged, indicating the signal that caused the failure; see "Log Files" on page 91 for more information
	Run On Error	Continues testing until the Max Errors number is reached
	Max Passes	Specifies the maximum number of passes a test can run

TABLE 3-2 (Continued)

Global Options	System Option	Description
	Max Errors	States the maximum number of allowable errors before stopping the test (0 makes the SunVTS kernel continue testing regardless of errors)
	Max Time	States the time limit (in minutes) a test can run (0 = no limit)
	Number of Instances	Specifies the number of instances to run each scalable test
Advanced...	System Override	Supersedes the specific group and test options in favor of the options set in a global options window; sets all options on all test group and test option menus Note: To save a set of options, use the Option Files window described in "To Use the Option Files Button" on page 88
	Group Override	Supersedes the specific test options in favor of the group options set in a group options window
	Group Lock	Protects specific group options from being changed from the options set at the system level (the System Override option supersedes this option)
	Test Lock	Protects specific test options from being changed from options set at the group or system level (the System Override and Group Override options supersede this option)
	Processor Affinity	Only available on multiprocessor systems; use to specify on which processor you want to run all tests. To select the specific processor, click the number. If no processor is specified, the operating system randomly distributes testing among all the processors. Note that when you use random distribution, you cannot verify that all processors have been tested.
Option Files	Option Files	Creates an option file or selects a file from the Option File List, which can then be loaded, stored, or removed

FIGURE 3-8 shows the CDE Options Pop-up Windows.

NOTE: Use arrows to increase or decrease option menu values.

FIGURE 3-8 CDE Options Pop-up Windows

CDE Reports Menu

From the Reports pull-down menu, you can choose to view system configuration or log file reports (FIGURE 3-9).

FIGURE 3-9

System Configuration

When you select System Configuration, you can check all of the connected devices, as follows:

• Display the test system configuration information
• Print the test system configuration information

The System Configuration window is displayed (FIGURE 3-10) and lists all of the hardware on the test system and their corresponding hardware tests.

FIGURE 3-10

· To Print the Test System Hardware Configuration

1. Click Reports from the Menu bar and then select System Configuration from the pull-down menu to display the System Configuration window.

2. Click the Print button at the bottom of this window and the System Configuration File Print pop-up window is displayed.

3. Select your default printer, or enter the name of another printer in the printer name field, and then click the OK button.

4. Click the Cancel button to cancel the print request.

Log Files

SunVTS saves the status of its progress in three types of log files:

• SunVTS Error Status Log--the sunvts.err file contains SunVTS test error messages.

/var/opt/SUNWvts/logs/sunvts.err

• SunVTS Information Log--the sunvts.info file contains informative messages generated while SunVTS tests are running, plus start and stop times.

/var/opt/SUNWvts/logs/sunvts.info

• Solaris System Message Log--the messages file is a log of all the general UNIX messages.

/var/adm/messages

When you select Log Files, you can display or print information about error log files, information log files, or UNIX message log files.

· To Display or Print Log Files

1. Select Log Files from the Reports pull-down menu (FIGURE 3-9).

   When the Log Files window is displayed, you can choose the type of log file from an option menu at the top of the window (FIGURE 3-11).

2. Print or delete the displayed log file information, or close the pop-up window by clicking on one of the buttons at the bottom of the window.

   a. To remove a Log File, click the Delete button.

   b. To print a Log File, click the Print button and a print pop-up window is displayed.

---

Note - These logs can be very long; consider this before deciding to print the log file.

---

FIGURE 3-11

CDE Help Menu

The Help menu is located at the far right side of the Menu Bar (FIGURE 3-2). Currently, the only information provided is the version of SunVTS.

CDE Tool Bar

The Tool Bar is located just below the Menu Bar (FIGURE 3-12). The Tool Bar contains a set of icons or buttons that represent the most commonly used functions from the Menu Bar. These buttons provide quick access to their functions.

FIGURE 3-12

CDE Buttons

Start Button

Click the start button to begin testing, based on the defaults or the selections you made. When testing begins, the Start button dims and the System Status changes from idle to testing. The Test Status panel also starts displaying the status for all active tests (see "CDE System Status Panel" on page 67 for more information).

Stop Button

Click the Stop button to halt all active tests. The test results remain on the Test Status panel after testing is completed.

---

Note - Click the Stop button only once. Some tests do not stop immediately, so the System Status may take time to change from stopping to idle.

---

---

Caution - If you click the Stop button when a test is hung, the user interface appears frozen. You can override this by deselecting these tests from the Test Option panel.

---

Reset Button

The Reset button sets the pass and error counts to zero for each test in the Test Status panel. It also resets the system passes, total errors, and elapsed time to zero. This button only works when all testing has stopped and any colored test names revert to black.

Host (Connect to) Button

Use this feature to connect to another machine.

From this window (FIGURE 3-13) you can connect the user interface to another machine on the network that is running the SunVTS kernel.

FIGURE 3-13

• Type the host name of the machine you want to connect to and click the Apply button.

Once you are connected to the SunVTS kernel on the test machine, you can view and control that system's testing status.

You can also connect to another host by double clicking on the name in the Hostname List panel, shown in FIGURE 3-13. Each time you connect to a different host name, that host name is added to the Hostname List.

Log Button

Use the Log button to display the log files pop-up. From this pop-up window, you can view information about error log files, information log files, or UNIX message log files. You can either delete or print the displayed information, or you can close the pop-up window (see the FIGURE 3-11 on page 64.

Meter Button

The Meter button displays a Perfmeter window that gives statistical information about the system. By clicking within the perfmeter, you can bring up the properties and modify which components are being monitored, how the perfmeter displays the information, the duration, or you can log the information. For more information on Perfmeter, see the Solaris User's Guide or the perfmeter(1) man page in the Reference Manual.

Quit Button

From the Quit button, you can quickly terminate SunVTS GUI.

CDE System Status Panel

The System Status panel is located below the Tool Bar (FIGURE 3-14) and provides system testing status. In addition, it includes the name and model number of the host being tested.

FIGURE 3-14

CDE Device Selection and Status Window

The area below the System Status window is divided into two parts:

• The left side contains the Select Devices and Select Mode panels.
• The right side contains the System Map window. At the top of the System Map window are "radio buttons" used to select either a Physical or Logical view of the system hierarchy (FIGURE 3-15).

From the Tests Selection panel, you can select a set of tests as either default, none, or all. From the Testing Mode panel, you can select the test mode.

FIGURE 3-15

The Container checkbox is a square in front of each device listed; it has two states to indicate that the device contains more objects. Click the "+" (plus) checkbox to change to "-" (minus), or open state, and display the next level of devices. This sequence continues down a branch of the system hierarchy until the device names are at their lowest level.

· To Select a Device from the Test Option Menu

1. Click the left mouse button on the device name, or on the small checkbox to the left.

2. Click the right mouse button to display a pull-down menu of options for that device (FIGURE 3-16).

Device status option menu

FIGURE 3-16 CDE Device-Specific Option Menu

In addition to the test option selections, the Test Option menu contains a status entry. When you select status from the pop-up menu, the status window for that device appears (FIGURE 3-17).

FIGURE 3-17

Displaying Status in the System Map Window

The primary method of displaying status uses color within the System Map window (see the outlined areas in FIGURE 3-18). During testing, the name of any device changes color from black to green if it has at least one pass and no failures. The moment a device has at least one failure, the color of it's name changes to red. This color information is propagated up an entire branch of the hierarchy, but keeps the

System Map hierarchy closed. You can then view the entire system at the highest level during a test session. A branch that has no failures is displayed in green; those with failures are in red. To investigate the test names in red, move down that branch of the hierarchy, using the container checkboxes until the lowest level indicates which particular device has failed.

A secondary level of status is the individual device pop-up window (mentioned above) that displays the testing Pass and Fail counts for the device and it's immediate sub-devices. For the lowest level device, it displays the test status for that device and all of the test instances below it. You can selectively choose devices that you want to monitor during testing, and can display the corresponding status pop-up windows. They will be dynamically updated during testing.

---

Note - The boxed regions in FIGURE 3-18 show areas that change color to indicate test status on color monitors. If you have a monochrome monitor, these changes cannot be detected; in this case, rely on the status pop-up windows.

---

FIGURE 3-18

CDE Test Message Console

The Test Message Console contains test results and information. This panel is located at the bottom of the Main window (FIGURE 3-19).

FIGURE 3-19

---

OPEN LOOK User Interface

When you start the SunVTS vtsui.ol application, the OPEN LOOK main window is displayed (FIGURE 3-20).

FIGURE 3-20

OPEN LOOK System Status and Test Status

FIGURE 3-21 shows a typical System Status panel.

FIGURE 3-21

Test Status Buttons

Quite often, more tests are run than can be displayed on the Test Status panel. For example, there may be as many as 100 disk drive tests running on a SPARCcenter^(TM) 2000 system at one time. FIGURE 3-22 shows the Test Status buttons that you can use to scroll though pages of tests.

FIGURE 3-22

FIGURE 3-23 shows how to go directly to a specific test or test group by clicking the curved arrow button and dragging right to display the pop-up menu.

FIGURE 3-23

OPEN LOOK Performance Meter

The Performance Meter panel (FIGURE 3-24) shows a graphic display of the test system's performance statistics. This panel provides the same statistics as the perfmeter utility.

FIGURE 3-24

OPEN LOOK Control Panel

You can control the SunVTS tests by using the Control panel menus and buttons (FIGURE 3-25 and TABLE 3-3).

FIGURE 3-25

TABLE 3-3 shows where you can locate more information about each of the Control Panel selections.

TABLE 3-3

Selection	Button	Description	Page
Control	Start	Starts all enabled tests	page 77
	Stop	Stops all tests	page 77
	Reset	Resets all pass and error counts	page 78
	Quit	Terminates the SunVTS user interface and/or the SunVTS kernel	page 79
	Connect to	Connects to another machine	page 80
	Reprobe	Reprobes the system	page 81
	Trace Test	Creates a log of every system call	page 82
Options	Set Options	Sets the global SunVTS kernel and test options	page 84
	Select Tests	Sets global test options	page 88
	Option Files	Saves the current settings from the global test options and specific test settings	page 88

TABLE 3-3 (Continued)

Selection	Button	Description	Page
Info	Sys Config	Displays or prints system configuration information	page 89
	Log Files	Displays the Log Files window	page 91
System View		Determines whether the view is Logical or Physical	page 91

Using Control Selections

Use the Control Selection area of the Main window to set up the testing environment.

The Start Button

From the Start button you can:

• Start all enabled tests.
• Start all enabled tests with Record on.
• Replay the previous test session.

When testing begins, the Start button dims and the System Status changes from idle to testing. The Test Status panel also starts displaying the status for all active tests (see "CDE System Status Panel" on page 67.

If Start with Record is selected, the sequence of events that the SunVTS kernel goes through will be recorded. This lets you duplicate the same sequence of events again by selecting Replay the next time testing begins. This is helpful when trying to duplicate an error condition that is dependent upon the SunVTS kernel's sequence of events during testing. (See "To Use the Option Files Button" on page 88 for additional information.)

The Stop Button

Click the Stop button to halt all active tests. The test results remain on the Test Status panel after testing is completed.

---

Note - Click the Stop button only once. Some tests do not stop immediately, so the System Status display may take time to change from stopping to idle.

---

---

Caution - If you click the Stop button when a test is hung, the user interface appears frozen. You can override this by deselecting these tests from the Test Option panel.

---

The Reset Button

The Reset button (FIGURE 3-26) resets the pass and error counts to zero for each test in the Test Status panel. It also resets the system passes, total errors, and elapsed time to zero. This button only works when all testing has stopped.

FIGURE 3-26

· To Reset Information in the Test Status Panel

1. Click the Reset button.

   Once testing has begun, the Reset button changes to Suspend.

2. Click the Suspend button to pause all SunVTS tests.

   The Suspend button changes back to Resume.

3. Click the Resume button to continue testing (FIGURE 3-27).

FIGURE 3-27

The Quit Button

You can use the Quit button to terminate SunVTS in any of the following ways:

• Both the user interface and the SunVTS kernel
• Only the SunVTS kernel on the test system
• The user interface only

Terminating only the SunVTS kernel is helpful if you want to restart the kernel from the command line, or if you want to connect to another machine on the network.

If you select Terminate Kernel Only, the SunVTS user interface displays a pop-up message (FIGURE 3-28).

FIGURE 3-28

The pop-up message notifies you that the connection to the host machine has been broken. The host name (shown in parentheses in FIGURE 3-28) is the name of the system where the SunVTS kernel terminated.

· To Use the Connect to Button

Use the Connect to button to access or link to another machine as follows:

1. Click the Connect to button to display the Connect to Machine pop-up window.

   From this window (FIGURE 3-29) you can connect the user interface to another machine on the network that is running the SunVTS kernel.

FIGURE 3-29

2. Type the host name of the machine you want to connect to and click the Apply button.

   Usually, you don't need a password to connect to another machine, in which case the password field is grayed-out.

   If you are setting up a machine with security restrictions that require a password, the password field will re-appear after you press Apply. You can then type the password and press Apply again to make the connection.

   Once you are connected to the SunVTS kernel on the test machine, you can view and control that system's testing status.

   After you successfully connect to another system, you can use the Connect to Machine abbreviated pull-down menu button to display and select other machines.

· To Use the Reprobe Button

· Click the Reprobe button to reprobe the hardware devices on the test system (FIGURE 3-30).

For example, if you forgot to insert a blank tape into a tape drive before you started the SunVTS kernel, you may need to reprobe the system. By reprobing the system, you can use the tapetest command to test the tape drive.

FIGURE 3-30

---

Note - When you click the Reprobe button, a pop-up window is displayed so you can confirm your selections.

---

If you add SCSI devices to your test system, you need to perform a reconfiguration boot on the system so these devices can be probed by the SunVTS kernel.

· To Use the Trace Test Button

Use the System Call Tracing function to create a log of every system call made when a test is running. This feature logs the system calls using the standard truss UNIX command. The trace messages logged by this feature give you a powerful debugging tool when isolating the specific cause of an error. (See the truss(1) man page for more information.)

· Choose one or more tests to be traced by selecting the test name from within the scrolling list (FIGURE 3-31).

FIGURE 3-31

You can only select test names; you cannot select test group names. Once a test is selected, system call tracing is immediately enabled. Therefore, if the test is already running when you select i, tracing begins immediately.

When a test is selected, the test name is highlighted in the list. In addition, a capital letter "T" appears next to the test name in the SunVTS Status panel (FIGURE 3-32). This "T" lets you see which tests are being traced.

FIGURE 3-32

· To Deselect a Test

· Click the highlighted test name in the list displayed by the Trace Test window (FIGURE 3-32).

When a test is deselected, system call tracing stops immediately. However, several trace messages may continue to be displayed until the message buffer has been emptied.

· To Send Trace Messages to the Console or to a Log File

Trace messages that are sent to a Log File are placed in /var/opt/SUNWvts/logs.

· Click either Console or File, respectively at the Output selection switch in the Trace Test window.

The system call trace messages are immediately redirected to either the console window or the Log File.

---

Note - Although you can select multiple tests, each traced test degrades system performance due to the large overhead involved when tracing a process. Consequently, select no more than three tests at one time. Be aware that if you decide to send the messages to the sunvts.trace log file, the log file size increases in size rapidly (approximately 1 Mbyte for each minute and a half of run time).

---

Using Option Choices

This area of the Main window is where you set global options for each group of tests. There are three areas where you can make choices: Set options, Select tests and Option files, as follows:

Using the Set Options Button

From the Set Options window, you can set the global SunVTS kernel and test options for Thresholds, Notify, Schedule, Test execution, and Advanced. See FIGURE 3-33 for an overview of these options.

· To Use the Set Options Button

1. Click the Set Options button to display the SunVTS Options window.

2. Drag to highlight and select from the various options, and click Apply. (See

   TABLE 3-4 on page 86</> for a complete list and description of each available option)

FIGURE 3-33

TABLE 3-4

Global Options	System Option	Description
Thresholds...	Max System Passes	States the maximum number of system passes before stopping all tests (0 causes the SunVTS kernel to run the tests until you click the Stop button)
	Max System Errors	States the maximum number of system errors before SunVTS stops all tests (0 causes the SunVTS kernel to continue testing regardless of errors)
	Max System Time	Specifies the maximum number of minutes that SunVTS continues testing (0 makes the SunVTS kernel run the selected tests until you click the Stop button)
Notify...	Send Email	Determines when and if you want the test status messages sent to you by email. From this menu, you can choose: - Disabled (never send email) - Now (send email immediately) - On Error (send email when an error occurs) - Periodically (send email with a time period set in the Log Period option) - On Error & Periodically (send email periodically as well as when an error occurs)
	Email Address	Indicates the email address where the test status messages are sent (the address is root by default)
	Log Period	Specifies the time in minutes, between sending test status email messages
Schedule...	Auto Start	Eliminates the need to use the Start button to start a SunVTS testing session. To use this option: 1. Enable the Auto Start setting. 2. Save the System options and Test options to an option file (see "To Use the Option Files Button" on page 88 for more information). 3. Starts SunVTS from the command line, specifying the option file. SunVTS begins testing soon after the main window is displayed.
	Single Pass	Runs only one pass of each selected test
	System Concurrency	Sets the maximum number of test instances that can be run concurrently in the machine being tested
	Group Concurrency	Sets the number of tests you want to run at the same time in the same group
Test Execution...	Stress	The amount of stress can be tuned by the number of test instances you select

TABLE 3-4 (Continued)

Global Options	System Option	Description
	Verbose	Displays verbose messages in the SunVTS Console window
	Core File	Creates a core file. If the <SunVTS bin> directory is writable; core.<testname>.xxxxxx is the Core File name, where <testname> is the test that dumped core, and where xxxxxx is a character string generated by the system in order to make the file name unique. When Core File is disabled, a message is displayed and logged, indicating the signal that caused the failure; see "Log Files" on page 91 for more information
	Run On Error	Continues testing until the Max Errors number is reached
	Max Passes	Specifies the maximum number of passes a test can run
	Max Errors	States the maximum number of allowable errors before stopping the test (0 makes the SunVTS kernel continue testing regardless of errors)
	Max Time	States the time limit (in minutes), a test can run (0 = no limit)
	Number of Instances	Specifies the number of instances to run each scalable test
Advanced...	System Override	Supersedes the specific group and test options in favor of the options in this window; sets the options on the test group and test option menus Note: To save a set of options, use the Option Files window described in "To Use the Option Files Button" on page 88
	Group Override	Supersedes the specific test options in favor of the group options in this window
	Group Lock	Protects the specific group options from being changed in this window from the options set at the system level (the System Override option supersedes this option)
	Test Lock	Protects the specific test options from being changed in this window from options set at the group or system level (the System Override and Group Override options supersede this option)
	Processor Affinity	Only available on multiprocessor systems; use to specify on which processor you want to run all tests. To select the specific processor, click the number. If no processor is specified, the operating system randomly distributes testing among all the processors. Note that when you use random distribution, you cannot verify that all processors have been tested.

· To Use the Select Tests Button

You can set global testing options using the Select Tests pop-up window.

1. Click the Select Tests button to display the Select Tests pop-up window (FIGURE 3-34).

FIGURE 3-34

2. Select and pull down the Test Mode arrow so that your choice (Functional or Connection test mode) is displayed.

3. Select groups of tests (Default, None or All) from Test Set.

   Note - Selecting None while tests are running stops the tests, but the System Status panel still displays the word testing, and the Elapsed Time indicator continues to increment. Click the Stop button to halt testing.

4. Select Disabled or Enabled to intervene.

   There are two categories of tests that require intervention mode:

• Tests of drives that require scratch media (tapes, disks, or diskettes)
• Tests that require loopback connectors

SunVTS cannot run these tests until you enable intervention mode. This setting does not change the test function; it just serves as a reminder that you must intervene before the test can be successfully completed.

· To Use the Option Files Button

You can Load, Store or Remove an Option File. Storing an Option file saves the current settings from the global test options and specific test settings to a file in the /var/opt/SUNWvts/options directory.

1. Click the Option Files button to display the Option Files pop-up window (FIGURE 3-35).

FIGURE 3-35

2. Type the file name or pull-down and select a listed file name.

3. Load, Store or Remove the specified Option File.

Information (Info) Choices

The Info area of the Main window lets you select various ways to view system information.

Using the Sys Config Button

From the pull-down Sys Config menu, you can either display or print test system configuration information.

· To Display the Hardware Configuration of the Test System

1. Click the SysConfig button to display the pop-up window.

2. Select Display.

   The Configuration window is displayed (FIGURE 3-36) listing all of the hardware on the test system and the corresponding hardware tests.

FIGURE 3-36

· To Print the Hardware Configuration of the Test System

1. Select the Print option from the Sys Config pull-down menu.

   A Print System Configuration window is displayed with your default local printer (FIGURE 3-37).

   FIGURE 3-37 OPEN LOOK Sample Print System Configuration

2. If you want to use another printer, type that printer name in the Printer Name field.

3. Click the Print button.

4. If you want to end the print request, select the Cancel button.

Log Files

SunVTS saves the status of its progress in three kinds of log files--error, information, and UNIX messages.

· To Access Files from the Log Files Window

1. Click the Log Files button (FIGURE 3-38).

   Refer to "Reviewing Log Files" on page 119 in Chapter 4 for more details.

FIGURE 3-38

The three log files in this menu are:

• /var/opt/SUNWvts/logs/sunvts.err (SunVTS error status log)
• /var/opt/SUNWvts/logs/sunvts.info (SunVTS information log)
• /var/adm/messages (Solaris system message log)

2. Click to select one category of the log files.

3. Type the name of the printer if you want to print a file.

4. Select Display, Remove, or Print.

Choosing the System View

The System View area is where you choose to display either the Logical or Physical view of the system being tested (FIGURE 3-39).

FIGURE 3-39

Using the OPEN LOOK Test Selection Panel

From the Test Selection Panel, you can select and deselect the tests you want to run. You can also change global and individual test options (FIGURE 3-40). Active or selected tests appear darker, while inactive tests have look grayed-out.

The content of this panel is determined by the test configuration.

FIGURE 3-40

---

Note - Some tests can only be selected if you are running SunVTS in intervention mode. See "Intervention" on page 80 in Chapter 4 for more information.

---

If you click a test group (Processor(s), Memory, Network, and so on), the test group's system option window is displayed and you are given three choices for viewing and setting test group options:

• Scheduling
• Test Execution
• Advanced

See TABLE 3-4 on page 86 for descriptions of these options.

If you click an individual test (pmem0 (pmem), cpu-unit (fputest), and so on), the test system option window is displayed and you are given three choices for viewing and setting individual test options:

• Test Options
• Test Execution Options
• Test Advance Options

Each of these windows is test-dependent and is described in the SunVTS 2.1 Test Reference Manual.

OPEN LOOK Console Panel

SunVTS error messages are displayed in the Console panel. This panel is located in the lower right part of the SunVTS OPEN LOOK Main window (FIGURE 3-41).

FIGURE 3-41

· To display verbose messages from either the SunVTS kernel or the tests, enable the Verbose option on the Set Options window in the Test Execution selection.

See "Using Option Choices" on page 84 for more information about setting up Option files.

---

TTY Interface

A screen-oriented TTY-based interface is also an option with SunVTS. You can use it in a command shell from a telnet, rlogin, or tip session, or from a terminal attached to a serial port or connected to the system being tested through a modem. Most of the control and monitoring options also available through the GUI are available through the TTY interface.

TTY Main Window

The TTY Main window is divided into four main areas (FIGURE 3-42):

• Control panel
• Status panel
• Tests panel
• Console area

FIGURE 3-42

Navigating Through the TTY Interface

Common keyboard commands are used for navigating throughout the TTY interface. TABLE 3-5 summarizes these commands.

TABLE 3-5

Key	Description of Action
Tab	Moves the highlight or shifts the focus to another window. For example, if you are working in the Control panel and press the Tab key, the focus (or highlight) shifts to the Status panel. A panel that is highlighted will be bordered by asterisks (*). Before you can change an option, you must first highlight that panel.
Return	- Displays a menu - Selects and applies a choice or a command in a menu
Spacebar	Selects or deselects an option checkbox; [ ]= select; [*]= deselect
Arrow Keys	Moves between options in a highlighted panel
Backspace Key	Deletes text in a text field
Escape	Discards a pop-up menu or window
Control-F	Scrolls forward in a scrollable window
Control-B	Scrolls backward in a scrollable window
Control-X	Quits the TTY user interface but leaves the SunVTS kernel running
Control-L	Refreshes the TTY window

The following sections lead you through some common testing procedures. In all cases, use these keyboard commands to select and apply your test options.

Setting TTY Options

For a description of all the SunVTS options, see "Using Option Choices" on page 84.

· To Select and Change System Options from the TTY Option Window

1. Select the Control panel with the Tab key (FIGURE 3-43).

   Asterisks (*) appear around the Control panel when it is selected.

2. Select set_options with the arrow keys.

3. Display the SunVTS System options with the Return key.

FIGURE 3-43

4. Highlight Test_Execution using the arrow keys and press Enter.

   When an option is highlighted, it can be changed. There are two ways to change the system options: from the menu and by typing in the text field.

   a. Select the Core File option with the Return key.

   b. Select this option.

   A pull-down menu is displayed on the machine and lists the choices of the Core File option (FIGURE 3-44).

   c. Highlight enabled.

FIGURE 3-44

d. Select this choice with the Return key.

The stress option changes from disabled to enabled.

e. View the second page of the Options menu by typing Control-F (FIGURE 3-45).

f. Select the num_instances text field.

g. Change the value to 10.

Use the up or down arrow keys to move the cursor out of the text field.

FIGURE 3-45

5. Highlight Apply after you finish changing the options.

6. Apply the changes and remove the Options window by pressing the Return key.

   Note - If you want to remove the Option window without changing any options, press the Escape key.

Selecting Tests and Test Groups for Testing in TTY

· To Select and Deselect Tests and Test Groups

1. Select the Tests panel with the Tab key.

   When selected, the panel is bordered by asterisks.

2. Highlight the checkbox by the test group name.

   In this example (FIGURE 3-46) the checkbox associated with SCSI-Devices (esp0) group is selected, so it is highlighted.

3. Deselect the test group with the spacebar.

   Notice that the asterisk no longer appears between the brackets, and that the test names are removed from the Status panel.

FIGURE 3-46

4. Highlight the test group name, using the right arrow key.

5. Display the tests within the test group by pressing the Return key.

6. Highlight the brackets in front of the test you want to enable, using the up and down arrow keys.

7. Select the test with the Spacebar.

   An asterisk displays between the two brackets, and the test group and test name appears on the Status panel (FIGURE 3-47).

FIGURE 3-47

---

Note - If you want to change the test options, highlight the test name and press the Return key to display the test option menus.

---

8. Remove the test group window with the Escape key.

Using the TTY Status_view Menu

The Status_view menu has a scrollable area. It is possible to select more tests than the status panel can display at one time. Use the Control-F and Control-B keys to scroll forward and backward to view additional selections. You can also display only those tests with errors by highlighting the Errors Only in the Status_view menu (see FIGURE 3-48 and TABLE 3-6).

· To Scroll Through Tests Using the Status_view Menu

1. Highlight the Status panel with the Tab key.

   When selected, the panel has asterisks around the border. Notice that the Status_view option is also highlighted.

2. Display the Status_view menu with the Return key (FIGURE 3-48).

FIGURE 3-48

3. Move to the option you want with the Arrow keys (TABLE 3-6).

   Choose one of the following options:

   TABLE 3-6 Status_view Menu Options

Option	Description
Errors_only	Displays only the tests that produce errors
Next_page	Skips to the next page of tests
Previous_page	Goes back to the previous page of tests
First_page	Goes to the first page of tests
Last_page	Goes to the last page of tests

4. Select your choice with the Return key.

   The Status panel changes to reflect your choice.

Using the TTY Log_Files Menu

The following paragraphs describe how to display, print, and remove log files.

· To Display, Print, or Remove Log Files

1. Highlight the Control panel with the Tab key.

   When selected, the panel has asterisks around the border (FIGURE 3-49).

FIGURE 3-49

2. Highlight the log_files option with the Arrow keys.

3. Display the log_files menu with the Return key.

4. Select the option you want with the Arrow keys (TABLE 3-7).

   Choose one of the following options:

   TABLE 3-7 TTY Log_files Menu Options

Option	Description
Error	Selects the Error log file
Information	Selects the Information log file
Unix Msgs	Selects the UNIX messages log file

---

Note - If you do not want to select a log file, press the Escape key to remove the Log_files menu.

---

5. Select the log file and display another menu by pressing Return.

   From this menu, you can either display, remove, or print the selected log file. See TABLE 3-7, for a description of these options.

6. Confirm your choice by pressing Return.

   FIGURE 3-50 is a sample SunVTS log file displayed in TTY mode. You can use the commands Control-F and Control-B to page forward and backward through the log file.

FIGURE 3-50

7. Return to the main window by typing :q.

   Note - If you try to run a graphics test on a test machine that is not running OPEN LOOK, and you are running the SunVTS TTY interface on the test machine monitor, the graphics test may fail. You can avoid this failure by either running the SunVTS TTY interface on a terminal attached to a serial port on the test machine, or you can run the TTY interface from a remote machine.