The shift from BAMOE v8 to v9 not only transforms the development experience but also significantly changes how business automation solutions are deployed, managed, and operated in production. While v8 relied on a centralized runtime model with KIE Server and Smart Router, v9 embraces a cloud-native architecture built around containerized services, Kubernetes orchestration, and modern operational practices.
This section explores the key differences in production architecture, deployment models, runtime behavior, and operational tooling between BAMOE v8 and v9. Whether you’re managing legacy environments or planning a migration, understanding these changes is essential for designing scalable, maintainable, and cloud-ready automation solutions.
Architecture overview
BAMOE 8
The architecture of BAMOE v8 is based on a centralized and tightly coupled set of components that support both authoring and runtime execution of business automation assets. The core components include Business Central, KIE Server, Business Central Monitoring, and optionally, the Smart Router.
Business Central provides a web-based interface for authoring business processes, rules, and other automation assets. Once developed and built, these assets are typically packaged as KJARs and deployed to a KIE Server, which handles their execution. Business Central Monitoring offers runtime visibility into process and task execution. In distributed environments, the Smart Router acts as a gateway, routing client requests to the appropriate KIE Server instance.
This architecture supports multiple deployment targets, including embedded Java applications and OpenShift-based containerized environments. While robust and familiar, it is monolithic in nature and can present challenges in terms of scalability, flexibility, and integration with modern cloud-native infrastructure.

BAMOE 9
BAMOE v9 introduces a modular and cloud-native architecture that replaces the centralized model of v8. The core unit of deployment is the Business Service, a microservice application that contains the business automation assets. A Business Service can be deployed as a container image generated during the Maven build process or executed directly using Java. It is also possible to run a plain Java application embedded with Drools and jBPM, without relying on Kogito.
The BAMOE Management Console provides a lightweight, stateless web interface for interacting with the runtime environment. It connects to the Business Services and leverages the Data-Index, Jobs Service, and User Tasks subsystems to retrieve and display information about process instances, user tasks, and jobs. The BAMOE Management Console is deployed as a container in a cloud environment, optionally using Helm Charts for convenience.
The production environment may also include optional components such as a Database, an Identity Provider (IdP) for authentication, Apache Kafka for event-driven communication, and a Monitoring System (if using Data-Audit), integrated with Prometheus and Grafana for observability.
This architecture supports flexible deployment models and aligns with modern container orchestration practices. Each Business Service is independently deployable and scalable, enabling a more maintainable and resilient production environment.
Please read Deploying to Kubernetes or OpenShift with the Helm Chart to know more about deploying BAMOE Management Console into Openshift using Helm Charts.

