View source for Installation/Linux/OpenFOAM-dev

; 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}} {{versionOpenFOAMFoundationDev}} on any Linux Distribution.

In the following chapters and sections is explained how to ''generally'' install [https://github.com/OpenFOAM/OpenFOAM-dev OpenFOAM-dev] (the development version released by the OpenFOAM Foundation) and related dependencies, such as ParaView:
__TOC__

For dedicated instructions (complete and/or partial) for each Linux Distribution: 
{{subpages|Installation/Linux/OpenFOAM-dev/}}

'''Note''': This repository is in constant development, therefore these instructions need to be revised more often than with the stable and bug fix versions.

<br>
= About the development version =

In case you're wondering what is the difference between the repository OpenFOAM-dev that is provided by the OpenFOAM Foundation, versus all other versions:
* For example, starting with the version 2.4.0, this is considered to be a ''stable release'' that was launched for the main version 2.4. This specific version won't change over time.
* The version 2.4.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''.
* In comparison with the previous two versions, the [https://github.com/OpenFOAM/OpenFOAM-dev OpenFOAM-dev] and [https://github.com/OpenFOAM/ThirdParty-dev ThirdParty-dev] repositories provide the development for the next major version of OpenFOAM.


So in essence, the development version is the [http://openfoam.org/download/source/ ''bleeding edge'' in the development of OpenFOAM], which allows one to contribute to the next version of OpenFOAM that is in development. This enables the following capabilities:
* Earlier access to new features, before the next major version is made.
* Higher probability of having bugs fixed.
* When there is a new feature in the development repository, it's just a matter of updating the local code repository.
* When reporting a bug, this is the version that is sometimes used as a reference, although not always. 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.
* For more details on how to contribute: [http://openfoam.org/dev/ OpenFOAM Development]


Nonetheless, there are some downsides of using the bug fix version:
* Very early access to a higher probability of new bugs.
* Things can change a lot more than stable and bug fix versions.
* Advised only for those who truly need the ''bleeding edge'' and/or want to [http://openfoam.org/dev/ collaborate closer with the development version].

<br>

= Installing from source code =
Official instructions for this repository are provided here: [http://openfoam.org/download/source/ OpenFOAM Source Repository]

A few details to keep in mind:
# As already implied on the chapter [[#About the development version|About the development version]], there are probably a lot of differences in building the development versions versus the bug fix version, but the work flow should still be the same. The main difference is that the repository for the source code is usually always the same, namely: <bash>git clone https://github.com/OpenFOAM/OpenFOAM-dev.git</bash>
# You should also clone the repository for the {{tt|ThirdParty-dev}} folder from the respective repository: <bash>git clone https://github.com/OpenFOAM/ThirdParty-dev.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-dev}}.
# 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]].
# As of OpenFOAM 5.0 (in [https://github.com/OpenFOAM/ThirdParty-dev/commit/f422429533c56ce52d4040fc0f441566850165d1 OpenFOAM-dev since August 2016]), the minimum required GCC version is 4.8, but this can easily change in this repository as time passes by. This implies one of the following situations:
## You should use a recent Linux Distribution, so that it can provide a recent GCC version.
## Or you should get familiar with building GCC from source code.
## When in doubt, you can always 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>

= Steps for updating =

In the bug reports [http://bugs.openfoam.org/view.php?id=1941 #1941] and [http://bugs.openfoam.org/view.php?id=2091 #2091], a new (relatively) easy way to update your development build to the latest code can be done by following the next steps, although keep in mind that these steps try to ''catch all'' possible scenarios:
<ol>
<li>Start a new terminal and activate the respective OpenFOAM shell environment.</li>
<li>Pull the latest changes for both repositories, by running the following commands:
<bash>cd $WM_THIRD_PARTY_DIR
git pull
foam
git pull
cd $WM_THIRD_PARTY_DIR
</bash>
</li>
<li>Read the {{tt|README.org}} file in the folder {{tt|ThirdParty-dev}} and check if you need to download and install new source code packages, such a new ParaView, CGAL or Scotch source code version.</li>
<li>Start a new terminal and activate the respective OpenFOAM environment again. You may need to check if your ParaView version is still correct, for example, by running:
<bash>paraview --version</bash>
since if a new version is expected, you might need to download and build the new version, as indicated in the previous step.
</li>
<li>Finally, once the 3rd party folder is sorted out, you can update the build by running:
<bash>foam
./Allwmake -update -j > log.make 2>&1
</bash>
</li>
</ol>


[[Category:Installing OpenFOAM on Linux]]