Trilinos Framework UpdateTrilinos Framework Update

Roscoe A. BartlettJames M. WillenbringMichael N. Phenow

Trilinos User GroupMonday, October 31st, 2005

9:30 - 10:30 amBuilding 980, Room 95, Albuquerque

TopicsTopics- 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 RuntestsHow To Use Runtestshttp://software.sandia.gov/trilinos/developer/test_harness/runtests.htmlhttp://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 Custom Test Harness RunsRuns

- Just send an invoke-configure script to Jim or Mike P.

- Currently targeted for Linux

- Could expand to other platforms

Package Test Package Test "Definition" Files"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 Package Test "Definition" Files"Definition" FilesTESTS names of individual tests

DIRS directories containing testsDESCEND_DIRS PACKAGE/test/ vs. PACKAGE/test/myTest/ARGS arguments to testsCOMM 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 fileMASTER-FILE compareTestOutput master fileARG-MASTER-PAIRS argument / master file pairs

New Release New Release Versioning SystemVersioning 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 Test Harness Results PagesPages

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

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

DiscussionDiscussion

Future Framework Future Framework DevelopmentDevelopment