View source for Installation/Linux/OpenFOAM-2.1.x

; Maintainer: The current maintainer of this page is [[User:Wyldckat|Wyldckat]] ([[User talk:Wyldckat|talk]]).

<br>

= Introduction =

This page aims to explain how to install {{OpenFOAM}} {{version2.1.x}} on any Linux Distribution.

In the following chapters and sections is explained how to ''generally'' install OpenFOAM 2.1.x and related dependencies, such as ParaView:
__TOC__


= Dedicated instructions =
Currently the following sub-pages exist with complete and/or partial instructions for specific Linux Distributions:
{{subpages|Installation/Linux/OpenFOAM-2.1.x/}}


= About the bug fix version =

In case you're wondering what is the difference between the versions 2.1.0, 2.1.1 and 2.1.x:
* The versions 2.1.0 and 2.1.1 are the stable releases that were launched for the main version 2.1. These releases do not change over time.
* The version 2.1.x is the bug fix version, which is regularly updated overtime, at least until the next major release of OpenFOAM is released.
** This version is also known as: the ''git version''; the ''repository version''.

So in essence, the version bug fix version 2.1.x allows one to stay the most up-to-date possible of OpenFOAM's latest source code. This enables the following capabilities:
* Earlier access to new features, before the next stable release is made.
* Higher probability of having bugs fixed.
* When a bug is fixed, it's just a matter of updating the local code repository.
* When reporting a bug, this is the version that is used as a reference. More specifically, the commit ''hash'' is used for keeping track of where in time is your code snapshot (for more, read the chapter [[#Installing from source code|Installing from source code]]).
* Makes it easier to learn how one can keep track of his/her own changes to the OpenFOAM source code.

Nonetheless, there are some downsides of using the bug fix version:
* Early access to new bugs.
** Yes, some bug fixes can introduce new bugs.
* Some features may be removed, since a bug might have been spotted that would indicate that said feature is ''incorrect''.
** For example, read: [http://www.cfd-online.com/Forums/openfoam-solving/93950-urgent-problem-dieselfoam-themophysical-properties.html ''URGENT: Problem with dieselFoam and thermophysical properties'']
* Not advised for using in a cluster or shared machine environment, since global installations of the bug fix version can get a bit ''onerous'' over time!


= Installing from source code =
The official instructions are made available here: [http://web.archive.org/web/20150419181149/http://openfoam.org/archive/2.1.0/download/git.php Repository Release - version 2.1.x]

A few details to keep in mind:
# As already implied on the chapter [[#About the bug fix version|About the bug fix version]], there are only a few differences in building 2.1.x, 2.1.0 and 2.1.1. The main difference is how the source code is downloaded and how you can keep up with updates that are made to the changes made on OpenFOAM's git repository, namely: <bash>git clone https://github.com/OpenFOAM/OpenFOAM-2.1.x.git</bash>
#* You can also choose to download the {{tt|ThirdParty-2.1.x}} folder from the respective repository: <bash>git clone https://github.com/OpenFOAM/ThirdParty-2.1.x.git</bash> In which case, you will need to also manually download the packages as listed in the {{tt|README.html}} or {{tt|README.org}} files in the downloaded folder {{tt|ThirdParty-2.1.x}}.
# When you need to update your local ''clone'', for getting the latest source code updates, you can follow the instructions provided in the page [[Installation/Working with git repositories]].
# For the minimum required GCC version, please check the [[Installation/Compatibility Matrix]] page for information on compatible compilers.
# When it comes to ParaView, it's possible to avoid the need to build it from source code. If your Linux Distribution provides ParaView 3.12.0 or newer, you don't need to build ParaView from source code. Simply run: <bash>paraFoam -builtin</bash> and it will open the case in ParaView.
#* If the previous command worked, you can add the following alias command in your {{tt|~/.bashrc}} file: <bash>alias paraFoam='paraFoam -builtin'</bash>
#* In case you have an old Linux Distribution and still don't want to build ParaView from source code, get the latest binary version for Linux from [http://paraview.org ParaView's official website]. Then add to your {{tt|~/.bashrc}} file the following line (adapt accordingly): <bash>export PATH=$HOME/Downloads/ParaView-4.2.0/bin:$PATH</bash>

[[Category:Installing OpenFOAM on Linux]]