Trilinos Framework Update

1. Trilinos Framework Update Roscoe A. Bartlett James M. Willenbring Michael N. Phenow Trilinos User Group Monday, October 31st, 2005 9:30 - 10:30 am Building 980, Room 95, Albuquerque

2. Topics - Makefile.export - How to use runtests - Custom test harness runs - Package test "definition" files - Adding tests - Excluding tests for particular platforms - DESCEND_DIR option - Adding categories of tests - New release versioning system - Test harness results pages - New website material - Supported versions of Autoconf and Automake - Trilinos monthly newsletter - Future Framework development

3. How To Use Runtests http://software.sandia.gov/trilinos/developer/test_harness/runtests.html http://software.sandia.gov/trilinos/developer/test_harness/runtests_make_target.html - To run the test suite (the tool will only attempt to run tests that were built), simply "make" and then type: make runtests-serial - Can run tests for individual packages - For MPI "make runtests-mpi" - must specify TRILINOS_MPI_GO in the environment or as an argument to make - Trilinos/commonTools/test/utilities/runtests --help

4. Custom Test Harness Runs - Just send an invoke-configure script to Jim or Mike P. - Currently targeted for Linux - Could expand to other platforms

5. Package Test "Definition" Files - Add to the tests that runtests knows about - Find detailed instructions at: http://software.sandia.gov/trilinos/developer/test_harness/test_definitions.html (FRAMEWORK, INSTALL, CHECKIN, ALL) { DIRS = SomeTests; ARGS = smallMatrix, bigMatrix; COMM = SERIAL, MPI; }

6. Package Test "Definition" Files TESTS names of individual tests DIRS directories containing tests DESCEND_DIRS PACKAGE/test/ vs. PACKAGE/test/myTest/ ARGS arguments to tests COMM SERIAL, MPI, CUSTOM-SERIAL, CUSTOM-MPI X-OS uname -o X-ARCH uname -m X-HOST hostname –s (uname –n) EXIT-STATUS RETURN-CODE, STRING-COMPARISON, compareTestOutput COMMAND-FILE compareTestOutput command file MASTER-FILE compareTestOutput master file ARG-MASTER-PAIRS argument / master file pairs

7. New Release Versioning System - Roughly every week we put out a new minor release (6.0.x) - Improves our ability to support users - Allows users to figure out when a new version is available - Provide good CVS log messages on the release branch!

8. Test Harness Results Pages http://software.sandia.gov/trilinos/developer/test_harness/results/ - Summary page (dev and 6.0) - Most recent results for configuring, building, and each individual test on each platform - Color coding available based on date or status - Failures - Issues not known to have been resolved - Lists the previous result and previous pass date - Today - Results from current calendar day - Note that emails contain results from the last 24 hours (from 8:00 am Mountain Time)

9. New Website Material - 6.0 changelog (includes changes for every minor release) - Many test harness-related links (from developer homepage) - SQP resources (from developer homepage)

10. Supported Versions of Autoconf and Automake • Autoconf 2.59 • Automake 1.8.2 • Very easy to install! • The current version numbers are always available in Trilinos/config/AutotoolsVersionInfo • Using unsupported versions has caused a lot of headache • Checking in lots of files that have not really “changed” • Multiple problems with other versions of Automake • Please be especially courteous about other peoples’ packages 10

11. Trilinos Monthly Newsletter - Send to trilinos-users list • Try to drum up user activity • Keep users informed – anything of general interest • Upcoming releases • New features • Events • Awards • New documentation/website content • Send notes to Mike P or Jim W • First newsletter planned for mid-November • Pointer to TUG slides • Update on 6.0 release 11

12. Discussion Future Framework Development