# Presentation: 797327

## 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

## 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

## 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**

## Custom Test Harness Runs

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

## 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;**
**}**

## 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

## 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!

## Test Harness Results Pages

- _[http://software.sandia.gov/trilinos/developer/test_harness/results/](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)

## 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)

## 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

## 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

## Discussion

- Future Framework Development