db2prereqcheck - インストール前提条件の検査

特定のバージョンの Db2®をインストールするための前提条件をシステムが満たしているかどうかを検査します。

このコマンドを使用することにより、インストール・プロセスを開始する前に、対象のシステムが前提条件を満たしているかどうか判別できます。

注： Db2db2prereqcheck を実行してインストールプロセスを開始するには、インストールメディアをダウンロードする必要があります。

注意をインストールするために db2prereqcheck ユーティリティを実行する場合。 Db212.1.2 以降のインストールでユーティリティを実行する場合 DB2WORKDIR の空き領域が検証されます。 AIX、 Linux デプロイメントの場合、ルート・ディレクトリの空き容量も検証される。

db2prereqcheck コマンドは、前提条件を含むリソース XML ファイルを使用します。 Linux® および UNIX の場合、XML ファイルのデフォルト・パスは DB2 installation/cfg/DB2prereqs.xmlにあります。この XML ファイルの読み取り権限または書き込み権限がなければなりません。 XML ファイルの内容を変更しないでください。

注：コマンド db2prereqcheck にオプションを指定しない場合、ファイル DB2prereqs.xml にリストされているすべての Db2 バージョンについて、 Db2 pureScale® および非 Db2 pureScale サーバーの前提条件がチェックされます。

からエラーが発生 db2prereqcheck しないからといって、現在の環境がサポートされている、あるいはテスト済みであるとは限りません。データサーバー製品の最新の-to-date インストール要件については、 Linux、UNIX、およびWindows向けの「 IBM® のシステム要件」 Db2 を参照してください。

許可

Linux およびUNIXオペレーティングシステムでは、rootユーザーまたはそれと同-root 等の権限が必要です。

コマンド構文

Db2-pureScale-options

注： db2prereqcheck は、 AIX の TSA 要件を、 Pacemaker は、 Linux の要件をチェックする。 Db2 の pureScale 機能を導入する際には、これらのソフトウェアが必須となります。したがって、システムが要件を満たしていない場合、 pureScale ソリューションの導入中にインストーラーがエラーを発生させ、その他の高可用性ソリューションの導入中には警告が表示されます。

コマンド・パラメーター

-v バージョン

特定の Db2 バージョンの前提条件を検査します。および -v パラメータは -i 、互いに排他的です。

-l

XMLリソースファイルで定義されている最新の Db2 バージョンについて、 Db2 pureScale に関連する前提条件、および Db2 pureScale に関連しない前提条件を確認します。 -l パラメーターと-v パラメーターは相互に排他的です。すべての前提条件が満たされている場合、この -l パラメータは画面に出力を表示しません。

-f XML-file

XML リソース・ファイルの名前を指定します。 -f パラメーターを指定しない場合は、DB2 installation/cfg/DB2prereqs.xml ファイルが使用されます。

-c

シン・クライアントの前提条件を検査します。

-c、-u、-gと-p パラメーターは相互に排他的です。

-p

Db2 pureScale 環境 (Linux および AIX® オペレーティング・システムのみ) の前提条件を検査します。これはデフォルト・オプションです。

-c、-u、-gと-p パラメーターは相互に排他的です。

重要: Db2 pureScale インストール済み環境の特定のネットワーク構成の前提条件要件を検証するには、このオプションとともに -t ネットワーク構成タイプ ・オプションを指定する必要があります。

-o 出力-file

出力ファイルの名前 ( db2prereqcheck.rptなど) を指定します。ファイル名を指定しない場合、出力は画面に表示されます。

-s

画面に前提条件の検証の要約を表示します。

-u

Db2 pureScale 環境の uDAPL 要件を検査します (Linux および AIX オペレーティング・システムのみ)。

注意：'-uパラメーターは非推奨。 RDMA ライブラリー要件を検査するには、-hl パラメーターと -nm パラメーターを併用します。

-c、-u、-gと-p パラメーターは相互に排他的です。

RoCE ネットワークでは、 AIX および uDAPL のソフトウェア前提条件が満たされていることを手動で確認する必要があります。 db2prereqcheck コマンドでは、AIX および uDAPL ソフトウェアのレベルの妥当性検査は行われません。

