CDE User Interface

When you start SunVTS using the vtsui application, the SunVTS CDE main window displays (see Figure 3-1).

Figure 3-1

CDE applications let you customize aspects of the GUI through a resource file. The SunVTS CDE GUI resource file lets you change font styles and colors.

The SunVTS CDE GUI resource file is in: /usr/openwin/lib/app-defaults/Vtsui

---

Note - The main window is properly formatted with the default resource settings. Changing fonts and colors may distort the window and obscure important status information

---

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 (see Figure 3-2).

Figure 3-2

• Command Menu - contains a list of SunVTS control commands.
• View Menu - contains two items: The Open System Map expands each branch of the system hierarchy and displays it in the System Map window. The Close System Map closes each branch to the top level.
• Options Menu - contains a list of the system option categories. You can select a category to change system options. See Table 3-2 for a description of system options.
• Reports Menu - lists the two types of reports that you can view. The first entry lets you view system configuration information. The second entry lets you view the log files.
• Help Menu - provides online help.

CDE Tool Bar

The Tool Bar is immediately below the Menu Bar (see Figure 3-3). The Tool Bar has a set of buttons that represents the most commonly used functions from the Menu Bar. These buttons provide quick access to their functions.

Figure 3-3

CDE System Status Window

The System Status window is below the Tool Bar (see Figure 3-4) which provides testing status on the overall system. In addition, it includes the name and model number of the host being tested.

Figure 3-4

CDE Device Selection/Status Window

The area below the system status window is divided into two parts. The left side contains the Tests Selection and Testing Mode selectors. The right side contains the System Map window. At the top of the window is a switch that lets you choose either a Physical or Logical view of the system hierarchy (see Figure 3-5).

Figure 3-5

A new type of object called the Container button has two states to indicate that the device contains more objects. Click the "+" button to change to "-", 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 click the left mouse button anywhere on the device name, or on the small check box to the left of it. Click the right mouse button to display a pull-down menu of options for that device (see Figure 3-6).

Figure 3-6

The Option menu contains a status entry in addition to the option selections. Selecting status from the menu causes a status window to pop-up for that device (see Figure 3-7).

Figure 3-7

The status pop-up 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-ups. They will be dynamically updated during testing.

Another status level that uses color displays within the System Map (see the shaded outline areas in Figure 3-8). 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, letting you keep the System Map hierarchy closed during testing. You can then view the entire system at the highest level during a test session. A branch that has no failures displays in green; those with failures are in red. To investigate any names in red, move down that branch of the hierarchy, using the container buttons, until the lowest level indicates which particular device failed.

---

Note - The shaded boxes in Figure 3-8 show areas that appear in color on color monitors.

---

Figure 3-8

CDE Console Panel

The Test Message console panel is at the bottom of the window (see Figure 3-9). It contains testing results and information.

Figure 3-9

OPEN LOOK User Interface

When you start the SunVTS vtsui.ol application, the OPEN LOOK Main window is displayed (see Figure 3-10).

Figure 3-10

OPEN LOOK System Status and Test Status Panels

Figure 3-11 shows a typical system status panel.

Figure 3-11

Test Status Icons

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 2000 system at one time. Figure 3-12 shows the Test Status icons that let you scroll though pages of tests.

Figure 3-12

Figure 3-13 shows how to quickly go to a specific test or test group by selecting the curved arrow icon and dragging right to display the pop-up menu.

Figure 3-13

OPEN LOOK Performance Meter

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

Figure 3-14

OPEN LOOK Control Panel

You can control the SunVTS tests using the Control panel menus and buttons (see Figure 3-15).

Figure 3-15

The following table shows the page number for information about each of the Control Panel selections.

Table 3-1

Selection	Button	Description	Page
Control	Start	Starts all enabled tests	page 47
	Stop	Stops all tests	page 48
	Reset	Resets all pass and error counts	page 48
	Quit	Terminates the SunVTS User Interface and/or the SunVTS kernel	page 49
	Connect to	Connects to another machine	page 50
	Reprobe	Reprobes the system	page 51
	Trace Test	Creates a log of every system call	page 51

Table 3-1

Selection	Button	Description	Page
Options	Set Options	Sets the global SunVTS kernel and test options	page 54
	Select Tests	Sets global test options	page 58
	Option Files	Saves the current settings from the global test options and specific test settings	page 59
Info	Sys Config	Displays and/or prints the system's configuration information	page 60
	Log Files	Displays the Log Files Window	page 62
System View		Determines whether the view is Logical or Physical	page 63

