View source for Installation/Linux/OpenFOAM-2.4.0/Fedora

= Introduction =
This page is dedicated to explaining how to install {{OpenFOAM}} {{version2.4.0}} in [http://fedoraproject.org Fedora].

If you do not yet feel comfortable using Linux, then perhaps you better first read the page [[Installation/Working with the Shell|Working with the Shell]] and train a bit with the shell/terminal environments, so you can have a better perception of the steps shown below.

__FORCETOC__
__TOC__

= ''Copy-Paste'' steps =

A few notes before you start copy-pasting:

# Lines that start with <tt>#</tt> don't have to be ''copy-pasted''. They are just comments to let you know what's going on.
# One wrong character is enough for breaking this guide, so make sure you can read the characters properly or that the installed language system does not break the copied characters!

== Fedora 22 ==
Here you have the following choices:
* You can install from source, by either:
** Following the official instructions from here: [http://openfoam.org/download/2-4-0-source/ Download v2.4.0 | Source Pack]
** Or by following the detailed step-by-step instructions below...


'''Discussion thread where you can ask questions about these steps''':  [http://www.cfd-online.com/Forums/openfoam-installation/160725-openfoam-2-4-0-fedora-22-error-building-cgal.html OpenFOAM 2.4.0 and Fedora 22: error building CGAL]

Steps:
<ol>
{{Installation/Linux/SwitchToRoot}}

<li>Install the necessary packages:
<bash>dnf groupinstall 'Development Tools' 
dnf groupinstall 'C Development Tools and Libraries'
dnf install openmpi openmpi-devel qt-devel qtwebkit-devel zlib-devel wget \
boost-devel gmp-devel mpfr-devel patch readline-devel ncurses-devel python python-devel
</bash>
</li>

{{Installation/Linux/ExitRoot}}

<li>Start a new terminal. This is because you'll need a fully refreshed shell.</li>
<li>Download and unpack (here you can copy-paste all in single go):
<bash>#OpenFOAM downloading and installation
cd ~
mkdir OpenFOAM
cd OpenFOAM
wget "http://downloads.sourceforge.net/foam/OpenFOAM-2.4.0.tgz?use_mirror=mesh" -O OpenFOAM-2.4.0.tgz
wget "http://downloads.sourceforge.net/foam/ThirdParty-2.4.0.tgz?use_mirror=mesh" -O ThirdParty-2.4.0.tgz

tar -xzf OpenFOAM-2.4.0.tgz 
tar -xzf ThirdParty-2.4.0.tgz 
</bash></li>
<li>For building OpenFOAM itself, it depends on whether you have installed the i386 or x86_64 architecture of Fedora. To check this, run:
<bash>uname -m
</bash>
Now, accordingly:
<ul {{NoIndentStyle}}>
<li>For i386:
<bash>#forcefully load Open-MPI into the environment
module load mpi/openmpi-i386 || export PATH=$PATH:/usr/lib/openmpi/bin

#here you can change 4 to the number of cores you've got
source $HOME/OpenFOAM/OpenFOAM-2.4.0/etc/bashrc WM_NCOMPPROCS=4 WM_MPLIB=SYSTEMOPENMPI WM_ARCH_OPTION=32
</bash>
Also, save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following command:
<bash>echo "alias of240='module load mpi/openmpi-i386; source \$HOME/OpenFOAM/OpenFOAM-2.4.0/etc/bashrc $FOAM_SETTINGS'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM 2.4.0|of240}}
</li>

<li>For x86_64:
<bash>#forcefully load Open-MPI into the environment
module load mpi/openmpi-x86_64 || export PATH=$PATH:/usr/lib64/openmpi/bin

#here you can change 4 to the number of cores you've got
source $HOME/OpenFOAM/OpenFOAM-2.4.0/etc/bashrc WM_NCOMPPROCS=4 WM_MPLIB=SYSTEMOPENMPI
</bash>
Also, save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following command:
<bash>echo "alias of240='module load mpi/openmpi-x86_64; source \$HOME/OpenFOAM/OpenFOAM-2.4.0/etc/bashrc $FOAM_SETTINGS'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM 2.4.0|of240}}
</li>
</ul>
</li>

<li>Fedora 22 comes with CMake 3.x, but both ParaView 4.1.0 and CGAL 4.6 need one of the latest of versions from the CMake 2.8.x series. Therefore, we'll need to build the CMake version that is packaged with {{tt|ThirdParty-2.4.0}}:
<bash>cd $WM_THIRD_PARTY_DIR
./makeCmake > log.mkcmake 2>&1
wmSET $FOAM_SETTINGS
</bash>
</li>

<li>Now let's build the {{tt|ThirdParty}} folder, because we need the shell environment to be updated afterwards, for CGAL to be properly picked up for building OpenFOAM:
<bash>cd $WM_THIRD_PARTY_DIR

# This next command will take a while... somewhere between 5 minutes to 30 minutes.
./Allwmake > log.make 2>&1

#update the shell environment
wmSET $FOAM_SETTINGS
</bash>
</li>

<li>Now let's build OpenFOAM:<br>
('''Warning''': this may take somewhere from 30 minutes to 6 hours, depending on your machine.)<br>
<bash>#Go into OpenFOAM's main source folder
cd $WM_PROJECT_DIR

# This next command will take a while... somewhere between 30 minutes to 3-6 hours.
./Allwmake > log.make 2>&1

#Run it a second time for getting a summary of the installation
./Allwmake > log.make 2>&1
</bash></li>

<li>{{Installation/Linux/CheckIfAllWentWell}}</li>

<li>Now, in order to build ParaView 4.1.0 that comes with OpenFOAM, including with the ability to use Python and MPI, several steps are needed:
<ol>
<li>Need to do several fixes:
<bash>cd $WM_THIRD_PARTY_DIR

sed -i -e 's=//#define GLX_GLXEXT_LEGACY=#define GLX_GLXEXT_LEGACY=' \
  ParaView-4.1.0/VTK/Rendering/OpenGL/vtkXOpenGLRenderWindow.cxx

cd $WM_THIRD_PARTY_DIR/ParaView-4.1.0

wget http://www.paraview.org/pipermail/paraview/attachments/20140210/464496cc/attachment.bin -O Fix.patch
patch -p1 < Fix.patch

cd VTK
wget https://github.com/gladk/VTK/commit/ef22d3d69421581b33bc0cd94b647da73b61ba96.patch -O Fix2.patch
patch -p1 < Fix2.patch

cd ../..
 </bash>
</li>
<li>For building ParaView with Python and MPI, run:
<bash>cd $WM_THIRD_PARTY_DIR
./makeParaView4 -qmake $(which qmake-qt4) -mpi -python  > log.makePV 2>&1
</bash>
</li>

<li>Once the {{tt|makeParaView4}} script is finished running, make sure to check the contents of the file {{tt|log.makePV}} and check if there are any errors.
</li>

<li>Finally, update the shell environment and build the official reader plug-in:
<bash>cd $FOAM_UTILITIES/postProcessing/graphics/PV4Readers 
wmSET $FOAM_SETTINGS
./Allwclean 
./Allwmake
</bash>
</li>
</ol>
</li>

<li>{{Installation/ReadUserGuideEtAl_OpenFOAMFoundation}}</li>
</ol>


{{Installation/Linux/AliasReminder|OpenFOAM 2.4.0|of240}}


'''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-installation/160725-openfoam-2-4-0-fedora-22-error-building-cgal.html OpenFOAM 2.4.0 and Fedora 22: error building CGAL]


== Fedora 23 ==
Here you have the following choices:
* You can install from source, by either:
** Following the official instructions from here: [http://openfoam.org/download/2-4-0-source/ Download v2.4.0 | Source Pack]
** Or by following the detailed step-by-step instructions below...


'''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-installation/171381-problems-installing-openfoam-2-4-0-fedora-23-a.html Problems installing OpenFOAM 2.4.0 on Fedora 23]

Steps:
<ol>
{{Installation/Linux/SwitchToRoot}}

<li>Install the necessary packages:
<bash>dnf groupinstall 'Development Tools' 
dnf groupinstall 'C Development Tools and Libraries'
dnf install openmpi openmpi-devel qt-devel qtwebkit-devel zlib-devel wget \
boost-devel gmp-devel mpfr-devel patch readline-devel ncurses-devel python python-devel
</bash>
</li>

{{Installation/Linux/ExitRoot}}

<li>Start a new terminal. This is because you'll need a fully refreshed shell.</li>
<li>Download and unpack (here you can copy-paste all in single go):
<bash>#OpenFOAM downloading and installation
cd ~
mkdir OpenFOAM
cd OpenFOAM
wget "http://downloads.sourceforge.net/foam/OpenFOAM-2.4.0.tgz?use_mirror=mesh" -O OpenFOAM-2.4.0.tgz
wget "http://downloads.sourceforge.net/foam/ThirdParty-2.4.0.tgz?use_mirror=mesh" -O ThirdParty-2.4.0.tgz

tar -xzf OpenFOAM-2.4.0.tgz 
tar -xzf ThirdParty-2.4.0.tgz 
</bash></li>
<li>For building OpenFOAM itself, it depends on whether you have installed the i386 or x86_64 architecture of Fedora. To check this, run:
<bash>uname -m
</bash>
Now, accordingly:
<ul {{NoIndentStyle}}>
<li>For i386:
<bash>#forcefully load Open-MPI into the environment
module load mpi/openmpi-i386 || export PATH=$PATH:/usr/lib/openmpi/bin

#here you can change 4 to the number of cores you've got
source $HOME/OpenFOAM/OpenFOAM-2.4.0/etc/bashrc WM_NCOMPPROCS=4 WM_MPLIB=SYSTEMOPENMPI WM_ARCH_OPTION=32
</bash>
Also, save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following command:
<bash>echo "alias of240='module load mpi/openmpi-i386; source \$HOME/OpenFOAM/OpenFOAM-2.4.0/etc/bashrc $FOAM_SETTINGS'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM 2.4.0|of240}}
</li>

<li>For x86_64:
<bash>#forcefully load Open-MPI into the environment
module load mpi/openmpi-x86_64 || export PATH=$PATH:/usr/lib64/openmpi/bin

#here you can change 4 to the number of cores you've got
source $HOME/OpenFOAM/OpenFOAM-2.4.0/etc/bashrc WM_NCOMPPROCS=4 WM_MPLIB=SYSTEMOPENMPI
</bash>
Also, save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following command:
<bash>echo "alias of240='module load mpi/openmpi-x86_64; source \$HOME/OpenFOAM/OpenFOAM-2.4.0/etc/bashrc $FOAM_SETTINGS'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM 2.4.0|of240}}
</li>
</ul>
</li>

<li>Fedora 22 comes with CMake 3.x, but both ParaView 4.1.0 and CGAL 4.6 need one of the latest of versions from the CMake 2.8.x series. Therefore, we'll need to build the CMake version that is packaged with {{tt|ThirdParty-2.4.0}}:
<bash>cd $WM_THIRD_PARTY_DIR
./makeCmake > log.mkcmake 2>&1
wmSET $FOAM_SETTINGS
</bash>
</li>

<li>Now let's build the {{tt|ThirdParty}} folder, because we need the shell environment to be updated afterwards, for CGAL to be properly picked up for building OpenFOAM:
<bash>cd $WM_THIRD_PARTY_DIR

# This next command will take a while... somewhere between 5 minutes to 30 minutes.
./Allwmake > log.make 2>&1

#update the shell environment
wmSET $FOAM_SETTINGS
</bash>
</li>

<li>Now, before we can build OpenFOAM, we need to do a few fixes:
<bash>#Go into OpenFOAM's main source folder
cd $WM_PROJECT_DIR

#Change how the flex version is checked
find src applications -name "*.L" -type f | xargs sed -i -e 's=\(YY\_FLEX\_SUBMINOR\_VERSION\)=YY_FLEX_MINOR_VERSION < 6 \&\& \1='
</bash>
</li>

<li>Now let's build OpenFOAM:<br>
('''Warning''': this may take somewhere from 30 minutes to 6 hours, depending on your machine.)<br>
<bash>#Go into OpenFOAM's main source folder
cd $WM_PROJECT_DIR

# This next command will take a while... somewhere between 30 minutes to 3-6 hours.
./Allwmake > log.make 2>&1

#Run it a second time for getting a summary of the installation
./Allwmake > log.make 2>&1
</bash></li>

<li>{{Installation/Linux/CheckIfAllWentWell}}</li>

<li>Now, in order to build ParaView 4.1.0 that comes with OpenFOAM, including with the ability to use Python and MPI, several steps are needed:
<ol>
<li>Need to do several fixes:
<bash>cd $WM_THIRD_PARTY_DIR

sed -i -e 's=//#define GLX_GLXEXT_LEGACY=#define GLX_GLXEXT_LEGACY=' \
  ParaView-4.1.0/VTK/Rendering/OpenGL/vtkXOpenGLRenderWindow.cxx

cd $WM_THIRD_PARTY_DIR/ParaView-4.1.0

wget http://www.paraview.org/pipermail/paraview/attachments/20140210/464496cc/attachment.bin -O Fix.patch
patch -p1 < Fix.patch

cd VTK
wget https://github.com/gladk/VTK/commit/ef22d3d69421581b33bc0cd94b647da73b61ba96.patch -O Fix2.patch
patch -p1 < Fix2.patch

cd ../..
 </bash>
</li>
<li>For building ParaView with Python and MPI, run:
<bash>cd $WM_THIRD_PARTY_DIR
./makeParaView4 -qmake $(which qmake-qt4) -mpi -python  > log.makePV 2>&1
</bash>
</li>

<li>Once the {{tt|makeParaView4}} script is finished running, make sure to check the contents of the file {{tt|log.makePV}} and check if there are any errors.
</li>

<li>Finally, update the shell environment and build the official reader plug-in:
<bash>cd $FOAM_UTILITIES/postProcessing/graphics/PV4Readers 
wmSET $FOAM_SETTINGS
./Allwclean 
./Allwmake
</bash>
</li>
</ol>
</li>

<li>{{Installation/ReadUserGuideEtAl_OpenFOAMFoundation}}</li>
</ol>


{{Installation/Linux/AliasReminder|OpenFOAM 2.4.0|of240}}


'''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-installation/171381-problems-installing-openfoam-2-4-0-fedora-23-a.html Problems installing OpenFOAM 2.4.0 on Fedora 23]



[[Category:Installing OpenFOAM on Linux]] [[Category:Installing OpenFOAM on Fedora]]