| SunVTS 7.0 Software User’s Guide for Initial Release Through Patch Set 7 |    
|
| C H A P T E R 3 |
|
Using the SunVTS Browser User Interface |
This chapter describes using the SunVTS 7.0 browser user interfaces (BUI). Topics include:
| Note - SunVTS must first be started before selecting a user interface. See Starting SunVTS. The BUI may not be supported in future releases of SunVTS. |
The SunVTS 7.0 browser user interface (BUI) is the Java Web Console. The Java Web Console provides a common point for Sun web-based system management applications to be registered and accessed. A common platform login is provided as well as a Start page to access all registered applications under these categories: Systems, Storage, Services, Desktop Applications, and Other.
Using the browser, start the URL where the Java Web Console is installed as https://hostname:6789. For example, https://santoor.india.sun.com:6789.
|
1. Using the browser, start the URL where the Java Web Console is installed as https://hostname:6789.
The default login window (FIGURE 3-1) is displayed.
FIGURE 3-1 Sun Java Web Login Window
The Java Web Console is displayed (FIGURE 3-2).
5. Click the SunVTS application listed under Systems.
The Host Machine View window appears (FIGURE 3-3).
FIGURE 3-2 Sun Java Web Console
TABLE 3-1 describes the Java Web Console window buttons.
|
Displays all the applications registered with Sun Java Web Console (FIGURE 3-2). Also displays the user that is currently logged in and the middle server name where the user has logged in. |
||
The Host Machine View screen (FIGURE 3-3) facilitates adding, removing, and viewing the configuration of a Host to be diagnosed.
The host to be configured should have both the middle server and vtsk installed. Ensure that the vts kernel is running on the hosts that you want to configure for system testing. Before initiating any tests or monitoring the test status, you must first add the host.
FIGURE 3-3 Host Machine View Window
|
1. From the Host Machine View, click Add Host (FIGURE 3-3).
The Add New Host dialog box is displayed (FIGURE 3-4).
FIGURE 3-4 Host Machine View - Add New Host Dialog Box
2. Type the IP address or host name.
3. Log in as root and type the user name and password.
The Add New Host screen is displayed (FIGURE 3-5).
FIGURE 3-5 Add New Host Window
If vtsk and JAVA bridge is not running on the host or agent machine, or in case of some other error, an alert message of Login Failed is displayed on the Add New Host pop-up (possibly from a login failure).
| Note - You can add only one host at a time using the Add Host pop-up window. That host is the system under test. |
When you add a host, an entry appears on the Host Machine View table (FIGURE 3-6).
FIGURE 3-6 Host Machine View Window
TABLE 3-2 shows the Host Machine View screen descriptions.
|
1. Click one or more boxes next to the host you want to remove.
The Remove Host button is highlighted.
2. Click the Remove Host button, and click OK on the confirmation window (FIGURE 3-7).
FIGURE 3-7 Remove Host Confirm Window
3. Click OK to remove the host.
The host is removed and an alert message is displayed that indicates a successful logout (FIGURE 3-8).
FIGURE 3-8 Successful Log Out Window
|
1. Click one or more boxes next to the hosts whose configuration details you want to view.
The View Host Configuration button is highlighted.
2. Click the View Host configuration button.
The details displayed are host name, IP address, platform, operating system, number of CPUs, machine type, and architecture of the selected system (FIGURE 3-9).
FIGURE 3-9 Host Configuration View Window
3. Click the Back to Host Server button to return to the Host Machine View.
An alternate way to go back to the parent page is by using the navigation link at the top of the window.
The Test Group window (FIGURE 3-10) lists the tests that are registered with the host machine.
1. Click the Hostname link in the Host Machine View.
The Test Group window is displayed. The Tests tab is associated with the Test Group View.
The host machine name can be viewed on the heading of the window.
2. Click on the Host machine View link to navigate back to the parent window.
The Test Group table (FIGURE 3-10) displays the tests registered with the host. This window also has the following features that allow you to:
FIGURE 3-11 shows a Test Group Screen under test.
FIGURE 3-11 Test Group Window Under Test
This section describes the parameters available in setting up a test. Select parameters from the Test Group screen (FIGURE 3-10) and Test Options screen (FIGURE 3-14).
The Test Group screen (FIGURE 3-10) displays the name of the system being viewed for status (santoor in this example). The following items describe the table:
Tests can be any of the following: Memory, Disk, Network, HBA, Graphics, Processor, IOports, interconnect, and Media. Click on the test link to set the test options; stress level, scheduling policy (time-based or in terms of test passes), and error limit.
This column shows the state of the test at a given time (enabled or disabled).
On the Test Options screen (FIGURE 3-14), select Test Time or Test Passes based on the testing requirement. In the case of Test Time, specify the time in minutes in the text box (range 0 to 99999). For Test Pass, specify the number of passes in the text box (range 0 to 99999). By default, Test Time is the scheduling policy and the default value for both (Time or Passes) is zero.
Select Test Passes when time is not a constraint and is being used to reproduce an error on the specific test.
Select low or high (FIGURE 3-14).
The Progress bar in the Test Group table (FIGURE 3-10) indicates the percentage of the test run completed. A tool tip over the progress bar shows the progress of the test in percentage and the current state of the test.
The Test Status column in the Test Group table (FIGURE 3-10) shows the status of the test, either idle, testing, analyzing, not supported, stopping, failed, or completed, along with the passes and error count. Each status item is described as follows.
Idle - A test can be idle for any of the following reasons:
Not supported - For the given stress level, a test might not be able to run for any of the following reasons:
Analyzing - A test is running after completion of each pass that checks for certain terminating parameters such as max time, max pass, and max error to analyze if it can run for the next pass. The Analyzing status lasts for 2 to 3 seconds.
Testing - The test is currently executing.
Completed - The test has completed its execution. The completion factor is based on the limits set from the scheduling policy, (time or pass limit).
Failed - The test stopped because the test errors reached the maximum error limit.
Waiting for swap - If there is not enough swap available, you can stop a test and schedule the test execution for later.
Stopping - When you press the Stop button, the test status shows the transition from stopping status to idle status.
The Test Results column displays test results in two subcolumns. The first subcolumn displays the number of test errors and second displays the number of test successes.
You can perform various functions on the Test Group table (FIGURE 3-10) using the buttons Enable, Disable, Start Tests, Stop Tests, Edit Global Options, Reset Results and Reprobe. TABLE 3-3 describes the button functions.
Select the Test Mode depending upon the testing requirement. Test Mode is located at the top left corner of the Test Group table. You can select one of the three test modes (Online Stress, System Exerciser, and Component Stress) from the drop-down menu.
See Test Modes in Chapter 1.
By default the Test Mode is set to System Exerciser mode.
The Session feature is very useful when you want to automate SunVTS 7.0 with some defined options. Instead of setting up the combination of test, global, or mode options each time you need to diagnose the host machine, you can create a session file with the combination of options. Then, save your test preferences with a session name. The session is saved in XML format. Load the session file and the saved option settings are used.
|
For selected test modes, you can save chosen tests with configured option values. This feature enables you to repeat tests in the same configuration for the same machine or a different machine.
1. Configure SunVTS for the test session that you want to save.
2. From the Test Group window, select a Save Session option from the Session menu.
The Save Session window is displayed (FIGURE 3-12).
3. Select or type a name in the Session Name text field.
You can also choose an existing session name from the list.
| Note - Do not include a space in the session name input. |
4. Select a Test Mode as the default active Test Mode for the Session.
5. Select the Overwrite Session option to overwrite the existing session with the new session.
6. Select the type of session: Generic or Host Specific.
7. Click OK to save the session.
The Save Session window is closed, and your session configurations are saved for future use.
FIGURE 3-12 Save Session Screen
|
You can view all the sessions existing for the machine. To list sessions:
1. From the test group window, select the List Sessions option from the Session menu.
The List Sessions window is displayed with the list of all the existing sessions
2. Click Close to close the List Session Window.
|
This option allows you to choose desired session. The test configuration and option values for tests execution is set based on selected session. To load sessions:
1. From the Test Group window, select a Load Session option from the Session menu.
The Load Session window is displayed.
2. Select an existing session name to load.
3. Select a Test Mode as the default Test Mode to load the session.
4. Click OK to Load the session.
The Load Session window is closed, and the test session configuration is loaded into SunVTS. SunVTS will update and refresh the values on the BUI. The BUI will show the name of the loaded session. You can use this configuration, or modify it, before you start the testing (FIGURE 3-13).
FIGURE 3-13 Load Session Screen
|
If you no longer need a specific test configuration, you can delete the session associated with it. To delete a session:
1. From the Test Group window, select Delete Sessions from Session drop-down menu.
The Delete Session window is displayed with the list of all existing sessions.
2. Select the Session that you want to delete from the List of Sessions.
3. Click OK to delete the selected Session.
The Delete Session window is closed, and the selected session is deleted.
If you loaded or saved a session but then you decide to run the tests with the default test configuration, you can use this option. This clears the session values and settings and loads the default parameters.
The Test Options screen (FIGURE 3-14) appears when you click the Test Name link from the Test Group (FIGURE 3-10) table in the Test column.
FIGURE 3-14 Test Options Screen
After selecting a test from the Test Groups table, select the test options that you need. For example: select Disk Test Options (FIGURE 3-15), or Interconnect Test Options (FIGURE 3-16).
FIGURE 3-15 Disk Test Options Screen
FIGURE 3-16 Interconnect Test Options Screen
1. Specify the stress level - low or high, depending upon your requirement.
The default stress values are based on the system configuration. If the system has a small memory configuration, the default stress is set to “low” level. Otherwise, the default stress is “high” level. SunVTS considers a system as a small memory configuration if it has less than or equal to 2GB of memory (for x86), and less than or equal to 4GB (for SPARC).
2. Choose the Scheduling Policy between Test Time or Test Passes.
Depending on the selection, provide the time in minutes or number of passes.
3. Choose a Specific Pass Level.
You can choose a specific pass level and only the test related to that specific pass level will run. The valid range of pass levels are listed in the enclosed bracket next to the specific pass level tag. By default, the value of Specific Pass level is 0 and means that no specific pass level has been selected.
Specify the number of errors beyond which the test should stop executing. By default, the Error Limit is set to 1. An error limit of 0 would mean that the test continues to run with no limits to error count.
5. Choose specific test device options (optional).
Some Tests export specific options that allow you to select the test devices and modify the device options.
a. Select the check box corresponding to the device and click the “enable” or “disable” button to select/de-select the device. By default, all the devices will be enabled or disabled.
b. To change the device options, click on the device link.
The test option selection window is displayed.
6. Click OK to confirm the changes and to return to the parent page.
The Cancel button cancels the changes and returns to the parent page.
There are certain options that can be applied to all the tests globally. These options can be used to schedule the total time of the testing session. To edit the Global options:
1. Click on the Edit Global Options button on the Test Group screen.
The Global Test Options screen is displayed (FIGURE 3-17).
FIGURE 3-17 Global Test Options Screen
2. Set the duration of testing in the Duration of Testing field in minutes.
3. For the Verbose option, select Enable if you want to log the Verbose messages or Disable, if otherwise.
Verbose messages are the console messages. If verbose is enabled then the console messages from the vtsk are not only displayed on the BUI console, but also logged in the log file. If this box is not checked, all verbose messages are only logged in the log file in /var/sunvts/logs/sunvts.verbose.
4. In the Duration of Logging option, set the time in minutes after which the information messages should log in the sunvts.info file.
For example, if the duration is set to 60 minutes, the testing information messages will be logged in the sunvts.info file every 60 minutes.
5. Click OK to save the edited global options.
Clicking Cancel navigates you back to the Test Group page without saving the edited options. You can also navigate back to the parent page using the links provided at the top of this page.
SunVTS 7.0 PS6 and subesequent compatible releases support a new global option. This option allows you to complete more stressful hardware testing.
By default all SunVTS tests are data safe. You must decide if you should disable the Safe option: choosing Disable performs the more stressful testing. By default, the option is always Enable or Data Safe.
To provide extra protection, the option will only becomes active if the sunvts_options.conf configuration file is present with the appropriate variable set. All the conditions need to be met before the tool accepts the unsafe testing (the Disable option).
2. Create a configuration file: /etc/sunvts/conf/sunvts_options.conf
The file takes a variable "name" and a corresponding "value,” which will be used by the tool. Both the "name" and the "value" are keywords. The only name and value that are accepted are
SunVTS reads the configuration file. In the BUI, the “Global Option” button now has another entry: "Safe Testing". You can set the button to Enable or Disable.
With the Safe Option feature, the Global Test option screen will look similar to FIGURE 3-18.
FIGURE 3-18 Safe Testing Enable or Disable Button
Logs appears as a tab that can be located next to the Tests tab. Select the Logs tab to view the following five logs. Each of these logs are displayed in five separate tabs.
Click a specific tab to view related logging information (FIGURE 3-19).
Click this tab to view the tests related error messages that gets logged to /var/sunvts/logs/sunvts.err directory. The test error log contains time-stamped SunVTS test error messages. This file is not created until a SunVTS test failure occurs.
You can click this tab to view the vtsk related error messages that gets logged to /var/sunvts/logs/vtsk.err directory. Vtsk error logs contains time-stamped SunVTS kernel and SunVTS probe errors. SunVTS kernel errors are errors that relate to running SunVTS, and not to testing of devices. This file is not created until SunVTS reports a SunVTS kernel error.
Click this tab to view all information about the running tests. Data like the number of test passes, failures, time elapsed, will get collected after a fixed interval of time. Informative messages are generated at the start and stop of the SunVTS testing session and also during intermediate interval notifications. The messages are logged to /var/sunvts/logs/sunvts.info directory. This file is not created until a SunVTS test session runs.
Click this tab to view system generated UNIX messages. It displays all the general Solaris events logged by syslogd. The pathname of this log file is /var/adm/messages.
Verbose Messages logs the test messages that can be useful for debugging. The logs displays test messages only when the verbose mode is enabled from Global Options. Verbose message are logged in /var/sunvts/logs/sunvts.verbose directory.
You can type the number of lines from the end of log file, that you want to view and then press View button.
This button clears the test log from the screen and deletes it from the directory. When you click the delete button, a conformation dialog is displayed, to confirm the deletion of the log.
| SunVTS 7.0 Software User’s Guide for Initial Release Through Patch Set 7 | 820-0012-20 |
|
Copyright © 2010, Oracle and/or its affiliates. All rights reserved.
To Start the SunVTS Browser User Interface
