db2prereqcheck - Check installation prerequisites
Checks whether your system meets the prerequisites for the installation of a specific version of Db2®.
By using this command, you can determine whether your system satisfies the prerequisites before you begin the installation process. Please note you must download the installation media to run db2prereqcheck Db2 and start the installation process.
The db2prereqcheck command uses a resource XML file that contains the prerequisites. The default path of the XML file for Linux® and UNIX is located in DB2 installation/cfg/DB2prereqs.xml. You must have read or write permissions on the XML file. Do not modify the contents of the XML file.No error from db2prereqcheck does not mean the current environment is supported or tested. For the most up-to-date installation requirements for data server products, see System requirements for IBM® Db2 for Linux, UNIX, and Windows.
Authorization
Root user or non-root user authority is required on Linux and UNIX operating systems.
Command Syntax
Command Parameters
- -v version
- Checks the prerequisites for a specific Db2 version. The -i and -v parameters are mutually exclusive.
- -l
- Checks the prerequisites related to Db2 pureScale and unrelated to Db2 pureScale environments for the latest Db2 version that is defined in the XML resource file. The -l and -v parameters are mutually exclusive. The -l parameter will not print any output to the screen if all prerequisites are met.
- -f xml-file
- Specifies the name of the XML resource file. If you do not specify the -f parameter, the DB2 installation/cfg/DB2prereqs.xml file is used.
- -c
- Checks the prerequisites for thin client.
- -p
- Checks the prerequisites for the Db2 pureScale environment (Linux and AIX® operating systems only). This is the default option.
- -o output-file
- Specifies a name for the output file such as db2prereqcheck.rpt. If you do not specify a filename the output is displayed on the screen.
- -s
- Prints prerequisite validation summary on screen.
- -u
- Checks the uDAPL requirement for the Db2 pureScale environment (Linux and AIX operating systems only).
- -g
- Checks the GPL compilation requirement (Linux operating systems only).
- -i
- Checks the prerequisites that are unrelated to Db2 pureScale environments for the latest Db2 version that you defined in the XML resource file. The -i and -v parameters are mutually exclusive.
- -t
- Validates the prerequisites for a specific type of network configuration (Linux operating systems only)
- -hl host-name
- Specifies a list of hosts that are checked for passwordless root SSH access between all hosts.
- -dl device
- Specifies one or more device paths of the shared disks that are verified in order
to make sure that they are accessible by all hosts. If you specify this parameter, you must also
specify the -hl parameter.
For example:
ex: /dev/hdisk2; /dev/dm-0/dev/hdisk2; /dev/dm-0
- -adapter_list adapter_list_filename
- Specifies the file name that contains the list of hostname(s), netname(s), adapter name(s), or each of the host to verify the network connectivity between all the hosts are pingable using RDMA. A full path to the adapter_list filename must be specified. Starting from Db2 V11.1.3.3, the MAC addresses of each adapter port for each host is also required in order to setup the routes correctly to verify the RDMA network connectivity among all hosts' adapters. This is only required on pureScale configured with RoCE network on Linux. For any configuration with other supported network types such as (Infiniband or TCP/IP sockets) on Linux or any configuration on AIX, specify a value of 0 as MAC address for each row in the input file suffices.
- -iu instance_user
- Specifies the instance user name. The UID and GID of the instance user name are verified to make sure they are the same across all hosts. If you specify this parameter, you must also specify the -hl parameter.
- -tb_dev device
-
Specifies the device name of the shared disk that is verified for use as the quorum tie-breaker device for the cluster. If you specify this parameter, you must also specify the -hl parameter.
- -nm netname
- Specifies the list of netnames. These netnames are used to ping the RocE & IB networks to verify that they are pingable between all hosts.
Examples
To check whether the system meets the basic pureScale prerequisites for a specific Db2 version, issue the following command:
$ ./db2prereqcheck -p -v 11.1.0.0 -hl <host1,host2..> -dl <shared_disk1,shared_disk2..>
-iu <user>
To check whether the system meets the comprehensive pureScale prerequisites for a specific type of network configuration (Linux operating systems only) and for a specific Db2 version, issue the following command:
$ ./db2prereqcheck -p -v 11.1.0.0 -hl <host1,host2..> -dl <shared_disk1,shared_disk2..>
-iu <user> -nm <netname1,netname2..>
db2prereqcheck -v 11.1.0.0 -s
db2prereqcheck -c -v 11.1.0.0 -s