この記事は流体解析のオープンソースソフトウェアであるOpenFOAMのバージョンv2312を，CentOS 7.xにインストールした際の手順を備忘録としてまとめたものです．
OpenFOAMのダウンロード
OpenFOAMのバイナリパッケージ及びソースコードは以下のサイトから入手できます．
1つめのサイトはESIグループによるものです．一方，2つめのサイトはOpenFOAM Foundationによるものです．リリースされた年月でバージョンがついてるもの，すなわち今回のv2312(2023年12月リリース)は前者のESIのサイトから入手できます．
インストールの種類
ESIのサイトでは，Windows，Mac，Linuxのバイナリがダウンロードできます．Windowsでは，Windows Subsystem for Linux (WSL)によるインストールもできます．ソースからビルドする方法については，レポジトリに最新の情報が掲載されています．この記事ではOpenFOAMをCentOS 7.xにソースからビルドすることを試みます． CentOS 7.xではソースからビルドする以外に， yumによるパッケージインストールやspackによるビルドもできます．
インストールの方針
- OpenFOAMはコンパイラやライブラリの要件があり，システムにインストール済みのものではバージョンが古いことがあります．システムにインストール済みのコンパイラ・ライブラリはアップデートせずに，OpenFOAMのサードパーティディレクトリで別途ビルドして環境構築を行うことにします(もとのシステム環境を汚さない)．
- 通常のデスクトップPCへのインストールでは
$Homeにインストールすることがよくありますが、今回は他のユーザも利用する計算サーバへのインストールを想定し，/opt以下にインストールします．
インストール手順の概要
- 管理者権限で必要なrpmパッケージをダウンロード・インストールする．
- OpenFOAM本体，サードパーティのビルドに必要となるソースパッケージをダウンロードし，展開する．
- 環境設定ファイル・ビルドスクリプトを編集する．
- サードパーティ(ツール，ライブラリ)のビルドする．
- OpenFOAM本体をビルドする．
- ビルドしたOpenFOAM本体(ソルバー)の動作検証を行う．
- 可視化に用いるParaViewをビルドする．
- 流体解析の一連の流れである，前処理(メッシュ生成)，計算実行, 後処理(可視化)ができることを確認する．
手順7.のParaViewのビルドは失敗することが多々あり，どうしてもうまくいかないときはあきらめます．ParaViewはCentOSサーバ以外にも別途インストールできるので，計算データを手元の環境にダウンロードして可視化を行うことができます．
必要なrpmパッケージのインストール
必要なパッケージは以下のとおりです．
- git, gcc-c++, bison, flex, m4, glibc-devel, glibc-devel.i686, zlib-devel
管理者権限でyumを使って上記のパッケージをインストールします．
$ yum install gcc gcc-c++ bison flex m4 glibc-devel glibc-devel.i686 zlib-devel
OpenFOAMソースパッケージのダウンロード・展開
OpenFOAMのパッケージは本体ソースコードとサードパーティパッケージの2種類から構成されています．ここでは異なるバージョンも管理できるように/opt/OpenFOAMというディレクトリを作成し，その下にwgetでダウンロードして展開します．
$ mkdir /opt/OpenFOAM
$ cd /opt/OpenFOAM
$ wget https://dl.openfoam.com/source/v2312/OpenFOAM-v2312.tgz
$ tar zxvf OpenFOAM-v2312.tgz
$ wget https://dl.openfoam.com/source/v2312/ThirdParty-v2312.tgz
$ tar zxvf ThirdParty-v2312.tgz
認証の関係でHTTPSのダウンロードができない場合は，--no-check-certificateをオプションを付けるか，.wgetrcの設定などによって回避してください．
各パッケージを展開したのちのディレクトリ・ファイルの構成は以下のようになります．
OpenFOAM-v2312/
Allwmake COPYING README.md bin etc src wmake
CONTRIBUTORS.md META-INFO applications doc modules tutorials
ThirdParty-v2312/
Allclean makeAdios2 makeLLVM makePETSC
Allwmake makeCCMIO makeMETIS makeParaView
BUILD.md makeCGAL makeMGridGen makeParaView.example
COPYING makeCmake makeMPICH makeQt
Environ.md makeFFTW makeMVAPICH makeSCOTCH
README.md makeGcc makeMesa makeVTK
Requirements.md makeGperftools makeMesa.example makeVTK.example
SOURCES.md makeHYPRE makeOPENMPI minCmake
etc makeKAHIP makeOPENMPI.example sources
OpenFOAMのビルド方法はOpenFOAM® Quick Build Guideに掲載されていますが，展開したOpenFOAM-v2312及びThirdParty-v2312にあるREADME.md，Requirements.md，BUILD.mdを熟読し，SOURCES.txtもチェックします．
最小限のシステム要件
公式サイトで指定されている要件は以下のとおりです．
- gcc: 7.5.0 (最小限、必ずしも推奨されるわけではない)
- cmake: 3.8 (ParaViewとCGALのビルドに必要)
- boost: 1.48 (CGALのビルドに必要)
- fftw: 3.3.7 (FFTに関する機能を使う場合は必要)
- paraview: 5.6.3 (可視化用)
- Qt: 5.9 (ParaViewビルドに必要)
元のOSシステムのgcc， cmake， openmpiのバージョンは以下のコマンドで確認できます．
$ gcc --version
$ cmake --version
$ orterun --version
私の環境では， gccは4.8.5，cmakeは2.8.12.2，openmpiは1.8.8でした． 以下の記事ではgccをThirdParty-v2312以下でコンパイルしますが，システムのgccを使う方は読み替え等をお願いします．
サードパーティパッケージに必要なソースのダウンロード・展開
上記のThirdParty-v2312以下で必要となるコンパイラ・ライブラリは以下のとおりです
(BUILD.mdにダウンロード先の記載があります)．
- gcc-7.5, gmp-6.2.0, mpfr-4.0.2, mpc-1.1.0, openmpi-4.1.2, scotch_6.1.0, boost_1_74_0, CGAL-4.14.3, cmake-3.8.2(ParaView 5.7-5.8利用にはcmake-3.10が必要), qt-5.6.3 or qt-5.9.3 (ParaView 5.9にはqt-5.12以上), fftw-3.3.10, libccmio-2.6.1, kahip-3.15, ADIOS2-2.9.2
コンパイラはGCC以外のintelコンパイラなどでも可能です．
GCC
$ cd ThirdParty-v2312
$ wget https://ftp.gnu.org/gnu/gcc/gcc-7.5.0/gcc-7.5.0.tar.gz
$ tar zxvf gcc-7.5.0.tar.gz
GNUライブラリ(gmp, mpfr, mpc)
$ wget ftp://ftp.gnu.org/gnu/gmp/gmp-6.2.0.tar.xz
$ tar Jxvf gmp-6.2.0.tar.xz
$ wget ftp://ftp.gnu.org/gnu/mpfr/mpfr-4.0.2.tar.xz
$ tar Jxvf mpfr-4.0.2.tar.xz
$ wget ftp://ftp.gnu.org/gnu/mpc/mpc-1.1.0.tar.gz
$ tar zxvf mpc-1.1.0.tar.gz
OpenMPI
sources以下にあります．
Scotch
sources以下にあります．
Boost
sources以下にあります．
CGAL
sources以下にあります．
Cmake
$ wget https://cmake.org/files/v3.14/cmake-3.14.5.tar.gz
$ tar zxvf cmake-3.14.5.tar.gz
Qt (qmake)
$ wget https://download.qt.io/archive/qt/5.12/5.12.11/single/qt-everywhere-src-5.12.11.tar.xz
$ tar Jxvf qt-everywhere-src-5.12.11.tar.xz
$ mv qt-everywhere-src-5.12.11 qt-everywhere-opensource-src-5.12.11
FFTW
sources以下にあります．
libccmio
STAR-CCM+のメッシュコンバータが必要な場合のみビルドします．以前のダウンロード先が無くなってしまったので，foam-extendから持ってきます．
$ wget https://sourceforge.net/projects/foam-extend/files/ThirdParty/libccmio-2.6.1.tar.gz
$ tar zxvf libccmio-2.6.1.tar.gz
ParaView
sources以下にあります．
環境設定ファイル・ビルドスクリプトを編集
OpenFOAM本体の環境設定
OpenFOAM本体の環境設定を，viやemacsなどの適当なエディタで編集します．シェルはbash利用で説明します．
$ vi ../OpenFOAM-v2312/etc/bashrc
修正箇所
# [WM_COMPILER_TYPE] - Compiler location:
# = system | ThirdParty
export WM_COMPILER_TYPE=ThirdParty
メッシュのラベルサイズを32ビットから64ビットにしたい場合は以下のように変更してください．
# [WM_LABEL_SIZE] - Label size in bits:
# = 32 | 64
export WM_LABEL_SIZE=64
# [WM_MPLIB] - MPI implementation:
# = SYSTEMOPENMPI | OPENMPI | SYSTEMMPI | MPI | MPICH | MPICH-GM |
# HPMPI | CRAY-MPICH | FJMPI | QSMPI | SGIMPI | INTELMPI | USERMPI
# Specify SYSTEMOPENMPI1, SYSTEMOPENMPI2 for internal tracking (if desired)
# Can also use INTELMPI-xyz etc and define your own wmake rule
export WM_MPLIB=OPENMPI
# [projectDir] - directory containing this OpenFOAM version.
# \- When this file is located as $WM_PROJECT_DIR/etc/bashrc, the next lines
# should work when sourced by BASH or ZSH shells. If this however fails,
# set one of the fallback values to an appropriate path.
#
# This can be removed if an absolute path is provided for WM_PROJECT_DIR
# later on in this file
# --
projectDir="${BASH_SOURCE:-${ZSH_NAME:+$0}}";
[ -n "$projectDir" ] && projectDir="$(\cd $(dirname $projectDir)/.. && \pwd -L)" ||\
#projectDir="$HOME/OpenFOAM/OpenFOAM-$WM_PROJECT_VERSION"
projectDir="/opt/OpenFOAM/OpenFOAM-$WM_PROJECT_VERSION"
# projectDir="/usr/local/OpenFOAM/OpenFOAM-$WM_PROJECT_VERSION"
コンパイラ・GNUライブラリの指定に関して，GNUライブラリの指定を変更します．
$ vi ../OpenFOAM-v2312/etc/config.sh/compiler
変更箇所
case "$WM_COMPILER_TYPE" in
ThirdParty)
# Default/minimum versions (compiler, GMP, MPFR, MPC) - override as needed
default_clang_version=llvm-5.0.2
default_gcc_version=gcc-7.5.0
default_gmp_version=gmp-6.2.0
default_mpfr_version=mpfr-4.0.2
default_mpc_version=mpc-1.1.0
gmp_version="$default_gmp_version"
mpfr_version="$default_mpfr_version"
mpc_version="$default_mpc_version"
GCCビルドの設定
$ vi makeGcc
確認箇所
先ほど編集したconfig.sh/compilerからコンパイラ・GNUライブラリのバージョンを参照するので，
以下は確認するだけです．
[ "${WM_COMPILER#Gcc}" = "$WM_COMPILER" ] && WM_COMPILER=Gcc # Force gcc
WM_COMPILER_TYPE=ThirdParty # Ensure we get the correct settings
# Default GCC, mpfr, gmp and mpc versions from OpenFOAM etc/config.sh file:
_foamConfig compiler
GMP_PACKAGE="${gmp_version:-gmp-system}"
MPFR_PACKAGE="${mpfr_version:-mpfr-system}"
MPC_PACKAGE="${mpc_version:-mpc-system}"
GCC_PACKAGE="$gcc_version"
CGALビルドの設定
CGALのビルドスクリプトを上と同様に確認します．
$ vi makeCGAL
確認箇所
# CGAL, boost and gmp/mpfr versions from OpenFOAM etc/config.sh files.
# Get compiler first and let CGAL config override GMP and MPFR
_foamConfig compiler
_foamConfig CGAL
BOOST_PACKAGE="${boost_version:-boost-system}"
GMP_PACKAGE="${gmp_version:-gmp-system}"
MPFR_PACKAGE="${mpfr_version:-mpfr-system}"
CGAL_PACKAGE="$cgal_version"
OpenFOAM本体でのCGALの設定を確認します．
vi ../OpenFOAM-v2312/etc/config.sh/CGAL
確認箇所
boost_version=boost_1_74_0
cgal_version=CGAL-4.14.3
FFTWビルドの設定
FFTWのビルドスクリプトを確認します．
vi makeFFTW
確認箇所
# FFTW version from OpenFOAM etc/config.sh file:
_foamConfig FFTW
PACKAGE="${fftw_version:-none}"
OpenFOAM本体でのFFTWの設定を確認します．
vi ../OpenFOAM-v2312/etc/config.sh/FFTW
確認箇所
fftw_version=fftw-3.3.10
export FFTW_ARCH_PATH=$WM_THIRD_PARTY_DIR/platforms/$WM_ARCH$WM_COMPILER/$fftw_version
サードパーティのビルド
GCCのビルド
はじめにOpenFOAMの環境設定を読み込みます．
$ . /opt/OpenFOAM/OpenFOAM-v2312/etc/bashrc
このとき，下記のようなメッセージが出力されますが，GCCがビルドがまだなので当たり前のエラーであり，GCCのビルドを進めます．
===============================================================================
Warning in /opt/OpenFOAM/OpenFOAM-v2312/etc/config.sh/settings:
Cannot find 'Gcc' compiler installation
/opt/OpenFOAM/ThirdParty-v2312/platforms/linux64/gcc-7.5.0
Either install this compiler version, or use the system compiler by setting
WM_COMPILER_TYPE to 'system' in $WM_PROJECT_DIR/etc/bashrc.
===============================================================================
No completions for /opt/OpenFOAM/OpenFOAM-v2312/platforms/linux64GccDPInt32Opt/bin
[ignore if OpenFOAM is not yet compiled]
$ ./makeGcc
ビルドしたGccを有効にするために，OpenFOAMの環境設定を再度読み込みます．
$ . /opt/OpenFOAM/OpenFOAM-v2312/etc/bashrc
Cmakeのビルド
Cmakeをビルドします．バージョンをオプションで指定する必要があります．以前はバージョン3.12や3.13で大丈夫でしたが，以降のADIOS2のビルドの際に失敗するので3.14を利用します．
./makeCmake cmake-3.14.5
サードパーティパッケージのビルド
Cmakeのビルドが完了したら，残りのパッケージのビルドをAllwmakeで行います．実行する前にもう一度OpenFOAMの環境設定を読み込みます．
$ . /opt/OpenFOAM/OpenFOAM-v2312/etc/bashrc
$ ./Allwmake
ADIOS2のビルド時に以下のようなエラーが出てしまいます．
Build adios library ADIOS2-2.9.2 for openmpi-4.1.2
Starting build: ADIOS2-2.9.2 (using cmake)
no patch found for ADIOS2-2.9.2
Using cmake=/usr/bin/cmake
+ /usr/bin/cmake -DCMAKE_INSTALL_PREFIX=/opt/OpenFOAM/ThirdParty-v2312/platforms/linux64Gcc/ADIOS2-2.9.2 -DCMAKE_BUILD_TYPE=Release -DADIOS2_USE_Fortran=FALSE -DADIOS2_BUILD_EXAMPLES=FALSE /opt/OpenFOAM/ThirdParty-v2312/sources/adios/ADIOS2-2.9.2
CMake Error at CMakeLists.txt:6 (cmake_minimum_required):
CMake 3.12 or higher is required. You are running version 2.8.12.2
-- Configuring incomplete, errors occurred!
Error building: ADIOS2-2.9.2
---------------------------------------------------
Optional component (ADIOS2) had build issues
OpenFOAM will nonetheless remain largely functional
---------------------------------------------------
サードパーティ以下にビルドしたCmakeを利用していないようなので，PATHを明示的に設定してADIOS2を再ビルドします．
$ ./makeAdios2 -cmake $WM_THIRD_PARTY_DIR/platforms/linux64Gcc/cmake-3.14.5/bin/
以上のサードパーティのビルドが終わったら，OpenFOAM本体ビルドのための条件を満たしているかどうかを以下のコマンドでチェックします．
$ foamSystemCheck
System check: PASS
==================
Can continue OpenFOAM installation.
PASSが表示されたら，OpenFOAM本体のビルドに移ります．
OpenFOAM本体のビルド
再度OpenFOAMの環境設定を読み込んでからビルドします．Allwmakeスクリプトを利用しますが，-jオプションで並列コンパイルのcpu数を指定できるので，環境に合わせて設定します．また，エイリアスコマンドfoamを用いると，OpenFOAMのプロジェクトディレクトリ(インストールディレクトリ)$WM_PROJECT_DIRに移動できます．
$ . /opt/OpenFOAM/OpenFOAM-v2312/etc/bashrc
$ foam
$ ./Allwmake –j4
もしエラーが出て正常終了しないときは，エラーメッセージから足りないライブラリがないかどうかなどを確認します．
OpenFOAM本体のビルド検証
OpenFOAM本体のビルドが正常終了したら，環境設定読み込みを再度行い，テストのためのプログラムを実行します．
$ . /opt/OpenFOAM/OpenFOAM-v2312/etc/bashrc
$ foamInstallationTest
ライブラリパスなどの確認結果が出力され，最後に以下のような要約が出力されればOKです．
Summary
-------------------------------------------------------------------------------
Base configuration ok.
Critical systems ok.
Done
gcc -vのバージョン出力で日本語が含まれる場合は上記のfoamInstallationTestがエラーとなるので，その前に
export LANG=C
などとして日本語を使用しないようにしてください．
ParaViewのビルド
Qtのビルド
makeQtの中でバージョン・パッケージの指定の仕方を確認します．
$ cd $WM_THIRD_PARTY_DIR
$ more makeQt
確認箇所
# Description
# Build script for QT (the qt-everywhere-opensource-src package)
#
# ----------------------------------------------
# NO USER-CONFIGURABLE SETTINGS WITHIN THIS FILE
#------------------------------------------------------------------------------
if : # Run from third-party directory
then
cd "${0%/*}" || exit
wmakeCheckPwd "$WM_THIRD_PARTY_DIR" 2>/dev/null || {
echo "Error (${0##*/}) : not located in \$WM_THIRD_PARTY_DIR"
echo " Check your OpenFOAM environment and installation"
exit 1
}
fi
. "${WM_THIRD_PARTY_DIR:?}"/etc/tools/ThirdPartyFunctions
. "${WM_THIRD_PARTY_DIR:?}"/etc/tools/QtFunctions
以前のOpenFOAMバージョンではmakeQtの中でユーザーが指定することができましたが，設定をここで変えることはできません．とりあえず，makeQtのヘルプを出してみます．
$ ./makeQt -help
Usage: makeQt [OPTION] [qt-VERSION] [-- configure-options]
options:
-force Force compilation, even if it already exists
-gcc Force use of gcc/g++
-list List available unpacked source versions
-help Display usage help
* build qt-everywhere-opensource-src, version undefined
バージョンを指定して実行すればよいようなので，5.12.11をコンパイルしてみます (qt-5.9.3はParaView-v5.9.1の最低要件を満たしていません)．
$ ./makeQt 5.12.11
エラーが出ないでビルドされることを確認します．
ParaViewのビルド
次にParaViewをビルドします． qmake（Qt）及びCmakeのパスが設されていないのでスクリプトのオプションで指定してビルドします．今回はParaView 5.11.2をビルドします．
$ ./makeParaView -qmake platforms/linux64Gcc/qt-5.12.11/bin -cmake platforms/linux64Gcc/cmake-3.14.5/bin 5.11.2
モジュールparaviewができてビルド完了です．
$ ls platforms/linux64Gcc/ParaView-5.11.2/bin/paraview
platforms/linux64Gcc/ParaView-5.11.2/bin/paraview
OpenFOAMでの前処理，計算実行，後処理の動作確認
上記のインストール作業がすべて終了したら，OpenFOAMによって流体解析の一連の流れである，前処理(メッシュ作成)，計算実行，後処理(可視化)が正常にできるかどうかを，チュートリアルケースであるpitzDailyを利用して確かめます．
$ cd
$ . /opt/OpenFOAM/OpenFOAM-v2312/etc/bashrc
$ mkdir –p $FOAM_RUN
$ run
$ cp -r $FOAM_TUTORIALS/incompressible/simpleFoam/pitzDaily ./
$ cd pitzDaily
$ blockMesh
$ simpleFoam
$ paraFoam
ここで出てくるOpenFOAMのコマンドの意味は以下のとおりです．
-
run: ユーザの計算実行ディレクトリ$FOAM_RUNに移動する． -
blockMesh: 基本的なメッシュを生成する． -
simpleFoam: 非圧縮性流体計算用の定常解析ソルバーsimpleFoamの実行． -
paraFoam: OpenFOAMの計算出力をParaViewに読み込める形式に変換し，ParaViewを起動して可視化する．
ここで行った動作確認では並列計算の確認ができていません．並列計算を行うチュートリアルケースはどれも計算時間がかかるので気軽に動作確認ができませんが，比較的軽い計算としてpipeCyclicを実行してみます．並列数はデフォルでは5であり，利用しているシステムのCPU数(コア数)が少ない場合はエラーとなるので，その場合はsystem/decomposeParDictを修正して並列数を変更します．
$ run
$ cp -r $FOAM_TUTORIALS/incompressible/simpleFoam/pipeCyclic ./
$ cd pipeCyclic
$ ./Allrun
Allrunはメッシュ生成から解析条件設定・計算実行を自動的に行うスクリプトです．pitzDaily及びpipeCyclicがエラーなしで計算実行できれば無事にインストール完了です．