TestWyldckat

1 Introduction

This is a step by step guide on how to cross-compile OpenFOAM in Linux for Windows, for both 32 and 64 bits architectures (to and from), using the patches available here: File:PatchesNBatches.tar.gz.

These patches were based on Symscape's "v3" patch for OpenFOAM available here. They differ substantially from that patch, as well as the more recent one available here. The build scripts for mingw were also based on the build-script available on the 1.5.x link.

With this guide and available patches, you should be able to cross-compile the whole OpenFOAM library and applications, using MPICH2 instead of Open MPI for parallel computing. You can cross-compile using mingw32 and/or mingw-w64. These enable you to build OpenFOAM 1.6 for Windows 32 and 64 bit versions, from Linux 32 and 64bit architectures.

2 Get OpenFOAM packages

In your Linux machine, open a terminal window and create the folder $HOME/OpenFOAM.
Get OpenFOAM-1.6.General.gtgz and ThirdParty-1.6.General.gtgz from the OpenCFD's website and move them to the folder $HOME/OpenFOAM.

Extract both files, by running in a terminal:

cd $HOME/OpenFOAM
tar xzf OpenFOAM-1.6.General.gtgz
tar xzf ThirdParty-1.6.General.gtgz

3 Optional: Using a specific gcc version for building the wmake binaries

This is optional, because the current patch will use the system's gcc for building them (more specifically gcc as compiler name).

Edit $HOME/.bashrc and add the following line to the end of it:
```
. $HOME/OpenFOAM/OpenFOAM-1.6/etc/bashrc
```
NOTE: sometimes the leading dot doesn't work, so use the following instead:
```
source $HOME/OpenFOAM/OpenFOAM-1.6/etc/bashrc
```
1. You might want to edit $HOME/OpenFOAM/OpenFOAM-1.6/etc/bashrc and set the Linux architecture correctly, namely WM_ARCH_OPTION to 32 or 64.
Two possibilities are now available:
1. Use the system's gcc - edit $HOME/OpenFOAM/OpenFOAM-1.6/etc/settings.sh and change compilerInstall=OpenFOAM to compilerInstall=System.
2. Use the gcc that comes with the ThirdParty-1.6.General.gtgz package - again, two choices:
  1. You can compile the gcc by running the following line:
