Install on Ubuntu

This installation process has been tested in a clean install of Ubuntu 9.10.

To install on other versions of Ubuntu adaptations might be necessary.

In case of problems, ask for help in the mailing list.

Follow the following steps to install the main dependencies. Note that a lot of software that will be installed is not a direct COOLFluiD dependency, but is pulled in by Ubuntu anyway.

---

Fast way

1. Install the required software from Ubuntu

   sudo apt-get --yes install subversion gcc g++ gfortran libboost1.40-all-dev \
                              openmpi-common openmpi-bin mpi-default-dev \
                              cmake doxygen \
                              libparmetis-dev \
                              libcurl4-openssl-dev libcgns-dev \
                              zlib1g-dev liblapack-dev libpetsc3.0.0-dev \
                              valgrind
   

2. To get the COOLFluiD kernel sources

   cd $HOME
   svn co https://coolfluidsrv.vki.ac.be/svn/coolfluid/Sources/Kernel/trunk coolfluid
   cd coolfluid
   

3. To get a plug-in (substitute NAME witht the plugin name)

   cd $HOME/coolfluid/plugins
   svn co https://coolfluidsrv.vki.ac.be/svn/coolfluid/Sources/Plugins/NAME/trunk NAME
   

4. Build COOLFluiD

   cd $HOME/coolfluid
   mkdir build
   cd build
   cmake ..
   make
   

---

Detailed way

Install all the necessary software

Subversion

Used to access the version control server.

sudo apt-get --yes install subversion

Compilers

To compile the sources.

sudo apt-get --yes install gcc g++ gfortran

Boost C++ Libraries

To provide platform independent tools.

sudo apt-get --yes install libboost1.40-all-dev

MPI (OpenMPI)

For parallel simulations.

sudo apt-get --yes install openmpi-common openmpi-bin mpi-default-dev

CMake

To manage the build of the sources.

sudo apt-get --yes install cmake

Doxygen (OPTIONAL)

To generate the documentation from the sources.

sudo apt-get --yes install doxygen

Parmetis (OPTIONAL)

To partition the domain in parallel simulations.

sudo apt-get --yes install libparmetis-dev

Curl (OPTIONAL)

To automatically download files from the internet when not found in the local filesystem.

sudo apt-get --yes install libcurl4-openssl-dev

Zlib (OPTIONAL)

To automatically compress and decompress files on the fly, when reading them from and to disk.

sudo apt-get --yes install zlib1g-dev

LAPACK and BLAS (OPTIONAL)

Support for lapack and blas linear algebra functions.

sudo apt-get --yes install liblapack-dev

PETSc (OPTIONAL)

Support for solution of linear systems using the PETSc library.

sudo apt-get --yes install libpetsc3.0.0-dev

CGNS (OPTIONAL)

Support for meshes in CGNS format.

sudo apt-get --yes install libcgns-dev

Valgrind (OPTIONAL)

For checking COOLFluiD for memory leaks and profiling.

sudo apt-get install valgrind

Checkout the Sources

Checkout COOLFluiD from the version control server using subversion.

svn co https://coolfluidsrv.vki.ac.be/svn/coolfluid/Sources/Kernel/trunk coolfluid
cd coolfluid

Make a directory to host the build files...

mkdir build

Configure the build

Configure it ...

cd build
cmake ..

Compile COOLFluiD

Go inside the build directory and start building COOLFluiD using make.

cd build
make