120 likes | 249 Views
What’s new with: How to configure, build and install Trilinos. November 2, 2004 2:15-2:35 p.m. Jim Willenbring Mike Phenow. Overview. Trilinos Web Page Tools for Users Configuring Trilinos Installing Trilinos Testing Improving Efficiency Linking to Trilinos Libraries.
E N D
What’s new with: How to configure, build and install Trilinos November 2, 2004 2:15-2:35 p.m. Jim Willenbring Mike Phenow
Overview • Trilinos Web Page • Tools for Users • Configuring Trilinos • Installing Trilinos • Testing • Improving Efficiency • Linking to Trilinos Libraries
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
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@software.sandia.gov for general help questions.
Configuring Trilinos • Find an in depth discussion in the Trilinos User Guide: http://software.sandia.gov/trilinos/trilinosUserGuide.pdf • Trilinos Installation manual: http://software.sandia.gov/trilinos/installation_manual.html
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.
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.
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.
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.)
Linking to Trilinos Libraries # Include Trilinos header that defines pertinent compilation information #include /path_to_trilinos_install1/include/trilinos_make_macros.mak include /path_to_trilinos_install2/include/trilinos_make_macros.mak OLIBS = $(LAPACK_LIBS) $(BLAS_LIBS) # # Compilation rules … .cpp.o: $(CXX) $(CPPFLAGS) -c $(DEFS) -I$(prefix)/include $< all : RBGen.x RBGen.x : RBGen.o RBGenParams.o BurkardtFileIOHandler.o netCDFFileIOHandler.o $(CXX)$(CXXFLAGS) -o $@ $^ -L$(prefix)/lib -lnetcdf -lepetra -lteuchos$(OLIBS)$(FLIBS) …
Where to Find Help • Trilinos Home Page: http://software.sandia.gov/trilinos
Discussion • Questions, comments?