SunVTS 3.0 User's Guide

Running SunVTS With the TTY Interface (Tutorial)

To Use SunVTS With the TTY Interface

The TTY interface is a ASCII based, screen-oriented interface that does not require a graphical window environment. Most of the control and monitoring options that are available in the SunVTS GUI interface are also available in the TTY interface.

You can use the TTY interface to run SunVTS from a terminal, shelltool, command tool, or a modem attached to a serial port.

Start SunVTS with the TTY interface:

The TTY main window is displayed (figure below):

# /opt/SUNWvts/bin/sunvts -t

Figure A-13 TTY Main Window

Identify the four main areas in the display (see Figure A-13):
- Control panel--access to SunVTS commands and options.
- System map--shows the testable devices (categorized in test groups) and provides access to their test options.
- Status panel--displays the SunVTS test status information
- Console Area--the area where test and error messages are displayed. No user input is possible in this area.

Review these keyboard commands:

Keyboard commands, instead of mouse and pointer action, are used to control SunVTS with the TTY interface. The following steps lead you through some of the common procedures. In all cases, use these keyboard commands to select and apply your test input.

Table A-1 TTY Keyboard Commands


Key	Description of Action
Tab	Moves the highlight or shifts the focus to the next 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	Closes 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

Move between the main display areas (press the Tab key several times).

As you use the Tab key, your position in the display is indicated by dark rectangle. It is important to keep track of your position in the display. When the dark triangle is over a word or command, it is highlighted (ready to be selected).

As you press the Tab key, you move from the Control panel to the Status panel to the System Map, and back.

Select your test mode:
1. Use the Tab key until you are in the Control panel area (Start will be highlighted).
2. Use the right arrow key to highlight test_mode.
3. Use the Return key to display the test_mode menu.
4. Use the down arrow to highlight Connectivity (Connection mode).
  
  (The up and down arrows are used to move between options.)
  
  For descriptions of Connection and Functional test modes refer to "Test Modes".
5. Press Return to apply the change and exit the menu.
6. Press the Return key again to reenter the test_mode menu.
7. Use the arrow key to highlight Functional and press Return.
  
  SunVTS prompts you to verify this change.
8. Use the arrow key to highlight OK and press Return.

Use the Tab key to move to the System map (Test_Group area).

The asterisk([*]) in the brackets, next to group name, indicates that all devices in that group are selected for testing.

To see devices listed inside a group:
1. Use the right arrow key to highlight Processors.
2. Use the Return key to display a menu that shows you the individual devices and their tests (see the following figure).
  
  Figure A-14 Processor Group Tests (TTY Interface)
3. Press the Escape key to Return to the main menu.

Deselect test groups:
1. Press the Tab key to move to the Control panel area.
2. Use the arrow key to highlight test_select.
3. Press the Return key to open the test_select menu.
4. Highlight None, and press Return.
  
  All asterisks next to each test groups are no longer displayed indicating that no tests are selected.

Modify device specific test options:
1. Press the Tab key to move to the System Map.
2. Use the arrow key to highlight Network and press Return.
  
  Your network device(s) are shown in the menu.
3. Highlight nettest (or whatever network test is available on your system), and press Return.
4. Highlight Test_Parameters and press Return.
  
  The Test Parameters menu for nettest is displayed. For the purpose of this tutorial, you will only be directed to change the Print_Warning option.
5. Use the arrow keys to highlight the word Disabled (next to Print_Warning, refer to the following figure).
  
  Figure A-15 nettest Test_Parameters (TTY Interface)
6. Press Return once to open the enable/disable menu, and again to select enable.
  
  The Print_Warning value is set to enable. Do not press the Escape key; the change must be applied.
7. Use the arrow keys to highlight Apply, and press Return.
  
  The change is applied and you return to the previous menu.
8. Press Return to enter the nettest option menu again.
9. Highlight Test_Execution, and press Return.
10. Highlight the Verbose option "disabled", and press Return twice to change it to enabled.
11. Use the arrow keys to highlight Apply, and press Return.

Select a device for testing:

Any number of tests can be selected. For the purpose of this tutorial, you will only be directed to select one test (nettest).
1. Use the arrow key to highlight the brackets ([ ]) next to nettest.
2. Press the space bar.
  
  An asterisk appears in the brackets indicating that this test is selected.
3. Press Escape to return to the main TTY window.
  
  The system map will show an asterisk next to the Network group (refer to the following figure).
  
  Figure A-16 Network Group Selected in the System Map (TTY Interface)

To set global options:
1. Use the Tab key to move to the Control panel area.
2. Use the down arrow to move to the second row of commands.
3. Use an arrow key to highlight set_options.
4. Press Return to open the set_options menu.
5. Press Return again to open the Thresholds menu.
6. Type 3 next to Max_System_Passes.
7. Use the arrow keys to highlight Apply and press Return.

To start testing:
1. Use the arrow keys to highlight Start in the Control panel area.
2. Press Return once to get the start menu, and again to select Start.
  
  Testing begins. The Console window displays messages because the verbose option is enabled. The Status panel displays the testing status such as the system status, passes, errors, and the elapsed time.
  
  Note -
  nettest checks all the networking hardware on the system CPU board and separate networking controller cards. For this test to be meaningful, the system must be attached to a network.

Review the test results:
1. Observe the message window that appears when testing is done (refer to the figure below).
  
  This window displays the test results for all of the tested devices.
  
  Figure A-17 TTY Message Window
2. Press Escape to dismiss the Message window.
  
  No other commands will work until this window is dismissed.

Review the log files:

SunVTS events are recorded in three log files. Refer to "The Log Files Button" for details. This tutorial directs you to view the contents of the Information log.
1. Tab to the Control panel area.
2. Highlight log_files and press Return.
3. Highlight Information and press Return.
4. Highlight Display and press Return.
  
  The contents of the SunVTS Information log are displayed.
  
  To display the log file, SunVTs opens a temporary file using the default editor for the shell (Bourne, korn, or c-shell, and so on) that you are using. In many cases, this is the vi editor. All of the standard editor commands are valid in this file, however, no changes will alter the permanent log file.
  
  Assuming that you are using the vi editor, use the following vi commands to view the log file contents:
  - Arrow keys--move the cursor one line, or character at a time.
  - Control-F--display the next screen
  - Control-B--display the previous screen
  - /string--search forward for string
  - Esc,Q--quit
  Figure A-18 SunVTS Information Log (TTY Interface)
5. When you are done reading the information log file, press the Escape key, then :q to dismiss it.
6. Press Escape again to dismiss the log_file menu.

To reset the current test status information:

It is a good idea to reset previous test status information before you begin another test session.
1. Tab to the Control panel area.
2. Highlight reset and press Return.
  
  The Status panel is cleared.
  
  Note -
  The messages in the lower Console window are not cleared by reset.

To Exit SunVTS:
1. If you are not in the Control panel area, move there now (Tab key).
2. Highlight quit and press Return once to get the Quit menu, and again to select quit UI and kernel.
  
  SunVTS is closed and your display is cleared.

Running SunVTS With the TTY Interface (Tutorial)

To Use SunVTS With the TTY Interface

Figure A-13 TTY Main Window

Figure A-14 Processor Group Tests (TTY Interface)

Figure A-15 nettest Test_Parameters (TTY Interface)

Figure A-16 Network Group Selected in the System Map (TTY Interface)

Figure A-17 TTY Message Window

Figure A-18 SunVTS Information Log (TTY Interface)

Figure A-15 `nettest` Test_Parameters (TTY Interface)