• Start: Start the IMPI Test Tool.
• Stop: Stop the IMPI Test Tool.
• Exit: Exit this applet and returns to the IMPI Test Tool page.

IMPI Test Tool Instructions

The IMPI Test Tool coordinates the execution the IMPI test interpreter (sutInterp, System Under Test Interpreter) on your machine, and the IMPI Test Manager on our machine. If you have not downloaded and compiled the IMPI test interpreter, you need to do so before you can run any tests.

The NIST IMPI Test Tool user interface is arranged in three sections:

• Configuration
• Tests
• Results

These sections are arranged vertically within a single seprate window. Scrollbars are provided if necessary.

Using the NIST IMPI Test Tool involves the following steps:

1. Initiate the IMPI Test Tool using the Start button above.
   
2. In the Configuration section specify the MPI configuration:
• Specify whether NIST runs the IMPI server or if you will run it.
• Specify the number of clients, simulated clients, and so on using the menus in the Test Tool.
• If you are going to run the IMPI server on one of your systems, start it up then enter the host:port in the indicated box in the Test Tool.
  
3. You now have two choices:
• Press the Run Startup Only button if you want to test only the IMPI startup protocol.
• The IMPI startup protocol will begin and the Test Tool will display a sample mpirun startup command.
• Startup sutInterp using the sample startup command as a guide (cut & paste).
• When the IMPI startup protocol is complete the Test Tool will return to it's initial state.
OR
• Press the Run Startup & Prepare for Scripts button to run both the startup protocol in preparation for running test scripts.
• The IMPI startup protocol will begin and the Test Tool will display a sample mpirun startup command.
• Startup sutInterp using the sample startup command as a guide.
• When the IMPI startup protocol is complete, the Tests section of the Test Tool will become active. You can now select and run tests as described in steps 4 and 5.
  
4. Select test scripts by clicking on the boxes next to the test names. Note that some test scripts may be grouped together under a single name. You can view the members of a group by pressing the show group button. You can then conceal the members of a group by pressing the hide group button. Selecting a group name is equivalent to selecting each of the members of the group.

You can get information on the tests scripts here.

5. Run the selected test scripts by pressing the Run Tests button. Each test script in turn will be transmitted to and run on each of the the MPI processes on your system(s) and on NIST's host.
   
6. Results for the tests scripts will be displayed in the text window of the Test Tool. Whether the test passed or failed will be displayed in this text window. In the test selection window each selected test name will be displayed with a color to indicate the result of running that test:
• Green - pass
• Red - fail
• Yellow - indeterminate
You may want to clear the Results window after running several tests since the IMPI Test Tool may slow down (severely) when the Results window contains a large amount of output.

7. If you want to reset both the IMPI Test Tool and the IMPI Test Manager to their initial state, press the Reset button. This is what you need to do to if you need to reconfigure the clients, hosts, and processes for further testing.
   
8. If the Test Tool does not respond to input, try pressing the Panic button. This should only be used as a last resort since this will kill the Test Manager Server running at NIST, along with anyone else's IMPI Test Managers that happen to be running at the same time. The Test Manager Server will automatically restart after about a minute (via a cron job on impi.nist.gov).  So, after about a minute, press the Reset button in the IMPI Test Tool and you should see that the IMPI Test Manager Server is operating again. You will know the server was restarted if you see "Test Manager 1" in the Results window, indicating that this is the first Test Manager started up since the IMPI Test Manager Server was re-started. There should be no need to kill and restart the whole IMPI Test Tool. 
           (In case the IMPI Test Tool Panic button does not work (try that one first),
           try this one:  [Panic]  to restart the IMPI Test Manager Server. )
   If the Panic button ever fails to restart the server, contact us directly and we will restart it from our side (william.george@nist.gov); and maybe work on making a more robust panic button!
   

9. Occasionally the IMPI Test Tool and its Test Manager can become out of sync with respect to which test scripts they think are currently queued to run. A message to this effect will be sent to the Results window when this happens. At that point, it will be necessary to quit the IMPI Test Tool and start over. To do this press the Quit button in the IMPI Test Tool and then press the Start button in the IMPI Test Controller applet at the top of this web page. Note: The Quit button in the IMPI Test Tool interface is the same as the Stop button in the small IMPI Test Controller applet at the top of this web page.

10. When you want to end the testing session completely, press the Exit button in the IMPI Test Controller at the top of this web page, or close the web page.
 

IMPI Home - IMPI Test Tool

This web page was last updated September 21, 2005.