-g

GPL コンパイル要件を検査します (Linux オペレーティング・システムのみ)。

-c、-u、-gと-p パラメーターは相互に排他的です。

-v または -l パラメーターを指定します。

-i

XML リソース・ファイルで定義した最新の Db2 バージョンの Db2 pureScale 環境に関連しない前提条件を検査します。 -i パラメーターと-v パラメーターは相互に排他的です。

-t

特定のタイプのネットワーク構成の前提条件を検証します (Linux オペレーティング・システムのみ)。

注意：'-tパラメーターは非推奨。 RDMA ネットワーク要件を検査するには、-hl パラメーターと -nm パラメーターを併用します。

ネットワーク構成タイプは、単一の InfiniBand ポート・クラスター、複数の InfiniBand ポート・クラスター、単一の RoCE ポート・クラスター、または複数の RoCE ポート・クラスター (シングル IB_ クラスター・ポート、マルチポート・クラスター (MULTI_IB_PORT_CLUSTER)、単一 ROCE_PORT_CLUSTER または複数のクラスター・ポート・クラスター) でなければなりません。

-hl ホスト-name

すべてのホスト間のパスワードなしのルート SSH アクセスが確認されるホストのリストを指定します。

-dl デバイス

検証された共有ディスクのデバイス・パスを 1 つ以上指定して、すべてのホストからそこにアクセスできるようにします。このパラメーターを指定する場合は、-hl parameterも指定しなければなりません。

例: /dev/hdisk2; /dev/dm-0

ex: /dev/hdisk2; /dev/dm-0

-adapter_list_adapter _ list_filename_

すべてのホストの間のネットワーク接続が RDMA を使用して ping 可能であることを検証するために、各ホストのホスト名、ネット名、アダプター名のリストを含むファイルの名前を指定します。 adapter_list filename への絶対パスを指定する必要があります。 Db2 12.1では、すべてのホストのアダプタ間でRDMAネットワークの接続性を確認するために、ルートを正しく設定するために、各ホストの各アダプタポートのMACアドレスも必要です。これは、Linux で RoCE ネットワークを構成した pureScale の場合にのみ必要です。サポートされる他のネットワーク・タイプ (Infiniband や TCP/IP ソケットなど) を Linux で構成した場合、また、AIX の場合はどのような構成でも、入力ファイル内の各行の MAC アドレスには値 0 を指定すれば十分です。

入力ファイルは、以下の形式でなければなりません。

#Hostname    Netname         Interface-Adapter    Mac-Address
hostname1    netname1-ro0    deviceName-1         macAddress-1
hostname2    netname2-ro1    deviceName-2         macAddress-2
hostname3    netname3-ro2    deviceName-3         macAddress-3

サンプル:

#Hostname          Netname                    Interface-Adapter          Mac-Address                                           
machine110         machine110-ro0             hca1                       A4:1B:2C:73:83:B1                                        
machine111         machine111-ro0             hca1                       A4:1B:2C:73:83:B2                               
machine112         machine112-ro0             hca1                       A4:1B:2C:73:83:B3

/etc/dat.confを参照して、インターフェース・アダプター名 ( dat.conf ファイルは、RHEL 8.x 以上では必要ありません)を見つけます。以下に例を示します。

from /etc/dat.conf: 
hca0 u1.2 nonthreadsafe default /usr/lib/libdapl/libdapl.a(shr_64.o) IBM.1.1 "/dev/iba0 1 ro0"

ここで、hca1 はアダプターのデバイス名です。

-aMACアドレスを確認するには、「ifconfig」コマンドを参照してください。例:

 ro0      Link encap:InfiniBand  HWaddr A4:1B:2C:73:83:B1
                   inet addr:192.168.10.101  Bcast:192.168.10.255  Mask:255.255.255.0
                   inet6 addr: fe80::202:2cff:fe73:83b1/64 Scope:Link
                   UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
                   RX packets:42445113 errors:0 dropped:0 overruns:0 frame:0
                   TX packets:53370185 errors:0 dropped:0 overruns:0 carrier:0
                   collisions:0 txqueuelen:1000
                   RX bytes:4685539133 (4468.4 Mb)  TX bytes:6176996772 (5890.8 Mb)

