Edited at

CentOSにOpenFOAM v1806をインストール

この記事は流体解析のオープンソースソフトウェアであるOpenFOAMのバージョンv1806を,CentOS 6.xにインストールした際の手順を備忘録としてまとめたものです.ParaViewは5.5.2のインストールを試みましたが失敗しました.


OpenFOAMのダウンロード

OpenFOAMのバイナリパッケージ及びソースコードは以下のサイトから入手できます.

1つめのサイトはESIグループによるものでLinux版以外にもWindows版も入手できます.一方,2つめのサイトはOpenFOAM Foundationによるものです.リリースされた年月でバージョンがついてるもの,すなわち今回のv1806は前者のESIのサイトから入手できます.


インストールの種類

ESIのサイトでは,Windows,Mac,Linuxのバイナリがダウンロードできます.Windowsでは,Windows Subsystem for Linux (WSL)によるインストールもできます.ソースからビルドする方法については,Ubuntu 16.04LTS, CentOS 7.4, OpenSUSE Tumbleweed に対してインストールが可能であることが公式に確認されています.この記事ではOpenFOAMをCentOS 6.xでソースからビルドすることを試みます.


インストールの方針


  • OpenFOAMはコンパイラやライブラリの要件があり,システムにインストール済みのものではバージョンが古いことがあります.システムにインストール済みのコンパイラ・ライブラリはアップデートせずに,OpenFOAMのサードパーティディレクトリで別途ビルドして環境構築を行うことにします(もとのシステム環境を汚さない).

  • 通常のデスクトップPCへのインストールでは$Homeにインストールすることがよくありますが、今回は他のユーザも利用する計算サーバへのインストールを想定し,/opt以下にインストールします.


インストール手順の概要


  1. 管理者権限で必要なrpmパッケージをダウンロード・インストールする.

  2. OpenFOAM本体,サードパーティのビルドに必要となるソースパッケージをダウンロードし,展開する.

  3. 環境設定ファイル・ビルドスクリプトを編集する.

  4. サードパーティ(ツール,ライブラリ)のビルドする.

  5. OpenFOAM本体をビルドする.

  6. ビルドしたOpenFOAM本体(ソルバー)の動作検証を行う.

  7. 可視化に用いるParaViewをビルドする.

  8. 可視化用データリーダーをリビルドする.

  9. 流体解析の一連の流れである,前処理(メッシュ生成),計算実行, 後処理(可視化)ができることを確認する.

手順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://sourceforge.net/projects/openfoamplus/files/v1806/OpenFOAM-v1806.tgz
$ tar zxvf OpenFOAM-v1806.tgz
$ wget https://sourceforge.net/projects/openfoamplus/files/v1806/ThirdParty-v1806.tgz
$ tar zxvf ThirdParty-v1806.tgz

認証の関係でHTTPSのダウンロードができない場合は,--no-check-certificateをオプションを付けるか,.wgetrcの設定などによって回避してください.

各パッケージを展開したのちのディレクトリ・ファイルの構成は以下のようになります.


  • OpenFOAM-v1806/

Allwmake      bin/             COPYING  etc/     README.md  tutorials/

applications/ BuildIssues.txt doc/ modules/ src/ wmake/


  • ThirdParty-v1806/

Allclean      kahip-2.00/   makeGcc         makeOPENMPI           openmpi-1.10.4/

Allwmake KaHIP_v2.00d/ makeGperftools makeOPENMPI.example ParaView-v5.5.2/
boost_1_64_0/ makeADIOS makeKAHIP makeParaView README.md
BUILD.md makeADIOS2 makeLLVM makeParaView.example scotch_6.0.3/
CGAL-4.9.1/ makeCCMIO makeMesa makeQt SOURCES.txt
COPYING makeCGAL makeMETIS makeVTK
etc/ makeCmake makeMGridGen makeVTK.example
fftw-3.3.7/ makeFFTW makeMPICH minCmake

OpenFOAMのビルド方法はOpenFOAM® Installation From SourceOpenFOAM® Build Guideに詳しく掲載されていますが,展開したOpenFOAM-v1806及びThirdParty-v1806にあるREADME.mdBuildIssues.txt,及びBUILD.mdも熟読し,SOURCES.TXTもチェックします.


最小限のシステム要件

公式サイトで指定されている要件は以下のとおりです.


  • gcc: 4.8.5

  • cmake: 3.3 (ParaViewとCGALのビルドに必要)

  • boost: 1.48 (CGALのビルドに必要)

  • Qt: 4.8 (ParaViewのビルドに必要),ParaView 5.4/5.5を使うためには Qt 5.xが必要.

QtのバージョンはCentOSに元々入っているものはバージョンが古く,4.8以上が必要とされます.


サードパーティパッケージに必要なソースのダウンロード・展開

