6th March 2013

Download v2.2.0 | Ubuntu

Ubuntu Versions

OpenFOAM and Paraview are currently available for the following versions of Ubuntu.

Note: only version 12.04LTS is still current (see Ubuntu Releases) and supports installation of the OpenFOAM package with apt using the instructions below.

11.10, codename oneiric
12.04 LTS, codename precise
12.10, codename quantal

Installation

OpenFOAM and Paraview can be simply installed using the apt package management tool. The user will need to provide superuser password authentication when executing the following commands with sudo

In a terminal window, add OpenFOAM to the list of repository locations for apt to search, by copying and pasting the following in a terminal prompt (Applications → Accessories → Terminal).
```
VERS=$(lsb_release -cs)
sudo sh -c "echo deb http://dl.openfoam.org/ubuntu $VERS main > /etc/apt/sources.list.d/openfoam.list"
```
Note 1: Line 1 stores the version name of your Ubuntu distribution (e.g. precise) under $VERS, which is used in line 2
Note 2: This only needs to be done once for a given system
Update the apt package list to account for the new download repository location
```
sudo apt-get update
```
Install OpenFOAM (220 in the name refers to version 2.2.0)
```
sudo apt-get install openfoam220
```
For Ubuntu versions 11.10 and 12.04 only, install Paraview (3120 in the name refers to version 3.12.0)
```
sudo apt-get install paraviewopenfoam3120
```
For Ubuntu versions 12.10, install the system version of Paraview
```
sudo apt-get install paraview
```

OpenFOAM-2.2.0 is now installed in the /opt directory (along with and Paraview-3.12.0 in the Ubuntu versions 11.10 and 12.04)

Installation Problems

Networking must be enabled in order to be able to install software packages in Ubuntu. Installation failure due to networking problems usually results in an error message that reports failures in fetching archives and ends with a line like the following:

E: Unable to fetch some archives...

The .deb files for different versions of Ubuntu supplied can be downloaded directly from the OpenFOAM Download Repository.

User Configuration

In order to use the installed OpenFOAM package, complete the following

Open the .bashrc file in the user’s home directory in an editor, e.g. by typing in a terminal window (note the dot)
```
gedit ~/.bashrc
```
At the bottom of that file, add the following line (see Note 1) and save the file
```
source /opt/openfoam220/etc/bashrc
```
Open a new terminal window (see Note 2) and test that the simpleFoam application, from the OpenFOAM package, is working by typing
```
simpleFoam -help
```
A “Usage” message should appear. Your installation and user configuration is complete.

Note 1: If a similar line has already been added to the user’s .bashrc file, e.g. for a previous version of OpenFOAM, then the line should be deleted or, alternatively, commented out by inserting a # at the beginning of the line.
Note 2: If a user wishes to execute simpleFoam in the same terminal window, they must first register the change to the .bashrc file by typing at the terminal prompt (note the dots): source $HOME/.bashrc

Getting Started

Create a project directory within the $HOME/OpenFOAM directory named <USER>-2.2.0 (e.g. chris-2.2.0 for user chris and OpenFOAM version 2.2.0) 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.