APAR status
Closed as documentation error.
Error description
If Tivoli Storage Manager 6.1 has been deinstalled at some point it leaves behind a file called instance.info or instance.bat, of the format: <Instances> <Comment> Created on Month Day, Year Time </Comment> <Instance> <InstanceName>abcXX</InstanceName> <InstanceUser>xyz</InstanceUser> <DefaultDatabasePath>/home/xyz/abcXX</DefaultDatabasePath> <Database> <DatabaseName>TSMDB1</DatabaseName> <DatabasePath>/home/xyz/abcXX</DatabasePath> </Database> </Instance> </Instances> This file is created so that if Tivoli Storage Manager is installed again, the info can be used to help re-install the server. But, if this file exists and an upgrade occurs, ie 6.1.2.1 to 6.1.3, the upgrade will fail as it tries to reinstall using the info in the file and will fail to create the db2 instance. In the upgrade process, an error is seen after specifying instance userid information; Creating the database manage instance: tsm01 DBI1131E The user ID tsm01 is invalid Explanation: An attempt to access the given user ID failed. One of the following situations has occurred: This user ID does not exist on the system The home directory of this user is not set up properly One of the user attributes needed by DB2 is unset In log.txt you will see errors like: Tue Dec 29 14:43:19.028 GMT+01:00 2009 : INFO : existingInstances size = 1 (from com.tivoli.dsm.install.RedefineInstances.checkExistingInstance) Tue Dec 29 14:43:19.032 GMT+01:00 2009 : INFO : existingInstances[0]= tsm (from com.tivoli.dsm.install.RedefineInstances.checkExistingInstance) Tue Dec 29 14:43:19.222 GMT+01:00 2009 : INFO : Issuing cmd: LANG=C /opt/tivoli/tsm/db2/instance/db2icrt -u tsm01 tsm01 (from com.tivoli.dsm.install.RedefineInstances.createInstance) Tue Dec 29 14:43:19.232 GMT+01:00 2009 : INFO : signalEvent (from com.tivoli.dsm.install.RedefineInstancesPanel.signalEvent) Tue Dec 29 14:43:20.942 GMT+01:00 2009 : INFO : signalEvent (from com.tivoli.dsm.install.RedefineInstancesPanel.signalEvent) Tue Dec 29 14:43:20.953 GMT+01:00 2009 : SEVERE : Failed to create instance: tsm01 (from com.tivoli.dsm.install.RedefineInstances.createInstance) Tue Dec 29 14:43:20.961 GMT+01:00 2009 : INFO : signalEvent (from com.tivoli.dsm.install.RedefineInstancesPanel.signalEvent) Tue Dec 29 14:43:20.976 GMT+01:00 2009 : INFO : exit, rc 1 (from com.tivoli.dsm.install.RedefineInstancesPanel.panelIsDisplayed) Tue Dec 29 14:43:20.980 GMT+01:00 2009 : FINER : RETURN (from com.tivoli.dsm.install.RedefineInstancesPanel.panelIsDisplayed) Initial Impact: Low Tivoli Storage Manager Versions Affected: 6.1 Additional Keywords: TSM zz61 upgrade deinstalled deinstall fixpack upgraded failed
Local fix
Rename instance.info or instance.bat file and repeat upgrade
Problem summary
**************************************************************** * USERS AFFECTED: All Tivoli Storage Manager server users. * **************************************************************** * PROBLEM DESCRIPTION: See error description * **************************************************************** * RECOMMENDATION: * **************************************************************** *
Problem conclusion
This tip was added to the Upgrading Tivoli Storage Manager using the installation wizard and Upgrading Tivoli Storage Manager using the console installation wizard topics in the Installation Guide: Tip: During an upgrade of Tivoli Storage Manager Version 6.1 to a later version, or if you uninstall any version of Tivoli Storage Manager 6.1 or later, including a fix pack, an instance file is created. The instance file is created to help reinstall Tivoli Storage Manager. If this file exists and you start an upgrade, the upgrade might fail because the server instance cannot be created when information is retrieved from the file. Consider removing or temporarily renaming the instance file if you have old information in it, or if you get an error message after adding your credentials to the Instance User ID panel of the installation wizard. Affected platforms: AIX, HP-UX, Sun Solaris, Linux, and Windows.
Temporary fix
Comments
APAR Information
APAR number
IC65591
Reported component name
TSM SERVER
Reported component ID
5698ISMSV
Reported release
61L
Status
CLOSED DOC
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2010-01-15
Closed date
2010-02-06
Last modified date
2010-02-06
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
GC23978101 | GC23978201 | GC23978301 | GC23978401 | GC23978501 |
Fix information
Applicable component levels
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"61L","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}}]
Document Information
Modified date:
06 February 2010