上記のThirdPart-v1806以下で必要となるコンパイラ・ライブラリは以下のとおりです

(BUILD.mdにダウンロード先の記載があります).


  • gcc-4.8.5, gmp-6.1.0, mpfr-3.1.4, mpc-1.0.3, openmpi-1.10.4, scotch_6.0.3, boost_1_64_0, CGAL-4.9.1, cmake-3.5.2, qt-5.6.3, fftw-3.3.5, libccmio-2.6.1

コンパイラはGCC以外のintelコンパイラなどでも可能です.GCCのバージョンは4.8.5より新しいものでも大丈夫ですが,後で出てくる設定を合わせて変更する必要があります.

GCC

$ cd ThirdParty-v1806

$ wget https://ftp.gnu.org/gnu/gcc/gcc-4.8.5/gcc-4.8.5.tar.gz
$ tar zxvf gcc-4.8.5.tar.gz

GNUライブラリ(gmp, mpfr, mpc)

$ wget ftp://ftp.gnu.org/gnu/gmp/gmp-6.1.0.tar.bz2

$ tar jxvf gmp-6.1.0.tar.bz2
$ wget ftp://ftp.gnu.org/gnu/mpfr/mpfr-3.1.4.tar.bz2
$ tar jxvf mpfr-3.1.4.tar.bz2
$ wget ftp://ftp.gnu.org/gnu/mpc/mpc-1.0.3.tar.gz
$ tar zxvf mpc-1.0.3.tar.gz

OpenMPI

すでにサードパーティディクトリにあります.

Scotch

すでにサードパーティディクトリにあります.

Boost

すでにサードパーティディクトリにあります.

CGAL

すでにサードパーティディクトリにあります.

Cmake

$ wget http://www.cmake.org/files/v3.5/cmake-3.5.2.tar.gz

$ tar zxvf cmake-3.5.2.tar.gz

Qt (qmake)

$ wget http://download.qt.io/official_releases/qt/5.6/5.6.3/single/qt-everywhere-opensource-src-5.6.3.tar.xz

$ tar xvf qt-everywhere-opensource-src-5.6.3.tar.xz

FFTW

すでにサードパーティディクトリにあります.

libccmio

STAR-CCM+のメッシュコンバータが必要な場合のみビルドします.

$ wget http://portal.nersc.gov/svn/visit/trunk/third_party/libccmio-2.6.1.tar.gz

$ tar zxvf libccmio-2.6.1.tar.gz


環境設定ファイル・ビルドスクリプトを編集


OpenFOAM本体の環境設定

OpenFOAM本体の環境設定を,viemacsなどの適当なエディタで編集します.シェルはbash利用で説明します.

$ vi ../OpenFOAM-v1806/etc/bashrc

修正箇所

# [FOAM_INST_DIR] - parent directory containing the OpenFOAM installation.

# \- 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.
# --
rc="${BASH_SOURCE:-${ZSH_NAME:+$0}}"
[ -n "$rc" ] && FOAM_INST_DIR=$(\cd $(dirname $rc)/../.. && \pwd -L) || \
# FOAM_INST_DIR=$HOME/$WM_PROJECT
FOAM_INST_DIR=/opt/$WM_PROJECT
# FOAM_INST_DIR=/usr/local/$WM_PROJECT

# [WM_COMPILER_TYPE] - Compiler location:

# = system | ThirdParty
export WM_COMPILER_TYPE=ThirdParty

 [WM_MPLIB] - MPI implementation:

# = SYSTEMOPENMPI | OPENMPI | SYSTEMMPI | MPI | MPICH | MPICH-GM |
# HPMPI | CRAY-MPICH | FJMPI | QSMPI | SGIMPI | INTELMPI | USERMPI
export WM_MPLIB=OPENMPI

メッシュのラベルサイズを32ビットから64ビットにしたい場合は以下のように変更してください.

# [WM_LABEL_SIZE] - Label size in bits:

# = 32 | 64
export WM_LABEL_SIZE=64

コンパイラ・GNUライブラリの指定に関して,GNUライブラリの指定を変更します.

$ vi ../OpenFOAM-v1806/etc/config.sh/compiler

変更箇所

case "$WM_COMPILER_TYPE" in

OpenFOAM | ThirdParty)
# Default versions of GMP, MPFR and MPC, override as necessary
gmp_version=gmp-6.1.0
mpfr_version=mpfr-3.1.4
mpc_version=mpc-1.0.3


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

gmpPACKAGE=${gmp_version:-gmp-system}
mpfrPACKAGE=${mpfr_version:-mpfr-system}
mpcPACKAGE=${mpc_version:-mpc-system}
gccPACKAGE=$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

