|
|
(11 intermediate revisions by 3 users not shown) |
Line 1: |
Line 1: |
| = Introduction = | | = Introduction = |
− | This page is dedicated to explaining how to install {{-Extend}} {{version3.0-ext}} in [http://www.opensuse.org openSUSE]. | + | This page is dedicated to preparing an [http://www.opensuse.org openSUSE] system for installing {{-Extend}} {{version3.0-ext}}. |
− | | + | |
− | 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__ | | __FORCETOC__ |
| __TOC__ | | __TOC__ |
| | | |
− | = ''Copy-Paste'' steps =
| + | = openSUSE versions = |
− | | + | |
− | A few notes before you start copy-pasting:
| + | |
− | | + | |
− | # Lines that start with {{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!
| + | |
− | | + | |
− | | + | |
− | == openSUSE 12.1 ==
| + | |
− | | + | |
− | 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/foam-extend-3.0/ci/master/tree/doc/buildInstructions/openSUSE/12.1 Building Instructions for openSUSE 12.1 at the official Extend repository]
| + | |
− | *** [http://repo.or.cz/w/foam-extend-3.0.git/tree/master:/doc/buildInstructions/openSUSE/12.1 Building Instructions for openSUSE 12.1 at repo.or.cz mirror]
| + | |
− | *** [https://github.com/Unofficial-Extend-Project-Mirror/openfoam-extend-foam-extend-3.0/tree/master/doc/buildInstructions/openSUSE/12.1 Building Instructions for openSUSE 12.1 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]]
| + | |
− | | + | |
− | | + | |
− | == openSUSE 12.2 ==
| + | |
− | | + | |
− | Here you have a few choices:
| + | |
− | * You can install from source, by:
| + | |
− | ** Trying to follow the available official instructions for openSUSE 12.1, while taking into account it's openSUSE 12.2:
| + | |
− | *** [http://sourceforge.net/p/openfoam-extend/foam-extend-3.0/ci/master/tree/doc/buildInstructions/12.1 Building Instructions for openSUSE 12.1 at the official Extend repository]
| + | |
− | *** [http://repo.or.cz/w/foam-extend-3.0.git/tree/master:/doc/buildInstructions/openSUSE/12.1 Building Instructions for openSUSE 12.1 at repo.or.cz mirror]
| + | |
− | *** [https://github.com/Unofficial-Extend-Project-Mirror/openfoam-extend-foam-extend-3.0/tree/master/doc/buildInstructions/openSUSE/12.1 Building Instructions for openSUSE 12.1 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]]
| + | |
− | | + | |
| | | |
| == openSUSE 13.1 == | | == openSUSE 13.1 == |
− | | + | Follow these steps: |
− | Here you have a few choices:
| + | |
− | * You can install from source, by:
| + | |
− | ** Following the instructions available at the following thread at [http://www.cfd-online.com CFD-Online]: [http://www.cfd-online.com/Forums/openfoam-installation/128436-smooth-installation-foam-3-0-extend-opensuse-13-1-64-bits.html#post469686 A smooth installation of foam-3.0-extend on OpenSUSE 13.1 64-bits]
| + | |
− | ** 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''': ''none so far.''
| + | |
− | | + | |
− | Steps:
| + | |
| <ol> | | <ol> |
| {{Installation/Linux/SwitchToRoot}} | | {{Installation/Linux/SwitchToRoot}} |
Line 58: |
Line 18: |
| {{Installation/Linux/ExitRoot}} | | {{Installation/Linux/ExitRoot}} |
| | | |
− | <li>Set-up the base folder where foam-extend-3.0 will be installed (here you can copy-paste all in single go): | + | <li>'''Note''': In order for Open-MPI to be properly accessible, you will need to either logout and then log back in or run the following command in each terminal in the meantime: |
− | <bash>cd ~
| + | <bash>source /etc/profile.d/mpi-selector.sh</bash> |
− | mkdir foam
| + | |
− | cd foam
| + | |
− | </bash></li>
| + | |
− | | + | |
− | <li>The next command will depend on the repository mirror you want to use:
| + | |
− | * Extend's official repository: <bash>git clone git://git.code.sf.net/p/openfoam-extend/foam-extend-3.0 foam-extend-3.0</bash>
| + | |
− | * Extend's official repository (''https'' mode, if you're behind a firewall): <bash>git clone https://git.code.sf.net/p/openfoam-extend/foam-extend-3.0 foam-extend-3.0</bash>
| + | |
− | * Mirror at repo.or.cz repository: <bash>git clone git://repo.or.cz/openfoam-extend-foam-extend-3.0.git foam-extend-3.0.git foam-extend-3.0</bash>
| + | |
− | * Mirror at repo.or.cz repository (''http'' mode, if you're behind a firewall): <bash>git clone http://repo.or.cz/r/openfoam-extend-foam-extend-3.0.git foam-extend-3.0</bash>
| + | |
− | * Mirror Unofficial-Extend-Project-Mirror@github repository: <bash>git clone https://github.com/Unofficial-Extend-Project-Mirror/openfoam-extend-foam-extend-3.0.git foam-extend-3.0</bash>
| + | |
| </li> | | </li> |
− |
| |
− | <li>After the cloning is complete, go into the cloned folder and switch to the {{tt|master}} branch:
| |
− | <bash>cd foam-extend-3.0
| |
− | git checkout master</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\/lib64\/mpi\/gcc\/openmpi"/g etc/prefs.sh
| |
− | sed -i s/"#export OPENMPI_BIN_DIR"/"export OPENMPI_BIN_DIR=\$OPENMPI_DIR/bin"/g etc/prefs.sh
| |
− |
| |
− | # Use the system installation of Qt
| |
− | 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>For building 1.6-ext itself, it depends on whether you have installed the i686 or x86_64 architecture of openSUSE. To check this, run:
| |
− | <bash>uname -m</bash>
| |
− | Now, accordingly:
| |
− | <ul>
| |
− | <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++
| |
− |
| |
− | # repair broken template maximum
| |
− | sed -i 's/template-depth-40$/template-depth-80/' wmake/rules/linuxGcc48/c++
| |
− | </bash>
| |
− |
| |
− | <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++
| |
− |
| |
− | # repair broken template maximum
| |
− | sed -i 's/template-depth-40$/template-depth-80/' wmake/rules/linux64Gcc48/c++
| |
− | </bash>
| |
− |
| |
− | <li> Fix for the {{tt|c++}} file:
| |
− | <bash>git branch hotfix/gcc48
| |
− | git checkout hotfix/gcc48
| |
− | </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 it in the personal {{tt|.bashrc}} file:
| |
− | <bash>source etc/bashrc
| |
− |
| |
− | echo "alias fe30='source \$HOME/foam/foam-extend-3.0/etc/bashrc'" >> $HOME/.bashrc
| |
− | </bash>
| |
− | {{Installation/Linux/AliasNote|foam-extend 3.0|fe30}}
| |
− | </li>
| |
− |
| |
− | <li>Build the several stages of the {{tt|ThirdParty}} folder in a single go:
| |
− | <bash>cd ThirdParty
| |
− |
| |
− | # The next command will take a while
| |
− | ./AllMake.pre > log.AllMake 2>&1
| |
− |
| |
− | # Run it a second time for getting a summary of the installation
| |
− | ./AllMake.pre > 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 foam-extend-3.0:
| |
− | <bash># Go back to the main folder and update the environment
| |
− | cd ..
| |
− | source etc/bashrc
| |
− |
| |
− | # The next command will take a while... somewhere between 30 minutes to 3-6 hours.
| |
− | ./Allwmake.firstInstall > log.Allwmake.firstInstall 2>&1
| |
− |
| |
− | # Run it a second time for getting a summary of the installation
| |
− | ./Allwmake.firstInstall > log.Allwmake.firstInstall 2>&1
| |
− | </bash></li>
| |
− |
| |
− | <li>To check if everything went well:
| |
− | <bash># Check if icoFoam is working
| |
− | icoFoam -help
| |
− |
| |
− | # Edit the file "log.Allwmake.firstInstall" and check if there are any error messages
| |
− | # Example:
| |
− | gedit log.Allwmake.firstInstall
| |
− |
| |
− | # 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.Allwmake.firstInstall.tar.gz" to a post in the designated thread
| |
− | tar -czf log.Allwmake.firstInstall.tar.gz log.Allwmake.firstInstall
| |
− | </bash></li>
| |
− |
| |
− | <li>Now you can go read the User Guide, which is located at {{tt|$HOME/foam/foam-extend-3.0/doc/Guides-a4/UserGuide.pdf}}.</li>
| |
| </ol> | | </ol> |
| | | |
− | | + | Then continue following the instructions on the previous page, subsection [[Installation/Linux/foam-extend-3.0#Installing from source code|Get the source code]]. |
− | {{Installation/Linux/AliasReminder|foam-extend 3.0|fe30}}
| + | |
| | | |
| [[Category:Installing OpenFOAM on Linux]] [[Category:Installing OpenFOAM on openSUSE]] | | [[Category:Installing OpenFOAM on Linux]] [[Category:Installing OpenFOAM on openSUSE]] |