Red Hat JBoss BPM Suite-6.0

Suite BPM JBoss de Red Hat 6.
0
Gua de inicio
La gua de inicio para BPMS JBoss Red Hat
Kanchan Desai Doug Hoffman Eva Kopalova

Red Hat Content Services
Suite BPM JBoss de Red Hat 6.0 Gua de inicio
La gua de inicio para BPMS JBoss Red Hat
Kanchan Desai
kadesai@redhat.co m
Do ug Ho ffman
Eva Ko palo va
Red Hat Co ntent Services

Legal Notice
Co pyright 20 14 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
Esta gua le ayuda a lo s usuario s a instalar y co nfigurar BPMS JBo ss de Red Hat po r primera
vez.
T able of Cont ent s
T able of Contents
.Prefacio
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. . . . . . . . . .
1. Co nvenc io nes d el Do c umento 3
1.1. Co nvenc io nes tip o g rfic as 3
1.2. Co nvenc io nes d el d o c umento 4
1.3. No tas y Ad vertenc ias 5
2 . C mo o b tener ayud a y hac er s us c o mentario s 5
2 .1. Nec es ita ayud a? 5
2 .2. Nec es itamo s s us c o mentario s ! 6
C
. .apt. . . ulo
...1. .. .Int
. . roduccin
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7. . . . . . . . . .
1.1. So b re la Suite BPM JBo s s d e Red Hat 7
1.2. Co mp o nentes d e la s uite BPM JBo s s d e Red Hat 7
1.3. Ejemp lo d e us o : s o luc io nes b as ad as en p ro c es o s en la ind us tria d e p rs tamo s 7
C
. .apt
. . . ulo
...2. .. .Inicio
. . . . .rpido
. . . . . . con
. . . .Red
. . . .Hat
. . . .JBoss
. . . . . BPM
. . . . .Suit
. . . .e. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 0. . . . . . . . . .
C
. .apt
. . . ulo
. . . 3.
..O. .pciones
. . . . . . . de
. . . inst
. . . .alacin
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 1. . . . . . . . . .
3 .1. La ins talac i n ag rup ad a EAP6 11
3 .1.1. Des c arg a d el p aq uete EAP6 11
3 .1.2. Ins talac i n d el p aq uete EAP6 11
3 .1.3. Definic i n d e ro les 13
3 .1.4. Creac i n d e us uario s 13
3 .2. La ins talac i n ag rup ad a g enric a imp lementab le 14
3 .2.1. Des c arg a d el p aq uete imp lementab le g enric o 14
3 .2.2. Ins talac i n d el p aq uete imp lementab le g enric o 15
3 .2.2.1. Co nfig urac i n d el ad minis trad o r d e trans ac c io nes p ara Red Hat JBo s s Web Server 2.0
(To mc at 7) 15
Ins tale el g es to r d e trans ac c io nes . 16
3 .2.2.2. Co nfig urac i n d e una c entral emp res arial p ara Red Hat JBo s s Web Server 2.0 (To mc at
7) 18
3 .2.2.3. Co nfig urac i n d e Das hb uild er p ara Red Hat JBo s s Web Server 2.0 (To mc at 7) 21
3 .3. Inic io d el s ervid o r 22
3 .4. Ad minis trad o r d e s eg urid ad Java y g es ti n d e rend imiento 23
C
. .apt
. . . ulo
...4. .. .Inicio
. . . . .de
. . .sesin
. . . . . .en
. . .la. .cent
. . . .ral
. . empresarial
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. 5. . . . . . . . . .
C
. .apt
. . . ulo
. . . 5.
. . Proyect
. . . . . . .o
. .Hello
. . . . .World
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2. 6. . . . . . . . . .
5 .1. Creac i n d e una es truc tura d e rep o s ito rio 26
C
. .apt
. . . ulo
...6. .. .Proceso
. . . . . . . Hello
. . . . . World
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2. 9. . . . . . . . . .
6 .1. Creac i n d e p ro c es o s emp res ariales 29
6 .2. Mo d elad o d e p ro c es o s emp res ariales 29
6 .3. Definic i n d e p ro p ied ad es d el elemento 30
6 .4. Co ns truc c i n e imp lementac i n 31
6 .5. Ins tanc iac i n d e p ro c es o s emp res ariales 32
6 .6 . Canc elac i n d e p ro c es o s emp res ariales 33
C
. .apt . . . ulo
...7 . .. .Reglas
. . . . . . empresariales
. . . . . . . . . . . . .Hello
. . . . .World
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
...........
7 .1. Creac i n d e la reg la emp res arial 34
7 .2. Ag reg ac i n d e la tarea d e reg las emp res ariales 35
7 .3. Co ns truc c i n e imp lementac i n 36
7 .4. Ins tanc iac i n d e p ro c es o s emp res ariales 37
C
. .apt
. . . ulo
...8. .. .BAM
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
...........
8 .1. Ac c es o al c o ns truc to r d e p neles d e la s uite BPM JBo s s Red Hat 39
1
Suit e BPM JBoss de Red Hat 6 .0 G ua de inicio
8 .1. Ac c es o al c o ns truc to r d e p neles d e la s uite BPM JBo s s Red Hat 39

8 .2. Mo nito riz ac i n d e ins tanc ias 39
C
. .apt
. . . ulo
...9. .. .Est
. . .udio
. . . . del
. . . desarrollador
. . . . . . . . . . . . JBoss
. . . . . . de
. . .Red
. . . .Hat
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. 0. . . . . . . . . .
9 .1. Central d e JBo s s 40
9 .2. Ins talac i n d e lo s p lug ins d el es tud io d el d es arro llad o r JBo s s 41
9 .3. Co nfig urac i n d el tiemp o d e ejec uc i n Dro o ls 41
9 .4. Co nfig urac i n d el tiemp o d e ejec uc i n jBPM 42
9 .5. Co nfig urac i n d el s ervid o r d e la s uite BPM JBo s s 42
9 .6 . Imp o rtac i n d e p ro yec to s d es d e un rep o s ito rio G it a JBo s s Develo p er Stud io 43
9 .7. Creac i n d e un p ro yec to Dro o ls 45
9 .8 . Creac i n d e un p ro yec to jBPM 45
C
. .apt
. . . ulo
...1. .0.. .Planificador
. . . . . . . . . . .de
. . recursos
. . . . . . . . .empresariales
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. 7. . . . . . . . . .
10 .1. Ins talac i n d el p lanific ad o r d e rec urs o s emp res ariales 47
10 .2. Ejec uc i n d e lo s ejemp lo s d el p lanific ad o r d e rec urs o s emp res ariales 47
. . . . orial
Hist . . . . de
. . . revisiones
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. 9. . . . . . . . . .
2
Prefacio
Prefacio
1. Convenciones del Document o
Este manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la
atencin sobre ciertas partes especficas de informacin.
En ediciones PD F y de papel, este manual utiliza tipos de letra procedentes de Liberation Fonts.
Liberation Fonts tambin se utilizan en ediciones de HTML si estn instalados en su sistema. Si no,
se muestran tipografas alternativas pero equivalentes. Nota: Red Hat Enterprise Linux 5 y siguientes
incluyen Liberation Fonts predeterminadas.
1.1. Convenciones t ipogrficas
Se utilizan cuatro convenciones tipogrficas para llamar la atencin sobre palabras o frases
especficas. D ichas convenciones y las circunstancias en que se aplican son las siguientes:
Neg ri ta mo no espaci ad o
Utilizado para resaltar la entrada del sistema, incluyendo los comandos de shell, nombres de
archivos y rutas. Tambin sirve para resaltar teclas y combinaciones de teclas. Por ejemplo:
Para ver el contenido del archivo my_next_bestsel l i ng _no vel en su directorio

actual de trabajo, escriba el comando cat my_next_bestsel l i ng _no vel en el
intrprete de comandos de shell y pulse Enter para ejecutar el comando.
El ejemplo anterior incluye un nombre de archivo, un comando de shell y una tecla . Todo se
presenta en negrita-monoespaciado y distinguible gracias al contexto.
Las combinaciones de teclas se pueden distinguir de las individuales con el signo ms que conecta
cada partee de la combinacin de tecla. Por ejemplo:
Pulse Enter para ejecutar el comando.
Pulse C trl +Al t+F2 para pasar a una terminal virtual.
El primer ejemplo resalta una tecla particular a pulsar. El segundo ejemplo, resalta una combinacin
de teclas: un set de tres teclas pulsadas simultneamente.
Si se discute el cdigo fuente, los nombres de las clase, los mtodos, las funciones, los nombres de
variables y valores de retorno mencionados dentro de un prrafo sern presentados en Neg ri ta-
mo no espaci ad o . Por ejemplo:
Las clases de archivo relacionadas incluyen fi l ename para sistema de archivos,

fi l e para archivos y d i r para directorios. Cada clase tiene su propio conjunto
asociado de permisos.
N eg rit a p ro p o rcio n al
Esta denota palabras o frases encontradas en un sistema, incluyendo nombres de aplicacin, texto
de cuadro de dilogo, botones etiquetados, etiquetas de cajilla de verificacin y botn de radio;
ttulos de men y ttulos del submen. Por ejemplo:
Seleccione Sist ema Pref eren cias R at n desde la barra del men principal
para lanzar Pref eren cias d e rat n . En la pestaa de Bo to nes, seleccione la
cajilla de rat n d e mano i zq ui erd a y luego haga clic en C errar para cambiar
el botn principal del ratn de la izquierda a la derecha (adecuando el ratn para la
3
mano izquierda).
Para insertar un carcter especial en un archivo g ed it , seleccione Ap licacio n es

Acceso rio s Map a d e caract eres de la barra del men. Luego, seleccione
B sq u ed a B u scar de la barra del men de Map a d e caract eres, escriba el
nombre del carcter en el campo de Bsq ued a y haga clic en Si g ui ente. El
carcter que busc ser resaltado en la T abl a d e caracteres. Haga doble clic en
ese carcter resaltado para colocarlo en el campo de T exto a co pi ar y luego
haga clic en el botn C o pi ar. Ahora regrese al documento y elija Mo d if icar
Peg ar de la barra de men de g ed it .
El texto anterior incluye nombres de aplicacin; nombres y elementos del men de todo el sistema;
nombres de men de aplicaciones especficas y botones y texto hallados dentro de una interfaz
grfica de usuario, todos presentados en negrita proporcional y distinguibles por contexto.
Itlicas-negrita monoespaciado o Itlicas-negrita proporcional
Ya sea negrita monoespaciado o negrita proporcional, la adicin de itlicas indica texto

reemplazable o variable. Las itlicas denotan texto que usted no escribe literalmente o texto
mostrado que cambia dependiendo de la circunstancia. Por ejemplo:
Para conectar a una mquina remota utilizando ssh, teclee ssh nombre de
usuario@ dominio.nombre en un intrprete de comandos de shell. Si la mquina
remota es exampl e. co m y su nombre de usuario en esa mquina es john, teclee
ssh jo hn@ exampl e. co m.
El comando mo unt -o remo unt file-system remonta el sistema de archivo

llamado. Por ejemplo, para volver a montar el sistema de archivo /ho me, el comando
es mo unt -o remo unt /ho me.
Para ver la versin de un paquete actualmente instalado, utilice el comando rpm -q

paquete. ste entregar el resultado siguiente: paquete-versin-lanzamiento.
Observe que las palabras resaltadas en itlicas nombre de usuario, dominio.nombre, sistema de
archivo, paquete, versin y lanzamiento. Cada palabra es un marcador de posicin, ya sea de texto
a ingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema.
Aparte del uso estndar para presentar el ttulo de un trabajo, las itlicas denotan el primer uso de
un trmino nuevo e importante. Por ejemplo:
Publican es un sistema de publicacin de DocBook.
1.2. Convenciones del document o
Los mensajes de salida de la terminal o fragmentos de cdigo fuente se distinguen visualmente del
texto circundante.
Los mensajes de salida enviados a una terminal se muestran en ro mano mo no espaci ad o y se