boostPACKAGE=${boost_version:-boost-system}
gmpPACKAGE=${gmp_version:-gmp-system}
mpfrPACKAGE=${mpfr_version:-mpfr-system}
cgalPACKAGE=$cgal_version

OpenFOAM本体でのCGALの設定を確認します.

vi ../OpenFOAM-v1806/etc/config.sh/CGAL

確認箇所

boost_version=boost_1_64_0

cgal_version=CGAL-4.9.1


FFTWビルドの設定

FFTWのビルドスクリプトを確認します.

vi makeFFTW

確認箇所

# FFTW version from OpenFOAM etc/config.sh file:

_foamConfig FFTW

fftwPACKAGE=${fftw_version:-fftw-system}

OpenFOAM本体でのFFTWの設定を確認します.

vi ../OpenFOAM-v1806/etc/config.sh/FFTW

変更箇所

fftw_version=fftw-3.3.7

export FFTW_ARCH_PATH=$WM_THIRD_PARTY_DIR/platforms/$WM_ARCH$WM_COMPILER/$fftw_version


サードパーティのビルド


GCCのビルド

はじめにOpenFOAMの環境設定を読み込みます.

$ . /opt/OpenFOAM/OpenFOAM-v1806/etc/bashrc

このとき,下記のようなメッセージが出力されますが,GCCがビルドがまだなので当たり前のエラーであり,GCCのビルドを進めます.

===============================================================================

Warning in /opt/OpenFOAM/OpenFOAM-v1806/etc/config.sh/settings:
Cannot find 'Gcc' compiler installation
/opt/OpenFOAM/ThirdParty-v1806/platforms/linux64/gcc-4.8.5

Either install this compiler version, or use the system compiler by setting
WM_COMPILER_TYPE to 'system' in $WM_PROJECT_DIR/etc/bashrc.
===============================================================================

$ ./makeGcc


Cmakeのビルド

Cmakeをビルドします.バージョンをオプションで指定する必要があります.

./makeCmake cmake-3.5.2


サードパーティパッケージのビルド

Gccのビルドが完了したら,残りのパッケージのビルドをAllwmakeで行います.実行する前にもう一度OpenFOAMの環境設定を読み込みます.

$ . /opt/OpenFOAM/OpenFOAM-v1806/etc/bashrc 

$ ./Allwmake

このとき,OpenMPIをビルドする際に,以下のようなエラーメッセージを出力して終了してしまいます.

/opt/OpenFOAM/OpenFOAM-v1806/etc/config.sh/mpi: line 64: _foamEtc: command not found

fomaEtcが無いよ,と怒られるわけですが,これは$WM_PROJECT_DIR/etc/config.sh/functions

sourceしないと有効にならないので,上記の$WM_PROJECT_DIR/etc/config.sh/mpiのはじめに

以下を追記します.

$ vi ../OpenFOAM-v1806/etc/config.sh/mpi

# Load shell functions

. $WM_PROJECT_DIR/etc/config.sh/functions

編集が終わったら,再度Allwmakeを実行します.

$ ./Allwmake

以上のサードパーティのビルドが終わったら,OpenFOAM本体ビルドのための条件を満たしているかどうかを以下のコマンドでチェックします.

$ foamSystemCheck


OpenFOAM本体のビルド

再度OpenFOAMの環境設定を読み込んでからビルドします.Allwmakeスクリプトを利用しますが,-jオプションで並列コンパイルのcpu数を指定できるので,環境に合わせて設定します.また,エイリアスコマンドfoamを用いると,OpenFOAMのプロジェクトディレクトリ(インストールディレクトリ)$WM_PROJECT_DIRに移動できます.

$ . /opt/OpenFOAM/OpenFOAM-v1806/etc/bashrc

$ foam
$ ./Allwmake –j4

もしエラーが出て正常終了しないときは,エラーメッセージから足りないライブラリがないかどうかなどを確認します.


OpenFOAM本体のビルド検証

OpenFOAM本体のビルドが正常終了したら,環境設定読み込みを再度行い,テストのためのプログラムを実行します.

$ . /opt/OpenFOAM/OpenFOAM-v1806/etc/bashrc 

$ foamInstallationTest

ライブラリパスなどの確認結果が出力され,最後に以下のような要約が出力されればOKです.

Summary

-------------------------------------------------------------------------------
Base configuration ok.
Critical systems ok.

Done


ParaViewのビルド


Qtのビルド

makeQtの中でバージョン・パッケージの指定の仕方を確認します.

$ more makeQt

確認箇所

# Description

