Ubuntu Deb Pack Installation

Ubuntu Deb Pack Installation

Version 3.0.1, released 15/12/15

Ubuntu Versions

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

  • 14.04 LTS, codename trusty
  • 15.10, codename wily

Note: foamyHexMesh is not available in the pack for Ubuntu 14.04 LTS, since that version of Ubuntu provides a packaged version of CGAL (v4.2) which is no longer supported. However, foamyHexMesh is available in the pack for Ubuntu 15.10 which provides CGAL v4.6.1.

Upgrade from OpenFOAM 3.0.0

OpenFOAM 3.0.1 is a patch release of OpenFOAM 3.0.0, which can be upgraded for the Ubuntu pack openfoam30. Users with an existing installation of OpenFOAM 3.0.0 on their Ubuntu system can upgrade OpenFOAM only by typing in a terminal window:

sudo apt-get update
sudo apt-get install --only-upgrade openfoam30

OpenFOAM will be upgraded from 3.0.0 to 3.0.1 also if the user does a complete upgrade of all software packages:

sudo apt-get update
sudo apt-get install upgrade

New 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

  1. 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).

    sudo add-apt-repository http://www.openfoam.org/download/ubuntu
    • Note: This only needs to be done once for a given system
  2. Update the apt package list to account for the new download repository location

    sudo apt-get update
  3. Install OpenFOAM (30 in the name refers to version 3.0.1):

    sudo apt-get install openfoam30
  4. Install Paraview (44 in the name refers to version 4.4.0)
    **Note, Ubuntu 14.04.2 users: see first note in Installation Problems below**

    sudo apt-get install paraviewopenfoam44

OpenFOAM-3.0.1 is now installed in the /opt directory (along with and Paraview-4.4.0)

Installation Problems

  • Users running Ubuntu 14.04.2 (released 20/02/2015) have reported a problem installing Paraview. During installation, they see a message:

    Some packages could not be installed. This may mean that you have requested an
    impossible situation or if you are using the unstable distribution that some
    required packages have not yet been created or been moved out of Incoming.
    If this occurs, replace step 4, Install Paraview, above with:

    sudo apt-get download  paraviewopenfoam44  --allow-unauthenticated
    sudo dpkg -i paraviewopenfoam44_0-1_amd64.deb
    sudo apt-get install qt4-dev-tools
    sudo dpkg -i paraviewopenfoam44_0-1_amd64.deb
  • 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...
  • A few users have encountered an error message similar to the following during installation (step 3)

    Some packages could not be installed. This may mean that you
    have requested an impossible situation...
    The following information may help to resolve the situation:

    The following packages have unmet dependencies: openfoam231 :
    Depends: csh but it is not installable
    Depends: libopenmpi1.3 but it is not installable...

    The most likely cause of this error message is that the universe repositories are not enabled. To enable them, type the following in a terminal window:

    sudo apt-add-repository universe
    sudo apt-get update
  • If MPICH is installed on the system, then during user configuration (below), the following error message might occur when sourcing the etc/bashrc file in the OpenFOAM installation:

    gcc: error: unrecognized command line option '--showme:link'
    The user can check whether MPICH is installed by typing the following:

    sudo update-alternatives --list mpi
    which returns /usr/mpich/include if MPICH is installed. This error is caused when the default mpicc is MPICH, rather than OpenMPI. The simplest way to fix the problem is to set mpicc to OpenMPI is by running the following command in a terminal prompt:

    sudo update-alternatives --set mpi /usr/lib/openmpi/include
  • The .deb files for different versions of Ubuntu supplied can be downloaded directly from the following locations:

User Configuration

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

  1. 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
  2. At the bottom of that file, add the following line (see Note 1) and save the file

    source /opt/openfoam30/etc/bashrc
  3. Open a new terminal window (see Note 2) and test that the icoFoam application, from the OpenFOAM package, is working by typing

    icoFoam -help
  4. 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>-3.0.1 (e.g. chris-3.0.1 for user chris and OpenFOAM version 3.0.1) and create a directory named run within it, e.g. by typing:

mkdir -p $FOAM_RUN
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:

Run the first example case of incompressible laminar flow in a cavity:

cd $FOAM_RUN/tutorials/incompressible/icoFoam/cavity
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.