presentan as:
bo o ks D eskto p do cum entatio n drafts m ss pho to s stuff svn

bo o ks_tests D eskto p1 do wnlo ads im ages no tes scripts svgs
Los listados de cdigo fuente tambin se muestran en ro mano mo no espaci ad o , pero se

presentan y resaltan de la siguiente manera:
static int kvm _vm _io ctl_deassign_device(struct kvm * kvm ,

struct kvm _assigned_pci_dev * assigned_dev)
4
Prefacio
{
int r = 0 ;
struct kvm _assigned_dev_kernel * m atch;
m utex_lo ck(& kvm -> lo ck);
m atch = kvm _find_assigned_dev(& kvm -> arch.assigned_dev_head,

assigned_dev-> assigned_dev_id);
if (! m atch) {
printk(KER N_I NFO "%s: device hasn' t been assigned befo re, "
"so canno t be deassigned\n", __func__);
r = -EI NVAL;
go to o ut;
}
kvm _deassign_device(kvm , m atch);
kvm _free_assigned_device(kvm , m atch);
o ut:
m utex_unlo ck(& kvm -> lo ck);
return r;
}
1.3. Not as y Advert encias
Finalmente, utilizamos tres estilos visuales para llamar la atencin sobre la informacin que de otro
modo se podra pasar por alto.
Nota
Una nota es una sugerencia, atajo o enfoque alternativo para una tarea determinada. Ignorar
una nota no debera tener consecuencias negativas, pero podra perderse de algunos trucos
que pueden facilitarle las cosas.
Importante
Los cuadros con el ttulo de importante dan detalles de cosas que se pueden pasar por alto
fcilmente: cambios de configuracin nicamente aplicables a la sesin actual, o servicios
que necesitan reiniciarse antes de que se aplique una actualizacin. Ignorar estos cuadros
no ocasionar prdida de datos, pero puede causar enfado y frustracin.
Aviso
Las advertencias no deben ignorarse. Ignorarlas muy probablemente ocasionar prdida de

datos.
2. Cmo obt ener ayuda y hacer sus coment arios
2.1. Necesit a ayuda?
5
Si encuentra dificultades con alguno de los procedimientos descritos en este documento, visite el
Portal del cliente de Red Hat en http://access.redhat.com. A travs del portal del cliente, usted podr:
buscar o navegar a travs de la base de artculos de soporte tcnico sobre productos de Red
Hat.
enviar un caso de soporte a Servicios de Soporte Global de Red Hat (GSS)
acceder a otra documentacin del producto.
Red Hat alberga una lista grande de correos electrnicos para discutir sobre software de Red Hat y
tecnologa. Encontrar un listado de las listas de correo disponibles al pblico en
https://www.redhat.com/mailman/listinfo. Haga clic en el nombre de la lista a la que quiera
suscribirse o para acceder a los archivos de listados.
2.2. Necesit amos sus coment arios!
Si encuentra un error tipogrfico en este manual o si ha pensado que hay alguna manera de
mejorar este manual, nos gustara escuchar sus sugerencias. Por favor complete un reporte en
Bugzilla: http://bugzilla.redhat.com/ relacionando el producto Su it e B PM JB o ss d e R ed H at .
Cuando enve un reporte de error no olvide mencionar el identificador' del manual:

Getting_Started_Guide
Si tiene alguna sugerencia para mejorar la documentacin, trate de ser tan especfico como sea
posible. Si ha encontrado algn error, por favor incluya el nmero de la seccin y parte del texto
que lo rodea para que sea ms fcil ubicarlo.
6
Capt ulo 1 . Int roduccin
Captulo 1. Introduccin
1.1. Sobre la Suit e BPM JBoss de Red Hat

La suite BPM JBoss de Red Hat es una suite de gestion de procesos empresariales de cdigo
abierto que combina la administracin de procesos empresariales y la gestin de reglas
empresariales y habilita a las empresas y a los usuarios informticos para crear, administrar e
implementar procesos y reglas empresariales.
BRMS JBoss de Red Hat y la suite BPM JBoss de Red Hat usan un repositorio centralizado en
donde todos los recursos se almacenan. Esto asegura consistencia, transparencia y la habilidad
para realizar auditoras a travs de la empresa. Los usuarios empresariales pueden modificar la
lgica empresarial y los procesos empresariales sin requerir ayuda del personal de sistemas.
Para acomodar el componente de reglas empresariales, la suite BPM JBoss de Red Hat incluye
BRMS JBoss de Red Hat.
El planificador de recursos empresariales se incluye como un avance de tecnologa con este

lanzamiento.
Reportar un error
1.2. Component es de la suit e BPM JBoss de Red Hat
La suite BPM JBoss de Red Hat contiene los siguientes componentes:
Mq u in a d e ejecu ci n
El entorno del tiempo de ejecucin para los activos empresariales (procesos, tareas,
reglas, etc). Para obtener mayores detalles consulte la Gua de configuracin y administracin
de la suite BPM JBoss de Red Hat.
R ep o sit o rio d e art ef act o s ( almacn d e co n o cimien t o )
Un almacenamiento para activos empresariales que proporcionan funcionalidades de

control de revisiones (conecta repositorios GIT con activos empresariales).
C en t ral emp resarial
Una aplicacin basada en red para la creacin, administracin y monitoreamiento de

activos empresariales proporcionando un entorno integrado con las herramientas
respectivas tal como reglas y herramientas de autora de procesos, la herramienta de
administracin de activos empresariales para trabajar con el repositorio de artefactos,
herramientas de administracin de datos en tiempo de ejecucin, editores de recursos,
herramientas BAM (del ingls Business Activity Monitoring- monitoreamiento de actividades
empresariales), herramientas de administracin de tareas y herramientas BRMS. Para
obtener mayores detalles consulte la Gua del usuario de la suite BPM JBoss de Red Hat.
Reportar un error
1.3. Ejemplo de uso: soluciones basadas en procesos en la indust ria de

prst amos
La suite BPM JBoss de Red Hat (BPMS) se puede implementar para automatizar procesos
empresariales tal como automatizar el proceso de aprobacin de prstamos en un banco minorista.
7
Esta es una implementacin tpica 'basada en procesos especficos' que puede ser el primer paso
en una adopcin ms amplia de BPM a travs de una empresa. Aprovecha las funcionalidades de
BPM y las reglas empresariales de BPMS.
Un banco minorista ofrece varios tipos de productos de prstamo con diferentes trminos y
requerimientos de seleccin. Los clientes que requieren un prstamo deben llenar una aplicacin de
prstamo, la cual es procesada por el banco en varios pasos, verificando el criterio de seleccin,
determinando los trminos, verificando actividades fraudulentas y determinando el producto de
prstamo ms apropiado. Una vez aprobado, el banco crea y establece una cuenta de prstamo
para el aplicante, quien luego puede acceder a los fondos. El banco debe asegurarse de cumplir
con todos los requerimientos relevantes en cada paso del proceso y necesita administrar su
portafolio de prstamo para maximizar sus ganancias. Las polticas tienen lugar para ayudar a
tomar decisiones en cada paso y esas polticas estn administradas activamente para optimizar
resultados para el banco.
Los analistas empresariales en el banco modelan los procesos de aplicacin para prstamos
usando las herramientas de autor BPMN3 (diseador de procesos) en la suite BPM:
Fig u ra 1.1. Flu jo d e p ro ceso s d e ap licaci n p ara p rst amo s d e alt o n ivel
Las reglas empresariales se desarrollan con las herramientas de autor de reglas en la suite BPM
para aplicar polticas y tomar decisiones. Las reglas estn enlazadas con los modelos de procesos
para reforzar las polticas correctas en cada paso del proceso.
La seccin de sistemas del banco implementa la suite BPM de manera que todo el proceso de
aplicacin para prstamos se pueda automatizar.
8
Capt ulo 1 . Int roduccin
Fig u ra 1.2. Au t o mat iz aci n d el p ro ceso d e ap licaci n p ara p rst amo s
Todo el proceso de prstamo y de reglas se puede modificar en cualquier momento por parte de los
analistas empresariales del banco. El banco tiene la habilidad de mantener constantemente un
cumplimiento con los requerimientos de acuerdo con las regulaciones cambiantes y puede
introducir de manera rpida nuevos productos de prstamo y mejorar las polticas de prstamos
para competir efectivamente y dirigir la rentabilidad.
Reportar un error
9
Captulo 2. Inicio rpido con Red Hat JBoss BPM Suite

En esta seccin descargamos, instalamos y ejecutamos Red Hat JBoss BPM Suite con el nmero
mnimo de instrucciones. Para obtener pasos detallados y mtodos opcionales de instalacin,
sltese esta seccin y contine leyendo el resto de esta gua.
Estas instrucciones asumen que tiene instalada en su sistema la versin de Java soportada como
mnimo. No se requiere un servidor Red Hat JBoss EAP ya existente ya que el instalador instala uno
si no puede detectar uno.
Pro ced imien t o 2.1. G u a d e in icio rp id o B PM Su it e
1. D escargue el instalador BPM Suite de access.redhat.com.
2. Ejecute el instalador con el siguiente comando:
java -jar jbo ss-bpms-i nstal l er-VER SIO N. G A-red hat-MINO R . jar
3. Siga los pasos del instalador GUI tomando nota del nombre de usuario/contrasea para
acceder a la aplicacin BRMS despus de la instalacin.
4. D espus de una instalacin exitosa, en una ventana de comandos navegue hasta la

carpeta de inicio EAP en donde haya instalado BPM Suite.
5. Inicie el servidor BPM Suite emitiendo el siguiente comando.
bi n/stand al o ne. sh
6. Abra un navegador de red e inicie sesin en la central empresarial navegando hasta

http: //l o cal ho st: 80 80 /busi ness-central /. Inicie la sesin usando la
combinacin de nombre de usuario/contrasea para acceder a la aplicacin BPM Suite que
cre en el momento de la instalacin.
Ha instalado y ejecutado exitsamente BPM Suite. Ahora puede hacer lo siguiente:
Aprender ms sobre los roles: Seccin 3.1.3, D efinicin de roles

Crear usuarios adicionales: Seccin 3.1.4, Creacin de usuarios
Crear un proyecto Hello World: Captulo 5, Proyecto Hello World
Examine la Gua de la aplicacin de ejemplo BPM Working with the BPM Suite Example App
Busque instrucciones detalladas de instalacin para usar el instalador: Installation Guide
Reportar un error
10
Capt ulo 3. O pciones de inst alacin
Captulo 3. Opciones de instalacin

La suite BPM JBoss de Red Hat viene en dos versiones:
Instalador jar ejecutable para la instalacin en Red Hat JBoss Enterprise Application Platform
(EAP) 6.1.1.
Archivo comprimido de instalacin, el cual viene en dos versiones:
jbo ss-bpms-6 . MINOR_VERSION-red hat-x-d epl o yabl e-eap6 . x. zi p: versin

adaptada para implementacin en la plataforma de aplicaciones empresariales JBoss de Red
Hat (EAP 6.1.1).
jbo ss-bpms-6 . MINOR_VERSION-red hat-x-d epl o yabl e-g eneri c. zi p: la versin

implementable con bibliotecas adicionales adaptadas para la implementacin en el Red Hat
JBoss Web Server (WS), Apache Tomcat 6 y Apache Tomcat 7.
D ependiendo de su entorno puede seleccionar la mejor opcin de instalacin de acuerdo con las
necesidades de su proyecto.
Reportar un error
3.1. La inst alacin agrupada EAP6
Esta seccin describe la instalacin del paquete de la suite BPM JBoss de Red Hat implementable
para la plataforma de aplicaciones empresariales JBoss de Red Hat JBoss (EAP).
Nota
La configuracin mnima soportada de Red Hat JBoss EAP para la instalacin de la suite
BPM JBoss de Red Hat es 6.1.1 y no 6.1.0.
Reportar un error
3.1.1. Descarga del paquet e EAP6
Para descargar el paquete de la suite BPM JBoss de Red Hat para la plataforma de aplicaciones
empresariales JBoss, haga lo siguiente:
1. Vaya al portal del cliente de Red Hat e inicie sesin.
2. Seleccione D o wn lo ad s R ed H at JB o ss Mid d leware D o wn lo ad So f t ware.
3. D el men desplegable P ro d uct seleccione BP M Sui te.
4. D el men desplegable Versi o n seleccione la versin del producto.
5. En la tabla, navegue a la fila R ed Hat JBo ss BP M Sui te 6 . 0 . 2 i mpl ementabl e

