Upgrade to Dashboard Application Services Hub (DASH) v3.1.3.1 shows error CTGFI2019E

Body

Abstract:

Dashboard Application Services Hub (DASH) v3.1.3.1 upgrade fails if installing via Installation Manager (IM) console mode

   

Cause:
The following errors are displayed:
CTGFI2019E: WebSphere profile already exists. Please delete existing WebSphere profile or create new profile by specifying different profile name.

Explanation: WebSphere profile already exists. Please delete existing WebSphere profile or create new profile by specifying different profile name.

   

Resolution:

The error 'CTGFI2019E' appears because IM console mode is installing the 'JazzSMProfile' by default. Also, when upgrading to existing 'JazzSMProfile', this requires intervention to enter the smadmin password which IM console mode is unable to prompt user to enter the password.

User needs to create a response file and upgrade using IM silent install.

If user cannot create a response file via IM GUI mode due to restrictions, create the response file by running IM console mode first.

 

Follow the steps below:

 

-1. Ensure that the upgrade installer is downloaded from

 https://www-945.ibm.com/support/fixcentral/swg/selectFix?product=ibm%2FTivoli%2FJazz+for+Service+Management&fixids=1.1.3-TIV-JazzSM-multi-FP001&source=SAR&function=fixId&parent=ibm/Tivoli
 
-2. Unzip the file into tmp folder, i.e. /tmp/fixpack

 

-3. Run imcl from /opt/IBM/InstallationManager/eclipse/tools and specify the repository from the unzipped file from step #2

Example:

[root@shaz-jazzsm tools]# ./imcl -updateAll -c -repositories /tmp/fixpack/JazzSMFPRepository/disk1/diskTag.inf

 

-4. Once reach the stage where there is an option to Update a Response File, select the option G (   G. Generate an Update Response File).

 

Example:

=====> IBM Installation Manager> Update> Packages> Licenses> Features> Summary
 
Target Location:
 Shared Resources Directory : /opt/IBM/IMShared
Update packages:
    1-. Core services in Jazz for Service Management (/opt/IBM/JazzSM)
      2-. IBM Dashboard Application Services Hub 3.1.3.0
        3-. Features to install:
          4. Installation
          5. Configuration

Options:

    G. Generate an Update Response File

    B. Back,     U. Update,     C. Cancel

-----> [U] G

=====> IBM Installation Manager> Update> Packages> Licenses> Features>Summary> Save response file

Enter a directory path and a file name to generate the response file. Use .xml as the file extension. If a file name is specified without a full directory path, the response file is saved to /opt/IBM/InstallationManager/eclipse/tools. To skip the generation of a response file, press Enter.

-----> /tmp/response.xml

 

=====> IBM Installation Manager> Save response file

Response file was generated successfully: /tmp/response.xml
 
    O. OK

-----> [O] O

=====> IBM Installation Manager> Update> Packages> Licenses> Features> Summary

Target Location:
 Shared Resources Directory : /opt/IBM/IMShared
Update packages:
    1-. Core services in Jazz for Service Management (/opt/IBM/JazzSM)
      2-. IBM Dashboard Application Services Hub 3.1.3.0
        3-. Features to install:
          4. Installation
          5. Configuration

Options:

    G. Generate an Update Response File
 

    B. Back,     U. Update,     C. Cancel

-----> [U] C

 
=====> IBM Installation Manager

Select:

    1. Install - Install software packages
    2. Update - Find and install updates and fixes to installed software packages
    3. Modify - Change installed software packages
    4. Roll Back - Revert to an earlier version of installed software packages
    5. Uninstall - Remove installed software packages

Other Options:

    L. View Logs
    S. View Installation History
    V. View Installed Packages
       ------------------------
    P. Preferences
       ------------------------
    A. About IBM Installation Manager
       ------------------------
    X. Exit Installation Manager

-----> X

 

-5. Create encrypted smadmin password by using command imutilsc en from /opt/IBM/InstallationManager/eclipse/tools

Example:

[root@shaz-jazzsm tools]# ./imutilsc encryptString smadmin
WhqRS8fKYHHBpMh30p03mA==

 

-6. Edit the response.xml file generated in step #4,

-6a. Set
  <data key='user.CREATE_NEW_WAS_PROFILE' value='true/>

to
  <data key='user.CREATE_NEW_WAS_PROFILE' value='false'/>

 
-6b. Add entry of data key user.WAS_PASSWORD right after user.WAS_USER_NAME, use the password encrypted in step #5.
 

Example:

   <data key='user.WAS_USER_NAME' value='smadmin'/>
   <data key='user.WAS_PASSWORD' value='WhqRS8fKYHHBpMh30p03mA=='/>
   <data key='user.WAS_CELL' value='JazzSMNode01Cell'/>

 

-7. Run imcl command to install using the modified response file, also  enter -log option to record the logs

Example:

[root@shaz-jazzsm tools]# ./imcl -acceptLicense -showProgress input response.xml -log update_response_log.xml

                25%               50%               75%               100%

------------------|------------------|------------------|------------------|

............................................................................

-8. The successful output is

Updated to com.ibm.tivoli.tacct.psc.tip.install_3.1.3100.20180920-0924 in the /opt/IBM/JazzSM directory.

 

-9 Or verify the upgrade by running  command ./imcl listInstalledPackages -features -long

 

Example:

[root@shaz-jazzsm tools]# ./imcl listInstalledPackages -features -long

/opt/IBM/InstallationManager/eclipse : com.ibm.cic.agent_1.8.3000.20150606_0047 : IBM® Installation Manager : 1.8.3 :

/opt/IBM/WebSphere/AppServer : com.ibm.tivoli.tacct.psc.install.was85.extension_1.1.2001.20160606-1749 : Jazz for Service Management extension for IBM WebSphere 8.5 : 1.1.2.1 :

/opt/IBM/WebSphere/AppServer : com.ibm.websphere.BASE.v85_8.5.5009.20160225_0435 : IBM WebSphere Application Server : 8.5.5.9 : com.ibm.sdk.6_64bit,ejbdeploy,embeddablecontainer,thinclient

/opt/IBM/WebSphere/AppServer : com.ibm.websphere.IBMJAVA.v70_7.0.9030.20160224_1826 : IBM WebSphere SDK Java Technology Edition (Optional) : 7.0.9.30 :

/opt/IBM/JazzSM : com.ibm.tivoli.tacct.psc.tip.install_3.1.3100.20180920-0924 : IBM Dashboard Application Services Hub : 3.1.3.1 : com.ibm.tivoli.tacct.psc.install.server.feature.tip.config

 

If error persists, run consoleLogCollector.bat|sh script from <JazzSM HOME>/ui/bin

Collect the <JazzSM HOME>/ui/console_logs.zip file and send to support.

 

Author:

Sharon Orillaneda
Software Engineer, ITSM - JazzSM DASH TIP
IBM Cloud Labs