Ubuntu Deb Pack Installation
Version 2.0.1, released 04/08/11
Ubuntu Versions
OpenFOAM and Paraview are currently available for the following versions of
Ubuntu:
- 10.04 LTS, codename lucid
- 10.10, codename maverick
- 11.04, codename natty
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://www.openfoam.com/download/ubuntu $VERS main > /etc/apt/sources.list.d/openfoam.list"
- Note 1: Line 1 stores the version name of your Ubuntu
distribution (e.g. maverick) 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
- Install OpenFOAM (201 in the name refers to version 2.0.1):
sudo apt-get install openfoam201
- Install Paraview (3101 in the name refers to version 3.10.1):
sudo apt-get install paraviewopenfoam3101
OpenFOAM-2.0.1 and Paraview-3.10.1 are now installed in the /opt
directory.
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)
- At the bottom of that file, add the following line (see Note 1) and save the
file
source /opt/openfoam201/etc/bashrc
- Open a new terminal window (see Note 2) and test that the icoFoam
application, from the OpenFOAM package, is working by typing
- 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 icoFoam 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.0.1 (e.g. chris-2.0.1 for user chris and OpenFOAM version 2.0.1)
and create a directory named run within it, e.g. by typing:
Copy the tutorial examples directory in the OpenFOAM distribution to the run
directory. If the OpenFOAM environment variables are set correctly, then the
following command will be correct:
cp -r $FOAM_TUTORIALS $FOAM_RUN
Run the first example case of incompressible laminar flow in a cavity:
cd $FOAM_RUN/tutorials/incompressible/icoFoam/cavity
blockMesh
icoFoam
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.