Deployment & runtime model
BAMOE 8
In BAMOE v8, deployment is centered around a set of tightly coupled components including Business Central, KIE Server, and optionally the Smart Router. Applications are typically packaged as KJARs and deployed to a configured KIE Server. The Smart Router, available as an add-on and as a container image in the Red Hat OpenShift Image Catalog, acts as an intelligent load balancer. It routes client requests to the appropriate KIE Server instance and aggregates data across multiple servers, simplifying endpoint management in distributed environments.
For OpenShift deployments, BAMOE v8 provides an OpenShift Operator, available in the OpenShift Container Platform Catalog. This operator automates the setup of environments that include Business Central, Business Central Monitoring, Process Server, and Smart Router, streamlining the deployment process on OpenShift clusters.
BAMOE 9
BAMOE v9 introduces a fundamentally different deployment model based on microservices. Business automation assets are no longer deployed to a centralized KIE Server. Instead, they are packaged as containerized Business Services, built using Quarkus or Spring Boot. These services can be deployed as standalone Java applications or as container images generated during the Maven build process.
Since Business Services are independent microservices, BAMOE v9 does not include a dedicated load balancer like the Smart Router. Instead, load balancing can be handled using any solution compatible with cloud environments. In OpenShift environments, Business Services can be deployed as pods and scaled automatically using OpenShift’s native autoscaling capabilities.
BAMOE v9 does not provide its own OpenShift Operator. Instead, it offers Helm charts to simplify deployment. The BAMOE Management Console Helm Chart is available for installing the related components on Kubernetes or OpenShift clusters. These charts support flexible configuration and align with infrastructure-as-code practices. For more details, see Deploying to Kubernetes or OpenShift with the Helm Chart.
KIE Server vs. cloud-native Business Services
BAMOE v8 projects are packaged as a Knowledge JAR (KJAR) file and deployed to a KIE Server that runs the decision services, process applications, and other deployable assets from the KJAR file whereas in BAMOE BAMOE v9, Each Business Service project is a cloud-native microservice application built around a given set of models.
Below table compares the differences between BAMOE v8 KIE Server and BAMOE v9 cloud-native Business Services (powered by Kogito).
Aspect | KIE Server (BAMOE 8) | Cloud-native Business Services (BAMOE 9.2) |
---|---|---|
Packaging |
Each project in BAMOE v8 is packaged as a Knowledge JAR (KJAR) file with configuration files such as a Maven pom.xml and a KIE module descriptor file (kmodule.xml), which contains the KIE base and KIE session configurations for the assets in the project. |
BAMOE v9 Business Service projects can be packaged as a Container image, JAR file or Native Executable. |
Deployment |
If KIE Server is integrated with business central, projects can be automatically packaged and deployed into KIE Server whereas when building projects outside Business Central users must KIE Server REST API to deploy into KIE Server. |
Each Business Service project acts as microservice and can be deployed using standard deployment strategies for deploying Quarkus and Spring Boot microservices. |
API Management |
KIE Server exposes KIE Server REST APIs to interacts with deployed KIE containers and business assets like processes, tasks etc. |
Use standard tools provided by the container platform of choice to manage containers and Process API, User Task API, Process Management API, Data-Index API to interact with processes and tasks management features. |
Cloud deployment |
All individual components like Business Central, KIE Server, Smart Router can be deployed in Openshift/Kubernetes pods |
Use standard deployment strategies for deploying Quarkus and Spring Boot projects into Kubernetes/Openshift |
Management interfaces
Both BAMOE v8 and v9 provide tools to manage and monitor process instances, user tasks, and jobs running within Business Services. In BAMOE v8, these capabilities are integrated into Business Central, offering a unified interface for both authoring and runtime management. In contrast, BAMOE v9 separates these concerns, providing runtime management through the BAMOE Management Console, a lightweight web interface designed to interact with backend services such as the Data-Index, Jobs Service, and User Tasks.
The table below compares the key management features available in each version, highlighting how functionality has evolved or shifted between the two architectures.
Topic | BAMOE 8 Business Central | BAMOE 9.2 Management Console |
---|---|---|
Process definitions |
List all process definitions that are deployed in the platform. |
User can access process definitions list by going to Processes > Process Definitions Tab. |
Process Instances |
Start |
Start |
List and filter |
List and filter |
|
Process variables Tab |
Process variables Panel |
|
Process Diagram |
Process Diagram |
|
Process log |
Process timeline panel |
|
Process details |
Process details |
|
Node trigger |
Node trigger |
|
Documents |
Documents |
|
Abort process instance |
Abort process instance |
|
Signal process instance |
Signal process instance |
|
Bulk actions |
BAMOE management console allows users to select process instances from the process instances list and perform actions like abort, skip and retry. |
|
Tasks |
Access |
Access |
List Tasks |
List Tasks |
|
Claim Tasks |
Claim Tasks |
|
Delegate Tasks |
Delegate Tasks |
|
Delegate Tasks |
Delegate Tasks |
|
Tasks Details |
Tasks Details |
|
Task Filter |
Task Filter |
|
Set task priority and due date |
Set task priority and due date |
|
Bulk actions on tasks |
Bulk actions on tasks |
|
View and add comments to a task |
View and adding comments to a task |
|
View the history log of a task |
View the history log of a task |
|
Jobs |
List jobs |
List jobs |
Create Job |
Create Job |
|
Action |
Action |
|
Bulk Action |
Bulk Action |
|
Execution Errors |
Business Central provides feature to view, manage and filter errors when executing a process instance. |
BAMOE Management Console does not have that capability. Use BAMOE Management API or BAMOE Data-Index GraphQL API instead |
Process Reports |
Business Central provides feature to view process reports in dashboard and table format. |
BAMOE Management Console does not have the capability. BAMOE v9 provides monitoring add-ons that enable Prometheus metrics for monitoring your Business Services and to generate Grafana dashboards. See Monitoring Business Services. You can also use BAMOE Data-Index GraphQL API to query data for your own monitoring systems. |
Tasks Reports |
Business Central provides feature to view Task reports in dashboard or table format. |
BAMOE Management Console does not have the capability. BAMOE v9 provides monitoring add-ons that enable Prometheus metrics for monitoring your Business Services and to generate Grafana dashboards. See Monitoring Business Services. You can also use BAMOE Data-Index GraphQL API to query data for your own monitoring systems. |
Custom queries |
Can be done using the |
It is possible to use the BAMOE Data-Audit GraphQL API to perform custom queries. |
API differences
Both BAMOE v8 and v9 expose APIs to interact with business automation services, but the architecture and usage patterns differ significantly. In BAMOE v8, APIs are centralized and tied to the KIE Server, which manages containers and business assets. In BAMOE v9, APIs are decentralized and exposed directly by each Business Service, reflecting the shift to a microservice-based model.
The table below outlines the key differences in API structure, authentication, documentation, and supported features:
BAMOE 8 | BAMOE 9.2 | |
---|---|---|
Architecture |
BAMOE v8 exposes KIE APIs to interact with Process Servers, KIE containers and business assets. |
BAMOE v9 allows for creating domain-specific APIs that can be exposed through REST endpoints or events. BAMOE v9 doesn’t support APIs to interact with containers and servers as business assets are no longer deployed in internal KIE Server. |
Authentication |
API’s are authenticated by security provider configured on the platform for example, Wildfly elytron, Wildfly keycloak or LDAP . |
BAMOE v9 rely on Quarkus or Spring Boot security for authentication and authorization. see Securing Business Service API endpoints. |
Authorization |
Users roles/groups can be configured in the security provider. Only users with “kie-server” roles are able to access KIE APIs. |
Users can use Quarkus or Spring Boot API authorization mechanisms to allow only users with specific roles to access specific endpoints. see Authorization |
API Documentation |
Swagger documentation available at |
Swagger UI documentation for Domain and Management APIs are available at |
Event-driven Capabilities |
In BAMOE v8, Event driven capabilities are less emphasized. |
Users can expose domain-specific data through events or in a data index so that the data can be consumed and queried by other services in real time. |
API Types |
KIE Server REST API for KIE containers and business assets |
Use Process Management API, Process API, User Tasks API, Data-Index GraphQL API, and Data-Audit API |
KIE Server Java client API |
Does not support Java client API, use REST and GraphQL API endpoints instead. |
|
Controller REST API for KIE Server templates and instances |
N/A |
|
Controller Java client API |
N/A |
|
BPMN process fluent API for Business Central processes |
Use Process API |
|
Knowledge Store REST API for Business Central spaces and projects |
N/A |
|
Security Management REST API for Business Central groups, roles, and users |
Not supported, use Quarkus or Spring Boot supported security mechanism. |
|
EJB API for KIE sessions and task services |
N/A |
Monitoring & observability
Both BAMOE v8 and v9 support monitoring of Business Services using Prometheus and Grafana. These tools enable users to collect, store, and visualize metrics related to business process execution and system performance. While the overall monitoring architecture remains similar across versions, there are important differences in how metrics are enabled, exposed, and integrated—especially in the context of microservice-based deployments in BAMOE v9.
The table below outlines the key differences between BAMOE v8 and BAMOE v9.2 in terms of monitoring configuration, endpoints, and platform support.
Aspect | BAMOE 8 | BAMOE 9.2 |
---|---|---|
Enable/Disable metrics |
Prometheus extension can be enabled by setting |
BAMOE v9 provides monitoring add-ons for both Quarkus and Spring Boot that enable Prometheus metrics for monitoring your Business Services and to generate Grafana dashboards. Users can disable specific metrics from being exported by using properties |
REST Endpoint |
Process server publish the metrics to REST API endpoint |
Metrics are available at REST API endpoint |
Graphana Integration |
Supports default and custom Graphana dashboard |
Supports default and custom Graphana dashboard see Custom Grafana dashboards in IBM BAMOE |
Red hat Openshift support |
Users can configure Prometheus metrics monitoring for Process Server on Red Hat OpenShift Container Platform. See Managing and monitoring KIE Server |
Follow the same steps as BAMOE v8 openshift deployment but with changes in application properties to enable/disable metrics and changes in the endpoints. See Configuring Prometheus |
Standard Operating Environment differences
The Standard Operating Environment (SOE) for BAMOE has evolved significantly between v8 and v9.2. These changes reflect the shift toward a more cloud-native, containerized architecture in BAMOE v9, which impacts supported platforms, middleware, and system requirements.
To understand the specific differences in supported environments, refer to the official IBM compatibility reports: