Documente Academic
Documente Profesional
Documente Cultură
0
Administration And Configuration
Guide
The Administration and Configuration Guide for Red Hat JBoss BPM Suite
Red Hat JBoss BPM Suite 6.0 Administration And Configuration Guide
The Administration and Configuration Guide for Red Hat JBoss BPM Suite
Red Hat Co ntent Services
Legal Notice
Co pyright 20 15 Red Hat, Inc.
This do cument is licensed by Red Hat under the Creative Co mmo ns Attributio n-ShareAlike 3.0
Unpo rted License. If yo u distribute this do cument, o r a mo dified versio n o f it, yo u must pro vide
attributio n to Red Hat, Inc. and pro vide a link to the o riginal. If the do cument is mo dified, all Red
Hat trademarks must be remo ved.
Red Hat, as the licenso r o f this do cument, waives the right to enfo rce, and agrees no t to assert,
Sectio n 4 d o f CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shado wman lo go , JBo ss, MetaMatrix, Fedo ra, the Infinity
Lo go , and RHCE are trademarks o f Red Hat, Inc., registered in the United States and o ther
co untries.
Linux is the registered trademark o f Linus To rvalds in the United States and o ther co untries.
Java is a registered trademark o f Oracle and/o r its affiliates.
XFS is a trademark o f Silico n Graphics Internatio nal Co rp. o r its subsidiaries in the United
States and/o r o ther co untries.
MySQL is a registered trademark o f MySQL AB in the United States, the Euro pean Unio n and
o ther co untries.
No de.js is an o fficial trademark o f Jo yent. Red Hat So ftware Co llectio ns is no t fo rmally
related to o r endo rsed by the o fficial Jo yent No de.js o pen so urce o r co mmercial pro ject.
The OpenStack Wo rd Mark and OpenStack Lo go are either registered trademarks/service
marks o r trademarks/service marks o f the OpenStack Fo undatio n, in the United States and o ther
co untries and are used with the OpenStack Fo undatio n's permissio n. We are no t affiliated with,
endo rsed o r spo nso red by the OpenStack Fo undatio n, o r the OpenStack co mmunity.
All o ther trademarks are the pro perty o f their respective o wners.
Abstract
A guide fo r administrato rs and advanced users dealing with Red Hat JBo ss BPM Suite setup,
co nfiguratio n, and advanced usage.
T able of Contents
. .art
P
. . .I.. Int
. . .roduct
. . . . . .ion
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. . . . . . . . . .
. .hapt
C
. . . .er
. .1. .. Business
. . . . . . . . .Process
. . . . . . . Model
. . . . . . and
. . . .Not
. . . at
. . ion
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4. . . . . . . . . .
1.1. Ab o ut Red Hat JBo s s BPM Suite
4
1.2. Co mp o nents
4
1.3. Us e Cas e: Pro c es s -b as ed s o lutio ns in the lo an ind us try
5
. .art
P
. . .II.. .Configurat
. . . . . . . . . ion
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7. . . . . . . . . .
. .hapt
C
. . . .er
. .2. .. Business
. . . . . . . . .Cent
. . . .ral
. . .configurat
. . . . . . . . .ion
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8. . . . . . . . . .
2 .1. Ac c es s c o ntro l
8
. .hapt
C
. . . .er
. .3.
. .Command
. . . . . . . . . line
. . . .configurat
. . . . . . . . . ion
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 0. . . . . . . . . .
3 .1. Starting the kie-c o nfig -c li to o l in o nline mo d e
10
3 .2. Starting the kie-c o nfig -c li to o l in o ffline mo d e
10
3 .3. Co mmand s availab le fo r the kie-c o nfig -c li to o l
11
. .hapt
C
. . . .er
. .4. .. Migrat
. . . . . .ion
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 3. . . . . . . . . .
4 .1. Data Mig ratio n
13
14
14
15
. .hapt
C
. . . .er
. .5.
. .Dat
. . . a. .management
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 6. . . . . . . . . .
5 .1. Data b ac kup s
16
5 .2. Setup Ind exes
16
5 .3. Setting up the Datab as e
5 .4. Ed iting the Datab as e
16
17
. .hapt
C
. . . .er
. .6. .. Asset
. . . . . .reposit
. . . . . .ory
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 9. . . . . . . . . .
6 .1. Creating a rep o s ito ry
6 .2. Clo ning a rep o s ito ry
19
20
22
22
. .hapt
C
. . . .er
. .7. .. Process
. . . . . . . .export
. . . . . .and
. . . .import
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. 5. . . . . . . . . .
7 .1. Creating a Pro c es s d efinitio n
25
7 .2. Imp o rting a Pro c es s d efinitio n
7 .3. Imp o rting jPDL 3.2 to BPMN2
7 .4. Exp o rting a p ro c es s
25
26
27
. .art
P
. . .III.
. . Int
. . .egrat
. . . . ion
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2. 8. . . . . . . . . .
. .hapt
C
. . . .er
. .8. .. Int
. . .egrat
. . . . ion
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2. 9. . . . . . . . . .
8 .1. Co nfig uring Red Hat JBo s s BPM Suite with Ap ac he Sp ring
29
8 .2. CDI Integ ratio n
30
. .hapt
C
. . . .er
. .9. .. Deploying
. . . . . . . . . .Red
. . . .Hat
. . . JBoss
. . . . . . BPM
. . . . .Suit
. . . e. .art
. . ifact
. . . . s. .t .o. SO
. . .A. .Reposit
. . . . . . .ory
. . .Art
. . .ifact
. . . . Model
. . . . . .and
..............
Prot ocol (S- RAMP) reposit ory
32
9 .1. Dep lo ying Red Hat JBo s s BPM Suite artifac ts to SO A Rep o s ito ry Artifac t Mo d el and Pro to c o l (SRAMP) us ing Maven
32
9 .2. Dep lo ying Red Hat JBo s s BPM Suite artifac ts to SO A Rep o s ito ry Artifac t Mo d el and Pro to c o l
(S-RAMP) us ing g rap hic al us er interfac e (G UI)
34
. .hapt
C
. . . .er
. .1. 0. .. Persist
. . . . . . ence
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
...........
10 .1. Ses s io n
35
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
10 .1. Ses s io n
10 .2. Pro c es s Ins tanc e
10 .3. Wo rk Item
35
36
36
37
. .hapt
C
. . . .er
. .1. 1. .. Logging
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. 1. . . . . . . . . .
11.1. Lo g g ing events to d atab as e
42
. .hapt
C
. . . .er
. .1. 2. .. Localiz
. . . . . . at
. . ion
. . . .and
. . . cust
. . . . omiz
. . . . .at. ion
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4. 5. . . . . . . . . .
12.1. Availab le Lang uag es
45
12.2. Chang ing lang uag e s etting s
45
12.3. Running the JVM with UTF-8 Enc o d ing
46
. .art
P
. . .IV.
. . Execut
. . . . . . ion
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. 7. . . . . . . . . .
. .hapt
C
. . . .er
. .1. 3.
. . Execut
. . . . . . ion
. . . .server
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. 8. . . . . . . . . .
13.1. As s ig nment rules
48
13.2. Mail s es s io n
49
. .hapt
C
. . . .er
. .1. 4. .. Plug. . . . . in
. . for
. . . Red
. . . . Hat
. . . .JBoss
. . . . . .Developer
. . . . . . . . . St
. . udio
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
...........
14.1. Plug -in
51
. .art
P
. . .V.. .Monit
. . . . .oring
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
...........
. .hapt
C
. . . .er
. .1. 5.
. . Process
. . . . . . . .monit
. . . . .oring
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
...........
15.1. JBo s s O p eratio ns Netwo rk
53
15.2. Ins talling the BRMS Plug -in into JBo s s O N
53
53
. .hapt
C
. . . .er
. .1. 6. .. Managing
. . . . . . . . . Securit
. . . . . . .y. for
. . . Red
. . . . Hat
. . . .JBoss
. . . . . .BPM
. . . . Suit
. . . .e. Dashbuilder
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
...........
16 .1. Ac c es s ing Red Hat JBo s s BPM Suite Das hb uild er
55
16 .2. Manag ing s ec urity
16 .3. Wo rks p ac e p ermis s io ns
55
55
57
58
. . . . . . . . .Hist
Revision
. . . ory
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6. 0. . . . . . . . . .
Part I. Introduction
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
1.2. Component s
Red Hat JBoss BPM Suite integrates multiple components to support business processes throughout
their entire life cycle and to provide process management features and tools for business analysts,
developers, and business users. The product can be deployed on various JEE-compliant servers; the
recommended option is Red Hat JBoss Enterprise Application Platform 6.
Red Hat JBoss BPM Suite consists of the following main components:
Executi o n Eng i ne - provides the runtime environment for Processes and Business Rules. It
encompasses a workflow library that can be embedded into a user web application. Runtime
manager is the root object and contains the following components:
R unti me Eng i ne - implements the core behavior of the computer language and it is
provided by the runtime manager.
P ro cess Eng i ne - is the environment for business process model execution.
T ask Servi ce - handles human task lifecycles.
R ul e Eng i ne - can be used with the process engine or on its own.
R ul es Eval uati o n - executes business rules on the provided set of facts.
C o mpl ex Event P ro cessi ng - applies business rules on incoming stream of events.
Busi ness C entral - a web-based application that accommodates tooling for asset creation,
management, and monitoring by providing an integrated web environment.
Asset R epo si to ry - is the central sharing location (Knowledge Store) for business assets,
processes, rules, forms, etc. Users access this repository through the Project Explorer view of
Business Central via Au t h o rin g Pro ject Au t h o rin g . By default, the product initializes a
local GIT repository as its Asset Repository. However, other repositories may be added or
removed as necessary.
Arti fact R epo si to ry - is a Maven based repository for storage of project jar artifacts.
Executi o n Server - provides an execution environment for business process instances and
tasks.
Busi ness Acti vi ty Mo ni to r - provides customizable view on business performance.
Note
Red Hat JBoss BRMS comes with its own Business Central application that is a subset of the
Business Central application in Red Hat JBoss BPM Suite.
Report a bug
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
The bank's IT organization deploys the BPM Suite so that the entire loan application process can be
automated.
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
Warning
A group for a Human Task must not be named after an existing user of the system. D oing so
causes intermittent issues.
Report a bug
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
10
To operate in offline mode, append the offline parameter to the command as below.
1. Navigate to the ki e-co nfi g -cl i -6 . MINOR_VERSION-red hat-x-d i st directory where
you installed the tool.
2. In a Unix environment, run:
./kie-config-cli.sh offline
In a Windows environment, run:
./kie-config-cli.bat offline
Executing this command changes the tool's behaviour and displays a request to specify the folder
where the system repository (. ni o g i t) is located. If .niogit does not yet exist, the folder value can be
left empty and a brand new setup is created.
Report a bug
11
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
12
Chapter 4. Migration
Migrating your projects from BRMS 5 to BPMS 6 requires careful planning and step by step
evaluation of the various issues.
Because BPMS 6 uses GIT for storing assets, artifacts and code repositories including processes
and rules, you should start by creating an empty project in BPMS 6 as the basis for your migration
with dummy files as placeholders for the various assets and artifacts. Running a GIT clone of this
empty project into your favorite ID E will initiate the migration process.
Based on the placeholder files in your cloned project, you can start adding assets at the correct
locations. The BPMS 6 system is smart enough to pick these changes and apply them correctly.
Make sure that when you are importing old rule files that they are imported with the right package
name structure.
Since Maven is used for building projects, the projects assets like the rules, processes and models
are accessible as a simple jar file.
Let's get started with the simple data migration step, which migrates your BRMS 5 repository from the
JCR Jackrabbit to a GIT backend in the new BPMS 6.
Report a bug
13
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
Note
Assets can also be migrated manually. After all, they are all just text files. The BPMN2
specification and the D RL syntax did not change between the different versions.
14
If you can't migrate your code to use the new API, then you can use the API provided by the purpose
built kno wl ed g e-api jar for backwards compatible code. This API is the public interface for
working with BPMS and BRMS and is backwards compatible.
If you are instead using the REST API in BRMS 5, note that this has changed as well and there is no
mechanism in it for backwards compatibility.
Report a bug
15
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
Note
Consider backing up the entire busi ness-central . war and d ashbui l d er. war files.
Report a bug
Note
The database encoding must be UTF8
DB2
D B2 database can be created using the following sql sentence:
16
Note
The default pagesize for D B2 systems is 4k which is not enough for the dashbuilder
table columns size. The pagesize should be forced to 16384 as shown in the above
sentence.
Once the database is created, the application server datasource must be configured. You must edit
the JBoss EAP configuration file and configure the datasource subsystem as the following examples:
<datasource jndi-name="java:jboss/datasources/jbpmDS" enabled="true" usejava-context="true" pool-name="postgresqlDS">
<connection-url>jdbc:postgresql://localhost/test</connection-url>
<driver>postgresql</driver>
<pool></pool>
<security>
<user-name>sa</user-name>
<password>sa</password>
</security>
</datasource>
<drivers>
<driver name="postgresql" module="org.postgresql">
<xa-datasource-class>org.postgresql.xa.PGXADataSource</xadatasource-class>
</driver>
</drivers>
Report a bug
Note
This datasource is intended for development/demo purposes; it is present by default in any
JBoss installation.
If you want to deploy on a database different from H2 like Oracle, MySQL, Postgres or MS SQL
Server, please perform the following steps:
17
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
18
19
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
Note
Note that the repository name should be a valid filename. Avoid using a space or
any special character that might lead to an invalid folder name.
Select an organizational unit in which the repository is to be created from the
O rg ani zati o nal Uni t drop-down option.
5. Click C reate
6. A confirmation prompt with an O K button is displayed which notifies the user that the
repository is created successfully. Click O K.
The new repository can be viewed either in the Fi l e Expl o rer or P ro ject Expl o rer views.
Report a bug
20
21
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
Note
The file protocol is only supported for 'READ ' operations. 'WRITE' operations
are not supported.
c. If applicable, enter the User Name and P asswo rd to be used for authentication when
cloning the repository.
5. Click C l o ne.
6. A confirmation prompt with an O K button is displayed which notifies the user that the
repository is created successfully. Click O K.
The cloned repository can be checked either in the Fi l e Expl o rer or P ro ject Expl o rer views.
Report a bug
Report a bug
22
...
</system-properties>
Listed below are a list of all system properties:
o rg . uberfi re. ni o . g i t. d i r: Location of the directory .niogit. D efault: working directory
o rg . uberfi re. ni o . g i t. d aemo n. enabl ed : Enables/disables git daemon. D efault: true
o rg . uberfi re. ni o . g i t. d aemo n. ho st: If git daemon enabled, uses this property as local
host identifier. D efault: localhost
o rg . uberfi re. ni o . g i t. d aemo n. po rt: If git daemon enabled, uses this property as port
number. D efault: 9418
o rg . uberfi re. ni o . g i t. ssh. enabl ed : Enables/disables ssh daemon. D efault: true
o rg . uberfi re. ni o . g i t. ssh. ho st: If ssh daemon enabled, uses this property as local host
identifier. D efault: localhost
o rg . uberfi re. ni o . g i t. ssh. po rt: If ssh daemon enabled, uses this property as port
number. D efault: 8001
o rg . uberfi re. ni o . g i t. ssh. cert. d i r: Location of the directory .security where local
certtificates will be stored. D efault: working directory
o rg . uberfi re. metad ata. i nd ex. d i r: Place where Lucene .index folder will be stored.
D efault: working directory
o rg . uberfi re. cl uster. i d : Name of the helix cluster, for example: kie-cluster
o rg . uberfi re. cl uster. zk: Connection string to zookeeper. This is of the form
host1:port1,host2:port2,host3:port3, for example: localhost:2188
o rg . uberfi re. cl uster. l o cal . i d : Unique id of the helix cluster node, note that ':' is
replaced with '_', for example: node1_12345
o rg . uberfi re. cl uster. vfs. l o ck: Name of the resource defined on helix cluster, for
example: kie-vfs
o rg . uberfi re. cl uster. auto start: D elays VFS clustering until the application is fully
initialized to avoid conflicts when all cluster members create local clones. D efault: false
o rg . uberfi re. sys. repo . mo ni to r. d i sabl ed : D isable configuration monitor (do not
disable unless you know what you're doing). D efault: false
o rg . uberfi re. secure. key: Secret password used by password encryption. D efault:
org.uberfire.admin
o rg . uberfi re. secure. al g : Crypto algorithm used by password encryption. D efault:
PBEWithMD 5AndD ES
o rg . g uvno r. m2repo . d i r: Place where Maven repository folder will be stored. D efault:
working-directory/repositories/kie
o rg . ki e. exampl e. repo si to ri es: Folder from where demo repositories will be cloned. The
demo repositories need to have been obtained and placed in this folder. D emo repositories can
be obtained from the kie-wb-6.0.1.Final-example-repositories.zip artifact. This System Property
takes precedence over org.kie.demo and org.kie.example. D efault: Not used.
23
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
o rg . ki e. d emo : Enables external clone of a demo application from GitHub. This System
Property takes precedence over org.kie.example. D efault: true
o rg . ki e. exampl e: Enables example structure composed by Repository, Organization Unit and
Project. D efault: false
Report a bug
24
Creating packages
It is recommended to create your resources, including your Process definitions, in a
package of a Project to allow importing of resources and their referencing. To create a
package, do the following:
In the R epo si to ry view of the Project Explorer, navigate to the
REPOSITORY/PROJECT/src/mai n/reso urces/ directory.
Go to N ew It em Packag e.
In the New reso urce dialog, define the package name and check the location of
the package in the repository.
3. From the perspective menu, go to N ew It em B u sin ess Pro cess.
4. In the New P ro cesses dialog box, enter the Process name and click O K. Wait until the
Process Editor with the Process diagram appears.
Report a bug
25
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
26
27
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
28
Chapter 8. Integration
Red Hat JBoss BPM Suite provides integration modules for integrating BPMS with other frameworks,
namely Spring and Apache Camel. These modules are provided in the generic deployment package.
See Installation Guide for more details.
This section provides information about these modules and how to configure them.
Report a bug
8.1. Configuring Red Hat JBoss BPM Suit e wit h Apache Spring
Refer to the Red Hat JBoss BPM Suite Installation Guide to download the Apache Spring module.
You will need to download the generic deployable version of BPMS.
The Spring module is present in the jbo ss-bpms-eng i ne. zi p file and is called ki e-spri ng VER SIO N-red hat-MINO R VER SIO N. jar.
How you intend to use the Spring modules in your application affects how you configure them.
29
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
30
@ Produces
public EntityManagerFactory getEntityManagerFactory() {
return this.emf;
}
@ Produces
@ RequestScoped
public EntityManager getEntityManager() {
EntityManager em = emf.createEntityManager();
return em;
}
public void close(@ Disposes EntityManager em) {
em.close();
}
@ Produces
public UserGroupCallback produceSelectedUserGroupCalback() {
return userGroupCallback;
}
@ Produces
public IdentityProvider produceIdentityProvider {
return new IdentityProvider() {
// implement IdentityProvider
};
}
}
Then d epl o yments/busi ness-central . war/WEB-INF/beans. xml file may be configured to
change the current settings of the new userg ro upcal l back implementation.
<beans xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://docs.jboss.org/cdi/beans_1_0.xsd">
<alternatives>
<class>org.jbpm.services.task.identity.JAASUserGroupCallbackImpl</class>
</alternatives>
</beans>
Note
o rg . jbpm. servi ces. task. i d enti ty. JAASUserG ro upC al l backImpl is just an
example here to demonstrate the settings of the application server regardless of what it
actually is (LD AP, D B, etc).
Report a bug
31
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
9.1. Deploying Red Hat JBoss BPM Suit e art ifact s t o SOA Reposit ory
Art ifact Model and Prot ocol (S-RAMP) using Maven
Before you can deploy Red Hat JBoss BPM Suite artifacts to S-RAMP using Maven, you will need to
enable the S-RAMP Maven Wagon. The Maven Wagon is a key feature that supports the S-RAMP
Atom based REST API protocol. By enabling the S-RAMP Maven Wagon, users will be able to access
artifacts from the S-RAMP repository as dependencies in a Maven project.
Enable the S-RAMP Maven Wagon by making an edit in the po m. xml file as shown below:
<build>
<extensions>
<extension>
<groupId>org.overlord.sramp</groupId>
<artifactId>s-ramp-wagon</artifactId>
<version>${s-ramp-wagon.version}</version>
</extension>
</extensions>
</build>
Once the S-RAMP Maven Wagon is enabled, you can deploy the BPMS artifacts to that S-RAMP
repository. To do this, follow the steps below:
1. Clone the git repository where you have saved the BPM Suite project by running this
command:
git clone http://localhost:8001/REPOSITORY_NAME
2. On the command line, move into the folder that contains the project.
3. Follow the instructions in Red Hat JBoss Fuse Service Works 6 Development Guide, Volume 3:
Governance, section D eploying to S-RAMP. Use the URL from the example below:
<distributionManagement>
<repository>
<id>local-sramp-repo</id>
<name>S-RAMP Releases Repository</name>
<url>sramp://S-RAMP_SERVER_URL/s-ramp-server/</url>
</repository>
<snapshotRepository>
<id>local-sramp-repo-snapshots</id>
32
oying Red Hat JBoss BPM Suit e art ifact s t o SO A Reposit ory Art ifact Model and Prot ocol (S- RAMP) reposit ory
33
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
</dependency>
</dependencies>
</plugin>
</plugins>
5. Run a clean Maven deployment using the following command:
mvn -s sramp-settings.xml deploy
.
Note
For the Maven deployment to the S-RAMP repository, it is necessary to have credentials set in
the setti ng s. xml file. For further details on the credentials, refer to Red Hat JBoss Fuse
Service Works (FSW) documentation on Authentication.
Report a bug
9.2. Deploying Red Hat JBoss BPM Suit e art ifact s t o SOA Reposit ory
Art ifact Model and Prot ocol (S-RAMP) using graphical user int erface
(GUI)
To deploy BPMS artifacts to a S-RAMP repository using the user interface, do the following:
1. In a web browser, navigate to http://localhost:8080/s-ramp-ui/. If the user interface has been
configured to run from a domain name, substitute l o cal ho st for the domain name. For
example http://www.example.com:8080/s-ramp-ui/.
2. Click on Arti facts.
3. In the Manag e Arti facts section, select Impo rt.
4. Locate the kie archive you want to deploy. In the dialog that opens, fill out Ki eJarArchi ve
as the type, and select Impo rt.
5. The deployment then creates these entries in the S-RAMP repository:
Ki eJarArchi ve, from which it derives:
Ki eXml D o cument (if the archive contains kmo d ul e. xml )
BpmnD o cument (if the archive contains bpmn definitions)
D ro o l sD o cument (if the archive contains d rl definitions)
Report a bug
34
10.1. Session
Sessions are persisted as sessi o ni nfo entities. These persist the state of the runtime knowledge
session, and store the following data:
35
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
T ab le 10.1.
Field
D escrip t io n
N u llab le
id
lastmodificationdate
rulesbytearray
primary key
last saved to data store
binary dataset with session
state (binary blob )
session start
version number used lock
value for optimistic locking
false
N/A
false
startdate
optlock
Report a bug
D escrip t io n
N u llab le
instanceid
lastmodificationdate
lastreaddate
processid
primary key
last saved to data store
last read from data store
ID of the process the instance
is based on
binary dataset with process
instance state (binary blob )
Process instance start
version number used lock
value for optimistic locking
Process instance state
false
N/A
N/A
false
processinstancebytearray
startdate
optlock
state
false
false
D escrip t io n
N u llab le
instanceid
false
element
Report a bug
10.3. Work It em
36
Work Items are persisted as wo rki temi nfo entities, which persist the state of the particular work
item instance on runtime and store the following data:
T ab le 10.4 .
Field
D escrip t io n
N u llab le
workitemid
name
processinstanceid
state
primary key
work item name
parent Process instance id
integer representing work item
state
version number used lock
value for optimistic locking
binary dataset with work item
state (binary blob )
timestampe on which the work
item was created
false
optlock
workitembytearray
creationD ate
false
false
false
false
Report a bug
Examp le 10.1. A samp le jB PM.p ro p ert ies f ile wit h p ersist en ce f o r t h e in memo ry H 2 d at ab ase
# for creating a datasource
persistence.datasource.name=jdbc/jbpm-ds
persistence.datasource.user=sa
37
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
persistence.datasource.password=
persistence.datasource.url=jdbc:h2:tcp://localhost/~/jbpm-db
persistence.datasource.driverClassName=org.h2.Driver
# for configuring persistence of the session
persistence.enabled=true
persistence.persistenceunit.name=org.jbpm.persistence.jpa
persistence.persistenceunit.dialect=org.hibernate.dialect.H2Diale
ct
# for configuring the human task service
taskservice.enabled=true
taskservice.datasource.name=org.jbpm.task
taskservice.transport=mina
taskservice.usergroupcallback=org.jbpm.task.service.DefaultUserGro
upCallbackImpl
Any invocations on the session will now trigger the persistance process.
Make sure the datasource is up and running on engine start. If you are running the in-memory H2
database, you can start the database from your application using the
JBP MHel per. startH2Server(); method call and register it with the engine using
JBP MHel per. setupD ataSo urce(); method call.
Report a bug
38
Any invocations on the session will now trigger the persistance process.
39
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
Make sure the datasource is up and running on engine start. If you are running the in-memory H2
database, you can start the database from your application using the
JBP MHel per. startH2Server(); method call and register it with the engine using
JBP MHel per. setupD ataSo urce(); method call.
Report a bug
40
Chapt er 1 1 . Logging
D escrip t io n
N u llab le
id
end_date
No
Yes
processid
processinstanceid
start_date
status
parentProcessInstanceId
outcome
Yes
No
Yes
Yes
Yes
Yes
D escrip t io n
N u llab le
id
log_date
nodeid
No
Yes
Yes
nodeinstanceid
nodename
processid
processinstanceid
Yes
Yes
Yes
No
41
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
Field
D escrip t io n
N u llab le
type
No
D escrip t io n
N u llab le
id
log_date
processid
No
Yes
Yes
processinstanceid
value
variableid
variableinstanceid
outcome
No
Yes
Yes
Yes
Yes
If neccessary, define your own data model of custom information and use the process event listeners
to extract the information.
Report a bug
"http://java.sun.com/xml/ns/persistence
http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd
http://java.sun.com/xml/ns/persistence/orm
http://java.sun.com/xml/ns/persistence/orm_1_0.xsd"
xmlns:orm="http://java.sun.com/xml/ns/persistence/orm"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/persistence">
42
<persistence-unit name="org.jbpm.persistence.jpa">
<provider>org.hibernate.ejb.HibernatePersistence</provider>
<jta-data-source>jdbc/processInstanceDS</jta-data-source>
<class>org.drools.persistence.info.SessionInfo</class>
Chapt er 1 1 . Logging
<class>org.jbpm.persistence.processinstance.ProcessInstanceInfo</c
lass>
<class>org.drools.persistence.info.WorkItemInfo</class>
<class>org.jbpm.process.audit.ProcessInstanceLog</class>
<class>org.jbpm.process.audit.NodeInstanceLog</class>
<class>org.jbpm.process.audit.VariableInstanceLog</class>
<properties>
<property name="hibernate.dialect"
value="org.hibernate.dialect.H2Dialect"/>
<property name="hibernate.transaction.manager_lookup_class"
value="org.hibernate.transaction.BTMTransactionManagerLookup"/>
</properties>
</persistence-unit>
< /persistence>
i mport
i mport
i mport
i mport
. ..
org.jbpm.process.audit.AuditLogService;
org.jbpm.process.audit.AuditLoggerFactory;
org.jbpm.process.audit.AuditLoggerFactory.Type;
org.jbpm.process.audit.JPAAuditLogService;
@ PersistenceUnit(unitName = PERSISTENCE_UNIT_NAME)
private EntityManagerFactory emf;
RuntimeEngine runtime =
43
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
singletonManager.getRuntimeEngine(EmptyContext.get());
KieSession ksession = runtime.getKieSession();
AuditLoggerFactory.newInstance(Type.JPA, ksession, null);
3. Optionally, call the method ad d Fi l ter on the logger to filter out irrelevant information. Only
information accepted by all filters appears in the database.
4. Logger classes can be viewed in the Audit View:
<dependency>
<groupId>org.jbpm</groupId>
<artifactId>jbpm-audit</artifactId>
<version>6.0.1.Final</version>
</dependency>
Report a bug
44
Note
If a language is not specified, US English is used by default.
Report a bug
45
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
Note
Within Business Central, the application server does not need to be restarted after changing
locale if you append the " locale" parameter to the URL of Business Central. However, with
D ashbuilder, the application server should be restarted after the configuration files have been
changed.
Report a bug
46
47
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
org.kie.api.task.model.Task;
org.kie.api.task.model.User;
org.kie.api.task.model.Status;
org.kie.api.task.model.PeopleAssignments;
org.jbpm.services.task.rule.TaskServiceRequest;
org.jbpm.services.task.exception.PermissionDeniedException;
org.jbpm.services.task.impl.model.*;
java.util.HashMap;
java.util.List;
48
If the potential owners of a Human Task will contain the user Mary, the task will be automatically
assigned to the user mary.
org.kie.api.task.model.Task;
org.kie.api.task.model.User;
org.kie.api.task.model.Status;
org.kie.api.task.model.PeopleAssignments;
org.jbpm.services.task.rule.TaskServiceRequest;
org.jbpm.services.task.exception.PermissionDeniedException;
org.jbpm.services.task.impl.model.*;
java.util.HashMap;
java.util.List;
49
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
Report a bug
50
51
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
Part V. Monitoring
52
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
Note
Ki e Servi ces have been implemented for BRMS 6; for BRMS 5, D ro o l s Servi ces was
the naming convention used and it had different measurements on sessions. For example,
act ivat io n mat ch renaming occured in the updated version.
Please refer to the JBoss Operations Network Resource Monitoring and Operations Reference guide for
information on importing Kie Sessions into the Inventory View for monitoring purposes.
Report a bug
54
Chapt er 1 6 . Managing Securit y for Red Hat JBoss BPM Suit e Dashbuilder
Chapter 16. Managing Security for Red Hat JBoss BPM Suite
Dashbuilder
16.1. Accessing Red Hat JBoss BPM Suit e Dashbuilder
D ashbuilder is the Red Hat JBoss BPM Suite web-based user interface for Business Activity
Monitoring. To access the D ashbuilder from Business Central, go to D ash b o ard s Pro cess &
T ask D ash b o ard s.
The displayed dashboard provides statistics on runtime data selected on the left. You can create
your own dashboard in the D ashbuilder. To do so, display the D ashbuilder by clicking
D ash b o ard s B u sin ess D ash b o ard s.
Report a bug
55
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
4. Click the P ermi ssi o ns label to view the permission management screen.
56
Chapt er 1 6 . Managing Securit y for Red Hat JBoss BPM Suit e Dashbuilder
Note
By default, the full set of permissions go to the role admin. This makes it easy to create a user
that can do everything as long as the role admin is assigned.
Report a bug
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
1. To access P ag e permi ssi o ns, locate the P ag es drop-down under the jBPM D ashboard
(or whatever D ashboard you selected).
2. After expanding P ag es, expand the P ro cess d ashbo ard option.
3. Select the P ag e permi ssi o ns option.
58
Chapt er 1 6 . Managing Securit y for Red Hat JBoss BPM Suit e Dashbuilder
59
Red Hat JBoss BPM Suit e 6 .0 Administ rat ion And Configurat ion G uide
Revision History
R evisio n 1.0.0- 30
T h u Mar 05 2015
Vikram G o yal
Built from Content Specification: 22692, Revision: 745885 by vigoyal
60