jBPM logo
  • Blog
  • Download
    • Community
    • Docker
    • Enterprise
  • Learn
    • Getting Started - Using Single Zip Distribution
    • Getting Started - Using Docker
    • Releases
    • Documentation
    • Performance
    • Videos
    • Slides
  • Apps
    • Getting Started
    • Beyond Basics
  • Get help
  • Source
  • Team
  • Services
  • KIE
    • Drools
    • Kogito
    • jBPM
    • OptaPlanner

    • kie.org
  • Star
  • T
  • YT
Fork me on GitHub

Getting started - Using Single Zip Distribution

Download jBPM

First things first, download jBPM server distribution (if not already done) to start quickly with complete environment.

  • Download jBPM 7.74.1.Final server (single zip) distribution

Just download, unzip and run

  • On Unix/Linux

    • jbpm-server/bin/standalone.sh

  • On Windows

    • jbpm-server\bin\standalone.bat


Explore your running environment

Business Central

Business Central provides feature rich authoring and management environment. It consists of:

  • Design perspectives where users can create projects and pages
  • Deploy perspectives where users can manage execution servers
  • Manage perspectives where users can take control over process and case instances
  • Track perspectives where users can access assigned tasks and reports

Business Central can be accessed (once the server was started) at http://localhost:8080/business-central

There is a set of predefined users that can be used to log directly into Business Central:

  • wbadmin/wbadmin
  • krisv/krisv
  • john/john
  • mary/mary
  • katy/katy
  • jack/jack
  • kieserver/kieserver1!

Additional users can be created via Business Central Admin section.


KIE Server Swagger documentation

KIE Server is the execution server that provides various capabilities

  • BRM (business rules)
  • BPM (business processes)
  • BRP (planning/solver)
  • Case Management
  • DMN (decisions)

Its complete REST api documentation can be accessed at http://localhost:8080/kie-server/docs


jBPM Case Management Showcase

jBPM Case Management Showcase is a web application that aims at illustrating various case management building blocks in action. These are UI components built on top of KIE Server REST api for case management. It's not intended for production usage but more for getting better understanding of the capabilities. Case management, in general should be business focused so generic UI won't provide much business context to the knowledge workers.

jBPM Case Management application can be accessed at http://localhost:8080/jbpm-casemgmt

Same users as for Business Central can be used to logon to this application.


Try examples

Once you get yourself familiar with the tools of the jBPM it's time to see something running. The easiest way is to try one of the examples shipped with the platform, it will show typical path users take to design, build and execute business logic.

Evaluation process

Evaluation process is a business process that is human centric (heavily uses human actors to perform work) that defines a complete flow of activities to perform employee evaluation. This examples shows:

  • importing example project
  • building and deploying project
  • verifying deployment to execution server
  • executing process instance and work with human tasks
  • exploring reporting capabilities

IT Orders case

IT Orders case is more advanced use of the jBPM that relies on dynamic nature of business problems. It allows to take actions based on data so it's more event/data driven than structured processes. Although it still allows users to take advantage of process fragments to express bit of workflows within the case. This examples shows:

  • importing example project
  • building and deploying project
  • verifying deployment to execution server
  • use of jBPM Case management Showcase application
  • document upload and handing
  • monitoring of case instance in Business Central

More about case management capabilities can be found in following articles

  • Introduction to jBPM Case Management
  • Working with case data
  • Working with dynamic activities

Build your project from scratch

Building new project from scratch can give you an option to have a clean start where you design your process or case to fit your needs. This example shows:

  • creating new project
  • creating new asset - business process
  • build and deploy to execution server
  • execute process instance

Switch to another database

jBPM runs by default with H2 database with file storage - located under <JBOSS_HOME>/standalone/data/jbpm-db

Users can switch to another database very easily by invoking a script located in <JBOSS_HOME>/bin.

To switch to MySQL use following command when server is stopped

  • Unix/Linux:
    • <JBOSS_HOME>/bin/jboss-cli.sh --file=jbpm-mysql-config.cli
  • Windows:
    • <JBOSS_HOME>\bin\jboss-cli.bat --file=jbpm-mysql-config.cli

To switch to PostgreSQL use following command when server is stopped

  • Unix/Linux:
    • <JBOSS_HOME>/bin/jboss-cli.sh --file=jbpm-postgres-config.cli
  • Windows:
    • <JBOSS_HOME>\bin\jboss-cli.bat --file=jbpm-postgres-config.cli

These scripts assume that database is installed and some default configuration is present:

  • host -> localhost
  • port -> 3306 for MySQL and 5432 for PostgreSQL
  • database name -> jbpm
  • user name -> jbpm
  • password -> jbpm

in case the values are not correct, edit them in the script files jbpm-mysql-config.cli for MySQL and jbpm-postgres-config.cli for PostgreSQL - in both scripts values to be updated are on line 17.

There is H2 script as well to go back to default.

After running the script the only thing that is needed is to start the server.

Download
Try jBPM - Open Source Business Automation Toolkit
7.74.1.Final
Paid support and consulting

Want to talk to the experts? Red Hat offers certified binaries with enterprise consulting. See services for more information.

jBPM - Open Source Business Automation Toolkit is open. All dependencies of this project are available under the Apache Software License 2.0 or a compatible license.

This website was built with JBake and is completely open source.

Community

  • Blog
  • Get Help
  • Team
  • Governance
  • Academic research

Code

  • Build from source
  • Submit a bug
  • Report a security issue
  • License (Apache-2.0)
  • Release notes
  • Upgrade recipes

KIE projects

  • Drools rule engine
  • OptaPlanner constraint solver
  • jBPM workflow engine
  • Kogito Business Automation platform
CC by 3.0 | Privacy Policy
Sponsored by Red Hat