Professional Documents
Culture Documents
CHAPTER 7
IBM BAW 21.0.3
Upgrade Installation
from BAW 18.6.1.19002
Introduction
This chapter covers the upgrade installation of IBM BAW 21.0.3 (Business Automation
Workflow).
It will upgrade to version 21.0.3 from 18.0.0.x, 19.0.0.x, 20.0.0.x, or version 21.0.1.
Note: This upgrade only works successfully from Db2 Version 10.5.0.0 (unless the
option to defer schema creation is set).
The starting point of this upgrade is based on the installation of Business Workflow
Automation Version 8.6.1.19.0.0.2.
The installation of the Db2 database for this base version is covered in the IBM DB2
Administration Guide (ISBN 978-93-55511-669) Chapter 5, IBM Workflow Center 8.6 for IBM
BAW 18.0 Database Creation , which covers the creation of the four DB2 databases used by
the BAW system, and the ResearchGate download, with the link,
https://doi.org/10.13140/RG.2.2.27345.89440 - IBM BAW 18.0 Installation phase1 preprint
with install of IBM Workflow Center 8.6.1.19002, which covers the installation and fix pack
upgrade of IBM Business Automation Workflow to version 8.6.1.19.0.0.2.
For IBM Business Automation Workflow 21.0.3., before the upgrade, at least 18 GB of free
disk space is required, including temporary disk space.
2
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
Structure
In this chapter, we will discuss the following topics:
• Advanced Linux custom using the command line with DB2 Express
Objectives
After studying this unit, you will be able to download and install the IBM Business
Automation Workflow version 21.0.3 and identify the supporting components for installation
and configuration.
The following link on the base VMWare system, shows the current status of IBM BAW 8.6,
before the upgrade, it includes the BAW version number, version 8.6.1.19002:
https://ecmukdemo8:9447/ProcessCenter/repository/com.lombardisoftware.repository.Rep
ository/Repository.jsp?v=8.6.1.19002
3
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
7.1.1 Restarting and upgrading the system.
The original RHEL Linux 8.0 system build for Business Automation Workflow Center 8.6 is Deleted: Centre
described in the step-by step free download word document on ResearchGate, listed in the
introduction to this chapter. This base installation is used as the starting point for the IBM
Business Automation Workflow upgrade which is described in this Chapter.
https://www.ibm.com/docs/en/baw/20.x?topic=v2103-traditional-installing-configuring-
migrating-business-automation-workflow
First, we need to back up the current VMWare for the ECMUKDEMO8 server which hosts the
base system, since we have to selectively delete install package .bin files and the original
zipped install files to provide the additional space required. There are also old kernel installs
to be removed to provide the 25 Mbytes of space required on the /boot partition.
1. Stop the IBM Case Manager and IBM Content Navigator Application Server using the
following commands.
[root@ECMUKDEMO8 bin]# cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv02/bin
[root@ECMUKDEMO8 bin]# ./stopServer.sh server1
A pop-up window prompts for the WebSphere user name and password (wasadm/filenet on
this system)
2. Stop the IBM FileNet Content Engine Application Server using the following
commands.
[root@ECMUKDEMO8 bin]# cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
[root@ECMUKDEMO8 bin]# ./stopServer.sh server1
A pop-up window prompts for the WebSphere user name and password (wasadm/filenet on
this system)
Formatted: Centred
7. Update the RHEL 8.0 Linux server with the latest packages using dnf update.
The first time this was run it reported that there was insufficient /boot disk space.
First the current Linux kernel version was checked :
[root@ECMUKDEMO8 boot]# uname -r
4.18.0-348.12.2.el8_5.x86_64
8. The following command was used to remove the old Linux kernel from the /boot
system, as shown in Figure 7.2: Formatted: Font: Italic
Figure 7.4: The hostnamectl command shows that the RHEL 8.0 is updated to version 8.6
11.Start the DB2 Database.
[root@ECMUKDEMO8 ~]# su - db2inst1
Last login: Wed Sep 28 11:37:32 PDT 2022 on pts/0
[db2inst1@ECMUKDEMO8 ~]$ db2start
09/28/2022 14:27:02 0 0 SQL1063N DB2START processing was successful.
SQL1063N DB2START processing was successful.
[db2inst1@ECMUKDEMO8 ~]$
/opt/IBM/WebSphere/AppServer/profiles/Node1Profile/logs/nodeagent/startServer.log
ADMU0128I: Starting tool with the Node1ProfileRHEL8 profile
ADMU3100I: Reading configuration for server: nodeagent
ADMU3200I: Server launched. Waiting for initialization status.
ADMU3000I: Server nodeagent open for e-business; process id is 21260
[root@ECMUKDEMO8 bin]# pwd
/opt/IBM/WebSphere/AppServer/profiles/Node1Profile/bin
[root@ECMUKDEMO8 bin]#
/opt/IBM/WebSphere/AppServer/profiles/DmgrProfile/logs/dmgr/startServer.log
ADMU0128I: Starting tool with the DmgrProfileRHEL8 profile
ADMU3100I: Reading configuration for server: dmgr
ADMU3200I: Server launched. Waiting for initialization status.
ADMU3000I: Server dmgr open for e-business; process id is 21706
[root@ECMUKDEMO8 bin]#
14. Start the deployment environment
https://ecmukdemo8:9043/ibm/console/login.do?action=secure
15. Select Deployment Environments in the menu tree as shown in Figure 7.5:
Figure 7.5: The current status of the IBM Business Automation Workflow, V19.0.0.2
The web page should be refreshed after around 5 minutes to see the started applications as
shown in Figure 7.1 (there are a large number of web application components!). Deleted: -
The IBM Business Automation Workflow Center web application is loaded to check the Formatted: Font: Italic
https://ecmukdemo8:9447/ProcessCenter/
giving the security warning as shown in Figure 7.6:
Formatted: Centred
Figure 7.6: The Advanced command option is selected to accept the risk
7
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
This redirects to the full URL as follows:
https://ecmukdemo8:9447/ProcessCenter/repository/com.lombardisoftware.repository.Rep
ository/Repository.jsp?v=8.6.1.19002
The web page appears as illustrated in Figure 7.7. Formatted: Font: Palatino Linotype
Formatted: Font: Palatino Linotype, Italic
Formatted: Font: Palatino Linotype
Figure 7.8 The Audit Master for BS5750/ISO9000 Audit Process Workflow
Start the IBM FileNet Content Engine Application Server.
[root@ECMUKDEMO8 bin]# cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
[root@ECMUKDEMO8 bin]# ./startServer.sh server1
CWUPO0001I: Running configuration action detectNewProducts.ant
ADMU0116I: Tool information is being logged in file
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/server1/startServer.log
ADMU0128I: Starting tool with the AppSrv01 profile
ADMU3100I: Reading configuration for server: server1
ADMU3200I: Server launched. Waiting for initialization status.
ADMU3000I: Server server1 open for e-business; process id is 11054
[root@ECMUKDEMO8 bin]#
Start the IBM Case Manager and IBM Content Navigator Application Server.
[root@ECMUKDEMO8 bin]# cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv02/bin
[root@ECMUKDEMO8 bin]# ./startServer.sh server1
CWUPO0001I: Running configuration action detectNewProducts.ant
ADMU0116I: Tool information is being logged in file
/opt/IBM/WebSphere/AppServer/profiles/AppSrv02/logs/server1/startServer.log
ADMU0128I: Starting tool with the AppSrv02 profile
ADMU3100I: Reading configuration for server: server1
ADMU3200I: Server launched. Waiting for initialization status.
9
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
ADMU3000I: Server server1 open for e-business; process id is 11621
[root@ECMUKDEMO8 bin]#
Figure 7.9: The installation packages for IBM Business Automation 21.0.3 are copied
The installation packages are unpacked:
[root@ECMUKDEMO8 BAW_21_0_3]# tar -zxvf BAW_Enp_21.0.3_Lnx641.tar.gz
[root@ECMUKDEMO8 BAW_21_0_3]# tar -zxvf BAW_Etp_21.0.3_Lnx64_2of3.tar.gz
[root@ECMUKDEMO8 BAW_21_0_3]# tar -zxvf BAW_Etp_21.0.3_Lnx64_3of3.tar.gz
The Fix Packs for the Process Federation Server and Workflow components, are shown in
Figure 7.10, after downloading from the IBM Fix Central web site:
Figure 7.11: The IBM Business Automation Workflow version 21.0.3 packages are copied.
The Linux bash cp copy command is used to copy the IBM Business Automation v 21.0.3 FixPack
zipped files from the /mnt/hgfs VMware mapped drive to the installation folder as shown in
Figure 7.12:
Figure 7.12: The IBM BAW v 21.0.3 Fix Packs are copied to the Linux server
The unpacked FixPack repository.config file is selected for loading using the Browse
command button after choosing the IBM Installation Manager File| Preferences menu
item as shown in Figure 7.13:
11
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
Figure 7.13: The IBM BAW Fix Pack 21.0.3 repository.config file is selected
The Update Packages list is displayed for WebSphere and the IBM BPM 21.0.3 versions in the
IBM Installation Manager Update command option window as illustrated in Figure 7.14:
Figure 7.14: The IBM Installation Manager Update command window lists the updates
The IBM Fix Central web page shows the latest available Fix Packs for IBM Business
Automation Workflow as shown in Figure 7.15:
12
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
Figure 7.15: The Installed Version option is used to select the current base version
The search results show the latest Fix pack first, which is for IBM Business Automation
Workflow version 21.0.3.1 shown in Figure 7.16:
Figure 7.16: The latest Fix pack for IBM Business Automation Workflow, version 21.0.3.1
The search results also show the required Fix Packs for the base IBM Business Automation
Workflow Version 21.0.3 and the base IBM Process Federation Server version 21.0.3, which we
select for download as shown in Figure 7.17:
Figure 7.17: The required Fix Packs for the base IBM Business Automation Workflow Version 21.0.3 and the base IBM
Process Federation Server version 21.0.3
The IBM Download Director option is used to download the selected Fix Packs as shown in
Figure 7.18:
13
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
Figure 7.18: The IBM Download Director is used to download the required Fix Packs
The Details command button is used after IBM Download Director completes to display the
downloaded Fix Pack for IBM Business Automation Workflow version 21.0.3.1 as illustrated
in Figure 7.19:
Figure 7.19: The downloaded Fix Pack for IBM Business Automation Workflow version 21.0.3.1
The Find by text option for searching in the IBM Software Access Catalog web site is shown
in Figure 7.20:
14
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
Figure 7.20: The Find by text option for searching in the IBM Software Access Catalog
The resulting list is scrolled down to select the required Linux version components of IBM
Business Automation Workflow we need for upgrading our existing system as illustrated in
Figure 7.21:
Figure 7.21: The required Linux version components of IBM Business Automation Workflow 21.0.3 for download
The IBM Download Director Details command button is used to display the downloaded IBM
Business Automation Workflow 21.0.3 installation files as shown in Figure 7.22:
15
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
Figure 7.22: The downloaded IBM Business Automation Workflow 21.0.3 installation files
Figure 7.23: The IBM PFS base installation Fix Packs are copied to Linux
[root@ECMUKDEMO8 PFS21]# cd /opt/IBM/Installs/PFS21
[root@ECMUKDEMO8 PFS21]# cp /mnt/hgfs/Install_21_03/BAW_FixPacks_To_21.0.3/*.zip .
[root@ECMUKDEMO8 PFS21]# cp /mnt/hgfs/Install_21_03/BAW_Base_System/Process*.gz .
Unpack the IBM PFS 21.0.3 tar.gz file
tar -zxvf Process_Fed_21.0.3_Lnx64.tar.gz
Remove the unpacked gzip file to save space
rm -rf Process_Fed_21.0.3_Lnx64.tar.gz
Run the installer and get the Installation screen as shown in Figure 7.24.
./installPFS.sh
17
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
Figure 7.24: The IBM Installation Manager displays the versions to install
(Note: Ignore the Check for Other Versions, Fixes and Extensions button!) Click on
the Next command button as illustrated in Figure 7.25.
Figure 7.25: The Next command is selected to install the IBM WebSphere Fixes
Click the I accept radio button and the Next|command button as illustrated in Figure 7.26.
18
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
Figure 7.26: The I accept… License agreements is selected and Next clicked
This IBM License acceptance gives access to use the supporting programs as listed:
• IBM API Connect Professional
(only for the purpose of building Analytics Collections (of IBM Watson Explorer
Advanced Edition))
• Content Analytics Miner
(only for the purpose of analyzing the Analytics Collections (of IBM Watson Explorer
Advanced Edition))
Figure 7.28: The default Recommended installation option is left and Next clicked
Note the End Of Support for Java 1.7, then we click Next, we click on Install as shown in
Figure 7.29:
21
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
Figure 7.29: The installation options are reviewed and the Install command clicked
Click Finish.
Fix Packs are then added to the base:
[root@ECMUKDEMO8 PFS_2103]# cd ..
[root@ECMUKDEMO8 PFS_21031]# cp
/mnt/hgfs/Install_21_03/BAW_FixPacks_To_21.0.3/workflow.21031.delta.repository.zip .
unzip workflow.21031.delta.repository.zip
Figure 7.30: The IBM WebSphere Liberty fix packs are selected and the Next is clicked
The scrollable License text box, displays the Supporting Programs and deployed software
packages as shown in Figure 7.31:
23
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
Conclusion
In this chapter, we covered the “Bill of Materials” and the upgrade installation of IBM BAW
21.0.3 (Business Automation Workflow).
It will upgrade to version 21.0.3 from 18.0.0.x, 19.0.0.x, 20.0.0.x, or version 21.0.1. We also
covered the supporting software required for the related IBM Information Management
Products to be installed, with the download site URLs, Product Codes, Descriptions and size
and name of the download gzip tar files for each Software Download. In the next Chapter 8,
Cloud Based Systems, we cover the IBM Cloud based systems; IBM Cloud Private and the
IBM FileNet P8 CPIT Installation; Installation of Eclipse Codewind, with Docker Compose
using IBM Cloud Private CE and IBM Cloud Private P8 Docker Container CPIT Installation
for the preparation of a new Object Store.
Points to Remember
• Remember to back up the whole system before upgrading!
• Remember, this upgrade to version 21.0.3 only works successfully from Db2 Version
10.5.0.0 (unless the option to defer schema creation is set).
• Ignore the Check for Other Versions, Fixes and Extensions button on IBM Installation
Manager for the upgrade.
• The supporting IBM Software Packages are only included to support the Licensee's
use of the Principal IBM Upgrade Program under the Agreement.
26
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
• The End Of Support for Java 1.7, means the upgrade to Java 1.8 is required.
Multiple Choice Answers Formatted: Heading 1 [BPB HEB], None, Don't keep
with next, Don't keep lines together
b) 18.0.0.x
d) Backup the existing working system
c) Start the DB2 Database, Start the node agent, Start the deployment manager, Start
the deployment environment
b).DB2 11.1
27
Installation, Upgrade and Configuration of IBM FileNet Information Management Software on
RedHat Linux 8.0, Windows 10 and IBM Cloud platforms - IBM FileNet ECM and Case Manager
Installation on RHEL 8.0
Questions
1. How much disk space would you provision for the downloads recommended in this
Chapter? (Hint: this is specifically defined including the temporary disk space
required).
2. What web site could you browse to view any IBM software compatibility issues and
limitations for products which are used by IBM Business Automation Workflow
upgrade?
3. What import post-installation upgrade steps must you take to ensure the WebSphere
application can run correctly?
4. Where would you find the procedures to create the IBM PFS Process Federation Server
and the four databases it uses?
Key Terms
• CPEDB- Content Platform Engine Database - Used for the IBM FileNet Content server
software service Database name