ここでは、A4:1B:2C:73:83:B1 (HWaddr 行) が、アダプターの Mac-Address です。

注: 入力ファイルでは、# が前に付いている行はコメントと見なされ、スキップされます。

-iu インスタンスユーザー

インスタンス・ユーザー名を指定します。インスタンス・ユーザー名の UID と GID は、それらがすべてのホストで同じであることを確認するために検査されます。このパラメーターを指定する場合は、 -hl パラメーターも指定しなければなりません。

-tb_dev デバイス

クラスタのクォーラムタイブレークデバイス-breaker として使用するために検証される共有ディスクのデバイス名を指定します。このパラメーターを指定する場合は -hl パラメーターも指定する必要があります。

-nm ネット名

ネット名のリストを指定します。これらのネット名は、すべてのホスト間で ping 可能であることを検査するために、 RocE & IB ネットワークを ping する際に使用されます。

例

システムが特定の Db2 バージョンの基本的な pureScale 前提条件を満たしているかどうかを確認するには、次のコマンドを発行します。

db2prereqcheck -p -v 12.1.0.0 
=============================================================================================================
Checking prerequisites for DB2 installation with the DB2 pureScale Feature.  Version: "12.1.0.0".  Operating system: "AIX".

Validating "IOPORTS" ...
The input/output completion Port (IOCP) is installed on host "hostA.torolab.ibm.com".
The input/output completion Port (IOCP) is  enabled on host "hostA.torolab.ibm.com".
   Requirement matched.

Validating "prereqSAM" ...
   Requirement matched.

Validating "free space" ...
The directory "/tmp" has enough space on host "hostA.torolab.ibm.com".
   Requirement matched.

Validating "free space" ...
The directory "/var" has enough space on host "hostA.torolab.ibm.com".
   Requirement matched.

Validating "free space" ...
The directory "/usr" has enough space on host "hostA.torolab.ibm.com".
   Requirement matched.

Validating "kernel level " ...
   Required minimum operating system kernel level: "7.1".
   Actual operating system kernel level: "7.1".
   Requirement matched.

Validating "Power hardware " ...
   Required minimum operating system Power level: "7".
   Actual operating system Power level: "7".
   Requirement matched.

Validating "AIX technology level and service pack " ...
   Required minimum technology level: "5" Service pack: "3"
   Actual technology level: "5" Service pack: "3"
   Requirement matched.

Validating "Java for TSAMP" ...
   Required minimum "Java" version: "7.1.0.145 or 7.0.0.265 or 6.0.0.265"
   Requirement matched.

Validating "XL C/C++ Runtime" ...
   Required minimum "XL C/C++ Runtime" level:  "13.1.2.0"
   Actual version:  "13.1.3.1"
   Requirement matched.
DBT3533I  The db2prereqcheck utility has confirmed that all installation prerequisites were met.

以下の出力例は、AIX オペレーティング・システムで生成されたものです。 Db2 pureScale uDAPLのみ'-uパラメータを使用する：

db2prereqcheck -u -v 12.1.0.0
==========================================================================

Checking prerequisites for DB2 installation. Version "12.1.0.0". Operating system "AIX"

Validating "uDAPL" ...
   Required minimum "uDAPL" level:  "7.1.5.3"
   Actual version:  "7.1.5.30"
   Requirement matched.
DBT3533I  The db2prereqcheck utility has confirmed that all installation prerequisites were met.

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

Checking prerequisites for DB2 installation with the DB2 pureScale Feature.  Version: "12.1.0.0".  Operating system: "AIX".

Validating "uDAPL" ...
   Required minimum "uDAPL" level:  "7.1.5.3"
   Actual version:  "7.1.5.30"
   Requirement matched.
DBT3533I  The db2prereqcheck utility has confirmed that all installation prerequisites were met.

以下の出力例は、AIX オペレーティング・システムで生成されたものです。クライアント・インストールの場合は、-c パラメーターを使用します。

db2prereqcheck -c -v 12.1.0.0
root@hostA.torolab.ibm.com./db2prereqcheck -c -v 12.1.0.0
==========================================================================
Tue Apr 22 07:37:18 2025
Checking prerequisites for DB2 installation. Version "12.1.0.0". Operating system "AIX" 