para EAP 6 . 1. 1 y luego haga clic en D escarg ar.
Reportar un error
3.1.2. Inst alacin del paquet e EAP6
11
Para instalar el paquete implementable para un EAP que todava no se ha configurado, haga lo
siguiente:
1. Extraiga el paquete zip implementable para EAP que descarg del portal del cliente de Red
Hat.
2. Agrupe el paquete zip extrado para EAP en el directorio EAP SERVER_HOME.
Aviso
Este paso debe ser realizado con la misma cuenta de usuario que se utiliz para
instalar EAP. Esta cuenta no debe ser la cuenta del superusuario.
3. En este proceso, se sobreescribirn mltiples archivos en el directorio EAP SERVER_HOME y

usted debe permitir que el proceso de descompresin sobreescriba estos archivos. Un
ejemplo de un archivo que se sobreescribe es el archivo
SERVER_HOME/bi n/pro d uct. co nf. D espus de una agrupacin exitosa, este archivo
debe contener la cadena sl o t= bpms. Puede abrir este archivo para verificar que los
archivos se hayan sobreescrito de manera exitosa.
En Red Hat Enterprise Linux puede utilizar el siguiente comando para extraer el archivo zip BRMS y
unirlo con su directorio de servidor correctamente en un paso, si ejecuta este comando en el
directorio en donde descarg el archivo zip:
unzip -u jbo ss-bpm s-VERSION-TYPE.zip -d SERVER_HOME_PARENT_DIR
Ejemp lo 3.1. El co man d o p ara d esco mp rimir
unzip -u jbo ss-bpm s-6 .0 .2-redhat-7-deplo yable-eap6 .x.zip -d /ho m e/jo hn/m yS ervers/
En el arranque del servidor se implementar la suite BPM JBoss de Red Hat.
Para instalar el paquete implementable para un EAP previamente configurado, haga lo siguiente:
1. Extraiga el paquete zip implementable para EAP que descarg del portal del cliente de Red
Hat.
2. D escomprima el archivador comprimido descargado; sin embargo, no sobreescriba todos

