IT03408: INSTALLATION OF TPC REPORTS FAIL WITH BPCIN0004E COMPONENT ON OF THE TIVOLI STORAGE PRODUCTIVITY CENTER REPORTS

Tivoli Storage Productivity Center Refresh Pack 4
Fix Pack 5.2.4 (November 2014) for Tivoli Storage Productivity Center
Fix Pack 5.2.4.1 (December 2014) for Tivoli Storage Productivity Center
Refresh Pack 5.2.5 (March 2015) for Tivoli Storage Productivity Center (withdrawn)
Fix Pack 5.2.5.1 (April 2015) for Tivoli Storage Productivity Center (withdrawn)
Refresh Pack 5.2.6 (June 2015) for Tivoli Storage Productivity Center
Refresh Pack 5.2.7 (August 2015) for Tivoli Storage Productivity Center
IBM Spectrum Control V5.2.8 (December 2015)
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)
Fix Pack 5.2.7.1 (February 2016) for Tivoli Storage Productivity Center

APAR status

• Closed as program error.

Error description

• In the TPC installer log on Windows shows following error:
  Execute failed: java.io.IOException: Cannot run program
  "\bin\trcmd.bat"
  On Linux/AIX it shows: The directory /cognos/bin does not exist
  
  When trying to install TPC reports, at TPC preinstall, if the
  error: "BPCIN0238E The Tivoli Common Reporting server located at
  C:\Program Files\IBM\JazzSM\reporting cannot be reached." occurs
  for some reason and the user clicks then the previous button on
  "Configure Jazz for Service Management and Tivoli Common
  Reporting" panel, fixes the problem in Tivoli Common Reporting
  and resumes the TPC installation by clicking Next on the "Choose
  Installation Location and Type" panel, the installer may fail at
  installation of TPC reports with
  "BPCIN0004E An error occurred during the installation of the
  Tivoli Storage Productivity Center reports component."
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Those installing TPC 5.2.x in a single server install        *
  * scenario when TPC reports are installed later, as the        *
  * remaining TPC component to be installed.                     *
  * The issue happens only if there are JazzSM validation errors *
  * on the "Configure Jazz for Service Management and Tivoli     *
  * Common Reporting" panel                                      *
  * and the user clicks then Previous button and then from       *
  * "Choose Installation Location and Type" panel clicks Next    *
  * and then Install.                                            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Installation of TPC reports fail with "BPCIN0004E An error   *
  * occurred during the installation of the Tivoli Storage       *
  * Productivity Center reports component."                      *
  * In the TPC installer log:                                    *
  * on Windows there is an error like this: Execute failed:      *
  * java.io.IOException: Cannot run program "\bin\trcmd.bat"     *
  * on Linux/AIX there is an error like this: The directory      *
  * /cognos/bin does not exist                                   *
  *                                                              *
  * When trying to install TPC reports,                          *
  * at TPC preinstall, if the error "BPCIN0238E The Tivoli       *
  * Common Reporting server located at C:\Program                *
  * Files\IBM\JazzSM\reporting cannot be reached."               *
  * occurs for some reason and the user clicks then Previous     *
  * button on "Configure Jazz for Service Management and Tivoli  *
  * Common Reporting" panel,                                     *
  * fixes the problem in Tivoli Common Reporting and resumes the *
  * TPC installation by clicking Next on the "Choose             *
  * Installation Location and Type" panel,                       *
  * the installer may fail at installation of TPC reports with   *
  * "BPCIN0004E An error occurred during the installation of the *
  * Tivoli Storage Productivity Center reports component."       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fix maintenance when available.                        *
  ****************************************************************
  

Problem conclusion

• The fix for this APAR is targeted for the following maintenance
  packages:
  
  | refresh pack | 5.2-TIV-TPC-RP0004 - target TBD
  
  The target dates for future fix packs do not represent a formal
  commitment by IBM. The dates are subject to change without
  notice.
  

Temporary fix

• A temporary fix includes some manual changes to
  <TPC_INSTALL_DIR>/config/InstallVariable.properties.
  Because this is a TPC internal configuration file, caution
  should be exercised and changing that file.
  It's recommended to ask L2/L3 support to provide an action plan
  after the TPC logs are collected using the TPC service tool.
  
  An example of such an action plan for Windows is the following:
  
  1) click the OK button in the TPC installer and wait until
  installer finishes, then close it.
  
  
  
  2) edit C:\Program
  Files\IBM\TPC\config\InstallVariable.properties and replace:
  
  
  varTCRHostName=
  
  with
  
  varTCRHostName=<real_host_name_here>
  
  
  varTCRPort=
  
  with
  
  varTCRPort=16311
  
  
  
  TCR_INSTALL_DIR=
  
  
  with
  
  TCR_INSTALL_DIR=C\:\\Program Files\\IBM\\JazzSM\\reporting
  
  
  
  varJazzSMUsrPW=
  
  with
  
  varJazzSMUsrPW=<here_the_encrypted_form_with_escaped_equal_sign_
  see_comment_above_about_tpctool_encrypt>
  
  
  
  Please note that
  <here_the_encrypted_form_with_escaped_equal_sign_see_comment_abo
  ve_about_tpctool_encrypt> must be
  replaced according to the details from below:
  
  
  varJazzSMUsrPW must be saved in encrypted form (encryption can
  be done using
  C:\Program Files\IBM\TPC\cli\tpctool.bat encrypt
  <jazzSM_password_in_clear_here>).
  
  Also, any = sign in the encrypted form must be escaped with a \,
  e.g. for an encrypted password value of LZFV7KXFluECfjcxoDXzQg==
  the escaped value in
  InstallVariable.properties will be LZFV7KXFluECfjcxoDXzQg\=\=
  
  
  
  Then save the changes made to InstallVariable.properties
  
  3) start again the TPC installer to install the TPC reports.
  

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

• R521 PSY

     UP