Validating "kernel level " ...
   Required minimum operating system kernel level: "7.3".
   Actual operating system kernel level: "7.3".
   Requirement matched.

Validating "Bin user" ...
   Requirement matched.

Validating "Power hardware " ...
   Required minimum operating system Power level: "8".
   Actual operating system Power level: "9".
   Requirement matched.

Validating "AIX technology level and service pack " ...
   Required minimum technology level: "2" Service pack: "0"
   Actual technology level: "2" Service pack: "3"
   Requirement matched.

Validating "IBM XL C++ Runtime for AIX 7.1 and later" ...
   Required minimum "IBM XL C++ Runtime for AIX 7.1 and later" 
   level:  "17.1.1.4"
   Actual version:  "17.1.1.4" 
   Requirement matched.
DBT3533I  The db2prereqcheck utility has confirmed that all installation prerequisites were met.
root@hostA.torolab.ibm.com>

以下の出力例は、Linux オペレーティング・システムで生成されたものです。 Db2 pureScaleのインストールには '-pパラメータを使用する：

db2prereqcheck -p -v 12.1.0.0
==========================================================================

Checking prerequisites for DB2 installation with the DB2 pureScale Feature.  Version: "12.1.0.0".  Operating system: "Linux".

Validating "Linux distribution " ...
   Required minimum operating system distribution: "RHEL"; Version: "7"; Service pack: "5".
   Actual operating system distribution Version: "7"; Service pack: "5".
   Requirement matched.

Validating "SELinux status " ...
   SELinux is "disabled ".
   Requirement matched.

Validating "libc.so version " ...
   glibc library is located in the following directory "/usr/lib64/libc-2.17.so".
   Required minimum glibc library version: "2.4.0"
   Actual glibc library version: "2.17.0"
   Requirement matched.

Validating "gcc" ...
   Package (or file) found: "gcc"
   Requirement matched.

Validating "binutils" ...
   Package (or file) found: "binutils"
   Requirement matched.

Validating "cpp" ...
   Package (or file) found: "cpp"
   Requirement matched.

Validating "gcc-c++" ...
   Package (or file) found: "gcc-c++"
   Requirement matched.

Validating "kernel-devel" ...
   Package (or file) found: "kernel-devel"
   Package "kernel-devel" level "3.10.0-957.5.1.el7.x86_64" match with the system "kernel" level "3.10.0-957.5.1.el7.x86_64".
   Requirement matched.

Validating "/usr/bin/ksh" ...
   Required minimum version for "/usr/bin/ksh": "20100621"
   Actual version of package: "20120801"
   Requirement matched.

Validating "/usr/sbin/ntpd" ...
   Required minimum version for "/usr/sbin/ntpd": "4.2.6p5"
   Requirement matched.

Validating "prereqSAM" ...
   Requirement matched.

Validating "free space" ...
The directory "/tmp" has enough space on host "hostA.fyre.ibm.com".
   Requirement matched.

Validating "free space" ...
The directory "/var" has enough space on host "hostA.fyre.ibm.com".
   Requirement matched.

Validating "free space" ...
The directory "/usr" has enough space on host "hostA.fyre.ibm.com".
   Requirement matched.

Validating "sg3_utils" ...
   Package (or file) found: "sg3_utils"
   Requirement matched.

Validating "sg_persist" ...
   Package (or file) found: "/usr/bin/sg_persist"
   Requirement matched.

Validating "kernel level " ...
   Required minimum operating system kernel level: "2.6.16".
   Actual operating system kernel level: "3.10.0".
   Requirement matched.

Validating "C++ Library version " ...
   Required minimum C++ library: "libstdc++.so.6"
   Standard C++ library is located in the following directory: "/usr/lib64/libstdc++.so.6.0.19".
   Actual C++ library: "CXXABI_1.3.1"
   Requirement matched.


Validating "32 bit version of "libstdc++.so.6" " ...
   Found the 32 bit "/lib/libstdc++.so.6" in the following directory "/lib".
   Requirement matched.

