View source for Installation/Linux/OpenFOAM-1.5.x/Ubuntu

= Introduction =
This page is dedicated to explaining how to install {{OpenFOAM}} {{version1.5.x}} in 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 12.04 ==

'''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-installation/86225-openfoam-1-5-ubuntu-10-04-a.html http://www.cfd-online.com/Forums/openfoam-installation/86225-openfoam-1-5-ubuntu-10-04-a.html]

Steps:
<ol>
<li>'''Note''': Given the age difference of OpenFOAM 1.5.x vs Ubuntu 12.04, these instructions will install the ParaView version that Ubuntu provides.</li>
{{Installation/Linux/SwitchToRoot}}
{{Installation/Linux/AptGetUpdate}}
<li>Install the necessary packages:
<bash>apt-get install libglib2.0-dev build-essential flex bison libreadline-dev libncurses5-dev paraview git

#if you have Ubuntu 64bit (see step #4)
apt-get install libc6-dev-i386
</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
wget "http://downloads.sourceforge.net/project/foam/foam/1.7.1/ThirdParty-1.7.1.gtgz" -O ThirdParty-1.7.1.gtgz

tar xzf ThirdParty-1.7.1.gtgz --transform 's=ThirdParty-1.7.1=ThirdParty-1.5.x='
</bash>
In addition, the necessary git repository can be retrieved with one of the following commands:
* Via Git protocol: <bash>git clone git://repo.or.cz/OpenFOAM-1.5.x.git</bash>
* Via HTTP protocol (useful when working behind firewalls): <bash>git clone http://repo.or.cz/r/OpenFOAM-1.5.x.git</bash>
</li>

<li>Now to do several more necessary fixes:
<ol>
<li>Go into OpenFOAM's main source folder:
<bash>cd OpenFOAM-1.5.x</bash>
</li>

<li>Upgrade several of the scripts at {{tt|etc}}:
<bash>cd etc

mv bashrc bashrc.orig
wget -c --no-check-certificate https://github.com/OpenCFD/OpenFOAM-1.7.x/raw/master/etc/bashrc
mv settings.sh settings.sh.orig
wget -c --no-check-certificate https://github.com/OpenCFD/OpenFOAM-1.7.x/raw/master/etc/settings.sh
mv aliases.sh aliases.sh.orig
wget -c --no-check-certificate https://github.com/OpenCFD/OpenFOAM-1.7.x/raw/master/etc/aliases.sh

sed -i -e 's_1\.7\.x_1.5.x_' -e 's_Gcc};_Gcc43};_' bashrc
sed -i -e 's_: ${compilerInstall:=system}_: ${compilerInstall:=OpenFOAM}_' settings.sh

#add an option that was valid back in 1.5 but not in 1.7
echo 'export WM_OS=Unix' >> bashrc

#we'll need this one for cleaning up the shell environment for ParaView
wget "https://raw.github.com/OpenFOAM/OpenFOAM-2.1.x/master/etc/config/unset.sh" -O unset.sh

cd ..
</bash>
</li>

<li>Now lets get some important things in the {{tt|bin}} folder:
<bash>cd bin
wget -c --no-check-certificate https://github.com/OpenCFD/OpenFOAM-1.7.x/raw/master/bin/foamEtcFile
chmod +x foamEtcFile

#because we're using Ubuntu's ParaView
mv paraFoam paraFoam.orig
wget -c --no-check-certificate https://github.com/OpenCFD/OpenFOAM-1.7.x/raw/master/bin/paraFoam
chmod +x paraFoam
sed -i -e 's=\.OpenFOAM=\.foam=' paraFoam
sed -i -e 's=^\(unset FOAM_ABORT\)=. $WM_PROJECT_DIR/etc/unset.sh 2>&1 ; \1=' paraFoam

#get the path checker, because we're going to need it for building Gcc
wget https://github.com/OpenCFD/OpenFOAM-1.7.x/raw/master/wmake/wmakeCheckPwd -O wmakeCheckPwd
chmod +x wmakeCheckPwd

cd ..
</bash>
</li>

<li>Adjust build rules to modern times:
<bash>cd wmake/rules
cp -r linux64Gcc linux64Gcc43
cp -r linuxGcc linuxGcc43
sed -i -e '/include $(GENERAL_RULES)\/java/d' General/standard
sed -i -e 's=/lib/cpp $(GFLAGS)=cpp -traditional-cpp $(GFLAGS)=' linuxGcc43/general
sed -i -e 's=/lib/cpp $(GFLAGS)=cpp -traditional-cpp $(GFLAGS)=' linux64Gcc43/general

cd ../..

#Remove all comments from "Make/options" and of some "Make/files"
find . -name 'options' | grep 'Make/options' | xargs sed -i -e '/^\/\//d'
sed -i -e 's=^//.*==' src/finiteVolume/Make/files
</bash>
</li>
</ol>
</li>


<li>For building OpenFOAM itself, it depends on whether you have installed the i386 or x86_64 architecture of Ubuntu. To check this, run:
<bash>uname -m</bash>
Now, accordingly:
<ul>
<li>For i386:
<bash>#here you can change 4 to the number of cores you've got
echo export WM_NCOMPPROCS=4 >> etc/bashrc

#we're building the 32bit version
sed -i -e 's/WM_ARCH_OPTION:=64/WM_ARCH_OPTION:=32/' etc/bashrc

#This is a hack for modern 32bit Ubuntu (http://www.lukedodd.com/?p=225)
echo 'export LIBRARY_PATH=/usr/lib/i386-linux-gnu:/lib/i386-linux-gnu' >> etc/bashrc
echo 'export C_INCLUDE_PATH=/usr/include/i386-linux-gnu' >> etc/bashrc
echo 'export CPLUS_INCLUDE_PATH=/usr/include/i386-linux-gnu' >> etc/bashrc

source etc/bashrc
</bash>
</li>

<li>For x86_64:
<bash>#here you can change 4 to the number of cores you've got
echo export WM_NCOMPPROCS=4 >> etc/bashrc

#This is a hack for modern 64bit Ubuntu (http://www.lukedodd.com/?p=225)
echo 'export LIBRARY_PATH=/usr/lib/x86_64-linux-gnu:/lib/x86_64-linux-gnu' >> etc/bashrc

source etc/bashrc
</bash>
</li>
</ul>
</li>

<li>Save an ''alias'' in the personal {{tt|.bashrc}} file, simply by running the following command:
<bash>echo "alias of15x='source \$HOME/OpenFOAM/OpenFOAM-1.5.x/etc/bashrc'" >> $HOME/.bashrc
</bash>
{{Installation/Linux/AliasNote|OpenFOAM 1.5.x|of15x}}
</li>

<li>Have to build Gcc 4.3.3 from source, because Ubuntu 12.04 doesn't have it:
<bash>#Go into the ThirdParty folder
cd ../ThirdParty-1.5.x

#Let's get a special compiler script
wget http://original.nucleation.googlecode.com/hg/build-gcc_v4.tar.gz -O build-gcc_v4.tar.gz
tar -xzf build-gcc_v4.tar.gz

#And this is going to build Gcc 4.3.3, along with downloading everyone that is needed
./build-gcc43 > log.gccmake 2>&1

#You can track the current progress in another terminal, by running:
#  tail -F log.gccmake
</bash>
</li>

<li>Now we need to do a first pass in building the {{tt|ThirdParty}} folder, where the second pass will be done when building OpenFOAM itself:
<bash>#update the shell environment
. ../OpenFOAM-1.5.x/etc/bashrc

#need to do some repairs in the Allwmake script
wget -c http://modular.nucleation.googlecode.com/hg/of17x/files/ThirdParty_Allwmake.diff
patch -p0 < ThirdParty_Allwmake.diff

# This next command will take a while... somewhere between 5 minutes to 60 minutes.
./Allwmake > log.make 2>&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 ../OpenFOAM-1.5.x

#update the shell environment
. 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>Update the shell environment one more time:
<bash>. etc/bashrc</bash></li>

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

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


{{Installation/Linux/AliasReminder|OpenFOAM 1.5.x|of15x}}


'''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-installation/86225-openfoam-1-5-ubuntu-10-04-a.html http://www.cfd-online.com/Forums/openfoam-installation/86225-openfoam-1-5-ubuntu-10-04-a.html]


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