# Build script for QT (the qt-everywhere-opensource-src package)
#
# ----------------------------------------------
# NO USER-CONFIGURABLE SETTINGS WITHIN THIS FILE
#------------------------------------------------------------------------------
# Run from third-party directory only
cd ${0%/*} && 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
}
. etc/tools/ThirdPartyFunctions
. etc/tools/QtFunctions

以前のOpenFOAMバージョンではmakeQtの中でユーザーが指定することが

できましたが,設定をここで変えることはできません.

とりあえず,makeQtのヘルプを出してみます.

$ ./makeQt -h

usage: makeQt [OPTION] [qt-VERSION] [-- configure-options]

options:
-gcc Force gcc/g++ instead of the values from $WM_CC, $WM_CXX
-help

* build qt-everywhere-opensource-src, version undefined

バージョンを指定して実行すればよいようなので,5.6.3をコンパイルしてみます.

$ ./makeQt 5.6.3

コンパイルに少々時間がかかり,何やら以下のようなエラーが出て失敗します.

/opt/OpenFOAM/ThirdParty-v1806/qt-everywhere-opensource-src-5.6.3/qtconnectivity/src/tools/sdpscanner/main.cpp:321:30: error: ‘htonl’ was not declared in this scope

エラーメッセージをGoogleで検索すると,stack overflow に対処法が載っているので,以下のようにソースに修正を加えます.

$ vi qt-everwhere-opensource-src-5.6.3/qtconnectivity/src/tools/sdpscanner/main.cpp

追記部分

#include <arpa/inet.h>

もう一度コンパイルしてエラーが出なければ成功です.

$ ./makeQt 5.6.3


ParaViewのビルド

次にParaViewをビルドします.

qmake(Qt)及びCmakeのパスが設されていないのでスクリプトのオプションで指定します.

また,OpenGLライブラリ2.x以上の機能を利用しない(-no-gl2)のオプションを付けて実行します(CentOS 6のドライバーが対応していないため).

$ ./makeParaView -no-gl2 -qmake platforms/linux64Gcc/qt-5.6.3/bin -cmake platforms/linux64Gcc/cmake-3.5.2/bin

モジュールparaviewができるのですが,以下のようにParaView単体で起動するとエラーを吐いて終了してしまいます.

$ paraview

ERROR: In /opt/OpenFOAM/ThirdParty-v1806/ParaView-v5.5.2/VTK/Rendering/OpenGL2/vtkOpenGLRenderWindow.cxx, line 793

vtkXOpenGLRenderWindow (0x50b4fc0): GL version 2.1 with the gpu_shader4 extension is not supported by your graphics driver but is required for the new OpenGL rendering backend. Please update your OpenGL driver. If you are using Mesa please make sure you have version 10.6.5 or later and make sure your driver in Mesa supports OpenGL 3.2.

ERROR: In /opt/OpenFOAM/ThirdParty-v1806/ParaView-v5.5.2/VTK/Rendering/OpenGL2/vtkOpenGLRenderWindow.cxx, line 793
vtkXOpenGLRenderWindow (0x50b4fc0): GL version 2.1 with the gpu_shader4 extension is not supported by your graphics driver but is required for the new OpenGL rendering backend. Please update your OpenGL driver. If you are using Mesa please make sure you have version 10.6.5 or later and make sure your driver in Mesa supports OpenGL 3.2.

確かに-no-gl2のオプションを付けてビルドしたつもりなのですが,うまくいきまん.いろいろ試してみたのですが,今のところ解決できていないので,ParaViewインストールについては深追いしないことにします.

ParaViewが正常にインストールできている場合は,引き続いてParaView Readerをビルドします.一度クリーンしてからビルドします.

$ cd $FOAM_UTILITIES/postProcessing/graphics/PVReaders 

$ ./Allwclean
$ ./Allwmake

ここで$FOAM_UTILITIESはOpenFOAMのユーティリティがインストールされたパスを表すOpenFOAMの環境変数です.


OpenFOAMでの前処理,計算実行,後処理の動作確認

上記のインストール作業がすべて終了したら,OpenFOAMによって流体解析の一連の流れである,前処理(メッシュ作成),計算実行,後処理(可視化)が正常にできるかどうかを,チュートリアルケースであるpitzDailyを利用して確かめます.

$ . /opt/OpenFOAM/OpenFOAM-v1806/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 Readerによって読み込み,ParaViewを起動して可視化する(今回はParaViewがビルドできていないのでもちろんエラーになる).


ここで行った動作確認では並列計算の確認ができていません.並列計算を行うチュートリアルケースはどれも計算時間がかかるので気軽に動作確認ができませんが,比較的軽い計算としてpipeCyclicを実行してみます(並列数はデフォルでは5).

$ run

$ cp -r $FOAM_TUTORIALS/incompressible/simpleFoam/pipeCyclic ./
$ cd pipeCyclic
$ ./Allrun

Allrunはメッシュ生成から解析条件設定・計算実行を自動的に行うスクリプトです.pitzDaily及びpipeCyclicがエラーなしで計算実行できれば無事にインストール完了です.