Open Editions

 View Only

Quick Reference Guide: Migrating Red Hat Business Automation (RHPAM/RHDM) to IBM Business Automation Manager Open Editions (IBM BAMOE)

By Thiago Nicino Menezes posted Thu June 01, 2023 12:59 PM

  

Here you can find a validated step-by-step checklist to help users migrate from Red Hat PAM and DM installations to IBM PAMOE and DMOE. It brings information about both use cases: on OpenShift and on-premises. 

Motivation for this article

I believe many users may need guidance and information during this process - information that is currently scattered amongst several articles. You can save some time by leveraging this migration guidance. This checklist has been used to support users who are running Red Hat BA on production and migrated to IBM BAMOE. This article may be updated as needed to bring new information.  

Migration checklist and recommendations:  

  • Which product version am I using? 

You can find a mapping between Red Hat Product, IBM Product, and maven artifacts version: 
Migrating from Red Hat Process Automation Manager and Decision Manager 7. x to IBM Business Automation Manager Open Editions 8.0 

  • Migrate to the latest Red Hat version. 

It’s very important to apply all the minor updates, for details refer to the step-by-step guide below. In this guide, you can also find the backup procedures for existing installations and business assets.
Chapter 63. Applying patch updates and minor release upgrades to IBM Business Automation Manager Open Editions 

  • Download IBM PAMOE or DMOE 

How to download the solution, how IBM will perform the licensing control (ILMT License Metric Tool), and the ODBC templates. 
IBM Business Automation Manager Open Editions 8.0 Download document 

Check on the following path /bamoe-8.0.x-add-ons/bamoe-8.0.x-migration-tool/upgrade-scripts/ to obtain the DDLs scripts related to your database, you can find the DDLs scripts from BPMS v6 to BAMOE v8 (7.13.1).

  • Install IBM PAMOE/DMOE 

To install BAMOE on Red Hat Openshift Container Platform (OCP) users can rely on an Operator. To perform the installation using the operator, refer to:  
Migrating from Red Hat Process Automation Manager and Decision Manager 7.x to IBM Business Automation Manager Open Editions 8.0.

  • Recommended tasks during the installation phase:  
    1. Test the database connections;
    2. Check System property Kie Persistence to ensure database endpoint is correctly configured with the corresponding dialect:

<property=org.kie.server.persistence.ds[…]/>

< property=org.kie.server.persistence.dialect[…]/>

    1. Check the Maven version;
    2. Check if there are any deprecated libraries (It is possible to check it by looking for warnings on the application log);
    3. Check config files to ensure all endpoints are correctly configured focusing on the following properties on the system property section on this path: /target/jboss-eap-7.4/configuration/standalone/standalone-full.xml (Check which standalone file are you using):

<property name="org.kie.server.controller" value="http://<endpoint>:8080/business-central/rest/controller"/>

<property name="org.kie.server.location" value="http://<endpoint>:8080/kie-server/services/rest/server"/>

    1. Check the execution of business assets contained in the migrated business application: simulate decisions, validate responses, and make comparisons between the new application version (migrated) and the previous version (before migration). 
  • About the product architecture 

Overview of the architecture of IBM BAMOE: Chapter 6. Example decision management architectures with IBM Business Automation Manager Open Editions 

  • Installation problems & Troubleshooting 

In case of problems during the installation, IBM is here to help. You can file a support case, making sure to attach all the information you can to collect before opening a support ticket (this is what we call MustGather):

Collect troubleshooting data for IBM Business Automation Manager Open Editions The version of your solution you can find on this 

Contributions are welcome! 

I hope this article can be of good use to you! Contributions and comments with more information are always welcome, so please feel free to share inputs and feedback!

2 comments
75 views

Permalink

Comments

Wed October 25, 2023 04:02 PM

great article Thiago!  much of this content has been added to the published BAMOE documentation, with an real-time update coming very soon!

Thu June 01, 2023 02:13 PM

Thank you for the knowledge sharing Thiago!