Validating "libaio.so version " ...
DBT3553I  The db2prereqcheck utility successfully loaded the libaio.so.1 file.
   Requirement matched.

Validating "libnuma.so version " ...
DBT3610I  The db2prereqcheck utility successfully loaded the libnuma.so.1 file.
   Requirement matched.

Validating "/lib/libpam.so*" ...
   Requirement matched.
DBT3533I  The db2prereqcheck utility has confirmed that all installation prerequisites were met.

次のサンプルは、システムが単一の InfiniBand ポート・クラスター・ネットワーク構成の前提条件を満たしているかどうかを検査します。

db2prereqcheck -v 12.1.0.0 -p -t SINGLE_IB_PORT_CLUSTER
==========================================================================

Checking prerequisites for DB2 installation with the DB2 pureScale Feature.  Version: "12.1.0.0".  Operating system: "Linux".

Validating "Linux distribution " ...
   Required minimum operating system distribution: "RHEL"; Version: "7"; Service pack: "5".
   Actual operating system distribution Version: "7"; Service pack: "5".
   Requirement matched.

Validating "SELinux status " ...
   SELinux is "disabled ".
   Requirement matched.

Validating "libc.so version " ...
   glibc library is located in the following directory "/usr/lib64/libc-2.17.so". 
   Required minimum glibc library version: "2.4.0"
   Actual glibc library version: "2.17.0"
   Requirement matched.

...

Validating Infiniband Support Package: libibcm.x86_64 ...
   Package (or file) found: libibcm.x86_64
   Requirement matched.

Validating Infiniband Support Package: librdmacm.x86_64 ...
   Package (or file) found: librdmacm.x86_64
   Requirement matched.

...

Validating Reliable Scalable Cluster Technology Package:
   librdmacm.i686 ...
   Package (or file) found: librdmacm.i686
   Requirement matched.

Validating Reliable Scalable Cluster Technology Package:
   libcxgb3.i686 ...
   Package (or file) found: libcxgb3.i686
   Requirement matched.

...

DBT3533I  The db2prereqcheck utility has confirmed that all installation prerequisites were met for Db2 database
server with Db2pureScale Feature. Version: "12.1.0.0".

次のサンプルは、システムが複数の InfiniBand ポート・クラスター・ネットワーク構成の前提条件を満たしているかどうかを検査します。

db2prereqcheck -p -v 12.1.0.0 -t MULTI_ROCE_PORT_CLUSTER
==========================================================================

Checking Db2 prerequisites for Db2 database version 12.1.0.0 on operating system "Linux"

Validating Linux distribution ...
   Required minimum operating system distribution: "RHEL"; Version: “7”;
   Service pack: “5”.
   Actual operating system distribution Version: “7”; Service pack: “5”.
   Requirement matched.

...

Validating Infiniband Support Package: libibcm.x86_64 ...
   Package (or file) found: libibcm.x86_64
   Requirement matched.

Validating Infiniband Support Package: librdmacm.x86_64 ...
   Package (or file) found: librdmacm.x86_64
   Requirement matched.

...

Validating High Performance Networking Package: libibverbs-rocee.x86_64 ...
   Package (or file) found: libibverbs-rocee.x86_64
   Requirement matched.

Validating High Performance Networking Package: libmlx4-rocee.x86_64 ...
   Package (or file) found: libmlx4-rocee.x86_64
   Requirement matched.

Validating Reliable Scalable Cluster Technology Package: libibcm.i686 ...
   Package (or file) found: libibcm.i686
   Requirement matched.

Validating Reliable Scalable Cluster Technology Package: librdmacm.i686 ...
   Package (or file) found: librdmacm.i686
   Requirement matched.

...

DBT3533I  The db2prereqcheck utility has confirmed that all installation prerequisites were met for Db2 database server with Db2
pureScale Feature. Version: "12.1.0.0".

システムが Db2 12.1 の前提条件を満たしているかどうかを確認するには、次のコマンドを実行してください：

db2prereqcheck -v 12.1.0.0 -s

システムが、 Db2 12.1 のシンクライアントの前提条件を満たしているかどうかを確認するには、次のコマンドを実行してください：

db2prereqcheck -c -v 12.1.0.0 -s