db2prereqcheck コマンドの使用によるインストール前提条件の検査
db2prereqcheck コマンドを使用して、特定の Db2® バージョンのソフトウェア前提条件の確認、レポート・ファイルの生成、およびその他のタスクの実行を行うことができます。
db2prereqcheck コマンドを使用すると、Db2 インストールを開始することなく、システムが Db2 インストール前提条件を満たしているかどうかを判別できます。 このコマンドは、オペレーティング・システム・レベル、 Linux® ディストリビューション、 AIX® テクノロジー・レベル、C ライブラリー、ランタイム・パッチなどの前提条件を検査します。 このコマンドは、クライアント uDAPL、GPL、および Db2 pureScale®に関連する前提条件も検査します。
Db2 製品には、 db2prereqcheck バイナリーと DB2prereqs.xml ファイルが付属しています。 これらのファイルは、インストール・イメージが置かれているフォルダー内にあります。 AIX オペレーティング・システムの場合、 DB2prereqs.xml ファイルは、 db2/aix/install ディレクトリーと db2/aix/bin ディレクトリーの両方にあります。 DB2prereqs.xml ファイルには、 バージョン 9.8 フィックスパック 2 から バージョン 11.5までの前提条件が含まれています。 このファイルの内容を変更してはなりません。 インストール・イメージがあるディレクトリー内で db2prereqcheck コマンドを実行する必要があります。
パラメーターを指定しないで db2prereqcheck コマンドを実行すると、システムがリソース XML ファイルに定義されているすべての Db2 リリースおよびフィックスパックの前提条件をシステムが満たしているかどうかが判別されます。
リソース XML ファイルに定義した最新の Db2 バージョンの前提条件を確認するには、以下の例に示すように、 -i パラメーターを指定して db2prereqcheck コマンドを発行します。
$ ./db2prereqcheck -i
注意: -i パラメーターは、 Db2 pureScale に関連しない前提条件を検査します。Db2 バージョン 11.5の場合、リソース XML ファイルに定義した最新の Db2 バージョンの前提条件を確認するには、 -l パラメーターを指定して db2prereqcheck コマンドを発行します。 以下に、このコマンドの例を示します。
$ ./db2prereqcheck -l
リソース XML ファイルで定義した特定の Db2 バージョンの前提条件をシステムが満たしているかどうかを確認するには、 -v version_number パラメーターを指定して db2prereqcheck コマンドを発行します。 例えば、 Db2 バージョン 11.5の前提条件が満たされているかどうかを確認するには、次のコマンドを発行します。
$ ./db2prereqcheck -v 11.5.0.0
db2prereqcheck コマンドによる妥当性検査情報と出力 (失敗したすべてのテストのリストを示す要約セクションを含む) を内容とするレポート・ファイルを生成するには、-o <filename> パラメーターを使用します。 別のディレクトリーに生成するレポート・ファイル名の完全パスを指定します。 Db2 製品をインストールするための前提条件は、以下の例に示すように、 -o <filename> パラメーターを指定せずにコマンド画面に表示されます。
$ ./db2prereqcheck -v 11.5.0.0 -o report.rpt
XML ファイルを指定するには、以下の例に示すように -f パラメーターを使用できます。
-f パラメーターを指定しない場合、デフォルトの XML ファイル (DB2 installation/cfg/DB2prereqs.xml) が使用されます。$ ./db2prereqcheck -i -f ./newDB2prereqs.xml
- AIX64 および Linuxamd64 オペレーティング・システムの場合、 Db2 pureScale インストールの前提条件を検証するには、 -p パラメーターを使用します。 以下の例は、-p パラメーターの使用法を示しています。
$ ./db2prereqcheck -p -v 11.5.0.0
重要: -p パラメーターを指定すると、 db2prereqcheck はフリー・スペースを検査します。 特に、db2prereqcheck は、使用可能なスペースが /tmp に 2 GB、 /var に 500 MB、/opt に 5 GB あるかどうかを検査します。 - Linuxamd64 オペレーティング・システムの場合、 Db2 pureScale インストール済み環境の特定のネットワーク構成の前提条件を検証するには、 -p オプションと -t <network configuration type> オプションの両方を指定して db2prereqcheck コマンドを使用します。 ネットワーク構成タイプは、単一の InfiniBand ポート・クラスター、複数の InfiniBand ポート・クラスター、単一の RoCE ポート・クラスター、または複数の RoCE ポート・クラスター (SINGLE_IB_PORT_CLUSTER、MULTI_IB_PORT_CLUSTER、 SINGLE_ROCE_PORT_CLUSTER、または MULTI_ROCE_PORT_CLUSTER) に設定する必要があります。 以下の例に示すように、db2prereqcheck コマンドを発行できます。
$ ./db2prereqcheck -v 11.5.0.0 -p -t <network configuration type>
注: -t パラメーターは推奨されません。代わりに -nm パラメーターとともに -hl を使用してください。
db2prereqcheck コマンドが、以下の DBT3507E のように、システムが前提条件を満たしていないことを示す場合、 次の例は、このコマンドの使用法を示しています。
Validating ofed ...
Required minimum version and release for ofed: 1.5.2-(null)
DBT3507E The db2prereqcheck utility failed to verify installation prerequisites
because the utility failed to find the following package or file: "ofed".
ERROR: Requirement not matched.
db2prereqcheck コマンドの出力例
以下の出力例は、AIX オペレーティング・システムで生成されたものです。 Db2 pureScale インストール済み環境の場合は、 -p パラメーターを使用します。
> > db2prereqcheck -p -v 11.5.0.0
==========================================================================
Checking prerequisites for Db2 installation with the Db2
pureScale Feature. Version: "11.5.0.0 Operating system: "AIX".
Validating kernel level ...
Required minimum operating system kernel level : "7.1".
Actual operating system kernel level: "7.1".
Requirement matched.
Validating "AIX technology level and service pack" ...
Required minimum technology level: "3" Service pack: "5"
Actual technology level: "3" Service pack: '5'
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.2.0"
Requirement matched.
Validating "IOPORTS" ...
The input/output completion Port (IOCP) is installed on host "coralpib241".
The input/output completion Port (IOCP) is enabled on host "coralpib241". Requirement matched.
Validating "free space" ...
The directory "/tmp" has enough space on host "coralpib241".
Requirement matched.
Validating "free space" ...
The directory "/var" has enough space on host "coralpib241".
Requirement matched.
Validating "free space" ...
The directory "/usr" has enough space on host "coralpib241".
Requirement matched.
DBT3533I The db2prereqcheck utility has confirmed that all installation
prerequisites were met.
以下の出力例は、AIX オペレーティング・システムで生成されたものです。 -u パラメーターは、 Db2 pureScale uDAPL の場合にのみ使用します。
> db2prereqcheck -u -v 11.5.0.0
==========================================================================
Checking prerequisites for Db2 installation. Version "11.5.0.0". Operating "AIX"
Validating uDAPL ...
Required minimum uDAPL level: 7.1.3.30
Actual version: 7.1.3.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: "11.5.0.0". Operating system: "AIX".
Validating uDAPL ...
Required minimum uDAPL level: 7.1.3.30
Actual version: 7.1.3.30
Requirement matched.
DBT3533I The db2prereqcheck utility has that all installation prerequisites were met.
以下の出力例は、AIX オペレーティング・システムで生成されたものです。 クライアント・インストールの場合は、-c パラメーターを使用します。
> db2prereqcheck -c -v 11.5.0.0
==========================================================================
Checking prerequisites for Db2 installation. Version "11.5.0.0". Operating "AIX"
Validating kernel level ...
Required minimum operating system kernel level : "7.1".
Actual operating system kernel level: "7.1".
Requirement matched.
Validating AIX technology level and service pack ...
Required minimum technology level: "3" Service pack: "5"
Actual technology level: "3" Service pack "5"
Requirement matched.
Validating XL C/C++ Runtime ...
Required minimum XL C/C++ Runtime level: "13.1.2.0"
Actual version: "13.1.2.0"
Requirement matched.
DBT3533I The db2prereqcheck utility has confirmed that all installation
prerequisites were met.
以下の出力例は、AIX オペレーティング・システムで生成されたものです。 妥当性検査の要約のみ表示する場合は、-s パラメーターを使用します。
> db2prereqcheck -s -v 11.5.0.0
DBT3533I The db2prereqcheck utility has that all installation prerequisites were met.
DBT3533I The db2prereqcheck utility has that all installation prerequisites were met.
以下の出力例は、Linux オペレーティング・システムで生成されたものです。 Db2 pureScale インストール済み環境の場合は、 -p パラメーターを使用します。
> db2prereqcheck -p -v 11.5.0.0
==========================================================================
Checking prerequisites for Db2 installation with the Db2
pureScale Feature. Version: "11.5.0.0". Operating system: "Linux".
Validating "Linux distribution" ...
Required minimum operating system distribution: "SUSE"; Version: "11"; Service pack "4".
Actual operating system distribution Version: "11"; Service pack: "4".
Requirement matched.
Validating "kernel level " ...
Required minimum operating system level: "2.6.16".
Actual operating system kernel level "3.0.101".
Requirement matched.
Validating "C++ Library version " ...
Required minimum C++ library: "libstdc++.so.6"
Standard C++ library is located in 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 64 bit "/usr/lib64/libstdc++.so.6" in the following directory "/usr/lib64".
Found the 32 bit "/usr/lib/libstdc++.so.6" in the following directory "/usr/lib".
Requirement matched.
Validating sles-release ...
Required minimum version and release for sles-release: 11.4.23
Actual version of package: 11.4
Requirement matched.
Validating kernel level ...
Required minimum kernel level : 3.0.101
Actual kernel level: 3.0.101-68.1
Requirement matched.
Validating C++ Library version ...
Required minimum C++ library: libstdc++.so.6
Standard C++ library is located at: /usr/lib64/libstdc++.so.6.0.10
Actual C++ library: CXXABI_1.3.1
Validating 32 bit version of libstdc++.so.6 ...
Found the 64 bit /usr/lib64/libstdc++.so.6 at /usr/lib64
Found the 32 bit /usr/lib/libstdc++.so.6 at /usr/lib
Requirement matched.
Validating libc.so version ...
glibc library is located in the following directory "/lib64/libc-2.11.3.so".
Required minimum glibc library version: "2.4.0"
Actual glibc library version: "2.11.3"
Requirement matched.
Validating libaio.so version ...
glibc library is located in the following directory "/lib64/libc-2.11.3.so".
Required minimum glibc library version "2.4.0"
Actual glibc library version: "2.11.3"
Requirement matched.
Validating "libaio.so version " ...
DBT3553I The db2prereqcheck utility successfully loaded the libaio.so.1 file.
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-source" ...
Package (or file) found: "kernel-source"
Requirement matched.
Validating "Intel TCO WatchDog Timer Driver modules" ...
The db2prereqcheck utility found that Intel TCO WatchDog Timer Driver module "iTCO_wdt is not loaded.
The db2prereqcheck utility found that Intel TCO WatchDog Timer Driver module "iTCO_vendor_support" is not loaded.
Requirement matched.
Validating "free space" ...
The directory "/tmp" has enough space on host "coralxib18".
Requirement matched.
Validating "free space" ...
The directory "/var" has enough space on host "coralxib18".
Requirement matched.
Validating "free space" ...
The directory "/usr" has enough space on host "coralxib18".
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 "/lib/libpam.so*" ...
Requirement matched.
DBT3533I The db2prereqcheck utility has confirmed that all installation prerequisites were met.
以下の出力例は、Linux オペレーティング・システムで生成されたものです。 特定のネットワーク構成の前提条件を確認するには、-p および -t のパラメーターを使用します。 出力は、 Db2 pureScale 環境における単一の InfiniBand ポート・クラスター構成の検証の結果を示しています。
db2prereqcheck -v 11.5.0.0 -p -t SINGLE_IB_PORT_CLUSTER
Checking Db2 prerequisites for Db2 database version 11.5.0.0 on
operating system "Linux"
Validating Linux distribution ...
Required minimum operating system distribution: "RHEL";
Version: "6"; Service pack: "7".
Actual operating system distribution Version: "6";
Service pack: "7".
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 Db2
pureScale Feature. Version: "11.5.0.0".
以下の出力例は、Linux オペレーティング・システムで生成されたものです。 出力には、 Db2 pureScale 環境で複数の RoCE ポート・クラスター構成を検証した結果が示されます。
db2prereqcheck -v 11.5.0.0 -p -t MULTI_ROCE_PORT_CLUSTER
==========================================================================
Checking Db2 prerequisites for Db2 database version 11.5.0.0 on operating
system "Linux"
Validating Linux distribution ...
Required minimum operating system distribution: "RHEL"; Version: "6";
Service pack: "7".
Actual operating system distribution Version: "6"; Service pack: "7".
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: "11.5.0.0".
以下の出力例は、Linux オペレーティング・システムで生成されたものです。 Db2 pureScale uDAPL の場合のみ、 -u パラメーターを使用します。
> db2prereqcheck -u -v 11.5.0.0
==========================================================================
Checking prerequisites for Db2 installation. Version "11.5.0.0". Operating "Linux"
Validating "dapl" ...
Required minimum version for "dapl: "2.0.25"
Actual version of package: "2.0.34"
Requirement matched.
Validating "/lib/libpam.so*" ...
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: "11.5.0.0".
Operating system: "Linux".
Validating "dapl" ...
Required minimum version for "dapl": "2.0.25"
Actual version of package: "2.0.34"
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.
All requirement matched for Db2 Server version 11.5.0.0 .
==========================================================================
Checking Db2 Prerequisites for Db2 Version 11.5.0.0 on Linux
Validating "dapl" ...
Required minimum version for "dapl": "2.0.25"
Actual version of package: "2.0.34"
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 "/lib/libpam.so*" ...
Requirement matched.
DBT3533I The db2prereqcheck utility has confirmed that all installation prerequisites were met.
The following sample output was generated on a Linux operating system. Use the -c parameter for a client installation.
以下の出力例は、Linux オペレーティング・システムで生成されたものです。 クライアント・インストールの場合は、-c パラメーターを使用します。
> db2prereqcheck -c -v 11.5.0.0
==========================================================================
Checking Db2 Prerequisites for Db2 Version 11.5.0.0 on Linux
Validating Linux distribution ...
Required minimum SUSE version : (null) SP (null)
Validating sles-release ...
Required minimum version and release for sles-release: 11.4.23
Actual version of package: 11.4
Requirement matched.
Validating kernel level ...
Required minimum kernel level : 3.0.101
Actual kernel level: 3.0.101-68.1
Requirement matched.
Validating C++ Library version ...
Required minimum C++ library: libstdc++.so.6
Standard C++ library is located at: /usr/lib64/libstdc++.so.6.0.10
Actual C++ library: CXXABI_1.3.1
Validating 32 bit version of libstdc++.so.6 ...
Found the 64 bit /usr/lib64/libstdc++.so.6 at /usr/lib64
Found the 32 bit /usr/lib/libstdc++.so.6 at /usr/lib
Requirement matched.
All requirement matched for Db2 Client version 11.5.0.0 .
==========================================================================
Checking Db2 Prerequisites for Db2 Version 11.5.0.0 on Linux
Validating Linux distribution ...
Required minimum SUSE version : (null) SP (null)
Validating sles-release ...
Required minimum version and release for sles-release: 11.4.23
Actual version of package: 11.4
Requirement matched.
Validating kernel level ...
Required minimum kernel level : 3.0.101
Actual kernel level: 3.0.101-68.1
Requirement matched.
Validating C++ Library version ...
Required minimum C++ library: libstdc++.so.6
Standard C++ library is located at: /usr/lib64/libstdc++.so.6.0.10
Actual C++ library: CXXABI_1.3.1
Validating 32 bit version of libstdc++.so.6 ...
Found the 64 bit /usr/lib64/libstdc++.so.6 at /usr/lib64
Found the 32 bit /usr/lib/libstdc++.so.6 at /usr/lib
Requirement matched.
Validating libc.so version ...
glibc library is located at: /lib64/libc-2.11.1.so
Required minimum glibc library version: 2.4.0
Actual glibc library version: 2.11.1
Requirement matched.
Validating ofed ...
Required minimum version and release for ofed: 1.5.2-(null)
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.
All requirement matched for Db2 Client version 11.5.0.0 Db2
pureScale Feature.
以下の出力例は、Linux オペレーティング・システムで生成されたものです。 妥当性検査の要約のみ表示する場合は、-s パラメーターを使用します。
DBT3533I The db2prereqcheck utility has confirmed that all installation prerequisites were met.
DBT3533I The db2prereqcheck utility has confirmed that all installation prerequisites were met.
以下の出力例は、Linux オペレーティング・システムで生成されたものです。 アダプターのタイプを確認するには、-nm パラメーターまたは -nl パラメーターを使用します。
> ./db2prereqcheck -v 11.5.0.0 -p -nm coralinst09-ib0
Validating ....
Validating....
Validating "Adapter and " ...
The db2prereqcheck utility found that Interface Adapter "coralinst09-ib0" is an InfiniBand Adapter
which is currently RDMA capable on host "coralinst09".