los archivos. Agrupe manualmente los siguientes archivos en el directorio SERVER_HOME.
jbo ss-eap-6 . 1/d o mai n/co nfi g urati o n/* - (por favor tenga en cuenta que BPMS
requiere JMS as que JMS se agrega por defecto en todos los perfiles en d o mai n. xml
proporcionado por la distribucin BPMS).
jbo ss-eap-6 . 1/stand al o ne/co nfi g urati o n/* - (por favor tenga en cuenta que
BPMS requiere JMS as que JMS se agrega por defecto en todos los archivos de
configuracin de perfiles (especialmente en stand al o ne. xml y stand al o ne-ha. xml )
proporcionado por la distribucin BPMS).
jbo ss-eap-6 . 1/mo d ul es/l ayers. co nf
jbo ss-eap-6 . 1/bi n/pro d uct. co nf
12
3. Asegrese de que el EAP de destino no incluya una implementacin con un nombre que cree
conflictos. Copie la carpeta jbo ss-eap-6 . 1/stand al o ne/d epl o yments en el directorio
EAP_HOME de la distribucin BPMS.
4. Asegrese de que no se ha llamado antes la capa del mdulo EAP llamada BPMS y copie la
carpeta jbo ss-eap-6 . 1/mo d ul es/system/l ayers/bpms en la carpeta EAP 6.1.1.
Reportar un error
3.1.3. Definicin de roles
Antes de iniciar el servidor e iniciar sesin en la central empresarial necesitar crear algunas
cuentas de usuarios. Esta seccin describe los diferentes roles de usuario que se utilizan Red Hat
JBoss BPM Suite :
admin: los usuarios con el rol admin son los administradores de la aplicacin. Los
administradores pueden administrar los usuarios, administrar los repositorios (crear y clonar) y
tienen acceso completo para realizar los cambios requeridos en la aplicacin. Los admins tienen
acceso a todas las reas dentro del sistema.
developer: un usuario developer -desarrollador- tiene acceso a casi todas las funcionalidades y
puede administrar reglas, modelos, flujos de procesos, formas y pneles. Pueden administrar el
repositorio de activos, pueden crear, construir e implementar proyectos e incluso pueden usar el
Red Hat JBoss D eveloper Studio para ver procesos. Solo se esconden ciertas funciones
administrativas como el crear y clonar un nuevo repositorio para el rol del desarrollador.
analyst: un rol de analista tiene acceso a todas las funcionalidades de alto nivel para modelar y
ejecutar sus proyectos. Sin embargo, el acceso Au t h o rin g Ad min ist rat io n no est
disponible para los usuarios con el rol de analista. Ciertas funcionalidades de menor nivel
orientadas a los desarrolladores como la vista D ep lo ymen t Art if act R ep o sit o ry no son
accesibles para este rol. Sin embargo, el botn Bui l d & D epl o y est disponible para el rol de
analista usando el editor de proyectos.
user: un usuario o un usuario empresarial trabajan en las listas de tareas empresariales que se
utilizan para operar cierto proceso. Un usuario con este rol puede acceder el pnel y administrar
procesos.
manager: un manager -gerente- es un espectador del sistema y est interesado en las

estadsticas con relacin a los procesos empresariales y su rendimiento, indicadores
empresariales y otros reportes del sistema. Un usuario con este rol tiene acceso al BAM
solamente.
Nota
Ingrese los roles mencionados anteriormente durante el proceso de creacin del usuario.
Reportar un error
3.1.4 . Creacin de usuarios
Para empezar a agregar nuevos usuarios necesitar ejecutar el script add-user.sh en un sistema
Unix o el archivo add-user.bat en un sistema Windows desde el directorio bin EAP.
1. Ejecute ./add-user.sh en un sistema Unix o add-user.bat en un sistema Windows desde el

directorio bin.
13
2. Ingrese b para seleccionar un usuario de la aplicacin en el tipo de usuario y presione Intro.
3. Acepte el dominio predeterminado (ApplicationRealm): presionando Intro.
4. En el campo del nombre del usuario ingrese un nombre de usuario y confirme. Por ejemplo:
hel l o wo rl d user.
5. Cree la contrasea del usuario en el campo de la contrasea y reingrese la contrasea. Por

ejemplo: Hel l o wo rl d @ 123.
Nota
La contrasea debe tener por lo menos 8 caracteres de largo y debe tener caracteres
en maysculas y minsculas (por ejemplo, A-Z , a-z) por lo menos un caracter
numrico (por ejemplo,. 0-9) y por lo menos un caracter especial (por ejemplo, ~ ! @ #
$ % ^ * ( ) - _ + =).
6. Ingrese una lista de roles que el usuario necesitar en el campo de roles (consulte
Seccin 3.1.3, D efinicin de roles ).
Los usuarios de la central empresarial necesitan por lo menos tener el rol anal yst y los
usuarios dashbuilder necesitan tener el rol ad mi n. Los roles se deben ingresar como una
lista:
7. Confirme que quiere agregar el usuario.
8. Ingrese si en el siguiente campo (esto es para habilitar el uso de clsters en el futuro si se

requiere).
Reportar un error
3.2. La inst alacin agrupada genrica implement able
Para instalar la suite BPM JBoss de Red Hat en el Red Hat JBoss Web Server (WS) , necesita utilizar
el paquete implementable genrico del producto.
Para la instalacin en WS, el paquete implementable genrico contiene bibliotecas de seguridad y

administradores de transacciones adicionales que no son parte del WS JBoss Red Hat.
Note que el paquete implementable genrico contiene los siguientes archivos zip:
jbo ss-bpms-eng i ne. zi p: las bibliotecas de la mquina de ejecucin soportada que se

necesitan si est incluyendo la mquina en su aplicacin
jbo ss-bpms-manag er. zi p: las aplicaciones de red busi ness-central . war y

d ashbui l d er. war
Reportar un error
3.2.1. Descarga del paquet e implement able genrico
Para descargar el paquete de la suite BPM JBoss de Red Hat genrico implementable para el
servidor de red JBoss, haga lo siguiente:
1. Vaya al portal del cliente de Red Hat e inicie sesin.
14
3. D el men desplegable P ro d uct seleccione BP M Sui te.
4. D el men desplegable Versi o n seleccione la versin del producto.
5. En la tabla, navegue a la fila R ed Hat JBo ss BP M Sui te 6 . 0 . 2 D epl o yabl e fo r

al l suppo rted co ntai ners y luego haga clic en D o wnl o ad .
Reportar un error
3.2.2. Inst alacin del paquet e implement able genrico
Para instalar el paquete implementable genrico, necesita configurar lo siguiente despus de haber
instalado la plataforma subyacente (Red Hat JBoss WS):
Configure el controlador de la base de datos y el gestor de transacciones (Bitronix) (consulte

Seccin 3.2.2.1, Configuracin del administrador de transacciones para Red Hat JBoss Web
Server 2.0 (Tomcat 7) ).
Configure la aplicacin de la central empresarial: configure usuarios y roles y configure la

persistencia (consulte Seccin 3.2.2.2, Configuracin de una central empresarial para Red Hat
JBoss Web Server 2.0 (Tomcat 7) ).
Configure la aplicacin D ashbuilder: configure usuarios y roles y configure la persistencia

(consulte Seccin 3.2.2.3, Configuracin de D ashbuilder para Red Hat JBoss Web Server 2.0
(Tomcat 7) ).
Reportar un error
3.2 .2 .1 . Co nfiguraci n de l adm inist rado r de t ransaccio ne s para Re d Hat JBo ss We b

Se rve r 2 .0 (T o m cat 7 )
1. Extraiga el paquete zip genrico implementable que descarg del Portal del cliente de Red
Hat. Este paquete zip contiene dos archvos zip ms: jbo ss-bpms-eng i ne. zi p y jbo ss-
bpms-manag er. zi p.
2. Extraiga el contenido del archivo jbo ss-bpms-manag er. zi p en una ubicacin temporal.
Este archivo zip contiene dos carpetas archivadoras de aplicaciones de red: busi ness-
central . war y d ashbui l d er. war en formatos expandidos y estas estn ahora en su
ubicacin temporal. Vuelva a nombrar estas carpetas para borrar la extensin . war.
Copie ambas carpetas directamente bajo la carpeta $TOMCAT_DIR/webapps.
Al final debe tener dos carpetas en formato expandido:

$TOMCAT_DIR/webapps/busi ness-central y $TOMCAT_DIR/webapps/d ashbui l d er.
Nota
$TOMCAT_DIR se refiere al directorio de inicio en donde se encuentra su servidor de

red. Reemplcelo con la ruta a su directorio de inicio del servidor de red, por ejemplo:
/ho me/jo hn/jbo ss-ews-2. 0 /to mcat7/
15
3. Extraiga la carpeta jbo ss-bpms-eng i ne del archivador jbo ss-bpms-eng i ne. zi p a

una ubicacin temporal desde donde puede copiar las bibliotecas requeridas. Esta carpeta
ahora contiene todas las abibliotecas centrales BPMS bajo la carpeta extrada y una
carpeta l i b.
4. In st ale el g est o r d e t ran saccio n es.
Copie las siguientes bibliotecas jar del administrador de transacciones de la carpeta l i b en

donde extrajo las bibliotecas jbo ss-bpms-eng i ne al directorio $TOMCAT_DIR/l i b/:
btm-VERSION.jar
btm-tomcat55-lifecycle-VERSION.jar
jta-VERSION.jar
slf4j-api-VERSION.jar
slf4j-ext-VERSION.jar
Adems descargue la siguiente biblioteca y cpiela en la carpeta $TOMCAT_DIR/l i b/

tambin:
javax.security.jacc-api.jar
5. Instale el controlador en su base de datos: copie el archivo jar con el controlador de la base
de datos relevante en $TOMCAT_DIR/l i b/.
Controlador para la base de datos H2 includa
Si utiliza la base de datos H2 includa, el controlador est disponible en busi ness-

central /WEB-INF/l i b/.
6. Cree los archivos de configuracin del gestor de transacciones en $TOMCAT_DIR/co nf/:
btm-config.properties
bitro nix.tm .serverI d=to m cat-btm -no de0

bitro nix.tm .jo urnal.disk.lo gP art1Filenam e=$ {btm .ro o t}/wo rk/btm 1.tlo g
bitro nix.tm .jo urnal.disk.lo gP art2Filenam e=$ {btm .ro o t}/wo rk/btm 2.tlo g
bitro nix.tm .reso urce.co nfiguratio n=$ {btm .ro o t}/co nf/reso urces.pro perties
resources.properties (el resource.ds1.uniqueName define el nombre de la fuente de datos

utilizado despus en la definicin de recursos tomcat - tome nota de este valor).
Asegrese de cambiar los valores en las siguientes definiciones para que coincidan con
su entorno.
Ejemp lo 3.2. D ef in ici n d e la f u en t e d e d at o s H 2
reso urce.ds1.classNam e=bitro nix.tm .reso urce.jdbc.lrc.LrcXAD ataS o urce

reso urce.ds1.uniqueNam e=jdbc/jbpm
reso urce.ds1.m inP o o lS ize=10
reso urce.ds1.m axP o o lS ize=20
reso urce.ds1.driverP ro perties.driverClassNam e=o rg.h2.D river
16
reso urce.ds1.driverP ro perties.url=jdbc:h2:file:~/jbpm

reso urce.ds1.driverP ro perties.user=sa
reso urce.ds1.driverP ro perties.passwo rd=
reso urce.ds1.allo wLo calT ransactio ns=true
Ejemp lo 3.3. D ef in ici n d e la f u en t e d e d at o s MySQ L 5.5
reso urce.ds1.classNam e=co m .m ysql.jdbc.jdbc2.o ptio nal.M ysqlXAD ataS o urce

reso urce.ds1.driverP ro perties.U R L=jdbc:m ysql://lo calho st:330 6 /sam pledb
reso urce.ds1.driverP ro perties.user=dbuser
reso urce.ds1.driverP ro perties.passwo rd=dbpasswo rd
Ejemp lo 3.4 . D ef in ici n d e la f u en t e d e d at o s D B 2 T yp e 4
reso urce.ds1.classNam e=co m .ibm .db2.jcc.D B 2D river

reso urce.ds1.driverP ro perties.U R L=jdbc:db2://lo calho st:50 0 0 0 /sam pledb
Ejemp lo 3.5. D ef in ici n d e la f u en t e d e d at o s O racle
reso urce.ds1.classNam e=o racle.jdbc.xa.client.O racleXAD ataS o urce

reso urce.ds1.driverP ro perties.U R L=jdbc:o racle:thin:@ //lo calho st:1521/bpm
s
Ejemp lo 3.6 . D ef in ici n d e la f u en t e d e d at o s d el servid o r Micro so f t SQ L
reso urce.ds1.classNam e=co m .m icro so ft.sqlserver.jdbc.S Q LS erverD river

reso urce.ds1.driverP ro perties.U R L=jdbc:sqlserver://lo calho st:1433;databas
eNam e=bpm s;
7. Configure el escucha del gestor de transacciones en $TOMCAT_DIR/co nf/server. xml

para iniciar y detener Bitronix en el arranque y detencin del contenedor:
Agregue el siguiente elemento como el ltimo elemento <Listener> en el elemento <Server>:
17
< Listener classNam e="bitro nix.tm .integratio n.to m cat55.B T M LifecycleListener"

/>
8. D efina la propiedad del sistema btm.root y la ubicacin en donde se ubica el archivo de

configuracin bitronix:
En $TOMCAT_DIR/bi n/ cree el archivosetenv. sh con el siguiente contenido:
CAT ALI NA_O P T S ="-Xm x512M -XX:M axP erm S ize=512m -D btm .ro o t=$ CAT ALI NA_HO M E -
D bitro nix.tm .co nfiguratio n=$ CAT ALI NA_HO M E/co nf/btm -co nfig.pro perties -
D o rg.jbpm .designer.perspective=R uleFlo w"
Otorgue permisos de ejecucin de archivos si aplica. La ltima propiedad

o rg . jbpm. d esi g ner. perspecti ve se establece como R ul eFl o w para permitir que la
perspectiva predeterminada para el diseador sea R ul eFl o w en lugar de Ful l .
T omcat en sistemas Microsoft Windows
En sistemas Microsoft Windows reemplace el valor $C AT ALINA_HO ME en el contenido

del archivo con el nombre de la variable de entorno equivalente o use la ruta absoluta
y agregue los valores en el archivo setenv. bat tal como se muestra en el siguiente
ejemplo:
set "CAT ALI NA_O P T S =-Xm x512M -XX:M axP erm S ize=512m -D btm .ro o t=C:/T o m cat
-D bitro nix.tm .co nfiguratio n=C:/T o m cat/co nf/btm -co nfig.pro perties -
D o rg.jbpm .designer.perspective=R uleFlo w"
Reportar un error
3.2 .2 .2 . Co nfiguraci n de una ce nt ral e m pre sarial para Re d Hat JBo ss We b Se rve r
2 .0 (T o m cat 7 )
Para establecer la central empresarial haga lo siguiente:
1. Establezca una Val ve de manera que la aplicacin de red de la central empresarial pueda
cargar la configuracin de los usuarios en Tomcat:
a. D efina los usuarios y roles en $TOMCAT_DIR/co nf/to mcat-users. xml . Note que
la central empresarial requiere que los usuarios tengan los roles especificados como
ad mi n y/o anal yst (fpara mayor informacin sobre definiciones de roles y usuarios
consulte la documentacin de Tomcat 7).
El programa listado a continuacin muestra un ejemplo de la manera en que estos

dos roles se agregaran y cmo se le asignar estos roles al usuario llamado
bpmsad mi n.
< ro le ro lenam e="adm in"/>

< ro le ro lenam e="analyst" />
< user usernam e="bpm sadm in" passwo rd="P @ ssw0 rd"
ro les="adm in,analyst"/>
18
b. Copie ki e-to mcat-i nteg rati o n-VERSION. jar de

$TOMCAT_DIR/webapps/busi ness-central /WEB-INF/l i b/ a
$TOMCAT_DIR/l i b/.
c. Copie jaxb-api -VERSION. jar de $TOMCAT_DIR/webapps/busi ness-

central /WEB-INF/l i b/ a $TOMCAT_DIR/l i b/.
d. En $TOMCAT_DIR/co nf/server. xml agregue la declaracin de la vlvula Tomcat

en el elemento relevante <host>:
< Valve classNam e="o rg.kie.integratio n.to m cat.JACCValve" />
e. En $TOMCAT_DIR/webapps/busi ness-central /WEB-INF/web. xml borre el

comentario de las entradas marcadas con el comentario T O MC AT -JEE-SEC UR IT Y .
f. Configure la fuente de autenticacin tomcat: en el directorio

$TOMCAT_DIR/webapps/busi ness-central /WEB-INF/cl asses/MET A-
INF/servi ces/, renombre los siguientes archivos:
o rg . uberfi re. securi ty. auth. Authenti cati o nSo urce como
o rg . uberfi re. securi ty. auth. Authenti cati o nSo urce-O R IG IN y
o rg . uberfi re. securi ty. auth. Authenti cati o nSo urce-T O MC AT -JEE-
SEC UR IT Y como o rg . uberfi re. securi ty. auth. Authenti cati o nSo urce:
# Co m ando de ejem plo si ejecuta este desde el directo rio

$ T O M CAT _D I R /webapps
$ m v business-central/WEB -I NF/classes/M ET A-
I NF/services/o rg.uberfire.security.auth.Authenticatio nS o urce business-
central/WEB -I NF/classes/M ET A-
I NF/services/o rg.uberfire.security.auth.Authenticatio nS o urce-O R I G I N
$ m v business-central/WEB -I NF/classes/M ET A-
I NF/services/o rg.uberfire.security.auth.Authenticatio nS o urce-T O M CAT -
JEE-S ECU R I T Y business-central/WEB -I NF/classes/M ET A-
I NF/services/o rg.uberfire.security.auth.Authenticatio nS o urce
g. En $TOMCAT_DIR/webapps/busi ness-central /WEB-INF/beans. xml borre el

comentario JAASUserG ro upInfo P ro d ucer y agregue el comentario
o rg . jbpm. ki e. servi ces. cd i . pro d ucer. D efaul tUserG ro upInfo P ro d uce
r (opcional). La parte al ternati ves de este archivo se debe ver as:
< alternatives>
< ! --
< class> o rg.jbpm .kie.services.cdi.pro ducer.D efaultU serG ro upI nfo P ro ducer
< /class> -->
< ! -- unco m m ent JAAS U serG ro upI nfo P ro ducer when using JEE security
o n T o m cat -->
< class> o rg.jbpm .kie.services.cdi.pro ducer.JAAS U serG ro upI nfo P ro ducer< /c

lass>
< /alternatives>
2. Si est usando una fuente de datos diferente de la predeterminada proporcionada por la

base de datos H2 subyacente necesitar configurar la persistencia. Si est utilizando la
base de datos H2 predeterminada entonces puede ignorar el resto de pasos en este
procedimiento.
19
En este procedimiento se configura una fuente de datos con el nombre JND I

jd bc/myD ataso urce tal como se define en uniqueName=jdbc/jbpm en el archivo bitronix
reso urces. pro perti es (para la opcin MySQL):
a. En busi ness-central /MET A-INF/co ntext. xml reemplace el nombre JND I de la

fuente de datos en el elemento <Resource>. El atributo uniqueName se refiere a la
propiedad resource.ds1.uniqueName establecida en reso urces. pro perti es:
< R eso urce nam e="jdbc/m yD ataso urce" uniqueNam e="jdbc/jbpm "
auth="Co ntainer" rem o veAbando ned="true"
facto ry="bitro nix.tm .reso urce.R eso urceO bjectFacto ry"
type="javax.sql.D ataS o urce"/>
b. En busi ness-central /WEB-INF/web. xml reemplace el nombre JND I de la fuente

de datos en el elemento <res-ref-name> con su nombre de fuente de datos:
< reso urce-ref>

< descriptio n> Co nso le D S < /descriptio n>
< res-ref-nam e> jdbc/m yD ataso urce< /res-ref-nam e>
< res-type> javax.sql.D ataS o urce< /res-type>
< res-auth> Co ntainer< /res-auth>
< /reso urce-ref>
c. Cambie busi ness-central /WEB-INF/cl asses/MET A-INF/persi stence. xml .
En este archivo cambie el nombre del dialecto hibernate utilizado para su base de
datos si est utilizando una base de datos diferente de H2. El cdigo a continuacin
demuestra la informacin de la base de datos original para persi stence. xml :
< pro perty nam e="hibernate.dialect"

value="o rg.hibernate.dialect.H2D ialect"/>
Esta informacin se puede actualizar de la siguiente manera (tal como se demuestra

con la base de datos MySQL a continuacin):
< pro perty nam e="hibernate.dialect"

value="o rg.hibernate.dialect.M yS Q LD ialect"/>
Nota
El dialecto para D B2 es o rg . hi bernate. d i al ect. D B2D i al ect, para

D B2 en AS/400 es o rg . hi bernate. d i al ect. D B24 0 0 D i al ect, para
Oracle es o rg . hi bernate. d i al ect. O racl e10 g D i al ect y para el
servidor Microsoft SQL es o rg . hi bernate. d i al ect. SQ LServerD i al ect
d. Cambie el archivo busi ness-central /WEB-INF/cl asses/MET A-

INF/persi stence. xml de manera que la mquina de procesos BPMS pueda usar
la nueva base de datos.
El cdigo a continuacin demuestra la informacin de la fuente de datos original

para persi stence. xml :
< jta-data-so urce> java:co m p/env/jdbc/jbpm < /jta-data-so urce>
Cambie este valor a la fuente de datos definida anteriormente:
20
< jta-data-so urce> java:co m p/env/jdbc/m yD ataso urce< /jta-data-so urce>
3. Ahora puede iniciar JBoss Web Server para iniciar sesin en la central empresarial.
a. Ejecute startup. sh en el directorio $TOMCAT_HOME/bi n.
./startup.sh
b. Navegue hasta http://localhost:8080/business-central en un navegador de red.
c. Inicie sesin con el nombre de usuario/contrasea correctos tal como aparece en el

archivo to mcat-users. xml en donde defini los roles de usuario.
Reportar un error
3.2 .2 .3. Co nfiguraci n de Dashbuilde r para Re d Hat JBo ss We b Se rve r 2 .0 (T o m cat

7)
Para establecer un panel de construccin en el servidor de red JBoss Red Hat, haga lo siguiente:
1. D efinir usuarios y roles en $TOMCAT_DIR/co nf/to mcat-users. xml . Note que

D ashbuilder requiere que los usuarios tengan el rol especificado como ad mi n y/o anal yst.
Si ya defini estos usuarios para la central empresarial entonces no necesita definirlos de
nuevo.
2. Habilitar el inicio de sesin nico entre D ashbuilder y la central empresarial borrando el

comentario de las siguientes lneas en el archivo $TOMCAT_DIR/co nf/server. xml :
< Valve classNam e="o rg.apache.catalina.authenticato r.S ingleS ignO n" />
3. As como con la configuracin de la central empresarial, si est utilizando una base de

datos diferente de la base de datos H2 integrada y predeterminada entonces necesitar
configurar la persistencia.
En este procedimiento se configura una fuente de datos con el nombre JND I

jd bc/d ashbui l d erD S tal como se define en uniqueName=jdbc/jbpm en el archivo bitronix
reso urces. pro perti es:
a. En d ashbui l d er/MET A-INF/co ntext. xml reemplace el nombre JND I de la fuente

de datos en el elemento <Resource>. El atributo uniqueName se refiere a la
propiedad resource.ds1.uniqueName establecida en reso urces. pro perti es:
< R eso urce nam e="jdbc/dashbuilderD S " uniqueNam e="jdbc/jbpm "

type="javax.sql.D ataS o urce"/>
21
Nota
D ependiendo de su base de datos es posible que necesite definir algunas

otras propiedades aqu tambin. Por ejemplo, en un entorno Oracle esta
entrada puede verse como el siguiente listado.
< R eso urce nam e="jdbc/jbpm " uniqueNam e="jdbc/jbpm "

type="javax.sql.D ataS o urce" usernam e="usernam e"
passwo rd="passwo rd"
driverClassNam e="o racle.jdbc.xa.client.O racleXAD ataS o urce"
url="jdbc:o racle:thin:Y O U R -U R L:1521:Y O U R -D B " m axActive="8 " />
b. En d ashbui l d er/WEB-INF/web. xml agregue el nombre JND I de la fuente de

datos en el elemento <res-ref-name> con su nombre de fuente de datos:
< reso urce-ref>

< descriptio n> D ashbo ard B uilder D ataso urce< /descriptio n>
< res-ref-nam e> jdbc/dashbuilderD S < /res-ref-nam e>
< res-type> javax.sql.D ataS o urce< /res-type>
< res-auth> Co ntainer< /res-auth>
< /reso urce-ref>
c. En d ashbui l d er/MET A-INF/co ntext. xml defina la fbrica de transacciones:
< T ransactio n
facto ry="bitro nix.tm .B itro nixU serT ransactio nO bjectFacto ry"/>
d. Actualice el nombre JND I de la fuente de datos en d ashbui l d er/WEB-

INF/etc/hi bernate. cfg . xml en el elemento <session-factory>:
< pro perty

nam e="co nnectio n.dataso urce"> java:/co m p/env/jdbc/dashbuilderD S < /pro per
ty>
4. Reinicie el servidor de red Java para que los cambios tengan efecto. Una vez reiniciado
puede navegar al D ashbuilder desde la central empresarial o directamente a travs de:
http: //l o cal ho st: 80 80 /d ashbui l d er.
Reportar un error
3.3. Inicio del servidor

Si ha instalado BPMS usando ya sea el instalador o por medio de la instalacin agrupada EAP6
entonces ahora puede iniciar su servidor en uno de dos modos disponibles.
22
Nota
Si instal BPMS usando la versin implementable genrica en el servidor de red Java de Red
Hat, las instrucciones para descargar e instalar tambin contienen las instrucciones para
iniciar el servidor. Puede ignorar la siguiente discusin.
El script de arranque predeterminado, stand al o ne. sh con el que se enva la suite BPMJBoss de
Red Hat est optimizado para rendimiento. Para ejecutar su servidor en modo de rendimiento, haga
lo siguiente:
1. En la lnea de comandos vaya al directorio $SERVER_HOME/bi n/.
2. En un entorno Unix ejecute:
./standalo ne.sh
En un entorno Windows ejecute:
./standalo ne.bat
La suite BPMJBoss Red Hat tambin se enva con un script separado, stand al o ne-secure. sh
que est optimizado para la seguridad. Este script aplica una poltica de seguridad por defecto que
protege en contra de alguna vulnerabilidad de seguridad conocida.
Nota
Se recomienda que los entornos de produccin utilicen el script stand al o ne-secure. sh.
Aviso
El uso de un administrador de seguridad impone una sancin importante en el rendimiento

que debe tener en mente. El intercambio entre la seguridad y el rendimiento se debe realizar
teniendo en consideracin las circunstancias individuales. Consulte Seccin 3.4,
Administrador de seguridad Java y gestin de rendimiento .
Para ejecutar su servidor en el modo seguro con este script, haga lo siguiente:
1. En la lnea de comandos vaya al directorio $SERVER_HOME/bi n/.
2. En un entorno Unix ejecute:
./standalo ne-secure.sh
En un entorno Windows ejecute:
./standalo ne-secure.bat
Reportar un error
3.4 . Administ rador de seguridad Java y gest in de rendimient o
23
3.4 . Administ rador de seguridad Java y gest in de rendimient o

Como se observ anteriormente el habilitar el administrador de seguridad Java (JSM del ingls Java
Security Manager) como un entorno de pruebas completo para la evaluacin de scripts MVEL en
BPMS introduce una penalidad de rendimiento en entornos de alta carga. Se deben tener en cuenta
los marcadores de entorno y de rendimiento al implementar una aplicacin BPMS. Use las
siguientes directrices para implementar aplicaciones BPMS seguras y de alto rendimiento.
En entornos de alto rendimiento en donde el rendimiento es crtico se recomienda que slo se

implementen aplicaciones que hayan sido desarrolladas en otros sistemas y que hayan sido
revisadas apropiadamente. Tambin se recomienda no crear ningn usuario con el rol Analyst
en dichos sistemas. Si se toman en cuenta estas medidas entonces es seguro el dejar JSM
deshabilitado en estos sistemas de manera que no introduzca ninguna degradacin del
rendimiento.
En entornos de prueba y desarrollo sin altas cargas o en entornos en donde la autora de reglas
y procesos est expuesta a redes externas, se recomienda tener JSM habilitado con el fin de
lograr beneficios de seguridad de una evaluacin completa del entorno de prueba de MVEL.
No es seguro y no se recomienda el permitir que usuarios con el rol Analyst inicien sesin en la
consola central empresarial con JSM inhabilitado.
Reportar un error
24
Capt ulo 4 . Inicio de sesin en la cent ral empresarial
Captulo 4. Inicio de sesin en la central empresarial

Inicio de sesin en la central empresarial despus de que el servidor ha iniciado exitsamente.
1. Navegue hasta http://localhost:8080/business-central en un navegador de red. Si la interfaz

se ha configurado para ejecutar desde un nombre de dominio, substituya l o cal ho st para
el nombre del dominio. Por ejemplo http://www.example.com:8080/business-central.
2. Inicie sesin con las credenciales de usuario que se crearon durante la instalacin. Por
ejemplo: User = hel l o wo rl d user and password = Hel l o wo rl d @ 123.
Reportar un error
25
Captulo 5. Proyecto Hello World

Para demostrar las funcionalidades bsicas de la suite BPM JBoss Red Hat, este captulo le
mostrar cmo configurar el proyecto Hel l o Wo rl d con un proceso empresarial Hel l o Wo rl d .
Todo lo que este proceso empresarial har es presentar el mensaje Hel l o Wo rl d ! y terminar la
ejecucin.
Tendr que hacer lo siguiente:
1. Cree un repositorio Hello World en el repositorio Artifact.
2. Cree el proyecto Hello World con la definicin del proceso empresarial con la definicin del
proceso empresarial Hel l o Wo rl d .
3. Modele la lgica del proceso Hello World en el proceso empresarial usando la herramienta
del diseador de procesos grfico.
4. Construya e implemente el proyecto en la mquina de ejecucin ejecutando localmente.
5. Ejecute el proceso Hello World.
6. Monitoree la ejecucin del proceso.
Reportar un error
5.1. Creacin de una est ruct ura de reposit orio

Todos los activos empresariales viven en repositorios que viven en unidades organizacionales, los
cuales son directorios en el repositorio Artifact. Por defecto, el repositorio Artifact no contiene
ninguna unidad organizacional. Por lo tanto, para poder crear sus propios activos empresariales
tal como un proceso empresarial, necesita crear una unidad organizacional en el repositorio Artifact
y un repositorio (Git) en el. Luego el repositorio puede contener su proyecto. Un proyecto puede
contener una estructura de paquete arbitraria, la cual le permite estructurar su contenido en una
estructura lgica de " directorio" . Cualquier paquete puede contener sus activos empresariales (para
mayor informacin sobre el repositorio Artifact consulte la Red Hat JBoss BRMS User Guide).
Para crear la estructura del repositorio, haga lo siguiente:
1. Abra la central empresarial en su navegador de red (si est ejecutando localmente

http://localhost:8080/business-central) e inicie sesin como usuario con el rol ad mi n
(hel l o wo rl d user).
2. Cree una unidad organizacional en el repositorio Artifact:
a. Vaya a Au t h o rin g Ad min ist rat io n .
b. En el men de perspectivas haga clic en O rg an iz at io n al U n it s Man ag e

O rg an iz at io n al U n it s.
c. En la vista que se presenta O rg ani zati o nal Uni t Manag er haga clic en Ad d .
En la ventana que se presenta Ad d New O rg ani zati o nal Uni t defina las
propiedades de las unidades y haga clic en O K:
Nombre: hel l o wo rl d
Propietario: hel l o wo rl d user
26
Capt ulo 5. Proyect o Hello World
3. Cree un nuevo repositorio en la unidad organizacional helloworld:
a. Vaya a Au t h o rin g Ad min ist rat io n .
b. En el men de perspectivas haga clic en R ep o sit o ries N ew rep o sit o ry.
c. En la ventana que se presenta C reate R epo si to ry defina las propiedades del

repositorio:
Nombre del repositorio: hel l o wo rl d repo
Unidad organizacional: hel l o wo rl d
4. Vaya a Au t h o rin g Pro ject Au t h o rin g .
5. En el explorador de proyectos en la casilla desplegable de la unidad organizacional,

seleccione hel l o wo rl d y en la casilla desplegable del repositorio seleccione
hel l o wo rl d repo .
Fig u ra 5.1. Seleccio n e el rep o sit o rio hel l o wo rl d repo en el g ru p o

o rg an iz acio n al hel l o wo rl d en el exp lo rad o r d e p ro yect o s
6. Cree un proyecto en el repositorio hel l o wo rl d :
a. En el men de perspectivas vaya a N ew It em Pro ject
b. En la ventana que se presenta C reate new defina sus propiedades del proyecto:
Nombre del recurso (nombre del proyecto): Hel l o Wo rl d
Ruta: d efaul t: //master@ hel l o wo rl d repo /
c. En el dilogo New P ro ject Wi zard defina las propiedades maven del proyecto.
Presione Intro despus de realiza cada entrada:
Id del grupo: o rg . jbpm
Id del arterfacto: Hel l o Wo rl d
Id de la versin: 1. 0
27
d. Haga clic en Fi ni sh.
Reportar un error
28
Capt ulo 6 . Proceso Hello World
Captulo 6. Proceso Hello World

En este captulo continuaremos con el ejemplo de Hello World y crearemos todo un proceso
empresarial para demostrar la creacin de un proceso bsico Hello World.
Reportar un error
6.1. Creacin de procesos empresariales
Para crear una nueva definicin de proceso empresarial haga lo siguiente:
1. Utilice la perspectiva de autora de proyectos (Au t h o rin g Pro ject Au t h o rin g ) .
2. En la vista del explorador de proyectos a la izquierda, seleccione la unidad organizacional

hel l o wo rl d , el repositorio hel l o wo rl d repo , el proyecto Hel l o Wo rl d y el paquete
org.jbpm: esto define la ubicacin en el repositorio Artifact, en donde crear su definicin de
proceso empresarial.
Seleccin de paquetes
Asegrese de seleccionar el paquete org.jbpm. El seleccionar un paquete incorrecto

hace que la implementacin falle.
3. En el men de perspectivas haga clic en N ew It em B u sin ess Pro cess y defina los
detalles de la definicin de procesos:
Ingrese el nombre del recurso como Hel l o Wo rl d .
4. Haga clic en Aceptar.
Se abre el diseador de procesos con la vista de la definicin del proceso creado.
Reportar un error
6.2. Modelado de procesos empresariales
D espus de haber creado la definicin de procesos empresariales, puede disear el proceso

empresarial en el diseador de procesos empresariales: el diseador del proceso empresarial debe
estar abierto en una pestaa a la derecha. Si cerr la pestaa, en el explorador de proyectos haga
clic en Hel l o Wo rl d bajo Busi ness P ro cesses para volver a abrir el diseador de procesos
empresariales. Asegrese de seleccionar el paquete correcto (org.jbpm.helloworld). Para disear el
contenido del proceso, haga lo siguiente:
1. Amplie la paleta O bject Li brary con los elementos del proceso: haga clic en el botn con
doble flecha ( ) en la esquina superior izquierda de la pestaa del diseador de procesos
empresariales.
2. Aparece un elemento de inicio del evento.
3. Haga clic en el elemento de inicio del evento: los objetos de enlace rpido aparecen
alrededor del nodo. Haga clic en el cono de la tarea ( ) para crear un flujo de secuencia
saliente y un elemento de tarea conectado al inicio del evento.
29
4. Cree un evento temporizador: de la paleta arrastre y deje caer el T i mer (bajo C atchi ng
Intermed i ate Events) y conecte la tarea al elemento temporizador usando el men de
enlace rpido.
5. Cree el elemento Terminar evento conectado al elemento Evento temporizador (ya sea
usando la funcionalidad de enlace rpido o arrastrndolo de la paleta).
Fig u ra 6 .1. B o rrad o r d el p ro ceso H ello Wo rld
Reportar un error
6.3. Definicin de propiedades del element o

Ahora necesita definir las propiedades del elemento:
1. Haga clic en la doble flecha ( ) en la esquina superior derecha para expandir la pestaa
P ro perti es.
2. Haga clic en cualquier parte. La pestaa P ro perti es presenta las propiedades del proceso
Hel l o Wo rl d . Las propiedades requeridas son pre-definidas; sin embargo, puede cambiar
sus valores si es necesario.
3. El elemento de inicio y el elemento para terminar solo tienen propiedades opcionales. Sin
embargo, los elementos tareas necesitan su tipo y propiedades especficas de tipo definidas:
haga clic en el elemento tarea y defina las propiedades requeridas:
Name: Scri ptT ask
Task Type: Scri pt
Script Language: java
Script: System. o ut. pri ntl n("Hel l o Wo rl d ! ");
Haga clic en Aceptar.
Ha definido una tarea que realizar un script durante la ejecucin. El script est definido en
Java y ejecuta el mtodo System. o ut. pri ntl n("Hel l o Wo rl d ! ");, eso significa que
escribir Hel l o Wo rl d ! en la salida estndar del servidor (por defecto, la salida estndar
del servidor es la consola en la que se inici el servidor).
4. Todava necesita definir propiedades del evento temporizador para hacer que el proceso
espere en tiempo de ejecucin de manera que usted pueda inspeccionar su ejecucin: haga
clic en el elemento temporizador y defina las propiedades requeridas:
Time Cycle Language: C ro n
30
D uration: 1m y presione Intro.
Por lo tanto el proceso esperar por un minuto en el evento temporizador despus de que
ejecuta la tarea script.
5. Nombre el evento temporizador por medio de las propiedades y luego guarde su proceso:
abra el men Save ( ) y haga clic en Save.
6. Haga click en el botn ( ) en la barra de herramientas del diseador de procesos con el

proceso para asegurarse de que el proceso definido es vlido. El esquema de cualquier
elemento con uno o mltiples errores de validacin se vuelve naranja (consulte la Red Hat
JBoss BPMS User Guide para obtener informacin sobre la funcionalidad de validacin).
Para obtener mayor informacin sobre los elementos de procesos y sus propiedades consulte la
JBoss BPMS User Guide.
Reportar un error
6.4 . Const ruccin e implement acin

Antes de poder instanciar, es decir, ejecutar su proceso Hel l o Wo rl d , necesita construir todo el
proyecto e implementarlo en el servidor de ejecucin:
1. En el men principal de la central empresarial vaya a Au t h o rin g Pro ject Au t h o rin g .
2. En el explorador de proyectos ubique el proyecto Hello World.
3. Abra el proyecto en el editor de proyectos: en el men de perspectivas haga clic en T o o ls

Pro ject Ed it o r.
4. Verifique que los detalles del proyecto estn correctos en el P ro ject Screen y haga clic en
el botn Bui l d & D epl o y en la esquina superior derecha de la vista de la pantalla del
proyecto.
Fig u ra 6 .2. Ed it o r d e p ro yect o s co n las sig u ien t es p ro p ied ad es d el p ro yect o

h ello Wo rld
31
Aparecer una notificacin en verde en la parte superior de la pantalla informndole que el proyecto
se ha construdo e implementado en el servidor de ejecuciones y est disponible para instanciacin.
Reportar un error
6.5. Inst anciacin de procesos empresariales

Para crear una instancia del proceso Hel l o Wo rl d , es decir, ejecutar el proceso empresarial,
haga lo siguiente:
1. Haga clic en Pro cess Man ag emen t Pro cess D ef in it io n s en el men principal.
2. En la pestaa P ro cess D efi ni ti o ns que se presenta ubique el Hel l o Wo rl d . Es

posible que tenga que hacer clic en R efresh para que la implementacin se pueda ver en la
lista.
3. Haga clic en el botn Start( ) al lado de la entrada de la definicin del proceso y en la
casilla Fo rm haga clic en el botn play ( ) para confirmar que quiere instanciar el
proceso.
El proceso se instancia con el usuario que actualmente est en sesin como propietario del
proceso y el formato del proceso se presenta (el formato puede servir para solicitar entrada
de un usuario en la instanciacin de procesos si est definido; consulte la Red Hat JBoss
BPMS User Guide).
Se presenta la vista P ro cess Instance D etai l s con los detalles sobre la instancia del proceso
iniciado. Aparece el mensaje Hel l o Wo rl d ! en la salida estndar, usualmente el emulador
terminal en el que se inici el servidor. Luego la instancia del proceso espera por el evento
temporizador. Haga clic en Vi ews - P ro cess Mo d el para ver el estado actual de ejecucin.
Fig u ra 6 .3. D iag rama d e ejecu ci n en t iemp o real H ello Wo rld : el even t o t emp o riz ad o r en
ejecu ci n
Reportar un error
32
6.6. Cancelacin de procesos empresariales
En este momento est ejecutando una instancia del proceso Hel l o Wo rl d en el servidor de
ejecucin (siendo ejecutado). Puede chequear la vista P ro cess Instances: para presentar la
vista vaya a Pro cess Man ag emen t Pro cess In st an ces.
D esde aqu puede ver los detalles de cualquier instancia de procesos usando el botn de detalles (
) y realizar acciones de administracin bsicas tal como enviar una seal a una instancia de
proceso ( ) y cancelarla ( ).
Ya que la instancia del proceso Hel l o Wo rl d est esperando por el evento temporizador,
canclela: haga clic en ( ) en la lnea con la informacin sobre la instancia del proceso
Hel l o Wo rl d : la instancia desaparecer de la lista de instancias de procesos activos y aparecer
en la lista de instancias Abo rted .
Fig u ra 6 .4 . In st an cias d e p ro ceso s can celad o s in clu yen d o la in st an cia d el p ro ceso

H ello Wo rld
Reportar un error
33
Captulo 7. Reglas empresariales Hello World

Ya que BPMS viene con BRMS integrado, este captulo proporciona una introduccin a la manera
en que funcionan las reglas empresariales y cmo se integran en BPMS.
Agregar una nueva tarea, una tarea de regla empresarial al proceso HelloWorld, el cual disparar
una regla empresarial de un grupo de reglas empresariales particular.
Note que este es un caso de integracin muy simple y en produccin puede que necesite un
concepto y tcnicas ms avanzadas tal como tablas de decisiones. Para mayor informacin sobre
las reglas empresariales y BRMS consulte la Red Hat JBoss BRMS User Guide
Reportar un error
7.1. Creacin de la regla empresarial
Las reglas empresariales se definen como declaraciones cuando-entonces: cuando algo es

verdadero entonces algo pasa (por ejemplo, cuando la persona es mayor de 18 aos, pueden
acceder el contenido particular). Las reglas empresariales se almacenan en archivos D RL.
Para definir la regla empresarial hel l o wo rl d rul e en el proyecto Hel l o Wo rl d haga lo siguiente:
1. En el P ro ject Expl o rer seleccione la unidad organizacional hel l o wo rl d , el repositorio

hel l o wo rl d repo , el proyecto Hel l o Wo rl d y el paquete default.
Asegrese de seleccionar el paquete default. El seleccionar un paquete incorrecto

causa que la implementacin falle.
2. Crear el archivo D RL:
a. En el men de perspectivas haga clic en N ew It em D R L f ile.
b. En la casilla C reate new defina el nombre del recurso como hel l o wo rl d rul e y
verifique que la ruta destino sea
d efaul t: //master@ hel l o wo rl d repo /Hel l o Wo rl d /src/mai n/reso urces.
c. Haga clic en Aceptar.
3. En el editor D RL que se presenta con el archivo hel l o wo rl d rul e. d rl defina la regla:
rule "hello wo rldrule"

ruleflo w-gro up "hello wo rldgro up"
when
then
S ystem .o ut.println("Hello Wo rld! ");
end
Esta regla no define ninguna condicin cuando, es decir que siempre ser verdadera
cuando se dispare (llamada a ejecutar) y se imprimir la frase Hel l o Wo rl d ! .
4. Haga clic en Save.
34
Capt ulo 7 . Reglas empresariales Hello World
5. Se presenta un campo Save thi s i tem. Ingrese el C heck-i n co mment y haga clic en
guardar.
Nota
El comentario de registro sera una descripcin corta de la clase de cambio que

realiz y se tiene que ingresar cada vez que se guarda un activo.
Reportar un error
7.2. Agregacin de la t area de reglas empresariales
Una tarea de reglas empresariales es una tarea que dispara reglas que pertenecen a cierto grupo de
flujo de reglas.
Para agregar una tarea de reglas empresariales a su proceso, haga lo siguiente:
1. Abra su proceso empresarial en el diseador de procesos: en P ro ject Expl o rer

seleccione el proyecto Hel l o Wo rl d , el paquete org.jbpm, haga clic en BUSINESS
P R O C ESSES y haga clic en el proceso Hel l o Wo rl d .
Asegrese de seleccionar el paquete org.jbpm. El seleccionar un paquete incorrecto

causa que la implementacin falle.
2. En el diseador de procesos empresariales que se presenta con el proceso helloworld,

amplie la paleta O bject Li brary con los elementos del proceso: haga clic en el botn con
doble flecha ( ) en la esquina superior izquierda de la pestaa del diseador de procesos
empresariales.
3. Amplie el men T asks y arrastre y deje caer la tarea de reglas empresariales a la derecha.
Ajuste las conecciones de flujo para integrar la tarea en el flujo de trabajo.
4. Seleccione la tarea de reglas empresariales y defina sus propiedades en el panel

P ro perti es:
Nombre: Busi nessR ul e
Grupo de flujo de reglas: hel l o wo rl d g ro up
La propiedad Ruleflow Group define el grupo de reglas que se deben disparar cuando se
est ejecutando la tarea. En este ejemplo, solo una regla, la reglahel l o wo rl d g ro up
definida en el archivo hel l o wo rl d rul e. d rl , est presente en el grupo
hel l o wo rl d g ro up.
35
Fig u ra 7.1. El p ro ceso h ello wo rld co n la t area d e reg las emp resariales y su s
p ro p ied ad es
5. Haga clic en el botn para guardar para mantener los cambios.
Reportar un error
7.3. Const ruccin e implement acin

Construya todo el proyecto e implemntelo en el servidor de ejecucin:
1. En el men principal de la central empresarial vaya a Au t h o rin g Pro ject Au t h o rin g .
2. En el explorador de proyectos ubique el proyecto Hello World.
3. Abra el proyecto en el editor de proyectos: en el men de perspectivas haga clic en T o o ls

Pro ject Ed it o r.
4. Verifique que los detalles del proyecto estn correctos en el P ro ject Screen y haga clic en
el botn Bui l d & D epl o y en la esquina superior derecha de la vista de la pantalla del
proyecto.
36
Capt ulo 7 . Reglas empresariales Hello World
Fig u ra 7.2. Ed it o r d e p ro yect o s co n las sig u ien t es p ro p ied ad es d el p ro yect o

h ello Wo rld
Aparece una notificacin en verde en la parte superior de la pantalla informndole que el proyecto
se construy e implement en el servidor de ejecuciones y que est disponible para ser instanciado.
Note que la versin anterior de la implementacin hel l o Wo rl d se substituye con la nueva versin
con la tarea de la regla empresarial. Para mantener ambas implementaciones, cambie el nmero de
la versin del proyecto en el editor de proyectos.
Reportar un error
7.4 . Inst anciacin de procesos empresariales

Para crear una instancia del proceso Hel l o Wo rl d , es decir, ejecutar el proceso empresarial,
haga lo siguiente:
1. Haga clic en Pro cess Man ag emen t Pro cess D ef in it io n s en el men principal.
2. En la pestaa P ro cess D efi ni ti o ns que se presenta ubique el Hel l o Wo rl d . Es

posible que tenga que hacer clic en R efresh para que la implementacin se pueda ver en la
lista.
3. Haga clic en el botn Start( ) al lado de la entrada de la definicin del proceso y en la
casilla Fo rm haga clic en el botn play ( ) para confirmar que quiere instanciar el
proceso.
El proceso se instancia con el usuario que actualmente est en sesin como propietario del
proceso y el formato del proceso se presenta (el formato puede servir para solicitar entrada
de un usuario en la instanciacin de procesos si est definido; consulte la Red Hat JBoss
BPMS User Guide).
Se presenta la vista P ro cess Instance D etai l s con los detalles sobre la instancia del proceso
iniciado. Aparece el mensaje Hel l o Wo rl d ! en la salida estndar, usualmente el emulador
terminal en el que se inici el servidor. Luego la instancia del proceso espera por el evento
temporizador. Haga clic en Vi ews - P ro cess Mo d el para ver el estado actual de ejecucin.
Fig u ra 7.3. D iag rama d e ejecu ci n en t iemp o real H ello Wo rld : el even t o t emp o riz ad o r en
ejecu ci n
37
Reportar un error
38
Capt ulo 8 . BAM
Captulo 8. BAM
8.1. Acceso al const ruct or de pneles de la suit e BPM JBoss Red Hat
El constructor de pneles es la interfaz de usuario basada en red de la suite BPM JBoss Red Hat
para monitoreo de actividades empresariales. Para acceder el constructor de pneles desde la
central empresarial vaya a D ash b o ard s Pro cess & T ask D ash b o ard s.
El pnel que se presenta proporciona estadsticas sobre los datos en tiempo de ejecucin
seleccionados a su izquierda. Puede crear su propio pnel en el constructor de pneles que se
presenta al hacer clic en D ash b o ard s B u sin ess D ash b o ard s.
Reportar un error
8.2. Monit oriz acin de inst ancias

El constructor de pneles proporciona un pnel especial que le permite monitorear el estado de los
datos en tiempo de ejecucin (instancias de procesos y tareas) en su mquina de ejecucin.
Para ver estos datos vaya a D ash b o ard s Pro cess & T ask D ash b o ard .
Fig u ra 8.1. Pn el d e t areas y p ro ceso s
En el panel de la izquierda puede seleccionar una entidad para la cual presentar estadsticas. Las
tablas y los datos a la derecha se actualizan de acuerdo con esto.
Reportar un error
39
Captulo 9. Estudio del desarrollador JBoss de Red Hat

Red Hat JBoss D eveloper Studio es el entorno de desarrollo integrado de JBoss (ID E del ingls
integrated development environment) basado en Eclipse y disponible en el portal de soporte del
cliente de Red Hat en https://access.redhat.com. Red Hat JBoss D eveloper Studio proporciona plug-
ins con herramientas e interfaces para Red Hat JBoss BRMS y Red Hat JBoss BPM Suite. Estos
plugins se basan en la versin de la comunidad de estos productos. As que el plugin BRMS se
llama el plugin D rools y el plugin de la suite BPM se llama plugin jBPM.
Consulte la documentacin de Red Hat JBoss Developer Studio para ver las instrucciones de
instalacin y configuracin.
Reportar un error
9.1. Cent ral de JBoss

Cuando se inicia por primera vez JBoss D eveloper Studio 7.0, se presenta la central de JBoss en la
ventana principal del banco de trabajo. D esde la central de JBoss es posible crear nuevos
proyectos seleccionando las opciones del men bajo Start fro m scratch. Los proyectos de
ejemplo se pueden iniciar seleccionando los enlaces bajo Start fro m a sampl e.
Fig u ra 9 .1. C en t ral d e JB o ss
40
Capt ulo 9 . Est udio del desarrollador JBoss de Red Hat
Reportar un error
9.2. Inst alacin de los plugins del est udio del desarrollador JBoss
Los plugins D rools y jBPM para el estudio desarrollador JBoss estn disponibles a travs del sitio
de actualizacin.
Pro ced imien t o 9 .1. In st alaci n d el p lu g in d el est u d io d esarro llad o r JB o ss D ro o ls y

jB PM
1. Inicie el estudio desarrollador JBoss.
2. Seleccione H elp In st all N ew So f t ware.
3. Haga clic en Ad d para ingresar el men Ad d R epo si to ry.
4. D ele un nombre al sitio software junto al campo Name y agregue la siguiente url en el campo
Lo cati o n:https://devstudio.jboss.com/updates/7.0/integration-stack/
5. Haga clic en O K
6. Seleccione la funcionalidad JBo ss Busi ness P ro cess and R ul e D evel o pment de

las opciones disponibles y haga clic en Next y luego Next de nuevo.
7. Lea la licencia y acptela seleccionando el botn apropiado y haga clic en Fi ni sh.
8. D espus de que la instalacin de los plug-ins se haya completado, reinicie el estudio

desarrollador JBoss.
Reportar un error
9.3. Configuracin del t iempo de ejecucin Drools

Con el fin de utilizar el plugin BRMS JBoss con Red Hat JBoss D eveloper Studio es necesario
establecer el tiempo de ejecucin.
Un tiempo de ejecucin es una coleccin de archivos jar que representan un lanzamiento especfico
del software y proporciona las bibliotecas que se necesitan para la compilacin y ejecucin de sus
activos empresariales.
Extraiga los archivos jar de tiempo de ejecucin que se encuentran en el archivador jboss-brms-
engine.zip del archivador zip implementable genrico JBoss BRMS (no el archivador zip
implementable EAP6) (disponible en el portal del cliente de Red Hat).
Pro ced imien t o 9 .2. C o n f ig u raci n d el t iemp o d e ejecu ci n B R MS
1. D el men JBoss D eveloper Studiot seleccione Wi nd o w y haga clic en P references.
2. Seleccione D ro o ls In st alled D ro o ls R u n t imes.
3. Haga clic en Ad d . . . ; proporcione un nombre para el nuevo tiempo de ejecucin y haga

clic en Bro wse para navegar al directorio en donde se encuentra el tiempo de ejecucin.
Haga clic en OK para registrar el tiempo de ejecucin seleccionado en JBD S.
4. Marca el tiempo de ejecucin que usted ha creado como el tiempo de ejecucin D rools
predeterminado haciendo clic en la casilla al lado de este.
41
5. Haga clic en O K. Si tiene proyectos existentes, una ventana de dilogo indicar que tiene
que reiniciar JBoss D eveloper Studio para actualizar el tiempo de ejecucin.
Reportar un error
9.4 . Configuracin del t iempo de ejecucin jBPM

Con el fin de utilizar el plugin jBPM con Red Hat JBoss D eveloper Studio es necesario establecer el
tiempo de ejecucin.
Un tiempo de ejecucin es una coleccin de archivos jar que representan un lanzamiento especfico
del software.
Si descarg previamente el archivador zip implementable genrico de la suite BPM JBoss del portal
del cliente de Red Hat, los archivos jars que componen el tiempo de ejecucin se encuentran en el
archivador jbo ss-bpms-eng i ne. zi p.
Pro ced imien t o 9 .3. C o n f ig u raci n d el t iemp o d e ejecu ci n jB PM
1. D el men JBoss D eveloper Studiot seleccione Wi nd o w y haga clic en P references.
2. Seleccione jB PM In st alled jB PM R u n t imes.
3. Haga clic en Ad d . . . ; proporcione un nombre para el nuevo tiempo de ejecucin y haga

clic en Bro wse para navegar al directorio en donde se encuentra el tiempo de ejecucin.
4. Haga clic en O K, seleccione el nuevo tiempo de ejecucin y haga clic en O K de nuevo . Si

tiene proyectos existentes, una ventana de dilogo indicar que tiene que reiniciar
JBoss D eveloper Studio para actualizar el tiempo de ejecucin.
Reportar un error
9.5. Configuracin del servidor de la suit e BPM JBoss
El estudio desarrollador JBoss se puede configurar para ejecutar el servidor de la suite BPM JBoss
de Red Hat.
Pro ced imien t o 9 .4 . C o n f ig u raci n d el servid o r
1. Abra la vista jBPM seleccionando Win d o w O p en Persp ect ive O t h er y seleccione

D ro o l s y haga clic en O K.
2. Agregue la vista del servidor seleccionando Win d o w Sh o w View O t h er... y

seleccione Server Servers.
3. Abra el men del servidor haciendo clic con el botn derecho del ratn en el panel del
servidor y seleccione N ew Server.
4. D efina el servidor seleccionando JB o ss En t erp rise Mid d leware JB o ss En t erp rise

Ap p licat io n Plat f o rm 6 .1+ y haciendo clic en Next.
5. Establezca el directorio de inicio haciendo clic en el enlace en el botn Bro wse. Navegue
hasta el directorio de instalacin y seleccinelo para JBoss EAP 6.1.1, el cual tiene la suite
BPM JBoss instalada.
6. Proporcione un nombre para el servidor en el campo Name, asegrese de que el archivo de

configuracin se establece como y haga clic en Fi ni sh.
42
Reportar un error
9.6. Import acin de proyect os desde un reposit orio Git a JBoss

Developer St udio
El estudio desarrollador JBoss se puede configurar para conectarse a un repositorio de activos Git
central. En el repositorio se almacenan las versiones de las reglas, modelos, funciones y procesos.
Este repositorio Git ya debe estar definido por el banco de trabajo KIE.
Los usuarios pueden importar un repositorio local Git o pueden clonar un repositorio remoto Git.
Pro ced imien t o 9 .5. Imp o rt aci n d e u n rep o sit o rio lo cal G it
1. Inicie la suite BPM JBoss de Red Hat (si todava no est ejecutando) seleccionando el
servidor de la pestaa de servidores y haga clic en el cono de inicio.
2. Seleccione File Imp o rt ... y navegue a la carpeta Git. Abra la carpeta Git para seleccionar
Pro ject s f ro m G it y haga clic en siguiente.
3. Seleccione la fuente del repositorio Exist in g lo cal rep o sit o ry y haga clic en siguiente.
Fig u ra 9 .2. D et alles d el rep o sit o rio G it
4. Seleccione el repositorio que se va a configurar de la lista de repositorios disponibles.
5. Importe el proyecto como un proyecto general en la siguiente ventana y haga clic en

siguiente. D le nombre a este proyecto y haga clic en terminar.
Pro ced imien t o 9 .6 . C lo n aci n d e u n rep o sit o rio remo t o G it
43
1. Inicie la suite BPM JBoss de Red Hat (si todava no est ejecutando) seleccionando el
servidor de la pestaa de servidores y haga clic en el cono de inicio.
2. Al mismo tiempo inicie el servidor de la shell segura, si todava no est ejecutando, usando
el siguiente comando. Este comando es especfico para Linux y Mac slamente. En estas
plataformas, si sshd ya se inici entonces este comando fallar y puede ignorar de manera
segura este paso.
/sbin/service sshd start
3. Seleccione File Imp o rt ... y navegue a la carpeta Git. Abra la carpeta Git para seleccionar
Pro ject s f ro m G it y haga clic en siguiente.
4. Seleccione la fuente del repositorio C lo n e U R I y haga clic en siguiente.
5. Ingrese los detalles del repositorio Git en la siguiente ventana y haga clic en siguiente.
44
Fig u ra 9 .3. D et alles d el rep o sit o rio G it
6. Seleccione la rama que quiere importar en la siguiente ventana y haga clic en siguiente.
7. Se le presentar la opcin de definir el almacenamiento local para este proyecto. Ingrese (o

seleccione) un directorio que no est vaco, haga los cambios en la configuracin y haga
clic en siguiente.
8. Importe el proyecto como un proyecto general en la siguiente ventana y haga clic en

siguiente. D le nombre a este proyecto y haga clic en terminar.
Reportar un error
9.7. Creacin de un proyect o Drools
Pro ced imien t o 9 .7. C reaci n d e u n n u evo p ro yect o R ed H at JB o ss D evelo p er St u d io
1. D el men principal seleccione File N ew Pro ject .
Seleccione D ro o ls D ro o ls Pro ject y haga clic en Next.
2. Ingrese un nombre para el proyecto en la casilla P ro ject name: y haga clic en Next.
NOT A
JBoss D eveloper Studio proporciona la opcin para agregar un archivo de reglas

HelloWorld de ejemplo al proyecto. Acepte esta opcin predeterminada haciendo clic
en Next para probar el proyecto de ejemplo en los siguientes pasos.
3. Seleccione el tiempo de ejecucin D rools (o use el predeterminado).
4. Seleccione el cdigo compatible con D ro o l s 6 . 0 . x. Ingrese un G ro upID , un

Arti factID y la Versi o n y haga clic en Fi ni sh.
5. Para probar el proyecto, haga clic con el botn derecho del ratn en el archivo Java que
contiene el mtodo principal y seleccione R u n ru n as Java Ap p licat io n .
La salida se presentar en la pestaa de la consola.
Reportar un error
9.8. Creacin de un proyect o jBPM
Pro ced imien t o 9 .8. C reaci n d e u n n u evo p ro yect o R ed H at JB o ss D evelo p er St u d io
1. D el men principal seleccione File N ew Pro ject .
Seleccione jB PM jB PM Pro ject y haga clic en Next.
2. Ingrese un nombre para el proyecto en la casilla P ro ject name: y haga clic en Next.
45
Archivo de reglas HelloWorld de ejemplo
JBoss D eveloper Studio proporciona la opcin para agregar un archivo de reglas

HelloWorld de ejemplo al proyecto. Acepte esta opcin predeterminada haciendo clic
en Next para probar el proyecto de ejemplo en los siguientes pasos.
3. Seleccione el tiempo de ejecucin jBPM (o use el predeterminado).
4. Seleccione generar cdigo compatible con jBP M 6 o po steri o res y haga clic en
Fi ni sh.
5. Para probar el proyecto, haga clic con el botn derecho del ratn en el archivo Java que
contiene el mtodo principal y seleccione R u n ru n as Java Ap p licat io n .
La salida se presentar en la pestaa de la consola.
Reportar un error
46
Capt ulo 1 0 . Planificador de recursos empresariales
Captulo 10. Planificador de recursos empresariales

El p lan if icad o r d e recu rso s emp resariales est disponible como un avance tcnico con la suite
BPM JBoss de Red Hat. El planeador de recursos empresariales es una mquina ligera incluble de
planeacin que optimiza los problemas de planeacin. Ayuda a los programadores TM Java
normales a resolver problemas de planeacin de manera eficiente y combina heurstica de
optimizacin y metaheurstica con clculos muy eficientes.
El planificador ayuda a solucionar varios casos como los siguientes:
Emp lead o s/list a d e p acien t es. En planificador ayuda a crear horarios para las enfermeras y
mantiene registros de la administracin de las camas de los pacientes.
H o rario s ed u cacio n ales. El planificador ayuda a programar clases, cursos, exmenes y

presentaciones de conferencias.
H o rario s d el t aller: El planificador mantiene registros de las cadenas de fabricacin,

planeacin de colas de mquinas y planeacin de tareas del personal.
R eco rt e d e recu rso s: El planificador minimiza los desperdicios reduciendo el consumo de

recursos tal como papel y acero.
Reportar un error
10.1. Inst alacin del planificador de recursos empresariales

1. Navegue al portal del cliente de Red Hat e inicie sesin con sus credenciales de usuario.
3. D el men desplegable P ro d ucts seleccione BP M Sui te.
4. D el men desplegable Versi o n seleccione la versin del producto 6 . 0 . 2.
5. Seleccione R ed Hat JBo ss BP M Sui te 6 . 0 . 2 Busi ness R eso urce P l anner y

haga clic en D o wnl o ad .
Reportar un error
10.2. Ejecucin de los ejemplos del planificador de recursos

empresariales
1. En la lnea de comandos vaya hasta el directorio exampl es/.
2. En un entorno Unix ejecute el siguiente comando:
./runExam ples.sh
En un entorno Windows ejecute el siguiente comando:
./runExam ples.bat
3. Escoja un ejemplo de la aplicacin GUI de ejemplos que se abre y ejectelo en su ID E

favorito.
47
Reportar un error
48
Hist orial de revisiones
Historial de revisiones
R evisi n 1.0.0- 1 Wed Au g 06 2014 C S B u ild er R o b o t
Built from Content Specification: 22690, Revision: 684299
49

Red Hat JBoss BPM Suite-6.0

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Red Hat JBoss BPM Suite-6.0

Transféré par

Droits d'auteur :

Formats disponibles

Suite BPM JBoss de Red Hat 6.

La gua de inicio para BPMS JBoss Red Hat

Kanchan Desai Doug Hoffman Eva Kopalova

La gua de inicio para BPMS JBoss Red Hat

Red Hat Co ntent Services

Java is a registered trademark o f Oracle and/o r its affiliates.

No de.js is an o fficial trademark o f Jo yent. Red Hat So ftware Co llectio ns is no t fo rmally

The OpenStack Wo rd Mark and OpenStack Lo go are either registered trademarks/service

8 .1. Ac c es o al c o ns truc to r d e p neles d e la s uite BPM JBo s s Red Hat 39

1. Convenciones del Document o

1.1. Convenciones t ipogrficas

Para ver el contenido del archivo my_next_bestsel l i ng _no vel en su directorio

Pulse Enter para ejecutar el comando.

Pulse C trl +Al t+F2 para pasar a una terminal virtual.

Las clases de archivo relacionadas incluyen fi l ename para sistema de archivos,

Para insertar un carcter especial en un archivo g ed it , seleccione Ap licacio n es

Itlicas-negrita monoespaciado o Itlicas-negrita proporcional

Ya sea negrita monoespaciado o negrita proporcional, la adicin de itlicas indica texto

El comando mo unt -o remo unt file-system remonta el sistema de archivo

Para ver la versin de un paquete actualmente instalado, utilice el comando rpm -q

Publican es un sistema de publicacin de DocBook.

1.2. Convenciones del document o

Los mensajes de salida enviados a una terminal se muestran en ro mano mo no espaci ad o y se

bo o ks D eskto p do cum entatio n drafts m ss pho to s stuff svn

Los listados de cdigo fuente tambin se muestran en ro mano mo no espaci ad o , pero se

static int kvm _vm _io ctl_deassign_device(struct kvm * kvm ,

m utex_lo ck(& kvm -> lo ck);

m atch = kvm _find_assigned_dev(& kvm -> arch.assigned_dev_head,

kvm _deassign_device(kvm , m atch);

kvm _free_assigned_device(kvm , m atch);

1.3. Not as y Advert encias

Las advertencias no deben ignorarse. Ignorarlas muy probablemente ocasionar prdida de

2. Cmo obt ener ayuda y hacer sus coment arios

2.1. Necesit a ayuda?

enviar un caso de soporte a Servicios de Soporte Global de Red Hat (GSS)

acceder a otra documentacin del producto.

2.2. Necesit amos sus coment arios!

Cuando enve un reporte de error no olvide mencionar el identificador' del manual:

1.1. Sobre la Suit e BPM JBoss de Red Hat

El planificador de recursos empresariales se incluye como un avance de tecnologa con este

1.2. Component es de la suit e BPM JBoss de Red Hat

La suite BPM JBoss de Red Hat contiene los siguientes componentes:

R ep o sit o rio d e art ef act o s ( almacn d e co n o cimien t o )

Un almacenamiento para activos empresariales que proporcionan funcionalidades de

C en t ral emp resarial

Una aplicacin basada en red para la creacin, administracin y monitoreamiento de

1.3. Ejemplo de uso: soluciones basadas en procesos en la indust ria de

Fig u ra 1.2. Au t o mat iz aci n d el p ro ceso d e ap licaci n p ara p rst amo s

Captulo 2. Inicio rpido con Red Hat JBoss BPM Suite

Pro ced imien t o 2.1. G u a d e in icio rp id o B PM Su it e

1. D escargue el instalador BPM Suite de access.redhat.com.

2. Ejecute el instalador con el siguiente comando:

4. D espus de una instalacin exitosa, en una ventana de comandos navegue hasta la

5. Inicie el servidor BPM Suite emitiendo el siguiente comando.

6. Abra un navegador de red e inicie sesin en la central empresarial navegando hasta

Ha instalado y ejecutado exitsamente BPM Suite. Ahora puede hacer lo siguiente:

Aprender ms sobre los roles: Seccin 3.1.3, D efinicin de roles

Captulo 3. Opciones de instalacin

Archivo comprimido de instalacin, el cual viene en dos versiones:

jbo ss-bpms-6 . MINOR_VERSION-red hat-x-d epl o yabl e-eap6 . x. zi p: versin

jbo ss-bpms-6 . MINOR_VERSION-red hat-x-d epl o yabl e-g eneri c. zi p: la versin

3.1. La inst alacin agrupada EAP6

3.1.1. Descarga del paquet e EAP6

1. Vaya al portal del cliente de Red Hat e inicie sesin.