```
(cd $HOME/OpenFOAM/ThirdParty-1.6 && makeGcc gcc-4.3.3)
```
  2. Or by getting the available compiled version for your Linux version ( ThirdParty-1.6.linuxGcc.gtgz or ThirdParty-1.6.linux64Gcc.gtgz from OpenCFD's website).
3. launch a new terminal and run the following line, thus building wmkdep and dirToString:
```
(cd $HOME/OpenFOAM/OpenFOAM-1.6/wmake/src && make)
```

4 Applying patches

Copy the File:PatchesNBatches.tar.gz file into the $HOME/OpenFOAM folder. Then unpack it by running:
```
tar -xzf PatchesNBatches.tar.gz
```
A new folder is created, named pnb. Now to apply the patches, run from the $HOME/OpenFOAM folder:
```
patch -p0 < pnb/OpenFOAM-1.6_patch
patch -p0 < pnb/ThirdParty-1.6_patch
```

Still have to do some chmodding, for new scripts to run properly. Run the following lines in the terminal:

chmod 744 $HOME/OpenFOAM/ThirdParty-1.6/build-mingw32
chmod 744 $HOME/OpenFOAM/ThirdParty-1.6/build-mingw-w32
chmod 744 $HOME/OpenFOAM/ThirdParty-1.6/build-mingw-w64
chmod 744 $HOME/OpenFOAM/ThirdParty-1.6/build-mingw-w64-45
chmod 744 $HOME/OpenFOAM/ThirdParty-1.6/makeGcc44
chmod 744 $HOME/OpenFOAM/ThirdParty-1.6/get-mpich2
chmod 744 $HOME/OpenFOAM/OpenFOAM-1.6/src/mingwFunctions
chmod 744 $HOME/OpenFOAM/OpenFOAM-1.6/src/Allclean
chmod 744 $HOME/OpenFOAM/OpenFOAM-1.6/etc/bashrc-mingw32
chmod 744 $HOME/OpenFOAM/OpenFOAM-1.6/etc/bashrc-mingw-w32
chmod 744 $HOME/OpenFOAM/OpenFOAM-1.6/etc/bashrc-mingw-w32-prof
chmod 744 $HOME/OpenFOAM/OpenFOAM-1.6/etc/bashrc-mingw-w32S
chmod 744 $HOME/OpenFOAM/OpenFOAM-1.6/etc/bashrc-mingw-w64
chmod 744 $HOME/OpenFOAM/OpenFOAM-1.6/etc/bashrc-mingw-w64-45
chmod 744 $HOME/OpenFOAM/OpenFOAM-1.6/etc/bashrc-mingw-w64-prof
chmod 744 $HOME/OpenFOAM/OpenFOAM-1.6/applications/utilities/parallelProcessing/Allwmake
chmod 744 $HOME/OpenFOAM/OpenFOAM-1.6/bin/tutowin
chmod 744 $HOME/OpenFOAM/OpenFOAM-1.6/bin/foamDiff

5 Getting Windows version of MPICH2 into the ThirdParty-1.6 folder in Linux

There are two ways of getting MPICH2 into your Linux+OpenFOAM set up:
1. Use the get-mpich2 script, that requires Wine to be installed. With Wine installed and with msiexec executable from the terminal, then the get-mpich2 script should work. To check whether you have msiexec accessible in the terminal, run:
```
which msiexec
```
  If it returns the full path to the executable, then it is ready to use.
2. Copy MPICH2 files from a Windows Installation. Three steps for this part:
  - Download and install in Windows the MPICH2, version 1.1.1p1 Win32 IA32 from here. Get and install the 64bit version, if you wish to build OpenFOAM for Windows x64.
  - Create the folder ThirdParty-1.6/mpich2-1.1.1p1 in your Linux set up.
  - Copy the folders bin, include and lib from the installed version of MPICH2 in Windows, into the folder ThirdParty-1.6/mpich2-1.1.1 in Linux.

The Allwmake script at the folder ThirdParty-1.6 will take care of the rest. For now, the tough part is that, this way, you can only build one version of OpenFOAM (32 or 64bit) at a time.

6 Tweaking environment options

Choose which version you want to use:

mingw32

for getting a 32bit version of OpenFOAM, that builds on Linux i?86, using mingw;

mingw-w32

for getting a 32bit version of OpenFOAM, that builds on Linux i686 and x86_64, using mingw-w64;

mingw-w64

for getting a 64bit version of OpenFOAM, that builds on Linux i686 and x86_64, using mingw-w64;

Variants of the "bashrc" file that is inside the folder "OpenFOAM-1.6/etc", have been created, to meet the most likely options. These are:

sample - <bashrc-version>

configured for <compiler>, <mingw version>, <MPI option>, <WM_COMPILE_OPTION>, <WM_ARCH_OPTION>

bashrc-mingw32

configured for gcc-4.3.3, mingw32, MPI with MPICH2, Opt, DP, 32

bashrc-mingw-w32

configured for gcc-4.4.2, mingw-w32, MPI with MPICH2, Opt, DP, 32

bashrc-mingw-w32-prof

configured for gcc-4.4.2, mingw-w32, No MPI, Prof, DP, 32

bashrc-mingw-w32S

configured for gcc-4.4.2, mingw-w32, MPI with MPICH2, Opt, SP, 32

bashrc-mingw-w64

configured for gcc-4.4.2, mingw-w64, MPI with MPICH2, Opt, DP, 64

bashrc-mingw-w64-prof

configured for gcc-4.4.2, mingw-w64, No MPI, Prof, DP, 64

bashrc-mingw-w64-45

configured for gcc-4.5.0, mingw-w64, MPI with MPICH2, Opt, DP, 64

Wyldckat 17:34, 10 November 2009 (UTC)