IBM Support

IC65591: EXISTENCE OF INSTANCE.INFO OR INSTANCE.BAT FILE PREVENTS TIVOLI STORAGE MANAGER 6.1 UPGRADE FROM SUCCEEDING.

Subscribe

You can track all active APARs for this component.

 

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:

Publications Referenced
GC23978101GC23978201GC23978301GC23978401GC23978501

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