Upgrading PowerHA? Don't forget your TSM client!
cggibbo 270000TMUJ Visits (12173)
When you upgrade PowerHA (formerly HACMP) don’t forget to check/update your TSM client as well!
We successfully upgraded from PowerHA 5.4 to PowerHA 6.1 SP6 first.
# halevel -s
We found that our
DB2 backups to TSM were no longer working.
$ db2adutl query
Error: Initialize environment failed with TSM return code 4602
In the TSM error log file we also saw the following message repeated over and over:
# tail -1 dsmerror_db2_ha.log
10/17/11 12:42:57 ANS1478E CLUSTERNODE is set to YES but the cluster software is not available on this system.
Obviously cluster services were most
certainly installed and running! So we suspected the TSM client was in need of
an update or two! This was no surprise to us.
The current installed TSM client version was 5.5.2.
# lslpp -L tivoli*
tivoli.tivguid 126.96.36.199 C F IBM Tivoli GUID on AIX
We upgraded the TSM client to version 6.2.
# lslpp -l tiv*
188.8.131.52 COMMITTED TSM Client - Application
Now our DB2 connection to the TSM server was working again.
$ db2adutl query
Query for database C01DCVBD1
Retrieving FULL DATABASE BACKUP information.
1 Time: 20111024221807 Oldest log: S0093112.LOG DB Partition Number: 0 Sessions: 1
2 Time: 20111023215632 Oldest log: S0093111.LOG DB Partition Number: 0 Sessions: 1
3 Time: 20111022220109 Oldest log: S0093109.LOG DB Partition Number: 0 Sessions: 1
4 Time: 20111021221842 Oldest log: S0093108.LOG DB Partition Number: 0 Sessions: 1
5 Time: 20111020223428 Oldest log: S0093106.LOG DB Partition Number: 0 Sessions: 1
6 Time: 20111019221958 Oldest log: S0093105.LOG DB Partition Number: 0 Sessions: 1
7 Time: 20111018221802 Oldest log: S0093103.LOG DB Partition Number: 0 Sessions: 1
Retrieving INCREMENTAL DATABASE BACKUP information.
No INCREMENTAL DATABASE BACKUP images found for C01DCVBD1
Retrieving DELTA DATABASE BACKUP information.
No DELTA DATABASE BACKUP images found for C01DCVBD1
Retrieving TABLESPACE BACKUP information.
No TABLESPACE BACKUP images found for C01DCVBD1
Retrieving INCREMENTAL TABLESPACE BACKUP information.
No INCREMENTAL TABLESPACE BACKUP images found for C01DCVBD1
Retrieving DELTA TABLESPACE BACKUP information.
No DELTA TABLESPACE BACKUP images found for C01DCVBD1
Retrieving LOAD COPY information.
No LOAD COPY images found for C01DCVBD1
Retrieving LOG ARCHIVE information.
Log file: S0093099.LOG, Chain Num: 9, DB Partition Number: 0, Taken at: 2011-10-15-04.03.52
We also discovered that we needed to comment out the following entries in the TSM client dsm.sys file (note the MAILPROG variable appeared twice in our dsm.sys file):
The latest TSM client no longer supports the MAILPROG option, as we discovered when we ran the TSM client from the command line:
# dsmc q sess
ANS1677W The MAILPROG option is ignored because it is no longer supported.
IBM Tivoli Storage Manager
Command Line Backup/Archive Client Interface
Client Version 5, Release 5, Level 2.0
Client date/time: 17-10-2011 12:01:34
(c) Copyright by IBM Corporation and other(s) 1990, 2009. All Rights Reserved.
Node Name: AIX1
Session established with server TSM1: AIX-RS/6000
Server Version 5, Release 5, Level 5.0
Server date/time: 17-10-2011 12:01:38 Last access: 17-10-2011 09:44:26
TSM Server Connection Information
Server Name.............: TSM1
Server Type.............: AIX-RS/6000
Archive Retain Protect..: "No"
Server Version..........: Ver. 5, Rel. 5, Lev. 5.0
Last Access Date........: 17-10-2011 09:44:26
Delete Backup Files.....: "No"
Delete Archive Files....: "Yes"
The CLUSTERNODE option was previously required when using TSM in a PowerHA (HACMP) environment. But not anymore:
Do tsm client 6.1 and 6.2 support PowerHA cluster system?
TSM client supports all versions of PowerHA. In the past, TSM client used to publish information in the client books about the HACMP versions that it supported. The reason for this was, at that time TSM client was invoking the HACMP API in order to support it. From TSM version 6.1, TSM client does not use the HACMP API. As long as TSM client is configured with HACMP as documented in the client books and the HACMP documentation, TSM will be able to support any version of PowerHA (formerly known as HACMP).
IBM Tivoli Storage Manager Requirements for the IBM® AIX® Backup-Archive and API Client