View source for Installation/Linux/OpenFOAM-dev/Raspbian

= Introduction =
This page is dedicated to explaining how to install {{OpenFOAM}} {{versionOpenFOAMFoundationDev}} in [https://www.raspberrypi.org/downloads/raspbian/ Raspbian] for Raspberry Pi.

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. And please do keep in mind that these instructions can easily go out of date, because the OpenFOAM development repository is the ''bleeding edge''. For more details about this version, see the parent page [[Installation/Linux/OpenFOAM-dev]].

__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!

== Raspbian Jessie ==

Here you have the following choices:
* You can install from source, by either:
** Following the official instructions from here, by following the instructions for Ubuntu: [http://openfoam.org/download/source/ OpenFOAM Source Repository]
** Or by following the detailed step-by-step instructions below...


; Important Notes
# The instructions below are based on top the ones provided in the [http://bugs.openfoam.org/view.php?id=2051#c6216 bug report #2051 comment #6216].
# The build will take a considerable long amount of time to do. Expect it will take 12 to 24h, if not more.
# The instructions below were tested using emulation via QEMU on a machine with a common x86_64 CPU, which are detailed here: [https://github.com/wyldckat/wyldckat.github.io/wiki/Raspberry-Pi-on-QEMU Raspberry Pi on QEMU]


'''Discussion thread where you can ask questions about these steps''': {{Installation/NoThreadAskForum}}

Steps:
<ol>
{{Installation/Linux/SwitchToRoot}}
{{Installation/Linux/AptGetUpdate}}
<li>Install the necessary packages:
<bash>apt-get install git-core build-essential binutils-dev cmake flex bison zlib1g-dev qt4-dev-tools libqt4-dev libqtwebkit-dev gnuplot \
libreadline-dev libncurses-dev libxt-dev libopenmpi-dev openmpi-bin libboost-system-dev libboost-thread-dev libgmp-dev \
libmpfr-dev python python-dev  freeglut3-dev mesa-common-dev
</bash>
</li>

{{Installation/Linux/ExitRoot}}

<li>Download and unpack (here you can copy-paste all in single go):
<bash>#OpenFOAM downloading and installation
cd ~
mkdir OpenFOAM
cd OpenFOAM
git clone https://github.com/OpenFOAM/OpenFOAM-dev.git
git clone https://github.com/OpenFOAM/ThirdParty-dev.git
</bash>
But we will now have to download a few more of the necessary packages for the {{tt|ThirdParty-dev}} folder:
<ol>
<li>First, we need to prepare for the downloads:
<bash>cd ThirdParty-dev
mkdir download
</bash>
</li>

<li>Now, we need to download the essential source code packages for these instructions you are following (the links are from the file {{tt|README.org}}):
<bash>wget -P download https://github.com/CGAL/cgal/releases/download/releases%2FCGAL-4.8.1/CGAL-4.8.1.tar.xz</bash>
</li>

<li>Next, we need to unpack the packages we've downloaded:
<bash>tar -xJf download/CGAL-4.8.1.tar.xz</bash>
</li>

<li>Last but not least, the final command on this sub-list is to go back to the main {{tt|OpenFOAM}} folder:
<bash>cd ..
</bash>
</li>
</ol>
</li>

<li>'''Optional''': Let's make a few symbolic links that should ensure that the correct global MPI installation is used by this OpenFOAM installation:
<bash>ln -s /usr/bin/mpicc.openmpi OpenFOAM-dev/bin/mpicc
ln -s /usr/bin/mpirun.openmpi OpenFOAM-dev/bin/mpirun</bash>
This way we avoid having problems in case there is more than one MPI toolbox installed in your Raspbian system, for example if MPICH2 is installed and is the default MPI toolbox.
</li>

<li>A few details need to be fixed, before proceeding, which will change the default CGAL version and use the correct build option for Raspberry Pi:
<bash>sed -i -e 's/\(cgal_version=\)cgal-system/\1CGAL-4.8.1/' OpenFOAM-dev/etc/config.sh/CGAL
sed -i -e '/softfp/ s/^/#/'  -e '/hard/ s/^#//' OpenFOAM-dev/wmake/rules/linuxARM7Gcc/{cOpt,c++Opt}
</bash>
</li>

<li>For building OpenFOAM itself, activate the OpenFOAM environment with the following command:
<bash>source $HOME/OpenFOAM/OpenFOAM-dev/etc/bashrc FOAMY_HEX_MESH=yes
</bash>
</li>

<li>Save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following command:
<bash>echo "alias ofdev='source \$HOME/OpenFOAM/OpenFOAM-dev/etc/bashrc $FOAM_SETTINGS'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM-dev|ofdev}}
</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

#make very certain that the correct Qt version is being used, by running this command:
export QT_SELECT=qt4

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

#update the shell environment
wmRefresh
</bash>
</li>

<li>Now, in order to build ParaView 5.0.1, including with the ability to use Python and MPI, several steps are needed:
<ol>
<li>Make sure you're running in the {{tt|ThirdParty}} folder and that the correct Qt version is used:
<bash>cd $WM_THIRD_PARTY_DIR
export QT_SELECT=qt4
 </bash>
</li>
<li>For building ParaView with Python and MPI, run:
<bash>./makeParaView -python -mpi -python-lib /usr/lib/arm-linux-gnueabihf/libpython2.7.so.1.0 > log.makePV 2>&1</bash>
</li>
<li>{{Installation/ParaView/BuildProblemsCheckFAQ|makeParaView|log.makePV}}
</li>
<li>Finally, update the shell environment:
<bash>wmRefresh</bash>
</li>
</ol>
</li>

<li>Now let's build OpenFOAM:
<ol>
<li>Go into OpenFOAM's main source folder and be certain that the correct Qt version is being used:
<bash>cd $WM_PROJECT_DIR
export QT_SELECT=qt4</bash>
</li>

<li>This next command will take a considerably long time to run somewhere between 12 to 24 hours:
<bash>./Allwmake > log.make 2>&1</bash>
'''Note''': If you're using Raspbian with {{tt|chroot}}+QEMU and you have enough RAM in your real machine, then you can use the {{tt|-j}} option, e.g. for using 4 cores:
<bash>./Allwmake -j 4 > log.make 2>&1</bash>
</li>
<li>Run it a second time for getting a summary of the installation:
<bash>./Allwmake > log.make 2>&1</bash>
'''Note:''' Technically, the build will stop as soon as the first error is found. Running a second time only makes it easier to sort through between what's already been built and where the crash occurred.
</li>
</ol>
</li>

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

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

<li>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]].</li>

<li>'''Note''': When you want to update your build, follow the instructions on section [[Installation/Linux/OpenFOAM-dev#Steps for updating|Steps for updating]] on the parent page.</li>
</ol>


{{Installation/Linux/AliasReminder|OpenFOAM-dev|ofdev}}


'''Discussion thread where you can ask questions about these steps''': {{Installation/NoThreadAskForum}}


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