Control Selections

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

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 Window" in this chapter).

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 "Option Files Button" in this chapter for additional 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 force the interface to ignore the hung tests by deselecting these tests from the Test Option panel.

---

Reset Button The Reset button (see Figure 3-16) 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-16

Once testing has begun, the Reset button changes to Suspend. Click the Suspend button to change this button to Resume and pause all SunVTS tests. To resume testing, click the Resume button (see Figure 3-17).

Figure 3-17

Quit Button From the Quit menu button, you can terminate SunVTS for:

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

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 the following pop-up message (see Figure 3-18).

Figure 3-18

This tells you that the connection to this machine has been broken. The beginning of the message shows the machine host name (in parentheses) where the SunVTS kernel terminated.

Connect to Button Use this feature to connect to another machine.

* Click the Connect to button to display the Connect to Machine window

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

Figure 3-19

* Type the hostname 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.

In the case of a machine being setup to have security restrictions that require a password, the password field will appear fully after you press Apply. You can then type in 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.

Reprobe Button * Click the Reprobe button to force the SunVTS kernel to reprobe the hardware devices on the test system (see Figure 3-20).

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 displays so you can confirm your selections.

---

Figure 3-20

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. See the section "Adding and Removing Devices" in Chapter 2 for more information.

Trace Test Button Use the System Call Tracing 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.)

From the Trace Test window (see Figure 3-21) you can choose one or more tests to be traced by selecting the test name from within the scrolling list. 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 it for tracing, it will begin being traced immediately.

Figure 3-21

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 (see Figure 3-22). This "T" lets you see which tests are being traced.

Figure 3-22

To deselect a test, click the highlighted test name in the list displayed by the Trace Test window (see Figure 3-21). 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.

You can send the trace messages to either the SunVTS Console window, or to a log file in /var/opt/SUNWvts/logs. Click either the Console or File selection respectively at the Output selection switch in the Trace Test window. The system call trace messages are immediately redirected.

---

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

---

Options Selections

This area of the Main window is where you set global options for each group of tests.

Set Options Button From the Set Options window, you can set the global SunVTS kernel and test options. See Figure 3-23 for an overview of the various options available on SunVTS.

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

2. Select and change the options (see Table 3-2 for a complete list and description of each available option), and click the Apply button.

