Close

11th July 2013

Download v2.2.1 | Source Pack

The following tar-zipped tgz source packs are available for download.

PackFilemd5sum
OpenFOAM OpenFOAM-2.2.1.tgz618db969546847d9c0a27340f8f90f7a
Third-Party ThirdParty-2.2.1.tgzb6f1aa1afe39769007a5dbd0b0eb3244

Unpacking the Sources

The user should choose a directory location to unpack these files, which will become the installation directory of OpenFOAM. If the installation is for a single user only, or if the user does not have root access to the machine, we would recommend the installation directory is $HOME/OpenFOAM (i.e. a directory OpenFOAM in the user’s home directory). If the installer has root permissions and the installation is for more than one user, one of the ‘standard’ locations can be used, e.g. /usr/local/OpenFOAM, /opt/OpenFOAM, or just /opt.

After the installation directory is chosen (and, if necessary, created), simply copy the 2 source pack files into the directory and unpack using tar xzf <filename>, e.g. from the installation directory:

tar xzf OpenFOAM-2.2.1.tgz
tar xzf ThirdParty-2.2.1.tgz

The files unpack to produce directories OpenFOAM-2.2.1 and ThirdParty-2.2.1.

System Requirements

OpenFOAM is developed and tested on Linux, but should work with other POSIX systems. OpenFOAM-2.2.1 and ThirdParty-2.2.1 have been tested on the following Linux distributions:

  • Ubuntu 12.04 (precise), 12.10 (quantal), 13.04 (raring)
  • OpenSuSE 12.1, 12.2 and 12.3
  • Fedora 17, 18 and 19

In the following instructions, log in as the root user or switch to root user with sudo by typing in a terminal

sudo su -

Dependent packages for Ubuntu

Dependent packages required for Ubuntu can be installed by executing the following command in a terminal:

apt-get install build-essential flex bison cmake zlib1g-dev libopenmpi-dev openmpi-bin qt4-dev-tools libqt4-dev libqt4-opengl-dev freeglut3-dev libqtwebkit-dev gnuplot libreadline-dev libncurses-dev libxt-dev

System versions of the OpenMPI and Scotch libraries can also be installed for Ubuntu, rather than having to compile them from sources:

apt-get install libscotch-dev

Dependent packages for OpenSuSE

Dependent packages required for OpenSuSE can be installed by executing the following commands in a terminal:

zypper install -t pattern devel_C_C++
zypper install cmake libqt4-devel gnuplot

Dependent packages for Fedora

Dependent packages required for Fedora can be installed by executing the following commands in a terminal:

yum groupinstall 'Development Tools'
yum install openmpi-devel qt-devel qtwebkit-devel zlib-devel cmake

Dependent packages for Other Linux Distributions

OpenFOAM-2.2.1 also builds on many other and older Linux distributions but the ParaView-3.12.0 version supplied in ThirdParty requires cmake-2.8.2 or higher and Qt-4.6.2 or higher which can be obtained from various repositories for many Linux distributions. To check your system setup, you can execute the foamSystemCheck script, described in “Checking the System” (below).

Setting Environment Variables

The environment variable settings are contained in files in an OpenFOAM-2.2.1/etc directory in the OpenFOAM release. e.g. for the case where the installation is in $HOME/OpenFOAM, in:

  • $HOME/OpenFOAM/OpenFOAM-2.2.1/etc
EITHER

if running bash or ksh (if in doubt type echo $SHELL), source the etc/bashrc file by adding the following line to the end of your $HOME/.bashrc file:

source $HOME/OpenFOAM/OpenFOAM-2.2.1/etc/bashrc

then type “source $HOME/.bashrc” in the current terminal window

OR

if running tcsh or csh, source the etc/cshrc file by adding the following line to the end of your $HOME/.cshrc file:

source $HOME/OpenFOAM/OpenFOAM-2.2.1/etc/cshrc

then type “source $HOME/.cshrc” in the current terminal window

Setting environment variables for alternative locations

OpenFOAM may also be installed in alternative locations. However, the installation directory should be network available (e.g. NFS) if parallel calculations are planned.

The environment variable FOAM_INST_DIR can be used to find and source the appropriate resource file. Here is a bash/ksh/sh example:

export FOAM_INST_DIR=/data/app/OpenFOAM
foamDotFile=$FOAM_INST_DIR/OpenFOAM-2.2.1/etc/bashrc
[ -f $foamDotFile ] && . $foamDotFile

and a csh/tcsh example:

setenv FOAM_INST_DIR /data/app/OpenFOAM
foamDotFile=$FOAM_INST_DIR/OpenFOAM-2.2.1/etc/cshrc
if ( -f $foamDotFile ) source $foamDotFile

