IT13053: 5.2.8 UPGRADE FAILS, LOGGING BPCIN0202E

IBM Spectrum Control V5.2.9 (February 2016)
IBM Spectrum Control V5.2.10 (May 2016)
IBM Spectrum Control V5.2.10.1 (July 2016)
IBM Spectrum Control V5.2.11 (August 2016)
IBM Spectrum Control V5.2.12 (November 2016)
IBM Spectrum Control V5.2.13 (March 2017)
IBM Spectrum Control V5.2.14 (May 2017)
IBM Spectrum Control V5.2.15 (August 2017)
IBM Spectrum Control V5.2.15.2 (November 2017)
IBM Spectrum Control V5.2.16 (March 2018)
IBM Spectrum Control V5.2.17 (May 2018)

APAR status

• Closed as program error.

Error description

• LDAP configuration export did not succeed, causing 5.2.8 upgrade
  to fail and log the following message:
  BPCIN0202E:  Runtime errors have occurred during the IBM
  Spectrum Control preinstallation process.  The installation
  program cannot recover from this error.
  Review of lax*.* logs in %temp% shows the following error
  sequence, which shows that the LDAP configuration export failed
  and the installer is unable to read encrypted password strings
  that it needs:
  java.lang.IllegalArgumentException: ERROR: userID cannot be null
  or empty at
  com.ibm.tpc.install.frontend.ia.TPCUtility.isFileRegistryUser(TP
  CUtility.java:2162) at
  com.ibm.tpc.install.frontend.ia.TPCUtility.prepareLDAPMigration5
  2(TPCUtility.java:2139) at
  com.ibm.tpc.install.frontend.ia.panels.PanelUpgradeInstall.okToC
  ontinueImplementation(PanelUpgradeInstall.java:457) at
  com.ibm.tpc.install.frontend.ia.TPCInstallerPanel.okToContinue(T
  PCInstallerPanel.java:96) at
  com.zerog.ia.installer.AAMgr.clickNextButton(Unknown Source) at
  com.zerog.ia.installer.AAMgr.actionPerformed(Unknown Source) at
  javax.swing.AbstractButton.fireActionPerformed(AbstractButton.ja
  va:2030) at
  javax.swing.AbstractButton$Handler.actionPerformed(AbstractButto
  n.java:2353)
  RECREATE STEPS:  Attempt to upgrade prior TPC versions to
  Spectrum Control 5.2.8 on an LDAP-configured server.
  ________________________________________________________________
  DB2 Version used for Server:    N/A
  The defect is against component:   5608TPC00
  Server/Manager build/release (TPC):   5.2.8
  
  ________________________________________________________________
  Problem as described by customer:   5.2.8 upgrade failed.
  Initial customer impact (low/med/high): med
  

Local fix

• Locate the following file:
  <tpc_install_dir>\config\InstallVariable.properties
  Add the following properties to that file (they are missing):
  varWSAdmUsrID=
  varWSAdmUsrPW=
  
  Set those values - the ID and password, to match the values that
  are stored in that file for these two variables: varCommonUsrID
  varCommonUsrPW
  varWSAdmUsrID with same stored value as varCommonUsrID
  varWSAdmUsrPW with same stored value as varCommonUsrPW
  ***Ensure that you do a copy&paste for the values and there's no
  space before or after the value.
  Save the file and restart the TPC installer.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * TPC and Spectrum Control users upgrading from 5.2.x to 5.2.8 *
  * when existing 5.2.x installation (e.g. 5.2.5) was done and   *
  * the following conditions were true:                          *
  * a) existing 5.2.x installation has TPC reports installed     *
  * AND                                                          *
  * b) JazzSM was installed by launching it from the TPC Install *
  * JazzSM Panel.                                                *
  * AND                                                          *
  * c) In the Single Server Installation Information panel, the  *
  * user clicked the "Configure Jazz for Service Management and  *
  * Tivoli Common Reporting" link.                               *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fix maintenance when available.                        *
  ****************************************************************
  

Problem conclusion

• The fix for this APAR is targeted for the following maintenance
  package:
  
  | refresh pack | 5.2-TIV-TPC-RP0010 - target May 2016
  
  Fixed in IBM Spectrum Control 5.2.10.
  
  http://www-01.ibm.com/support/docview.wss?&uid=swg21320822
  
  The target dates for future refresh packs do not represent a
  formal commitment by IBM. The dates are subject to change
  without notice.
  

Temporary fix

• Locate the following file:
  <tpc_install_dir>\config\InstallVariable.properties
  Add the following properties to that file (they are missing):
  varWSAdmUsrID=
  varWSAdmUsrPW=
  
  Set those values - the ID and password, to match the values that
  are stored in that file for these two variables: varCommonUsrID
  varCommonUsrPW
  varWSAdmUsrID with same stored value as varCommonUsrID
  varWSAdmUsrPW with same stored value as varCommonUsrPW
  ***Ensure that you do a copy&paste for the values and there's no
  space before or after the value.
  Save the file and restart the TPC installer.
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Modules/Macros

• INSTALL
  

Fix information

• Fixed component name

  TPC

• Fixed component ID

  5608TPC00

Applicable component levels

• R527 PSY

     UP

• R528 PSY

     UP