Figure 3-23

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)
Notify...	Send Email	Determines when and if you want the test status messages sent to you through email. From this menu, you can choose: - Disabled (never send mail) - Now (send mail immediately) - On Error (send mail when an error occurs) - Periodically (send mail with a time period set in the Log Period option) - On Error & Periodically (send mail 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, in minutes, the time 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 "Option Files Button" in this chapter 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

Table 3-2 (Continued)

Global Options	System Option	Description
	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
	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 indicating the signal that caused the failure is displayed and logged. See "Log Files Button" in this chapter 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 errors a test allows before stopping (0 makes the SunVTS kernel continue testing regardless of errors)
	Max Time	States, in minutes, the time limit 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 all of the options on all of the test group and test option menus Note: To save a set of options, use the Option Files window described in "Option Files Button" in this chapter
	Group Override	Supersedes the specific test options in favor of the group options in this window

Table 3-2 (Continued)

Global Options	System Option	Description
	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: lets you 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.

Select Tests Button From the Select Tests Window, you can set the global testing options (see Figure 3-24).

Figure 3-24

* Select Test Mode to choose Online or Offline mode for testing.

* Select Test Set for a quick way to select groups of tests

• Default enables the default group of tests.
• None enables none of the individual tests
• All selects all of the tests

---

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

---

* Select Intervention to enable or disable tests that require you to intervene before or while a test is running.

There are two categories of tests that require intervention mode:

• Tests of drives that require scratch media (tapes, discs, 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.

Option Files Button 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 (see Figure 3-25).

.

Figure 3-25

Please refer to "Option Files" in Chapter 4 for more details.

Info Selections

This area on the Main window lets you select various ways to view system information.

Sys Config Button From the Sys Config menu, you can:

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

· To Display the Hardware Configuration of the Test System

1. Select Display from the Sys Config menu.

   The Configuration window appears (see Figure 3-26) listing all of the hardware on the test system and their corresponding hardware tests.

Figure 3-26

· To Print the Hardware Configuration of the Test System to a Local Printer

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

   A Print Configuration window displays (see Figure 3-27).

Figure 3-27

2. Type the name of your printer in the Printer Name field.

3. Click the Print button.

Log Files Button SunVTS saves the status of its progress in three log files. These files contain error, information, and UNIX messages. You can access these files from the Log Files Window, which is displayed when you click the Log Files button (see Figure 3-28).

Figure 3-28

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)

Please refer to "Reviewing Log Files" in Chapter 4 for more details.

System View Selections

This selection gives you a choice of displaying either the Logical or Physical view of the system being tested (see Figure 3-29).

Figure 3-29

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 (see Figure 3-30).

---

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

---

Figure 3-30

---

Note - Some tests can only be selected if you are running SunVTS in Intervention mode. See "Intervention" 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 displays and gives you three options for viewing and setting test group options:

• Scheduling
• Test Execution
• Advanced

See Table 3-2 for descriptions of these options.

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

• Test Options
• Test Execution Options
• Test Advance Options

Each of these windows are test dependent and are described in the SunVTS 2.0 Test Reference Manual.

OPEN LOOK Console Panel

SunVTS error messages are displayed in the Console panel, located in the lower right portion of the SunVTS OPEN LOOK Main window (see Figure 3-31).

Figure 3-31

* 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 "Option Files Button" in this chapter for more information about setting up Option files.

TTY Interface

A screen-oriented TTY-based interface is 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 available through the GUI are available through the TTY interface also.

TTY Main Window

The TTY Main window is divided into four main areas (see Figure 3-32):

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

Figure 3-32

Navigating Through TTY

Throughout the TTY interface, there are common keyboard commands used to navigate through the interface. Table 3-3 summarizes these commands.

Table 3-3

Key	Description of Action
Tab	Shifts focus to another window. For example, if you are working in the Control panel and hit the Tab key, you will shift the focus (or highlight) the Status panel. A highlighted panel will be bordered by asterisks (*). You must first highlight a panel before you can change an option in that panel
Return	Depends on the context: - Displays a menu, or - Selects and applies a choice or a command in a menu
Spacebar	Selects or deselects an option checkbox; select is represented by open double brackets [ ] and deselect is represented by an asterisk within double brackets [*]
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 "Options Selections" in this chapter.

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

1. Press the Tab key until the Control panel is selected (see Figure 3-33).

   When asterisks (*) appear around the Control panel, it is selected.

2. Use the arrow keys until the set_options choice is highlighted.

3. Press the Return key to display the SunVTS System options.

Figure 3-33

4. Use the up/down arrow keys to highlight Test_Execution 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. Use the up and down arrow keys to select the Core File option.

b. Press the Return key to select this option.

A pull-down menu displays on the machine that shows the choices for the Core File option (see Figure 3-34).

c. Use the arrow keys to highlight enabled.

Figure 3-34

d. Press the Return key to select this choice.

The stress option changes from disabled to enabled.

e. Type Control-F to view the second page of the Options menu (see Figure 3-35).

f. Use the up and down arrow keys to 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-35

5. When you finish changing the options, use the arrow keys to highlight Apply.

6. Press the Return key to apply the changes and remove the Options window.

---

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. Press the Tab key until the Tests panel is selected.

   When selected, the panel is bordered by asterisks.

2. Use the arrow keys to highlight the checkbox by the test group name.

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

3. Press the Spacebar to deselect the test group.

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

Figure 3-36

4. Use the right arrow key to highlight the test group name.

5. Press the Return key to display the tests within the test group.

6. Use the up and down arrow keys to highlight the brackets in front of the test you want to enable.

7. Press the spacebar to select the test.

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

Figure 3-37

---

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. Press the Escape key to remove the test group window.

Using the TTY Status_view Menu

Because of the small size of the Status panel, often more tests are selected than can be shown on the panel. Use Control-F and Control-B keys to scroll forward and backward respectively. You can also use the Status_View menu to scroll through the pages and also to display only those tests that have errors.

· To Scroll Through Tests Using the Status_view Menu

1. Press the Tab key until the Status panel is highlighted.

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

2. Press the Return key to display the Status_view menu (see Figure 3-38).

Figure 3-38

3. Use the up and down arrow keys to select the option you want.

   Choose one of the following options:

Table 3-4

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. Press the Return key to select your choice.

   The Status panel changes to reflect your choice.

Using the TTY log_files Menu

· To Display, Print, or Remove log_files

1. Press the Tab key until the Control panel is highlighted.

   When selected, the panel has asterisks around the border (see Figure 3-39).

2. Use the arrow keys to highlight the log_files option.

3. Press the Return key to display the log_files menu.

4. Use the Up and Down arrow keys to select the option you want.

   Choose one of the following options:

Table 3-5

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.

---

Figure 3-39

5. Press the Return key to select the log file, and display another menu.

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

6. Press the Return key to select your choice.

   Figure 3-40 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-40

7. Type :q to return to the main window.

---

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.

---