The value set in $FOAM_INST_DIR will be used to locate the remaining parts of the OpenFOAM installation.

Checking the System

To check your system is ready to build the sources, execute the foamSystemCheck script (in the OpenFOAM-2.2.1/bin directory). If any critical software is missing, or needs updating to a newer version, please contact the system administrator to install the required software before proceeding to the build.

In particular your system will need to include a recent version of a C++ compiler. Compilation has been tested with the following compilers and versions:

  • GCC: 4.5.0 and above
  • LLVM Clang: 3.1
  • Intel ICC: 12.0.1 and 13.0.1

The default compiler for OpenFOAM is GCC. Since v2.2, OpenFOAM will only compile with versions of GCC above 4.5.0. Administrators and users can check the version of GCC running on their system by typing

gcc --version

If the installed version is not recent, the source pack for newer versions are available from http://gcc.gnu.org/.

Building the Sources

Go to the top-level source directory $WM_PROJECT_DIR and execute the top-level build script ./Allwmake. In principle this will build everything, but if problems occur with the build order it may be necessary to update the environment variables and re-execute ./Allwmake.

wmake

OpenFOAM uses wmake to perform compilation (building, linking) of its C++ source code into executable code. wmake is called from the Allwmake scripts during the initial build of the complete OpenFOAM project but can be executed directly to update the compilation of any of the OpenFOAM components:

  • all invocations can have an optional directory:
    wmake $FOAM_UTILITIES/mesh/manipulation/checkMesh
    wmake libso $FOAM_SRC/finiteVolume
  • recursively build all applications in current or specified directory:
    wmake all
    wmake all <dir>
  • build any single object or executable:
    wmake Make/linux64Gcc4DPOpt/<object>.o
    wmake <executable>
  • build any single shared library:
    wmake libso
    wmake libso <lib dir>

wmakeScheduler for faster compilation

wmake comes with a parallel compilation scheduler, wmakeScheduler, which spawns compilation jobs on free machines. These machines need password-less network access, e.g. using SSH, and a network mounted installation, e.g. using NFS.wmakeScheduler is set up with environment variables:

  • WM_SCHEDULER : the name of the scheduler to use
  • WM_HOSTS : the list of cores to use
  • WM_NCOMPPROCS : the number of parallel builds (usually the size of WM_HOSTS)
  • WM_COLOURS : Optional list of colours for the compilation output from the cores.

For example to build on 1 processor of machine aaa and 4 processors of bbb:

export WM_SCHEDULER=wmakeScheduler
export WM_HOSTS="aaa:1 bbb:4"
export WM_NCOMPPROCS=$($WM_SCHEDULER -count)
export WM_COLOURS="black blue green cyan red magenta yellow"

wmakeScheduler uses ssh to spawn jobs on the listed machines so needs passwordless access and a network mounted installation.

Compiling Paraview 3.12.0 and the PV3FoamReader Module

Paraview is the third-party software that we provide for graphical post-processing in OpenFOAM. Its compilation is automated using a script called makeParaView in the ThirdParty-2.2.1 directory.

To install Paraview, execute the following (except for Fedora)

cd $WM_THIRD_PARTY_DIR
./makeParaView

Compiling on Fedora

For Fedora, execute the following:

cd $WM_THIRD_PARTY_DIR 
./makeParaView -qmake $(which qmake-qt4)

Compiling the reader modules

For all systems, the PV3blockMeshReader and the PV3FoamReader ParaView plugins are compiled as usual for OpenFOAM utilities.

cd $FOAM_UTILITIES/postProcessing/graphics/PV3Readers
wmSET
./Allwclean
./Allwmake

Testing the Installation

To check your installation setup, execute the foamInstallationTest script (in the OpenFOAM-2.2.1/bin directory). If no problems are reported, proceed to getting started with OpenFOAM; otherwise, go back and check you have installed the software correctly and/or contact your system administrator.

Getting Started

Create a project directory within the $HOME/OpenFOAM directory named <USER>-2.2.1 (e.g. chris-2.2.1 for user chris and OpenFOAM version 2.2.1) and create a directory named run within it, e.g. by typing:

mkdir -p $FOAM_RUN

Copy across the backward facing step example, generate the mesh with blockMesh and run the steady flow, incompressible solver simpleFoam

cd $FOAM_RUN
cp -r $FOAM_TUTORIALS/incompressible/simpleFoam/pitzDaily .
cd pitzDaily
blockMesh
simpleFoam
paraFoam

Refer to the OpenFOAM User Guide to get started.

Reporting Bugs in OpenFOAM

We appreciate that bugs in OpenFOAM are reported so we can fix them. Please refer to the OpenFOAM bugs pages to report bugs.