Configuring a clustered environment using Db2 High Availability Instance Configuration Utility (db2haicu)

You can configure and administer your databases in a clustered environment using Db2® high availability instance configuration utility (db2haicu). When you specify database manager instance configuration details to db2haicu, db2haicu communicates the required cluster configuration details to your cluster managing software.

Before you begin

There is a set of tasks you must perform before using Db2 high availability instance configuration utility (db2haicu). For more information, see: Db2 High Availability Instance Configuration Utility (db2haicu) prerequisites.

About this task

You can run db2haicu interactively, or using an XML input file:

Interactive mode: When you invoke Db2 high availability instance configuration utility (db2haicu) by running the db2haicu command without specifying an XML input file with the -f parameter, the utility runs in interactive mode. In interactive mode, db2haicu displays information and queries you for information in a text-based format. For more information, see: Running Db2 High Availability Instance Configuration Utility (db2haicu) in interactive mode
Batch mode with an XML input file: You can use the -f input-file-name parameter with the db2haicu command to run Db2 high availability instance configuration utility (db2haicu) with an XML input file specifying your configuration details. Running db2haicu with an XML input file is useful when you must perform configuration tasks multiple times, such as when you have multiple database partitions to be configured for high availability. For more information, see: Running Db2 High Availability Instance Configuration Utility (db2haicu) with an XML input file

For a detailed scenario that uses db2haicu with both methods to set up an HADR pair, see the Automating HADR on Db2 10.1 for Linux, UNIX and Windows Failover Solution Using Tivoli System Automation for Multiplatforms white paper, which is also applicable to higher versions of Db2.

Db2 instances that are configured in Version 9.1 for high availability by using the regdb2salin script are not supported on Versions 9.5 and later. Use the db2haicu utility to configure these instances for high availability.

Restrictions

There are some restrictions for using the Db2 high availability instance configuration utility (db2haicu). For more information, see: Db2 high availability instance configuration utility (db2haicu) restrictions.

Procedure

Perform the following steps for each database manager instance:

Create a new cluster domain.
When you run Db2 high availability instance configuration utility (db2haicu) for the first time for a database manager instance, db2haicu creates a model of your cluster, called a cluster domain. For more information, see: Creating a cluster domain using Db2 High Availability Instance Configuration Utility (db2haicu).
Continue to refine the cluster domain configuration, and administer and maintain the cluster domain
When you are modifying the cluster domain model of your clustered environment using db2haicu, the database manager propagates the related changes to your database manager instance and cluster configuration. For more information, see: Maintaining a cluster domain using Db2 High Availability Instance Configuration Utility (db2haicu).

What to do next

Db2 high availability instance configuration utility (db2haicu) does not have a separate diagnostic log. You can investigate and diagnose db2haicu errors using the database manager diagnostic log, db2diag log file, and the db2pd tool. For more information, see: Troubleshooting Db2 High Availability Instance Configuration Utility (db2haicu)

In addition, the cluster manager that is used by the db2haicu utility is IBM® Tivoli® System Automation for Multiplatforms (SA MP). When troubleshooting cluster manager related issues, it is often necessary to collect trace diagnostic information for SA MP. For this reason, it is highly recommended that you configure trace spooling for SA MP. For more information about configuring trace spooling for SA MP, see http://www-01.ibm.com/support/docview.wss?uid=swg21375626. The IBM Tivoli System Automation for Multiplatforms (SA MP) data collection guide also has an appendix that describes trace spooling with different stanzas for the various subcomponents that make up the Reliable Scalable Cluster Technology (RSCT) and SA MP.