IBM Support

IMPORTANT: Actions required before upgrading Business Automation Workflow depending on the interim fixes applied

Flashes (Alerts)


Abstract

If you have Interim fixes applied in your Business Automation Workflow environment, there are actions required to ensure a successful upgrade:

Content

Problem

When upgrading Business Automation Workflow, IBM Installation Manager may fail with an error like
ERROR: Error during "install" phase: ERROR: File /home/bpminst/BPM/v85/BPM/navigator/lib/icnjson.jar exists. It cannot be created.

Symptom

The upgrade is aborted. Reviewing Installation Manager logs will reveal an error message similar to the one above.
The issue has been observed when upgrading from 21.0.3.1 to 24.0.0.0 and 24.0.1.0.

Cause

Fixes applied to 21.0.3.1 for the following Known Issues can result in the error: 
DT245291, DT260516, DT259647, DT261360, DT380668, DT381059, DT400225, DT418407, 
DT197398, DT257955, DT260813, and/or DT386610

Resolving the Problem

Use the following steps prior to performing an upgrade from 21.0.3.1, to avoid the issue, or if the error has already been encountered.
 
  • Using WebSphere's versioninfo command from the bin directory of your Business Automation Workflow installation, for example, 
    versioninfo -ifixes
    Alternatively, use the IBM Installation Manager UI or imcl command from the eclipse/tools directory of your Installation Manager installation, for example, 
    imcl listInstalledPackages
    to determine whether fixes for DT245291, DT260516, DT259647, DT261360, DT380668, DT381059, DT400225, DT418407, DT197398, DT257955, DT260813 and/or DT386610 are installed on top of 21.0.3.1
  • If none of the listed fixes are installed, but you hit the above or a similar error, DO NOT continue following this document and contact IBM Support for further assistance.
  • If none of the listed fixes are installed and you didn't start the upgrade yet, no further action is required. Continue with the upgrade install steps for the release you are upgrading to.
  • If any of the fixes are installed, DO continue following the procedures in this document, and first use Installation Manager to uninstall the fixes. 
    For example, if your Business Automation Workflow installation is under /opt/ibm/bpm, use imcl command from the eclipse/tools directory of your Installation Manager installation, or use a script similar to the one provided at the end of this document. 

    Sample invocation to uninstall a single fix:  
    imcl uninstall 8.6.30021031-WS-BPM-IFDT245291 -installationDirectory /opt/ibm/bpm
  • When using command line mode (imcl) or silent mode to uninstall the fixes, use the following mapping to find the fix id to be specified on the command line or in the response file:
    • DT245291 : 8.6.30021031-WS-BPM-IFDT245291
    • DT260516 : 8.6.30021031-WS-BPM-IFDT260516
    • DT259647 : 8.6.30021031-WS-BPM-IFDT259647
    • DT261360 : 8.6.30021031-WS-BPM-IFDT261360
    • DT380668 : 8.6.30021031-WS-BPM-IFDT380668
    • DT381059 : 8.6.30021031-WS-BPM-IFDT381059
    • DT400225 : 8.6.30021031-WS-BPM-IFDT400225
    • DT418407 : 8.6.30021031-WS-BPM-IFDT418407
    • DT197398 :8.6.30021031-WS-BPM-MultiOS-IFDT197398 or 8.6.30021031-WS-BPM-WinX3264-IFDT197398
    • DT257955 :8.6.30021031-WS-BPM-MultiOS-IFDT257955 or 8.6.30021031-WS-BPM-WinX3264-IFDT257955
    • DT260813 : 8.6.30021031-WS-BPM-MultiOS-IFDT260813 or 8.6.30021031-WS-BPM-WinX3264-IFDT260813
    • DT386610 :8.6.30021031-WS-BPM-MultiOS-IFDT386610 or 8.6.30021031-WS-BPM-WinX3264-IFDT386610
  • If you uninstalled fixes for DT245291, DT260516, DT259647, DT261360, DT380668, DT381059, DT400225 and/or DT418407
    • Using your OS command line/terminal backup the folder CaseManagement/analytics/lib/ under your Business Automation Workflow's installation directory. Ensure this and subsequent backups are placed outside of the install directory.
    • Then, using your OS command line/terminal, delete all files in  the folder CaseManagement/analytics/lib/ under your Business Automation Workflow's installation directory.
  • If you uninstalled fixes for DT197398, DT257955, DT260813 and/or DT386610
    • Using your OS command line/terminal, if they still exist after uninstall, backup these files located under your Business Automation Workflow's installation directory
      • BPM/navigator/lib/icnjson.jar
      • BPM/navigator/lib/slf4j-api.jar
    • Then, using your OS command line/terminal, delete those two specific files.
    • Continue to use your OS command line/terminal to backup the folder UIStaticContent/navigator under your Business Automation Workflow's installation directory.
    •  Then delete all files under UIStaticContent/navigator.
  • After uninstalling all of the listed fixes and performing all removal actions above, continue with the upgrade install steps for the release you are upgrading to.
The removal and cleanup steps described above can be scripted to automate the resolution procedures. In most scenarios the following should be usable as-is. However, there may be instances where it needs to be refined. Here is an example shell script:
 
ID=/opt/ibm/bpm #Set ID=Install Directory
export PATH=${PATH}:${ID}/bin:/opt/IBM/InstallationManager/eclipse/tools
for ifix in $(imcl listInstalledPackages |awk -F"_" '{print $1}' |grep -e DT245291-e DT260516 -e DT259647 -e DT261360 -e DT380668 -e DT381059 -e DT400225 -e DT418407 -e DT197398 -e DT257955 -e DT260813 -e DT386610)
do
imcl uninstall $ifix -installationDirectory $ID
done
cd $ID
/bin/rm -rf BPM/navigator/lib/icnjson.jar BPM/navigator/lib/slf4j-api.jar CaseManagement/analytics/lib/ UIStaticContent/navigator/* 

[{"Type":"MASTER","Line of Business":{"code":"LOB76","label":"Data Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SS8JB4","label":"IBM Business Automation Workflow"},"ARM Category":[{"code":"a8m50000000CcdEAAS","label":"Upgrade and Migration-\u003EInstallation Manager related"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
31 March 2025

UID

ibm17214668

Page Feedback