View source for Installation/Linux/OpenFOAM-dev/CentOS SL RHEL/6.10 (SCL)

For other versions of CentOS/RHEL/SL and other installation instructions, please visit the parent page: [[../]]

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!

== CentOS 6.10 (SCL) ==

Here you have the following choices:
* You can install from source, by either:
** Following the official instructions from here: [http://openfoam.org/download/source/ OpenFOAM Source Repository]
** If you're looking for semi-automatic installation instructions, try [[Installation/Ansible]].
** Or by following the detailed step-by-step instructions below...


Notes regarding the instructions below:
* These instructions rely heavily on the [https://wiki.centos.org/AdditionalResources/Repositories/SCL Software Collections ( SCL ) Repository], which can be used to install software in a non-intrusive way... which will require its own environment loading mechanism.
** This way it's not necessary to compile Python and GCC from source code and instead use pre-built packages provided by the SCL community.
* The instructions below were tested with CentOS 6.10, but might work with older or newer versions.


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

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

<li>Install the necessary packages:
<bash>yum groupinstall 'Development Tools' 
yum install zlib-devel texinfo gstreamer-plugins-base-devel \
libXext-devel libGLU-devel libXt-devel libXrender-devel libXinerama-devel libpng-devel \
libXrandr-devel libXi-devel libXft-devel libjpeg-turbo-devel libXcursor-devel \
readline-devel ncurses-devel mpfr-devel gmp-devel

#This one is useful, but not crucial
yum upgrade</bash>
Also install the aforementioned SCL repository and the packages we need from it:
<bash>yum install centos-release-SCL
yum install python27 devtoolset-7</bash>
</li>

<li>To check if the desired SCL packages are installed, run:
<bash>scl --list</bash>
</li>

<li>For future reference, the easiest way to activate the environment for the installed SCL packages on the current command line is to run, '''but do ''not'' do this right now''':
<bash>source /opt/rh/python27/enable
source /opt/rh/devtoolset-7/enable
</bash>
This command will be indicated to be executed at the right point in the instructions below.
</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
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://www.cmake.org/files/v3.9/cmake-3.9.0.tar.gz
wget -P download https://github.com/CGAL/cgal/releases/download/releases%2FCGAL-5.0.2/CGAL-5.0.2.tar.xz
wget -P download https://sourceforge.net/projects/boost/files/boost/1.72.0/boost_1_72_0.tar.bz2
wget -P download https://www.open-mpi.org/software/ompi/v2.1/downloads/openmpi-2.1.1.tar.bz2
wget -P download http://www.paraview.org/files/v5.6/ParaView-v5.6.3.tar.gz
wget -P download http://download.qt.io/archive/qt/5.9/5.9.6/single/qt-everywhere-opensource-src-5.9.6.tar.xz
</bash>
</li>

<li>Next, we need to unpack the packages we've downloaded:
<bash>tar -xzf download/cmake-3.9.0.tar.gz
tar -xJf download/CGAL-5.0.2.tar.xz
tar -xjf download/boost_1_72_0.tar.bz2
tar -xjf download/openmpi-2.1.1.tar.bz2
tar -xzf download/ParaView-v5.6.3.tar.gz --transform='s/ParaView-v5.6.3/ParaView-5.6.3/'
tar -xJf download/qt-everywhere-opensource-src-5.9.6.tar.xz --transform='s/qt-everywhere-opensource-src/qt-everywhere-src/'
</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>A few details need to be fixed, before proceeding, which will change the default Boost and CGAL versions:
<bash>sed -i -e 's/\(boost_version=\)boost-system/\1boost_1_72_0/' OpenFOAM-dev/etc/config.sh/CGAL
sed -i -e 's/\(cgal_version=\)cgal-system/\1CGAL-5.0.2/' OpenFOAM-dev/etc/config.sh/CGAL
</bash>
</li>

<li>Now is the time to load in the SCL packages that were installed, by running:
<bash>source /opt/rh/python27/enable
source /opt/rh/devtoolset-7/enable</bash>
</li>

<li>For building OpenFOAM itself, it depends on whether you have installed the i386 or x86_64 architecture of CentOS/SL/RHEL. To check this, run:
<bash>uname -m</bash>
Now, accordingly:
<ul {{NoIndentStyle}}>
<li>For i386:
<bash>source $HOME/OpenFOAM/OpenFOAM-dev/etc/bashrc WM_ARCH_OPTION=32 WM_MPLIB=OPENMPI FOAMY_HEX_MESH=yes
</bash>
Also, save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following command:
<bash>echo "alias ofdev='source /opt/rh/python27/enable && source /opt/rh/devtoolset-7/enable && source \$HOME/OpenFOAM/OpenFOAM-dev/etc/bashrc $FOAM_SETTINGS'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM dev|ofdev}}
</li>

<li>For x86_64, it depends on whether you need 64-bit integer support or not. Depending on whether you need 64-bit integer support or not:
<ul {{NoIndentStyle}}>
<li>For building with the normal 32-bit integer support (maximum 2.147×10<sup>9</sup> cells, faces or points):
<bash>source $HOME/OpenFOAM/OpenFOAM-dev/etc/bashrc WM_MPLIB=OPENMPI FOAMY_HEX_MESH=yes
</bash>
</li>
<li>For building with the normal 64-bit integer support (maximum 9.22×10<sup>18</sup> cells, faces or points):
<bash>source $HOME/OpenFOAM/OpenFOAM-dev/etc/bashrc WM_LABEL_SIZE=64 WM_MPLIB=OPENMPI FOAMY_HEX_MESH=yes
</bash>
</li>
</ul>

Also, save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following command:
<bash>echo "alias ofdev='source /opt/rh/python27/enable && source /opt/rh/devtoolset-7/enable && source \$HOME/OpenFOAM/OpenFOAM-dev/etc/bashrc $FOAM_SETTINGS'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM dev|ofdev}}
</li>
</ul>
</li>

<li>CentOS 6.10 comes with CMake 2.6.4, but ParaView 5.6.3 needs a one of the versions from the more recent CMake 3.x series, so we need a custom build:
<bash>cd $WM_THIRD_PARTY_DIR
./makeCmake > log.makeCmake 2>&1
wmRefresh
</bash>
</li>

<li>CentOS 6.6 comes with Qt 4.6.2, but ParaView 5.6.3 needs at least 5.X.  However, since we are using GCC 7, it's best to use a more recent Qt version, namely 5.9.6 was downloaded and unpacked already. Therefore, we'll need to do a custom build of Qt 5.9.6:
<bash>cd $WM_THIRD_PARTY_DIR

#Get the scripts we need
wget https://github.com/wyldckat/scripts4OpenFOAM3rdParty/raw/master/makeQt5
wget -P etc/tools/ https://github.com/OpenFOAM/ThirdParty-2.4.x/raw/master/etc/tools/QtFunctions

#make them executable
chmod +x makeQt5

./makeQt5 qt-5.9.6 > log.makeQt 2>&1</bash>

'''Important Note''': Building Qt 5 will use up a lot of disk space (roughly 10GB, including the source code package). Therefore, after you've check the contents of the file {{tt|log.makeQt}} (or check the last few lines of this file), then you can delete the temporary+intermediate files used to build Qt 5, by running the following commands:
<bash>cd $WM_THIRD_PARTY_DIR
rm -r build
rm -r qt-everywhere-src-5.9.6</bash>
</li>

<li>Given that a custom Open-MPI version is being built with these instructions, it's necessary to first build it before ParaView so that Open-MPI can be used by ParaView:
<bash>cd $WM_THIRD_PARTY_DIR
./Allwmake > log.make 2>&1
wmRefresh
</bash>
</li>

<li>For building ParaView 5.6.3 with Python and MPI, it depends on whether you have installed the i686 or x86_64 architecture of CentOS 6:
<ol>
<li>To check this, run:
<bash>uname -m</bash>
Now, accordingly:
<ul {{NoIndentStyle}}>
<li>For '''i686''':
<bash>cd $WM_THIRD_PARTY_DIR

# Load the Python 2.7 that came with the SCL repository
source /opt/rh/python27/enable

# Need Qt5 to be found by CMake
export CMAKE_PREFIX_PATH=$WM_THIRD_PARTY_DIR/platforms/$WM_ARCH$WM_COMPILER/qt-5.9.6/

#this will take a while... somewhere between 30 minutes to 2 hours or more
./makeParaView -qt-5.9.6 -mpi -python -python-lib /opt/rh/python27/root/usr/lib/libpython2.7.so -python-include /opt/rh/python27/root/usr/include/python2.7 > log.makePV 2>&1
</bash>
</li>

<li>For '''x86_64''':
<bash>cd $WM_THIRD_PARTY_DIR

# Load the Python 2.7 that came with the SCL repository
source /opt/rh/python27/enable

# Need Qt5 to be found by CMake
export CMAKE_PREFIX_PATH=$WM_THIRD_PARTY_DIR/platforms/$WM_ARCH$WM_COMPILER/qt-5.9.6/

#this will take a while... somewhere between 30 minutes to 2 hours or more
./makeParaView -qt-5.9.6 -mpi -python -python-lib /opt/rh/python27/root/usr/lib64/libpython2.7.so -python-include /opt/rh/python27/root/usr/include/python2.7 > log.makePV 2>&1
</bash>
</li>
</ul>
'''Note''': Building with Qt 5 means that OpenGL2 must be used, therefore if you really want to use OpenGL rendering, follow the instructions from section [[#CentOS 6.10 (without SCL)|CentOS 6.10 (without SCL)]] instead.
</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:
<bash>cd $WM_PROJECT_DIR</bash>
</li>
<li>We need to temporarily populate {{tt|CMAKE_PREFIX_PATH}} with the path to the custom Qt build, so that {{tt|qmake}} is properly found when building OpenFOAM's plug-in libraries for ParaView:
<bash>export CMAKE_PREFIX_PATH=$WM_THIRD_PARTY_DIR/platforms/$WM_ARCH$WM_COMPILER/qt-5.9.6/</bash>
</li>
<li>This next command will take a while... somewhere between 30 minutes to 3-6 hours:
<bash>./Allwmake -j 4 > log.make 2>&1</bash>
{{Installation/Linux/NumberOfCores}}
</li>
<li>Run it a second time for getting a summary of the installation:
<bash>./Allwmake -j 4 > 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>'''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}}

<br>


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