DB2 - Problem description
| Problem IC64658 | Status: Closed |
DB2HAICU ON PRIMARY HADR DATABASE MAY FAIL AT THE END OF THE SETUP. | |
| product: | |
DB2 FOR LUW / DB2FORLUW / 970 - DB2 | |
| Problem description: | |
At the end of the setup, db2haicu on primary node may fail
saying:
The HADR database TSA cannot be added to the cluster because the
standby instance is not configured in the domain. Run db2haicu
on the standby instance to configure it into the cluster.
In the db2diag.log, we can see the following probe point. Data
#2 showed 'DB2TSA' as the remote instance name in uppercase
letters.
2009-01-21-14.34.07.639034-300 E5403185A588 LEVEL: Error
PID : 344298 TID : 1 PROC :
db2haicu
INSTANCE: db2tsa NODE : 000
EDUID : 1
FUNCTION: DB2 Common, SQLHA APIs for DB2 HA Infrastructure,
sqlhaUICreateHADR, probe:900
RETCODE :
ECF=0x9000056F=-1879046801=ECF_SQLHA_HADR_VALIDATION_FAILED
The HADR DB failed validation before being added to
the cluster
DATA #1 : String, 6 bytes
db2tsa
DATA #2 : String, 6 bytes
DB2TSA
DATA #3 : String, 10 bytes
amdha01
DATA #4 : String, 10 bytes
amdha02
DATA #5 : String, 3 bytes
TSA
This was because HADR_REMOTE_INST was set to capitalized
letters, as in
HADR instance name of remote server (HADR_REMOTE_INST) = DB2TSA | |
| Problem Summary: | |
**************************************************************** * USERS AFFECTED: * * db2haicu users with HADR configuration * **************************************************************** * PROBLEM DESCRIPTION: * * At the end of the setup, db2haicu on primary node may fail * * * * saying: * * * * * * * * The HADR database TSA cannot be added to the cluster because * * the * * standby instance is not configured in the domain. Run * * db2haicu * * on the standby instance to configure it into the cluster. * * * * * * * * In the db2diag.log, we can see the following probe point. * * Data * * #2 showed 'DB2TSA' as the remote instance name in uppercase * * * * letters. * * * * * * * * 2009-01-21-14.34.07.639034-300 E5403185A588 LEVEL: * * Error * * PID : 344298 TID : 1 PROC : * * * * db2haicu * * * * INSTANCE: db2tsa NODE : 000 * * * * EDUID : 1 * * * * FUNCTION: DB2 Common, SQLHA APIs for DB2 HA Infrastructure, * * * * sqlhaUICreateHADR, probe:900 * * * * RETCODE : * * * * ECF=0x9000056F=-1879046801=ECF_SQLHA_HADR_VALIDATION_FAILED * * * * The HADR DB failed validation before being added * * to * * the cluster * * * * DATA #1 : String, 6 bytes * * * * db2tsa * * * * DATA #2 : String, 6 bytes * * * * DB2TSA * * * * DATA #3 : String, 10 bytes * * * * amdha01 * * * * DATA #4 : String, 10 bytes * * * * amdha02 * * * * DATA #5 : String, 3 bytes * * * * TSA * * * * * * * * This was because HADR_REMOTE_INST was set to capitalized * * * * letters, as in * * * * HADR instance name of remote server (HADR_REMOTE_INST) = * * DB2TSA * **************************************************************** * RECOMMENDATION: * * This is a configuration error, ensure the db cfg are correct * * and in the same case. (e.g. HADR_REMOTE_INST) * * A warning message will be added to the db2diag.log in DB2 * * V9.7.0.1. * **************************************************************** | |
| Local Fix: | |
Change the value for HADR_REMOTE_INST to lower-case letters on both primary and standby databases like the following. HADR instance name of remote server (HADR_REMOTE_INST) = db2tsa | |
| available fix packs: | |
DB2 Version 9.7 Fix Pack 1 for Linux, UNIX, and Windows | |
| Solution | |
A better diagnostic warning message will be added to db2diag.log to remind customer to check the db cfg to ensure they match and are the same case. This message is added to DB2 V9.7.0.1. | |
| Workaround | |
not known / see Local fix | |
| Timestamps | |
Date - problem reported : Date - problem closed : Date - last modified : | 19.11.2009 18.02.2010 18.02.2010 |
| Problem solved at the following versions (IBM BugInfos) | |
9.7.0.1 | |
| Problem solved according to the fixlist(s) of the following version(s) | |
| 9.7.0.1 |
|