# Presentation: 667258

## Getting Started with Trilinos

**October 14, 2003**
**9:30-10:30 a.m.**
**Jim Willenbring**

## Overview

**Obtaining Trilinos**
**Tools for Users**
**Mailman**
**Bugzilla**
**Configuring and Building Trilinos**
**General options**
**Platform and machine specific options**
**Troubleshooting**
**Where to start**
**Where to find help**

## The Trilinos Home Page

_**[http://software.sandia.](http://software.sandia.gov/trilinos/)**__**[gov](http://software.sandia.gov/trilinos/)**__**[/](http://software.sandia.gov/trilinos/)**__**[trilinos](http://software.sandia.gov/trilinos/)**__**[/](http://software.sandia.gov/trilinos/)**_
**Highlights of the web page**
**Download page**
**User documentation**
**User guide**
**FAQ**
**Individual package documentation**

## Instructions for obtaining Trilinos are available in the Trilinos User Guide.
http://software.sandia.gov/trilinos/publications.html
Two options
Download from Trilinos website.
http://software.sandia.gov/trilinos/downloads.html
Check out a copy from the Trilinos CVS repository.

Send a note to trilinos-help@software.sandia.gov if you have questions about obtaining Trilinos.

_**[http://software.sandia.gov/trilinos/publications.html](http://software.sandia.gov/trilinos/publications.html)**_
**Two options**
**Download from Trilinos website.**
_**[http://software.sandia.gov/trilinos/downloads.html](http://software.sandia.gov/trilinos/downloads.html)**_
**Check out a copy from the Trilinos CVS repository.**
**Send a note to trilinos-help@software.sandia.gov if you have questions about obtaining Trilinos.**

**Obtaining Trilinos**

## 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.**
**See http://software.sandia.gov/mailman/listinfo for the complete list of mail lists.**
**Use **_**[trilinos](mailto:trilinos-help@software.sandia.gov)**__**[-help@software.sandia.](mailto:trilinos-help@software.sandia.gov)**__**[gov](mailto:trilinos-help@software.sandia.gov)**_** for general help questions. **

## Tools for Users (cont.)

**Bugzilla**
**	****http://software.sandia.gov/bugzilla/**
**Issue tracking tool.**
**Can be used to report bugs or request new features.**
**Please provide as much detail as possible (For example: Platform, OS, compiler versions, etc.)**

## Configuring and Building Trilinos

**Find an in depth discussion in the Trilinos User Guide:**
_**[http://software.sandia.](http://software.sandia.gov/trilinos/trilinosUserGuide.pdf)**__**[gov](http://software.sandia.gov/trilinos/trilinosUserGuide.pdf)**__**[/](http://software.sandia.gov/trilinos/trilinosUserGuide.pdf)**__**[trilinos](http://software.sandia.gov/trilinos/trilinosUserGuide.pdf)**__**[/](http://software.sandia.gov/trilinos/trilinosUserGuide.pdf)**__**[trilinosUserGuide](http://software.sandia.gov/trilinos/trilinosUserGuide.pdf)**__**[.](http://software.sandia.gov/trilinos/trilinosUserGuide.pdf)**__**[pdf](http://software.sandia.gov/trilinos/trilinosUserGuide.pdf)**_
**General Configure options**
**./configure --help=recursive**
**Determine which Trilinos packages should be built.**
**Serial or MPI?**

## Configuring and Building 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/config/**** ****directory.**
**For example ****sgi64_mpi_atlantis****.**
**Users are encouraged to submit their scripts.**

## Configuring and Building Trilinos (cont.)

**Example invoke configure file for SGI64:**
**../configure --enable-mpi --with-mpi-libs=-lmpi \**
**--enable-amesos --enable-tsfcoreutils \**
**--enable-amesos-umfpack \**
**--with-trilinos3pldir=/scratch1/jmwille/Trilinos3PL \**
**CFLAGS="-O2 -64" FFLAGS="-O2 -64" \**
**CXXFLAGS="-O2 -64 -LANG:std  -LANG:ansi-for-init-scope=ON -ptused \**
**-DMPI_NO_CPPBIND" \**
**LDFLAGS=" -64 -L/usr/lib64/mips4/r10000 -L/usr/lib64/mips4 -L/usr/lib64 " **

## Configuring and Building Trilinos (cont.)

**Platform and machine specific options:**
**../configure --enable-mpi --with-mpi-libs=-lmpi \**
**--enable-amesos --enable-amesos-slud --enable-tsfcoreutils \**
**--enable-amesos-umfpack \**
**--with-trilinos3pldir=/scratch1/jmwille/Trilinos3PL \**
**CFLAGS="-O2 -64" FFLAGS="-O2 -64" \**
**CXXFLAGS="-O2 -64 -LANG:std  -LANG:ansi-for-init-scope=ON -ptused \**
**-DMPI_NO_CPPBIND" \**
**LDFLAGS=" -64 -L/usr/lib64/mips4/r10000 -L/usr/lib64/mips4 -L/usr/lib64 "**** **

## Configuring and Building Trilinos (cont.)

**Troubleshooting**
**The most common problems are the simple ones.**
**Look for errors in the invoke configure file.**
**Autoconf is not able to detect spelling errors.**
**Line continuation problems**
**--enable mpi \**_**[ ](http://software.sandia.gov/Trilinos/)**_
**Look at **_**the correct**_** config.log file.  (Created by Autoconf.)**
**The config.log at the Trilinos level is not the correct config.log file.  Go to the package level config.log file.  For example:**
- 	configure: error: /bin/sh '../../../packages/epetra/configure' failed for packages/epetra **indicates that one should look at packages/epetra/config.log.**

## Troubleshooting using config.log

**The config.log file is very long.  Follow these steps to find what you need:**
**Search for the string “Cache”.  That should bring you a point in the file that looks like this:**
**## ------------------------ ##**
**## Cache variables. ##**
**## ----------------------- ##**
**	****The error that caused the configure failure can be found above this point.**

## Working Through a config.log File

**Takes a little bit of practice.**
**Isn’t very hard.**
**Let’s try it.**
**Here is a common configure error:**
**error: Cannot find lapack library, specify a path using --with-ldflags=-I<DIR> (ex. --with-dlflags=-I/usr/path/lib) or a specific library using --with-lapack=DIR/LIB (ex. --with-lapack=/usr/path/lib/libcxml.a)**
**We will now examine two common ways that this error can occur.**

## Where to Find Help

**Help link from Trilinos home page.**
**http://software.sandia.gov/Trilinos/help.html**
**Online FAQ section.**
**	****    **_**[http://software.sandia.](http://software.sandia.gov/trilinos/faq.html)**__**[gov](http://software.sandia.gov/trilinos/faq.html)**__**[/](http://software.sandia.gov/trilinos/faq.html)**__**[trilinos](http://software.sandia.gov/trilinos/faq.html)**__**[/](http://software.sandia.gov/trilinos/faq.html)**__**[faq](http://software.sandia.gov/trilinos/faq.html)**__**[.html](http://software.sandia.gov/trilinos/faq.html)**_
**Trilinos User Guide.**
**	**_**[http://software.sandia.](http://software.sandia.gov/trilinos/publications.html)**__**[gov](http://software.sandia.gov/trilinos/publications.html)**__**[/](http://software.sandia.gov/trilinos/publications.html)**__**[trilinos](http://software.sandia.gov/trilinos/publications.html)**__**[/publications.html](http://software.sandia.gov/trilinos/publications.html)**_
**Submitting a bug report.**
**Please provide as much detail as possible.**
**Attach the appropriate config.log.**
**	**_**[http://software.sandia.](http://software.sandia.gov/trilinos/bug_reports.html)**__**[gov](http://software.sandia.gov/trilinos/bug_reports.html)**__**[/](http://software.sandia.gov/trilinos/bug_reports.html)**__**[trilinos](http://software.sandia.gov/trilinos/bug_reports.html)**__**[/bug_reports.html](http://software.sandia.gov/trilinos/bug_reports.html)**_
**Send an email.**
_**[trilinos](http://software.sandia.gov/Trilinos/TrilinosUserGuide.pdf)**__**[-help@software.sandia.](http://software.sandia.gov/Trilinos/TrilinosUserGuide.pdf)**__**[gov](http://software.sandia.gov/Trilinos/TrilinosUserGuide.pdf)**_** for general questions.**
_**[trilinos-bugs@software.sandia.gov](http://software.sandia.gov/trilinos/configuration_manual.html)**_** alternative to Bugzilla.**

## Where to Find Help (cont.)

**Trilinos Home Page:**
_**[http://software.sandia.](http://software.sandia.gov/trilinos)**__**[gov](http://software.sandia.gov/trilinos)**__**[/](http://software.sandia.gov/trilinos)**__**[trilinos](http://software.sandia.gov/trilinos)**_

## Discussion

**Questions, comments?**