View source for Installation/Linux/OpenFOAM-1.6-ext/Ubuntu

= Introduction =
This page is dedicated to explaining how to install {{-Extend}} {{version1.6-ext}} in [http://www.ubuntu.com Ubuntu].

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!


== Ubuntu 10.04 ==

Here you have at least two choices:
* You can install the Deb packages, which provide a quick and easy way for having a working installation of OpenFOAM 1.6-ext. This is the quickest solution for beginners and instructions are provided here: [[Installation/Installation_(old_monolithic_version)#OpenFOAM-dev-1.5 or OpenFOAM-1.6-ext under Ubuntu Lucid 10.04 LTS|OpenFOAM-dev-1.5 or OpenFOAM-1.6-ext under Ubuntu Lucid 10.04 LTS]]
* You can install from source, by either:
** Following the official instructions from one of these repositories:
*** [http://sourceforge.net/p/openfoam-extend/OpenFOAM-1.6-ext/ci/1.6.1/tree/doc/buildInstructions/Ubuntu/10.04/ Building Instructions for Ubuntu 10.04 at the official Extend repository]
*** [http://repo.or.cz/w/openfoam-extend-OpenFOAM-1.6-ext.git/tree/1.6.1:/doc/buildInstructions/Ubuntu/10.04 Building Instructions for Ubuntu 10.04 at repo.or.cz mirror]
*** [https://github.com/Unofficial-Extend-Project-Mirror/openfoam-extend-OpenFOAM-1.6-ext/tree/1.6.1/doc/buildInstructions/Ubuntu/10.04 Building Instructions for Ubuntu 10.04 at Unofficial-Extend-Project-Mirror@github mirror]
*** '''Note''': Before following any of the instructions above, check the section [[../#Note regarding foam-extend-3.0|Note regarding foam-extend-3.0]]
** Or by following the detailed step-by-step instructions below (which has been based on the previous link)...


'''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-installation/126685-failed-install-openfoam-1-6ext.html failed to install openFoam 1.6ext]

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

<li>Install the necessary packages:
<bash>apt-get install git-core flex bison rpm build-essential zlib1g-dev binutils-dev libstdc++5 \
libqt4-dev qt4-dev-tools libxext-dev libxt-dev libreadline-dev libncurses-dev
</bash>
</li>

{{Installation/Linux/ExitRoot}}

<li>Set-up the base folder where OpenFOAM-1.6-ext will be installed (here you can copy-paste all in single go):
<bash>cd ~
mkdir OpenFOAM
cd OpenFOAM
</bash></li>

{{Installation/Linux/OpenFOAM-1.6-ext/Mirrors}}

<li>After the cloning is complete, go into the cloned folder and checkout the commit associated to {{tt|1.6.1}}, so that the correct 1.6-ext version is used:
<bash>cd OpenFOAM-1.6-ext
git checkout 1.6.1 -b 16ext</bash></li>

<li>Configure the preferences file to specify the usage of the system's Qt 4:
<bash>cp etc/prefs.sh-EXAMPLE etc/prefs.sh

sed -i s/"#export QT_DIR=path_to_system_installed_qt"/"export QT_DIR=\/usr"/g etc/prefs.sh
sed -i s/"#export QT_BIN_DIR=\$QT_DIR\/bin"/"export QT_BIN_DIR=\$QT_DIR\/bin"/g etc/prefs.sh

#here you can change 4 to the number of cores you've got
echo "export WM_NCOMPPROCS=4" >> etc/prefs.sh
</bash></li>

<li>Now to do several more necessary fixes: 
<bash>#we'll need to switch to the internal reader for ParaView
sed -i -e 's=\.OpenFOAM=\.foam=' bin/paraFoam
sed -i -e 's/^unset/export LC_ALL=C; unset/' bin/paraFoam

#Create a symbolic link for gmake
ln -s /usr/bin/make bin/gmake

#Fix the link for Mesquite
sed -i -e 's=software.sandia.gov/~jakraft=downloads.sourceforge.net/project/openfoam-extend/foam-extend-3.0/ThirdParty=g' \
  ThirdParty/AllMake.stage3 ThirdParty/rpmBuild/SPECS/mesquite-2.1.2.spec
</bash></li>

<li>For building 1.6-ext itself, it depends on whether you have installed the i686 or x86_64 architecture of Ubuntu. To check this, run:
<bash>uname -m</bash>
Now, accordingly:
<ul {{NoIndentStyle}}>
<li>For i686:
<bash>echo "export WM_ARCH_OPTION=32" >> etc/prefs.sh
</bash></li>

<li>For x86_64... there's nothing special to do.</li>
</ul>
</li>

<li>''Activate'' the environment and save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following commands:
<bash>source etc/bashrc

echo "alias of16ext='source \$HOME/OpenFOAM/OpenFOAM-1.6-ext/etc/bashrc'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM 1.6-ext|of16ext}}
</li>

<li>Build the several stages of the {{tt|ThirdParty}} folder in a single go:
<bash>cd ThirdParty

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

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

<li>To check if everything went well:
<bash>#Edit the file "log.AllMake" and check if there are any error messages
#Example:
gedit log.AllMake

#Create a tarball in case you've seen any errors (it's the first error that matters)
#or if you don't understand the output
#and attach the file "log.AllMake.tar.gz" to a post in the designated thread
tar -czf log.AllMake.tar.gz log.AllMake
</bash></li>

<li>Now let's build 1.6-ext:
<bash>#Go back to the main folder and update the environment
cd ..
source etc/bashrc

# 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 you can go read the User Guide, which is located at {{tt|$HOME/OpenFOAM/OpenFOAM-1.6-ext/doc/Guides-a4/UserGuide.pdf}}.</li>
</ol>


{{Installation/Linux/AliasReminder|OpenFOAM 1.6-ext|of16ext}}


'''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-installation/126685-failed-install-openfoam-1-6ext.html failed to install openFoam 1.6ext]

== Ubuntu 11.04 ==

Here you have a few choices:
* You can install from source, by either:
** Trying to follow the available official instructions from one of these repositories (but keeping in mind that you are using 11.04):
*** [http://sourceforge.net/p/openfoam-extend/OpenFOAM-1.6-ext/ci/1.6.1/tree/doc/buildInstructions/Ubuntu/ Building Instructions for Ubuntu at the official Extend repository]
*** [http://repo.or.cz/w/openfoam-extend-OpenFOAM-1.6-ext.git/tree/1.6.1:/doc/buildInstructions/Ubuntu Building Instructions for Ubuntu at repo.or.cz mirror]
*** [https://github.com/Unofficial-Extend-Project-Mirror/openfoam-extend-OpenFOAM-1.6-ext/tree/1.6.1/doc/buildInstructions/Ubuntu Building Instructions for Ubuntu at Unofficial-Extend-Project-Mirror@github mirror]
*** '''Note''': Before following any of the instructions above, check the section [[../#Note regarding foam-extend-3.0|Note regarding foam-extend-3.0]]
** Or by following the detailed step-by-step instructions below (which has been based on the instructions from previous link)...


'''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 flex bison rpm build-essential zlib1g-dev binutils-dev libstdc++5 \
libqt4-dev qt4-dev-tools libxext-dev libxt-dev libreadline-dev libncurses-dev libxrender-dev
</bash>
</li>

{{Installation/Linux/ExitRoot}}

<li>Set-up the base folder where OpenFOAM-1.6-ext will be installed (here you can copy-paste all in single go):
<bash>cd ~
mkdir OpenFOAM
cd OpenFOAM
</bash></li>

{{Installation/Linux/OpenFOAM-1.6-ext/Mirrors}}

<li>After the cloning is complete, go into the cloned folder and checkout the commit associated to {{tt|1.6.1}}, so that the correct 1.6-ext version is used:
<bash>cd OpenFOAM-1.6-ext
git checkout 1.6.1 -b 16ext</bash></li>

<li>Configure the preferences file:
<bash>cp etc/prefs.sh-EXAMPLE etc/prefs.sh

#configuring it to build using the custom Qt build
sed -i s/"#export QT_THIRD_PARTY=1"/"export QT_THIRD_PARTY=1"/g etc/prefs.sh

#here you can change 4 to the number of cores you've got
echo "export WM_NCOMPPROCS=4" >> etc/prefs.sh
</bash></li>

<li>Now to do several more necessary fixes: 
<bash>#we'll need to switch to the internal reader for ParaView
sed -i -e 's=\.OpenFOAM=\.foam=' bin/paraFoam
sed -i -e 's/^unset/export LC_ALL=C; unset/' bin/paraFoam

#Create a symbolic link for gmake
ln -s /usr/bin/make bin/gmake

#Fix the link for Mesquite
sed -i -e 's=software.sandia.gov/~jakraft=downloads.sourceforge.net/project/openfoam-extend/foam-extend-3.0/ThirdParty=g' \
  ThirdParty/AllMake.stage3 ThirdParty/rpmBuild/SPECS/mesquite-2.1.2.spec
</bash></li>

<li>For building 1.6-ext itself, it depends on whether you have installed the i686 or x86_64 architecture of Ubuntu. To check this, run:
<bash>uname -m</bash>
Now, accordingly:
<ul {{NoIndentStyle}}>
<li>For i686:
<bash>echo "export WM_ARCH_OPTION=32" >> etc/prefs.sh
</bash></li>

<li>For x86_64... there's nothing special to do.</li>
</ul>
</li>

<li>''Activate'' the environment and save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following commands:
<bash>source etc/bashrc

echo "alias of16ext='source \$HOME/OpenFOAM/OpenFOAM-1.6-ext/etc/bashrc'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM 1.6-ext|of16ext}}
</li>

<li>Build the several stages of the {{tt|ThirdParty}} folder in a single go:
<bash>cd ThirdParty

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

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

<li>To check if everything went well:
<bash>#Edit the file "log.AllMake" and check if there are any error messages
#Example:
gedit log.AllMake

#Create a tarball in case you've seen any errors (it's the first error that matters)
#or if you don't understand the output
#and attach the file "log.AllMake.tar.gz" to a post in the designated thread
tar -czf log.AllMake.tar.gz log.AllMake
</bash></li>

<li>Now let's build 1.6-ext:
<bash>#Go back to the main folder and update the environment
cd ..
source etc/bashrc

# 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 you can go read the User Guide, which is located at {{tt|$HOME/OpenFOAM/OpenFOAM-1.6-ext/doc/Guides-a4/UserGuide.pdf}}.</li>
</ol>


{{Installation/Linux/AliasReminder|OpenFOAM 1.6-ext|of16ext}}


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

== Ubuntu 12.04 ==

Here you have a few choices:
* You can install from source, by either:
** Following the available official instructions from one of these repositories:
*** [http://sourceforge.net/p/openfoam-extend/OpenFOAM-1.6-ext/ci/1.6.1/tree/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at the official Extend repository]
*** [http://repo.or.cz/w/openfoam-extend-OpenFOAM-1.6-ext.git/tree/1.6.1:/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at repo.or.cz mirror]
*** [https://github.com/Unofficial-Extend-Project-Mirror/openfoam-extend-OpenFOAM-1.6-ext/tree/1.6.1/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at Unofficial-Extend-Project-Mirror@github mirror]
*** '''Note''': Before following any of the instructions above, check the section [[../#Note regarding foam-extend-3.0|Note regarding foam-extend-3.0]]
** Or by following the detailed step-by-step instructions below (which has been based on the instructions from previous link)...


'''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 flex bison rpm build-essential zlib1g-dev binutils-dev \
openmpi-bin libopenmpi-dev paraview libstdc++5
</bash>
</li>

{{Installation/Linux/ExitRoot}}

<li>Set-up the base folder where OpenFOAM-1.6-ext will be installed (here you can copy-paste all in single go):
<bash>cd ~
mkdir OpenFOAM
cd OpenFOAM
</bash></li>

{{Installation/Linux/OpenFOAM-1.6-ext/Mirrors}}

<li>After the cloning is complete, go into the cloned folder and checkout the commit associated to {{tt|1.6.1}}, so that the correct 1.6-ext version is used:
<bash>cd OpenFOAM-1.6-ext
git checkout 1.6.1 -b 16ext</bash></li>

<li>Configure the preferences file:
<bash>cp etc/prefs.sh-EXAMPLE etc/prefs.sh

#Use the system compiler and configure to use Gcc 4.6
sed -i s/"compilerInstall=System"/"compilerInstall=System"/g etc/prefs.sh
echo "export WM_COMPILER=Gcc46" >> etc/prefs.sh

# Use the system installation of OpenMPI
sed -i s/"#export WM_MPLIB=SYSTEMOPENMPI"/"export WM_MPLIB=SYSTEMOPENMPI"/g etc/prefs.sh
sed -i s/"#export OPENMPI_DIR=path_to_system_installed_openmpi"/"export OPENMPI_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export OPENMPI_BIN_DIR"/"export OPENMPI_BIN_DIR"/g etc/prefs.sh

# Use the system ParaView
sed -i s/"#export PARAVIEW_SYSTEM=1"/"export PARAVIEW_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export PARAVIEW_DIR=path_to_system_installed_paraview"/"export PARAVIEW_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export PARAVIEW_BIN_DIR"/"export PARAVIEW_BIN_DIR"/g etc/prefs.sh

#here you can change 4 to the number of cores you've got
echo "export WM_NCOMPPROCS=4" >> etc/prefs.sh
</bash></li>

<li>Now to do several more necessary fixes: 
<bash>#we'll need to switch to the internal reader for ParaView
sed -i -e 's=\.OpenFOAM=\.foam=' bin/paraFoam
sed -i -e 's/^unset/export LC_ALL=C; unset/' bin/paraFoam

#Create a symbolic link for gmake
ln -s /usr/bin/make bin/gmake

#disable X dependencies in tecio
sed -i -e 's=\(U_WIN32\)$=\1 -DENGINE=g' \
 applications/utilities/postProcessing/dataConversion/foamToTecplot360/tecio/tecsrc/Make/tecioOptions

#Fix the link for Mesquite
sed -i -e 's=software.sandia.gov/~jakraft=downloads.sourceforge.net/project/openfoam-extend/foam-extend-3.0/ThirdParty=g' \
  ThirdParty/AllMake.stage3 ThirdParty/rpmBuild/SPECS/mesquite-2.1.2.spec
</bash></li>

<li>For building 1.6-ext itself, it depends on whether you have installed the i686 or x86_64 architecture of Ubuntu. To check this, run:
<bash>uname -m</bash>
Now, accordingly:
<ul {{NoIndentStyle}}>
<li>For i686:
<bash>echo "export WM_ARCH_OPTION=32" >> etc/prefs.sh
</bash></li>

<li>For x86_64... there's nothing special to do.</li>
</ul>
</li>

<li>''Activate'' the environment and save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following commands:
<bash>source etc/bashrc

echo "alias of16ext='source \$HOME/OpenFOAM/OpenFOAM-1.6-ext/etc/bashrc'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM 1.6-ext|of16ext}}
</li>

<li>Build the several stages of the {{tt|ThirdParty}} folder in a single go:
<bash>cd ThirdParty

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

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

<li>To check if everything went well:
<bash>#Edit the file "log.AllMake" and check if there are any error messages
#Example:
gedit log.AllMake

#Create a tarball in case you've seen any errors (it's the first error that matters)
#or if you don't understand the output
#and attach the file "log.AllMake.tar.gz" to a post in the designated thread
tar -czf log.AllMake.tar.gz log.AllMake
</bash></li>

<li>Now let's build 1.6-ext:
<bash>#Go back to the main folder and update the environment
cd ..
source etc/bashrc

# 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 you can go read the User Guide, which is located at {{tt|$HOME/OpenFOAM/OpenFOAM-1.6-ext/doc/Guides-a4/UserGuide.pdf}}.</li>
</ol>


{{Installation/Linux/AliasReminder|OpenFOAM 1.6-ext|of16ext}}


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

== Ubuntu 12.10 ==

Here you have a few choices:
* You can install from source, by either:
** Adapting the available official instructions that are for Ubuntu 12.04 (keeping in mind you're trying to install on Ubuntu 12.10), from one of these repositories:
*** [http://sourceforge.net/p/openfoam-extend/OpenFOAM-1.6-ext/ci/1.6.1/tree/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at the official Extend repository]
*** [http://repo.or.cz/w/openfoam-extend-OpenFOAM-1.6-ext.git/tree/1.6.1:/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at repo.or.cz mirror]
*** [https://github.com/Unofficial-Extend-Project-Mirror/openfoam-extend-OpenFOAM-1.6-ext/tree/1.6.1/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at Unofficial-Extend-Project-Mirror@github mirror]
*** '''Note''': Before following any of the instructions above, check the section [[../#Note regarding foam-extend-3.0|Note regarding foam-extend-3.0]]
** Or by following the detailed step-by-step instructions below (which has been based on the instructions from previous link)...


'''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 flex bison rpm build-essential zlib1g-dev binutils-dev \
openmpi-bin libopenmpi-dev paraview libscotch-dev cmake libstdc++5

#just in case, make sure to uninstall the "gold" binutils version
apt-get remove binutils-gold
</bash>
</li>

{{Installation/Linux/ExitRoot}}

<li>Set-up the base folder where OpenFOAM-1.6-ext will be installed (here you can copy-paste all in single go):
<bash>cd ~
mkdir OpenFOAM
cd OpenFOAM
</bash></li>

{{Installation/Linux/OpenFOAM-1.6-ext/Mirrors}}

<li>After the cloning is complete, go into the cloned folder and checkout the commit associated to {{tt|1.6.1}}, so that the correct 1.6-ext version is used:
<bash>cd OpenFOAM-1.6-ext
git checkout 1.6.1 -b 16ext</bash></li>

<li>Configure the preferences file:
<bash>cp etc/prefs.sh-EXAMPLE etc/prefs.sh

#Use the system compiler and configure to use Gcc 4.7
sed -i s/"compilerInstall=System"/"compilerInstall=System"/g etc/prefs.sh
echo "export WM_COMPILER=Gcc47" >> etc/prefs.sh

# Use the system installation of OpenMPI
sed -i s/"#export WM_MPLIB=SYSTEMOPENMPI"/"export WM_MPLIB=SYSTEMOPENMPI"/g etc/prefs.sh
sed -i s/"#export OPENMPI_DIR=path_to_system_installed_openmpi"/"export OPENMPI_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export OPENMPI_BIN_DIR"/"export OPENMPI_BIN_DIR"/g etc/prefs.sh

# Use the system's ParaView
sed -i s/"#export PARAVIEW_SYSTEM=1"/"export PARAVIEW_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export PARAVIEW_DIR=path_to_system_installed_paraview"/"export PARAVIEW_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export PARAVIEW_BIN_DIR"/"export PARAVIEW_BIN_DIR"/g etc/prefs.sh

# Use the system's Scotch
sed -i s/"#export SCOTCH_SYSTEM=1"/"export SCOTCH_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export SCOTCH_DIR=path_to_system_installed_scotch"/"export SCOTCH_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export SCOTCH"/"export SCOTCH"/g etc/prefs.sh
sed -i 's-SCOTCH_DIR/include$-SCOTCH_DIR/include/scotch-g' etc/prefs.sh

# Use the system's CMake
sed -i s/"#export CMAKE_SYSTEM=1"/"export CMAKE_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export CMAKE_DIR=path_to_system_installed_cmake"/"export CMAKE_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export CMAKE"/"export CMAKE"/g etc/prefs.sh

#here you can change 4 to the number of cores you've got
echo "export WM_NCOMPPROCS=4" >> etc/prefs.sh
</bash></li>

<li>Now to do several more necessary fixes: 
<bash>#we'll need to switch to the internal reader for ParaView
sed -i -e 's=\.OpenFOAM=\.foam=' bin/paraFoam
sed -i -e 's/^unset/export LC_ALL=C; unset/' bin/paraFoam

#Create a symbolic link for gmake
ln -s /usr/bin/make bin/gmake

#disable X dependencies in tecio
sed -i -e 's=\(U_WIN32\)$=\1 -DENGINE=g' \
 applications/utilities/postProcessing/dataConversion/foamToTecplot360/tecio/tecsrc/Make/tecioOptions

#Fix the link for Mesquite
sed -i -e 's=software.sandia.gov/~jakraft=downloads.sourceforge.net/project/openfoam-extend/foam-extend-3.0/ThirdParty=g' \
  ThirdParty/AllMake.stage3 ThirdParty/rpmBuild/SPECS/mesquite-2.1.2.spec
</bash></li>

<li>For building 1.6-ext itself, it depends on whether you have installed the i686 or x86_64 architecture of Ubuntu. To check this, run:
<bash>uname -m</bash>
Now, accordingly:
<ul {{NoIndentStyle}}>
<li>For i686:
<bash>echo "export WM_ARCH_OPTION=32" >> etc/prefs.sh

#copy the rules from ''Gcc46'' to ''Gcc47''
cp -r wmake/rules/linuxGcc46 wmake/rules/linuxGcc47

# due to stricter name lookup rules in 4.7 we need to tell the compiler to lighten up on this
sed -i 's/^\(c++FLAGS.*\)/\1 -fpermissive/g' wmake/rules/linuxGcc47/c++
</bash>
Note: fix for the {{tt|c++}} file was retrieved from [http://www.cfd-online.com/Forums/openfoam-installation/108486-walkthrough-installation-openfoam-1-6-ext-opensuse-12-2-64-bit.html here].</li>

<li>For x86_64:
<bash>#copy the rules from ''Gcc46'' to ''Gcc47''
cp -r wmake/rules/linux64Gcc46 wmake/rules/linux64Gcc47

# due to stricter name lookup rules in 4.7 we need to tell the compiler to lighten up on this
sed -i 's/^\(c++FLAGS.*\)/\1 -fpermissive/g' wmake/rules/linux64Gcc47/c++
</bash>
Note: fix for the {{tt|c++}} file was retrieved from [http://www.cfd-online.com/Forums/openfoam-installation/108486-walkthrough-installation-openfoam-1-6-ext-opensuse-12-2-64-bit.html here].</li>
</ul>
</li>

<li>''Activate'' the environment and save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following commands:
<bash>source etc/bashrc

echo "alias of16ext='source \$HOME/OpenFOAM/OpenFOAM-1.6-ext/etc/bashrc'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM 1.6-ext|of16ext}}
</li>

<li>Now we need avoid building cmake, so first go into the {{tt|ThirdParty}} folder:
<bash>cd ThirdParty</bash>
Then run:
<bash>sed -i 's=^( rpm_make -p cmake=#( rpm_make -p cmake=' AllMake.stage1</bash>
</li>

<li>Build the several stages of the {{tt|ThirdParty}} folder in a single go:
<bash># This next command will take a while... somewhere between 5 to 30 minutes
./AllMake > log.AllMake 2>&1

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

<li>To check if everything went well:
<bash>#Edit the file "log.AllMake" and check if there are any error messages
#Example:
gedit log.AllMake

#Create a tarball in case you've seen any errors (it's the first error that matters)
#or if you don't understand the output
#and attach the file "log.AllMake.tar.gz" to a post in the designated thread
tar -czf log.AllMake.tar.gz log.AllMake
</bash></li>

<li>Now let's build 1.6-ext:
<bash>#Go back to the main folder and update the environment
cd ..
source etc/bashrc

# 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 you can go read the User Guide, which is located at {{tt|$HOME/OpenFOAM/OpenFOAM-1.6-ext/doc/Guides-a4/UserGuide.pdf}}.</li>
</ol>


{{Installation/Linux/AliasReminder|OpenFOAM 1.6-ext|of16ext}}


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

== Ubuntu 13.04 ==

Here you have a few choices:
* You can install from source, by either:
** Adapting the available official instructions that are for Ubuntu 12.04 (keeping in mind you're trying to install on Ubuntu 13.04), from one of these repositories:
*** [http://sourceforge.net/p/openfoam-extend/OpenFOAM-1.6-ext/ci/1.6.1/tree/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at the official Extend repository]
*** [http://repo.or.cz/w/openfoam-extend-OpenFOAM-1.6-ext.git/tree/1.6.1:/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at repo.or.cz mirror]
*** [https://github.com/Unofficial-Extend-Project-Mirror/openfoam-extend-OpenFOAM-1.6-ext/tree/1.6.1/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at Unofficial-Extend-Project-Mirror@github mirror]
*** '''Note''': Before following any of the instructions above, check the section [[../#Note regarding foam-extend-3.0|Note regarding foam-extend-3.0]]
** Or by following the detailed step-by-step instructions below (which has been based on the instructions from previous link)...


'''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 flex bison rpm build-essential zlib1g-dev binutils-dev \
openmpi-bin libopenmpi-dev paraview libscotch-dev cmake libstdc++5

#just in case, make sure to uninstall the "gold" binutils version
apt-get remove binutils-gold
</bash>
</li>

{{Installation/Linux/ExitRoot}}

<li>Set-up the base folder where OpenFOAM-1.6-ext will be installed (here you can copy-paste all in single go):
<bash>cd ~
mkdir OpenFOAM
cd OpenFOAM
</bash></li>

{{Installation/Linux/OpenFOAM-1.6-ext/Mirrors}}

<li>After the cloning is complete, go into the cloned folder and checkout the commit associated to {{tt|1.6.1}}, so that the correct 1.6-ext version is used:
<bash>cd OpenFOAM-1.6-ext
git checkout 1.6.1 -b 16ext</bash></li>

<li>Configure the preferences file:
<bash>cp etc/prefs.sh-EXAMPLE etc/prefs.sh

#Use the system compiler and configure to use Gcc 4.7
sed -i s/"compilerInstall=System"/"compilerInstall=System"/g etc/prefs.sh
echo "export WM_COMPILER=Gcc47" >> etc/prefs.sh

# Use the system installation of OpenMPI
sed -i s/"#export WM_MPLIB=SYSTEMOPENMPI"/"export WM_MPLIB=SYSTEMOPENMPI"/g etc/prefs.sh
sed -i s/"#export OPENMPI_DIR=path_to_system_installed_openmpi"/"export OPENMPI_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export OPENMPI_BIN_DIR"/"export OPENMPI_BIN_DIR"/g etc/prefs.sh

# Use the system's ParaView
sed -i s/"#export PARAVIEW_SYSTEM=1"/"export PARAVIEW_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export PARAVIEW_DIR=path_to_system_installed_paraview"/"export PARAVIEW_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export PARAVIEW_BIN_DIR"/"export PARAVIEW_BIN_DIR"/g etc/prefs.sh

# Use the system's Scotch
sed -i s/"#export SCOTCH_SYSTEM=1"/"export SCOTCH_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export SCOTCH_DIR=path_to_system_installed_scotch"/"export SCOTCH_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export SCOTCH"/"export SCOTCH"/g etc/prefs.sh
sed -i 's-SCOTCH_DIR/include$-SCOTCH_DIR/include/scotch-g' etc/prefs.sh

# Use the system's CMake
sed -i s/"#export CMAKE_SYSTEM=1"/"export CMAKE_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export CMAKE_DIR=path_to_system_installed_cmake"/"export CMAKE_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export CMAKE"/"export CMAKE"/g etc/prefs.sh

#here you can change 4 to the number of cores you've got
echo "export WM_NCOMPPROCS=4" >> etc/prefs.sh
</bash></li>

<li>Now to do several more necessary fixes: 
<bash>#we'll need to switch to the internal reader for ParaView
sed -i -e 's=\.OpenFOAM=\.foam=' bin/paraFoam
sed -i -e 's/^unset/export LC_ALL=C; unset/' bin/paraFoam

#Create a symbolic link for gmake
ln -s /usr/bin/make bin/gmake

#disable X dependencies in tecio
sed -i -e 's=\(U_WIN32\)$=\1 -DENGINE=g' \
 applications/utilities/postProcessing/dataConversion/foamToTecplot360/tecio/tecsrc/Make/tecioOptions

#Fix the link for Mesquite
sed -i -e 's=software.sandia.gov/~jakraft=downloads.sourceforge.net/project/openfoam-extend/foam-extend-3.0/ThirdParty=g' \
  ThirdParty/AllMake.stage3 ThirdParty/rpmBuild/SPECS/mesquite-2.1.2.spec
</bash></li>

<li>For building 1.6-ext itself, it depends on whether you have installed the i686 or x86_64 architecture of Ubuntu. To check this, run:
<bash>uname -m</bash>
Now, accordingly:
<ul {{NoIndentStyle}}>
<li>For i686:
<bash>echo "export WM_ARCH_OPTION=32" >> etc/prefs.sh

#copy the rules from ''Gcc46'' to ''Gcc47''
cp -r wmake/rules/linuxGcc46 wmake/rules/linuxGcc47

# due to stricter name lookup rules in 4.7 we need to tell the compiler to lighten up on this
sed -i 's/^\(c++FLAGS.*\)/\1 -fpermissive/g' wmake/rules/linuxGcc47/c++
</bash>
Note: fix for the {{tt|c++}} file was retrieved from [http://www.cfd-online.com/Forums/openfoam-installation/108486-walkthrough-installation-openfoam-1-6-ext-opensuse-12-2-64-bit.html here].</li>

<li>For x86_64:
<bash>#copy the rules from ''Gcc46'' to ''Gcc47''
cp -r wmake/rules/linux64Gcc46 wmake/rules/linux64Gcc47

# due to stricter name lookup rules in 4.7 we need to tell the compiler to lighten up on this
sed -i 's/^\(c++FLAGS.*\)/\1 -fpermissive/g' wmake/rules/linux64Gcc47/c++
</bash>
Note: fix for the {{tt|c++}} file was retrieved from [http://www.cfd-online.com/Forums/openfoam-installation/108486-walkthrough-installation-openfoam-1-6-ext-opensuse-12-2-64-bit.html here].</li>
</ul>
</li>

<li>''Activate'' the environment and save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following commands:
<bash>source etc/bashrc

echo "alias of16ext='source \$HOME/OpenFOAM/OpenFOAM-1.6-ext/etc/bashrc'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM 1.6-ext|of16ext}}
</li>

<li>Now we need avoid building cmake, so first go into the {{tt|ThirdParty}} folder:
<bash>cd ThirdParty</bash>
Then run:
<bash>sed -i 's=^( rpm_make -p cmake=#( rpm_make -p cmake=' AllMake.stage1</bash>
</li>

<li>Build the several stages of the {{tt|ThirdParty}} folder in a single go:
<bash># This next command will take a little while... somewhere between 5 and 30 minutes
./AllMake > log.AllMake 2>&1

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

<li>To check if everything went well:
<bash>#Edit the file "log.AllMake" and check if there are any error messages
#Example:
gedit log.AllMake

#Create a tarball in case you've seen any errors (it's the first error that matters)
#or if you don't understand the output
#and attach the file "log.AllMake.tar.gz" to a post in the designated thread
tar -czf log.AllMake.tar.gz log.AllMake
</bash></li>

<li>Now let's build 1.6-ext:
<bash>#Go back to the main folder and update the environment
cd ..
source etc/bashrc

# 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 you can go read the User Guide, which is located at {{tt|$HOME/OpenFOAM/OpenFOAM-1.6-ext/doc/Guides-a4/UserGuide.pdf}}.</li>
</ol>


{{Installation/Linux/AliasReminder|OpenFOAM 1.6-ext|of16ext}}


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

== Ubuntu 13.10 ==

Here you have a few choices:
* You can install from source, by either:
** Adapting the available official instructions that are for Ubuntu 12.04 (keeping in mind you're trying to install on Ubuntu 13.10), from one of these repositories:
*** [http://sourceforge.net/p/openfoam-extend/OpenFOAM-1.6-ext/ci/1.6.1/tree/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at the official Extend repository]
*** [http://repo.or.cz/w/openfoam-extend-OpenFOAM-1.6-ext.git/tree/1.6.1:/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at repo.or.cz mirror]
*** [https://github.com/Unofficial-Extend-Project-Mirror/openfoam-extend-OpenFOAM-1.6-ext/tree/1.6.1/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at Unofficial-Extend-Project-Mirror@github mirror]
*** '''Note''': Before following any of the instructions above, check the section [[../#Note regarding foam-extend-3.0|Note regarding foam-extend-3.0]]
** Or by following the detailed step-by-step instructions below (which has been based on the instructions from previous link)...


'''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-installation/127408-openfoam-1-6-ext.html OpenFOAM 1.6 ext]

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

<li>Install the necessary packages:
<bash>apt-get install git flex bison rpm build-essential zlib1g-dev binutils-dev \
openmpi-bin libopenmpi-dev paraview libscotch-dev cmake libstdc++5
</bash>
</li>

{{Installation/Linux/ExitRoot}}

<li>Set-up the base folder where OpenFOAM-1.6-ext will be installed (here you can copy-paste all in single go):
<bash>cd ~
mkdir OpenFOAM
cd OpenFOAM
</bash></li>

{{Installation/Linux/OpenFOAM-1.6-ext/Mirrors}}

<li>After the cloning is complete, go into the cloned folder and checkout the commit associated to {{tt|1.6.1}}, so that the correct 1.6-ext version is used:
<bash>cd OpenFOAM-1.6-ext
git checkout 1.6.1 -b 16ext</bash></li>

<li>Configure the preferences file:
<bash>cp etc/prefs.sh-EXAMPLE etc/prefs.sh

#Use the system compiler and configure to use Gcc 4.8
sed -i s/"compilerInstall=System"/"compilerInstall=System"/g etc/prefs.sh
echo "export WM_COMPILER=Gcc48" >> etc/prefs.sh

# Use the system installation of OpenMPI
sed -i s/"#export WM_MPLIB=SYSTEMOPENMPI"/"export WM_MPLIB=SYSTEMOPENMPI"/g etc/prefs.sh
sed -i s/"#export OPENMPI_DIR=path_to_system_installed_openmpi"/"export OPENMPI_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export OPENMPI_BIN_DIR"/"export OPENMPI_BIN_DIR"/g etc/prefs.sh

# Use the system's ParaView
sed -i s/"#export PARAVIEW_SYSTEM=1"/"export PARAVIEW_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export PARAVIEW_DIR=path_to_system_installed_paraview"/"export PARAVIEW_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export PARAVIEW_BIN_DIR"/"export PARAVIEW_BIN_DIR"/g etc/prefs.sh

# Use the system's Scotch
sed -i s/"#export SCOTCH_SYSTEM=1"/"export SCOTCH_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export SCOTCH_DIR=path_to_system_installed_scotch"/"export SCOTCH_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export SCOTCH"/"export SCOTCH"/g etc/prefs.sh
sed -i 's-SCOTCH_DIR/include$-SCOTCH_DIR/include/scotch-g' etc/prefs.sh

# Use the system's CMake
sed -i s/"#export CMAKE_SYSTEM=1"/"export CMAKE_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export CMAKE_DIR=path_to_system_installed_cmake"/"export CMAKE_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export CMAKE"/"export CMAKE"/g etc/prefs.sh

#here you can change 4 to the number of cores you've got
echo "export WM_NCOMPPROCS=4" >> etc/prefs.sh
</bash></li>

<li>Now to do several more necessary fixes: 
<bash>#we'll need to switch to the internal reader for ParaView
sed -i -e 's=\.OpenFOAM=\.foam=' bin/paraFoam
sed -i -e 's/^unset/export LC_ALL=C; unset/' bin/paraFoam

#Create a symbolic link for gmake
ln -s /usr/bin/make bin/gmake

#disable X dependencies in tecio
sed -i -e 's=\(U_WIN32\)$=\1 -DENGINE=g' \
 applications/utilities/postProcessing/dataConversion/foamToTecplot360/tecio/tecsrc/Make/tecioOptions

#Fix the link for Mesquite
sed -i -e 's=software.sandia.gov/~jakraft=downloads.sourceforge.net/project/openfoam-extend/foam-extend-3.0/ThirdParty=g' \
  ThirdParty/AllMake.stage3 ThirdParty/rpmBuild/SPECS/mesquite-2.1.2.spec
</bash></li>

<li>For building 1.6-ext itself, it depends on whether you have installed the i686 or x86_64 architecture of Ubuntu. To check this, run:
<bash>uname -m</bash>
Now, accordingly:
<ul {{NoIndentStyle}}>
<li>For i686:
<bash>echo "export WM_ARCH_OPTION=32" >> etc/prefs.sh

#copy the rules from ''Gcc46'' to ''Gcc48''
cp -r wmake/rules/linuxGcc46 wmake/rules/linuxGcc48

# due to stricter name lookup rules in 4.8 we need to tell the compiler to lighten up on this
sed -i 's/^\(c++FLAGS.*\)/\1 -fpermissive/g' wmake/rules/linuxGcc48/c++
</bash>
Note: fix for the {{tt|c++}} file was retrieved from [http://www.cfd-online.com/Forums/openfoam-installation/108486-walkthrough-installation-openfoam-1-6-ext-opensuse-12-2-64-bit.html here].</li>

<li>For x86_64:
<bash>#copy the rules from ''Gcc46'' to ''Gcc48''
cp -r wmake/rules/linux64Gcc46 wmake/rules/linux64Gcc48

# due to stricter name lookup rules in 4.8 we need to tell the compiler to lighten up on this
sed -i 's/^\(c++FLAGS.*\)/\1 -fpermissive/g' wmake/rules/linux64Gcc48/c++
</bash>
Note: fix for the {{tt|c++}} file was retrieved from [http://www.cfd-online.com/Forums/openfoam-installation/108486-walkthrough-installation-openfoam-1-6-ext-opensuse-12-2-64-bit.html here].</li>
</ul>
</li>

<li>''Activate'' the environment and save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following commands:
<bash>source etc/bashrc

echo "alias of16ext='source \$HOME/OpenFOAM/OpenFOAM-1.6-ext/etc/bashrc'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM 1.6-ext|of16ext}}
</li>

<li>Now we need avoid building cmake, so first go into the {{tt|ThirdParty}} folder:
<bash>cd ThirdParty</bash>
Then run:
<bash>sed -i 's=^( rpm_make -p cmake=#( rpm_make -p cmake=' AllMake.stage1</bash>
</li>

<li>A few fixes are necessary for building some of the third-party applications/libraries:
<bash>sed -i -e 's/\(\+.*LIBS = \)/\1-Xlinker --add-needed -Xlinker --no-as-needed /' ./rpmBuild/SOURCES/ParMGridGen-1.0.patch

sed -i -e 's/\(\+.*LIBS = \)/\1-Xlinker --add-needed -Xlinker --no-as-needed /' ./rpmBuild/SOURCES/ParMetis-3.1.1.patch
</bash>
</li>

<li>Build the several stages of the {{tt|ThirdParty}} folder in a single go:
<bash># This next command will take a little while... somewhere between 5 and 30 minutes
./AllMake > log.AllMake 2>&1

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

<li>To check if everything went well:
<bash>#Edit the file "log.AllMake" and check if there are any error messages
#Example:
gedit log.AllMake

#Create a tarball in case you've seen any errors (it's the first error that matters)
#or if you don't understand the output
#and attach the file "log.AllMake.tar.gz" to a post in the designated thread
tar -czf log.AllMake.tar.gz log.AllMake
</bash></li>

<li>Now let's build 1.6-ext:
<bash>#Go back to the main folder and update the environment
cd ..
source etc/bashrc

# 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 you can go read the User Guide, which is located at {{tt|$HOME/OpenFOAM/OpenFOAM-1.6-ext/doc/Guides-a4/UserGuide.pdf}}.</li>
</ol>


{{Installation/Linux/AliasReminder|OpenFOAM 1.6-ext|of16ext}}


'''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-installation/127408-openfoam-1-6-ext.html OpenFOAM 1.6 ext]

== Ubuntu 14.04 ==

Here you have a few choices:
* You can install from source, by either:
** Adapting the available official instructions that are for Ubuntu 12.04 (keeping in mind you're trying to install on Ubuntu 13.10), from one of these repositories:
*** [http://sourceforge.net/p/openfoam-extend/OpenFOAM-1.6-ext/ci/1.6.1/tree/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at the official Extend repository]
*** [http://repo.or.cz/w/openfoam-extend-OpenFOAM-1.6-ext.git/tree/1.6.1:/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at repo.or.cz mirror]
*** [https://github.com/Unofficial-Extend-Project-Mirror/openfoam-extend-OpenFOAM-1.6-ext/tree/1.6.1/doc/buildInstructions/Ubuntu/12.04 Building Instructions for Ubuntu 12.04 at Unofficial-Extend-Project-Mirror@github mirror]
*** '''Note''': Before following any of the instructions above, check the section [[../#Note regarding foam-extend-3.0|Note regarding foam-extend-3.0]]
** Or by following the detailed step-by-step instructions below (which has been based on the instructions from previous link)...


'''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-installation/127408-openfoam-1-6-ext.html OpenFOAM 1.6 ext]

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

<li>Install the necessary packages:
<bash>apt-get install git flex bison rpm build-essential zlib1g-dev binutils-dev \
openmpi-bin libopenmpi-dev paraview libscotch-dev cmake libstdc++5 libiberty-dev
</bash>
(''A shout-out to [http://www.cfd-online.com/Forums/members/nacholarrabide.html nacholarrabide] for the missing package {{tt|libiberty-dev}} and requesting this section for Ubuntu 14.04 to be added.'')
</li>

{{Installation/Linux/ExitRoot}}

<li>Set-up the base folder where OpenFOAM-1.6-ext will be installed (here you can copy-paste all in single go):
<bash>cd ~
mkdir OpenFOAM
cd OpenFOAM
</bash></li>

{{Installation/Linux/OpenFOAM-1.6-ext/Mirrors}}

<li>After the cloning is complete, go into the cloned folder and checkout the commit associated to {{tt|1.6.1}}, so that the correct 1.6-ext version is used:
<bash>cd OpenFOAM-1.6-ext
git checkout 1.6.1 -b 16ext</bash></li>

<li>Configure the preferences file:
<bash>cp etc/prefs.sh-EXAMPLE etc/prefs.sh

#Use the system compiler and configure to use Gcc 4.8
sed -i s/"compilerInstall=System"/"compilerInstall=System"/g etc/prefs.sh
echo "export WM_COMPILER=Gcc48" >> etc/prefs.sh

# Use the system installation of OpenMPI
sed -i s/"#export WM_MPLIB=SYSTEMOPENMPI"/"export WM_MPLIB=SYSTEMOPENMPI"/g etc/prefs.sh
sed -i s/"#export OPENMPI_DIR=path_to_system_installed_openmpi"/"export OPENMPI_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export OPENMPI_BIN_DIR"/"export OPENMPI_BIN_DIR"/g etc/prefs.sh

# Use the system's ParaView
sed -i s/"#export PARAVIEW_SYSTEM=1"/"export PARAVIEW_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export PARAVIEW_DIR=path_to_system_installed_paraview"/"export PARAVIEW_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export PARAVIEW_BIN_DIR"/"export PARAVIEW_BIN_DIR"/g etc/prefs.sh

# Use the system's Scotch
sed -i s/"#export SCOTCH_SYSTEM=1"/"export SCOTCH_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export SCOTCH_DIR=path_to_system_installed_scotch"/"export SCOTCH_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export SCOTCH"/"export SCOTCH"/g etc/prefs.sh
sed -i 's-SCOTCH_DIR/include$-SCOTCH_DIR/include/scotch-g' etc/prefs.sh

# Use the system's CMake
sed -i s/"#export CMAKE_SYSTEM=1"/"export CMAKE_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export CMAKE_DIR=path_to_system_installed_cmake"/"export CMAKE_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export CMAKE"/"export CMAKE"/g etc/prefs.sh

#here you can change 4 to the number of cores you've got
echo "export WM_NCOMPPROCS=4" >> etc/prefs.sh
</bash></li>

<li>Now to do several more necessary fixes: 
<bash>#we'll need to switch to the internal reader for ParaView
sed -i -e 's=\.OpenFOAM=\.foam=' bin/paraFoam
sed -i -e 's/^unset/export LC_ALL=C; unset/' bin/paraFoam

#Create a symbolic link for gmake
ln -s /usr/bin/make bin/gmake

#disable X dependencies in tecio
sed -i -e 's=\(U_WIN32\)$=\1 -DENGINE=g' \
 applications/utilities/postProcessing/dataConversion/foamToTecplot360/tecio/tecsrc/Make/tecioOptions

#Fix the link for Mesquite
sed -i -e 's=software.sandia.gov/~jakraft=downloads.sourceforge.net/project/openfoam-extend/foam-extend-3.0/ThirdParty=g' \
  ThirdParty/AllMake.stage3 ThirdParty/rpmBuild/SPECS/mesquite-2.1.2.spec
</bash></li>

<li>For building 1.6-ext itself, it depends on whether you have installed the i686 or x86_64 architecture of Ubuntu. To check this, run:
<bash>uname -m</bash>
Now, accordingly:
<ul {{NoIndentStyle}}>
<li>For i686:
<bash>echo "export WM_ARCH_OPTION=32" >> etc/prefs.sh

#copy the rules from ''Gcc46'' to ''Gcc48''
cp -r wmake/rules/linuxGcc46 wmake/rules/linuxGcc48

# due to stricter name lookup rules in 4.8 we need to tell the compiler to lighten up on this
sed -i 's/^\(c++FLAGS.*\)/\1 -fpermissive/g' wmake/rules/linuxGcc48/c++
</bash>
Note: fix for the {{tt|c++}} file was retrieved from [http://www.cfd-online.com/Forums/openfoam-installation/108486-walkthrough-installation-openfoam-1-6-ext-opensuse-12-2-64-bit.html here].</li>

<li>For x86_64:
<bash>#copy the rules from ''Gcc46'' to ''Gcc48''
cp -r wmake/rules/linux64Gcc46 wmake/rules/linux64Gcc48

# due to stricter name lookup rules in 4.8 we need to tell the compiler to lighten up on this
sed -i 's/^\(c++FLAGS.*\)/\1 -fpermissive/g' wmake/rules/linux64Gcc48/c++
</bash>
Note: fix for the {{tt|c++}} file was retrieved from [http://www.cfd-online.com/Forums/openfoam-installation/108486-walkthrough-installation-openfoam-1-6-ext-opensuse-12-2-64-bit.html here].</li>
</ul>
</li>

<li>''Activate'' the environment and save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following commands:
<bash>source etc/bashrc

echo "alias of16ext='source \$HOME/OpenFOAM/OpenFOAM-1.6-ext/etc/bashrc'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM 1.6-ext|of16ext}}
</li>

<li>Now we need avoid building cmake, so first go into the {{tt|ThirdParty}} folder:
<bash>cd ThirdParty</bash>
Then run:
<bash>sed -i 's=^( rpm_make -p cmake=#( rpm_make -p cmake=' AllMake.stage1</bash>
</li>

<li>A few fixes are necessary for building some of the third-party applications/libraries:
<bash>sed -i -e 's/\(\+.*LIBS = \)/\1-Xlinker --add-needed -Xlinker --no-as-needed /' ./rpmBuild/SOURCES/ParMGridGen-1.0.patch

sed -i -e 's/\(\+.*LIBS = \)/\1-Xlinker --add-needed -Xlinker --no-as-needed /' ./rpmBuild/SOURCES/ParMetis-3.1.1.patch
</bash>
</li>

<li>Build the several stages of the {{tt|ThirdParty}} folder in a single go:
<bash># This next command will take a little while... somewhere between 5 and 30 minutes
./AllMake > log.AllMake 2>&1

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

<li>To check if everything went well:
<bash>#Edit the file "log.AllMake" and check if there are any error messages
#Example:
gedit log.AllMake

#Create a tarball in case you've seen any errors (it's the first error that matters)
#or if you don't understand the output
#and attach the file "log.AllMake.tar.gz" to a post in the designated thread
tar -czf log.AllMake.tar.gz log.AllMake
</bash></li>

<li>Now let's build 1.6-ext:
<bash>#Go back to the main folder and update the environment
cd ..
source etc/bashrc

# 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 you can go read the User Guide, which is located at {{tt|$HOME/OpenFOAM/OpenFOAM-1.6-ext/doc/Guides-a4/UserGuide.pdf}}.</li>
</ol>


{{Installation/Linux/AliasReminder|OpenFOAM 1.6-ext|of16ext}}


'''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-installation/127408-openfoam-1-6-ext.html OpenFOAM 1.6 ext]

<br>
== Ubuntu 16.04 ==

Here you have a few choices:
* You can install from source, by either checking the instructions referred in the previous sections above...
* Or by following the detailed step-by-step instructions below (which has been based on the instructions from previous link)...


'''Discussion thread where you can ask questions about these steps''': [https://www.cfd-online.com/Forums/openfoam-installation/207867-foam-extend-1-6-scotchdecomp-error-while-compiling-ubuntu-16-04-a.html#post709300  foam-extend 1.6: ScotchDecomp error while compiling on Ubuntu 16.04]

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

<li>Install the necessary packages:
<bash>apt-get install git flex rpm build-essential zlib1g-dev binutils-dev \
openmpi-bin libopenmpi-dev cmake paraview libstdc++5 libiberty-dev
</bash>
</li>

{{Installation/Linux/ExitRoot}}

<li>Set-up the base folder where OpenFOAM-1.6-ext will be installed (here you can copy-paste all in single go):
<bash>cd ~
mkdir OpenFOAM
cd OpenFOAM
</bash></li>

{{Installation/Linux/OpenFOAM-1.6-ext/Mirrors}}

<li>After the cloning is complete, go into the cloned folder and checkout the commit associated to {{tt|1.6.1}}, so that the correct 1.6-ext version is used:
<bash>cd OpenFOAM-1.6-ext
git checkout 1.6.1 -b 16ext</bash></li>

<li>Configure the preferences file:
<bash>cp etc/prefs.sh-EXAMPLE etc/prefs.sh

#Use the system compiler and configure to use Gcc 5.4
echo "export WM_COMPILER=Gcc54" >> etc/prefs.sh

# Use the system installation of OpenMPI
sed -i s/"#export WM_MPLIB=SYSTEMOPENMPI"/"export WM_MPLIB=SYSTEMOPENMPI"/g etc/prefs.sh
sed -i s/"#export OPENMPI_DIR=path_to_system_installed_openmpi"/"export OPENMPI_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export OPENMPI_BIN_DIR"/"export OPENMPI_BIN_DIR"/g etc/prefs.sh

# Use the system's ParaView
sed -i s/"#export PARAVIEW_SYSTEM=1"/"export PARAVIEW_SYSTEM=1"/g etc/prefs.sh
sed -i s/"#export PARAVIEW_DIR=path_to_system_installed_paraview"/"export PARAVIEW_DIR=\/usr"/g etc/prefs.sh
sed -i s/"^#export PARAVIEW_BIN_DIR"/"export PARAVIEW_BIN_DIR"/g etc/prefs.sh

#here you can change 4 to the number of cores you've got
echo "export WM_NCOMPPROCS=4" >> etc/prefs.sh
</bash></li>

<li>Now to do several more necessary fixes: 
<bash>#we'll need to switch to the internal reader for ParaView
sed -i -e 's=\.OpenFOAM=\.foam=' bin/paraFoam
sed -i -e 's/^unset/export LC_ALL=C; unset/' bin/paraFoam

#Create a symbolic link for gmake
ln -s /usr/bin/make bin/gmake

#disable X dependencies in tecio
sed -i -e 's=\(U_WIN32\)$=\1 -DENGINE=g' \
 applications/utilities/postProcessing/dataConversion/foamToTecplot360/tecio/tecsrc/Make/tecioOptions

#Fix the link for Mesquite
sed -i -e 's=software.sandia.gov/~jakraft=downloads.sourceforge.net/project/openfoam-extend/foam-extend-3.0/ThirdParty=g' \
  ThirdParty/AllMake.stage3 ThirdParty/rpmBuild/SPECS/mesquite-2.1.2.spec

#Fix for Flex version detection
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>For building 1.6-ext itself, it depends on whether you have installed the i686 or x86_64 architecture of Ubuntu. To check this, run:
<bash>uname -m</bash>
Now, accordingly:
<ul {{NoIndentStyle}}>
<li>For i686:
<bash>echo "export WM_ARCH_OPTION=32" >> etc/prefs.sh

#copy the rules from ''Gcc46'' to ''Gcc54''
cp -r wmake/rules/linuxGcc46 wmake/rules/linuxGcc54

# due to stricter name lookup rules in GCC 4.8 and newer, we need to tell the compiler to lighten up on this
sed -i 's/^\(c++FLAGS.*\)/\1 -fpermissive/g' wmake/rules/linuxGcc54/c++
</bash>
Note: fix for the {{tt|c++}} file was retrieved from [http://www.cfd-online.com/Forums/openfoam-installation/108486-walkthrough-installation-openfoam-1-6-ext-opensuse-12-2-64-bit.html here].</li>

<li>For x86_64:
<bash>#copy the rules from ''Gcc46'' to ''Gcc54''
cp -r wmake/rules/linux64Gcc46 wmake/rules/linux64Gcc54

# due to stricter name lookup rules in GCC 4.8 and newer, we need to tell the compiler to lighten up on this
sed -i 's/^\(c++FLAGS.*\)/\1 -fpermissive/g' wmake/rules/linux64Gcc54/c++
</bash>
Note: fix for the {{tt|c++}} file was retrieved from [http://www.cfd-online.com/Forums/openfoam-installation/108486-walkthrough-installation-openfoam-1-6-ext-opensuse-12-2-64-bit.html here].</li>
</ul>
</li>

<li>''Activate'' the environment and save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following commands:
<bash>source etc/bashrc

echo "alias of16ext='source \$HOME/OpenFOAM/OpenFOAM-1.6-ext/etc/bashrc'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM 1.6-ext|of16ext}}
</li>

<li>Now we need avoid building cmake, so first go into the {{tt|ThirdParty}} folder:
<bash>cd ThirdParty</bash>
Then run:
<bash>sed -i 's=^( rpm_make -p cmake=#( rpm_make -p cmake=' AllMake.stage1</bash>
</li>

<li>A few fixes are necessary for building some of the third-party applications/libraries:
<bash>sed -i -e 's/\(\+.*LIBS = \)/\1-Xlinker --add-needed -Xlinker --no-as-needed /' ./rpmBuild/SOURCES/ParMGridGen-1.0.patch

sed -i -e 's/\(\+.*LIBS = \)/\1-Xlinker --add-needed -Xlinker --no-as-needed /' ./rpmBuild/SOURCES/ParMetis-3.1.1.patch

sed -i -e 's=$(LDFLAGS)=$(LDFLAGS) -pthread=' ./rpmBuild/SOURCES/scotch-5.1.10b_patch_0
</bash>
</li>

<li>Build the several stages of the {{tt|ThirdParty}} folder in a single go:
<bash># This next command will take a little while... somewhere between 5 and 30 minutes
./AllMake > log.AllMake 2>&1

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

<li>To check if everything went well:
<bash>#Edit the file "log.AllMake" and check if there are any error messages
#Example:
gedit log.AllMake

#Create a tarball in case you've seen any errors (it's the first error that matters)
#or if you don't understand the output
#and attach the file "log.AllMake.tar.gz" to a post in the designated thread
tar -czf log.AllMake.tar.gz log.AllMake
</bash></li>

<li>Now let's build 1.6-ext:
<bash>#Go back to the main folder and update the environment
cd ..
source etc/bashrc

# 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 you can go read the User Guide, which is located at {{tt|$HOME/OpenFOAM/OpenFOAM-1.6-ext/doc/Guides-a4/UserGuide.pdf}}.</li>
</ol>


{{Installation/Linux/AliasReminder|OpenFOAM 1.6-ext|of16ext}}


'''Discussion thread where you can ask questions about these steps''': [https://www.cfd-online.com/Forums/openfoam-installation/207867-foam-extend-1-6-scotchdecomp-error-while-compiling-ubuntu-16-04-a.html#post709300  foam-extend 1.6: ScotchDecomp error while compiling on Ubuntu 16.04]



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