12/8/2019 Is the SQL to create the BPMS / BRMS database available?

- Red Hat Customer Portal

C U S T O M E R (https://access.redhat.com/)
P O R TA L


Is the SQL to create the BPMS / BRMS database available?

/ SOLUTION UNVERIFIED - Updated January 22 2019 at 8:22 PM - English ()

Environment
JBoss BRMS
5.x
6.x
JBoss BPM Suite
6.x
Red Hat Decision Manager - RHDM
7.x
Red Hat Process Automation Manager - RHPAM
7.x

Issue
I am trying to configure JBoss Enterprise BRMS to use SQL Server as it's DB repository. However, I wish that the database tables/indexes (to be
used by JBoss Enterprise BRMS) are created from SQL scripts.

Can you please provide me the SQL to create the tables/indexes used by JBoss Enterprise BRMS database? The only work around I can think
of is to install JBoss Enterprise BRMS which is already configured with SQL Server, and then export the DDL for the database.
Is there further documentation on the database including an E-R design and whether querying the database from outside of JBoss Enterprise
BRMS is supported? i.e. Is the design subject to change without notification?

Resolution

BRMS 5
Unfortunately, there is no SQL script provided by us as the database is created through Apache Jackrabbit which is a JCR (Content
Respository API for Java) implementation. We don't recommend the idea of accessing database directly.
Regarding the work-around which you mentioned above (export the DDL for the database), in future when you upgrade JBoss Enterprise
BRMS, you would need to possibly upgrade the schema and SQL scripts as well.
Just for your information, there is a section in BRMS Administrator Guide (https://access.redhat.com/knowledge/docs/en-
US/JBoss_Enterprise_BRMS_Platform/5/html-single/BRMS_Administrator_Guide/index.html#chap-Data_Management) which you can
follow if you need to consider Data Management (i.e. take Data Backups, Importing and Exporting Data) while you are upgrading your JBoss
Enterprise BRMS installation.

Jackrabbit/ JCR encapsulates database access, so what you want to know depends on Jackrabbit/ JCR. Here are some links [1][2][3] you
might be interested in. There is no document which explicitly describes database schema. It is Jackrabbit's internal implementation. Querying
the database from outside of JBoss Enterprise BRMS is not supported and it can't be done without JBoss Enterprise BRMS.
The content repository design won't change as it's defined in JCR specification and JBoss Enterprise BRMS versions should support
backwards compatibility of rules, packages etc. But we cannot guarantee that physical database schema won't change.

BRMS 6, BPM Suite 6

DDL scripts for database tables for both BRMS and BPM Suite are available for download via Customer Portal
(https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?downloadType=distributions&product=bpm.suite&productChanged=yes),
respectively at following link (https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?
downloadType=distributions&product=brms&version=6.0.1&productChanged=yes) for BRMS. These DDL scripts are packaged inside the
downloaded archive for Supplementary Tools at the
jboss-bpms-brms-6.0.3.GA-redhat-1-supplementary-tools.zip/jboss-bpms-brms-6.0.3.GA-redhat-1-supplementary-tools/ddl-script
location (for an example) . Also, if the Source Distribution for BRMS/BPMS is downloaded from Customer Portal , users can find the DDL
scripts inside it's /jbpm/jbpm-installer/db/ddl-scripts/ location.
Sample Entity-Relationship diagram, generated from MySQL scripts for jBPM database is attached.


https://access.redhat.com/solutions/37751 1/3
12/8/2019 Is the SQL to create the BPMS / BRMS database available? - Red Hat Customer Portal

RHPAM 7, RHDM
C U S T7
O M E R (https://access.redhat.com/)

P O R TA L
DDL scripts for database tables for both RHDM and RHPAM are available for download via Customer Portal
(https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?product=rhpam&downloadType=distributions), respectively at following link
(https://access.redhat.com/jbossnetwork/restricted/softwareDetail.html?
softwareId=59061&product=rhpam&version=&downloadType=distributions) for RHDM/RHPAM. These DDL scripts are packaged inside the
downloaded archive for add-ons at the rhpam-7.0.1-add-ons.zip//rhpam-7.0-migration-tool/ddl-scripts/ location (for an example) .

Sample Entity-Relationship diagram, generated from MySQL scripts for jBPM database is attached.

=====
[1] http://jackrabbit.apache.org/jackrabbit-architecture.html (http://jackrabbit.apache.org/jackrabbit-architecture.html)
[2] http://jackrabbit.apache.org/object-content-mapping.html (http://jackrabbit.apache.org/object-content-mapping.html)
[3] http://jcp.org/aboutJava/communityprocess/final/jsr170/index.html (http://jcp.org/aboutJava/communityprocess/final/jsr170/index.html)

Attachments
- diagram.pdf (/node/37751/40/0/12807261)

Product(s) Red Hat Process Automation Manager (/taxonomy/products/red-hat-process-automation-manager)

Red Hat JBoss BPM Suite (/taxonomy/products/red-hat-jboss-bpm-suite) Red Hat Decision Manager (/taxonomy/products/red-hat-jboss-brms)

Component jbossas (/components/jbossas) Category Learn more (/category/learn-more)

Tags database (/tags/database) decision manager (/tags/brms) jboss (/tags/jboss) jbpm (/tags/jbpm) jcr (/tags/jcr) rhdm (/taxonomy/tags/rhdm)

rhpam (/taxonomy/tags/bpms)

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while
supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and
unedited form.

People who viewed this solution also viewed

Configure JBoss ON Database manually

Solution - Jun 2, 2017

Error changing workspace database to Oracle in JBoss BRMS

Solution - Apr 19, 2012

How to set up the required database tables for FSW 6 separately ?

Solution - Jan 6, 2015

Comments

All systems operational (https://status.redhat.com) 

https://access.redhat.com/solutions/37751 2/3
12/8/2019 Is the SQL to create the BPMS / BRMS database available? - Red Hat Customer Portal
Privacy Statement (http://www.redhat.com/en/about/privacy-policy)
C U S T O M E R (https://access.redhat.com/)
Customer Portal Terms of Use (https://access.redhat.com/help/terms/)
P O R TA L

All Policies and Guidelines (http://www.redhat.com/en/about/all-policies-guidelines)
Copyright © 2019 Red Hat, Inc.

https://access.redhat.com/solutions/37751 3/3