Whats new with: How to configure, build and install Trilinos

1
Whats new with How to configure, build and
install Trilinos

• November 2, 2004
• 215-235 p.m.
• Jim Willenbring
• Mike Phenow

2
Overview

• Trilinos Web Page
• Tools for Users
• Configuring Trilinos
• Installing Trilinos
• Testing
• Improving Efficiency
• Linking to Trilinos Libraries

3
The Trilinos Home Page

• http//software.sandia.gov/trilinos/
• Highlights of the web page
• Download page
• User documentation
• Installation guide
• User guide
• FAQ
• Individual package documentation

4
Tools for Users

• Mailman
• Users are encouraged to sign up for
• Users lists for Trilinos and individual packages
  of interest.
• Announce lists for Trilinos and individual
  packages of interest.
• Many new package lists have been established in
  the last year.
• See http//software.sandia.gov/mailman/listinfo
  for the complete list of mail lists.
• Use trilinos-help_at_software.sandia.gov for general
  help questions.

5
Configuring Trilinos

• Find an in depth discussion in the Trilinos User
  Guide
• http//software.sandia.gov/trilinos/trilinosUserG
  uide.pdf
• Trilinos Installation manual
• http//software.sandia.gov/trilinos/installation_
  manual.html

6
Configuring Trilinos (cont.)

• Platform and machine specific options
• Common options online at
• http//software.sandia.gov/trilinos/configuration_
  manual.html
• Example configure invocation scripts.
• Are meant to be examples only customizations
  will almost always be necessary.
• Can be found in the Trilinos directory structure
  in the
• Trilinos/sampleScripts/ directory.
• For example sgi64_mpi_atlantis.
• Users are encouraged to submit their scripts.

7
Installing Trilinos

• At configure time, use the prefix option,
• --prefix/where/I/want/to/install/Trilinos,
• if you want to install Trilinos libraries and
  headers.
• The install directory structure has been
  flattened.

8
Testing

• We are in the process of improving the tests that
  are available to users. For the time being,
  testing can be carried out in two different ways
• Run the tests manually
• cd Trilinos/SERIAL/packages/epetra/test/CrsMatrix
• ./CrsMatrix_test.exe v
• echo status
• Run the tests through the Trilinos Test Harness.
• http//software.sandia.gov/trilinos/developer/test
  _harness.html
• Note that there is a test only option.
• For the next release, we are looking at
  supporting a make check make target.

9
Improving Efficiency

• There are a number of ways to speed up the
  configure and build process (all of which are
  discussed in the Trilinos User Guide).
• Build only the packages that are needed -
• try the new --disable-default-packages option.
• After Trilinos has been ported to a machine
• try disabling tests and/or examples. (You can
  always build them later.)
• If tests and examples are disabled use
  --disable-libcheck.
• On multiprocessor machines, use make j n where
  n is the number of jobs to create. (This option
  is not universally supported.)

10
Linking to Trilinos Libraries

• Include Trilinos header that defines pertinent
  compilation information
• include /path_to_trilinos_install1/include/trilin
  os_make_macros.mak
• include /path_to_trilinos_install2/include/trilino
  s_make_macros.mak
• OLIBS (LAPACK_LIBS) (BLAS_LIBS)
• Compilation rules
• .cpp.o
• (CXX) (CPPFLAGS) -c (DEFS) -I(prefix)/include
  lt
• all RBGen.x
• RBGen.x RBGen.o RBGenParams.o
  BurkardtFileIOHandler.o netCDFFileIOHandler.o
• (CXX) (CXXFLAGS) -o _at_ -L(prefix)/lib
  -lnetcdf -lepetra -lteuchos (OLIBS) (FLIBS)

11
Where to Find Help

• Trilinos Home Page
• http//software.sandia.gov/trilinos

12
Discussion

• Questions, comments?