BRMS JBoss de Red Hat 6 Guía de inicio

BRMS JBoss de Red Hat 6 Guía de inicio La guía de inicio para BRMS JBoss Red Hat Edición 1 Kanchan Desai Eva Kopalova Red Hat Content Services

BRMS JBoss de Red Hat 6 Guía de inicio La guía de inicio para BRMS JBoss Red Hat Edición 1 Kanchan Desai kadesai@redhat.co m Eva Kopalova Red Hat Co ntent Services

Legal Notice Copyright 2014 Red Hat, Inc. T his document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux is the registered trademark of Linus Torvalds in the United States and other countries. Java is a registered trademark of Oracle and/or its affiliates. XFS is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL is a registered trademark of MySQL AB in the United States, the European Union and other countries. Node.js is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project. T he OpenStack Word Mark and OpenStack Logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community. All other trademarks are the property of their respective owners. Abstract Esta guía le ayuda a los usuarios a instalar y configurar BRMS JBoss de Red Hat por primera vez.

Table of Contents Table of Contents. Prefacio........................................................................................... 3.......... 1. Convenciones del Documento 3 1.1. Convenciones tipográficas 3 1.2. Convenciones del documento 4 1.3. Notas y Advertencias 5 2. Cómo obtener ayuda y hacer sus comentarios 5 2.1. Necesita ayuda? 5 2.2. Necesitamos sus comentarios! 6. Capítulo......... 1... Introducción................................................................................ 7.......... 1.1. Sobre JBoss BRMS de Red Hat 7 1.2. Ejemplo: administración de decisiones empresariales en la industria aseguradora con JBoss BRMS 7. Capítulo......... 2... Instalación................................................................................ 9.......... 2.1. Descarga de JBoss BRMS de Red Hat para la plataforma de aplicaciones empresariales JBoss 2.2. Instalación de JBoss BRMS de Red Hat para la plataforma de aplicaciones empresariales 9 JBoss de Red Hat 9 2.3. Definición de roles 10 2.4. Creación de usuarios 10 2.5. Instalación de Red Hat JBoss BRMS en el servidor de red JBoss de Red Hat 10 2.6. Iniciación del servidor 11. Capítulo......... 3... Inicio...... de... sesión........ en... la.. central........ empresarial................................................. 13............ Capítulo......... 4.. Ejemplo......... de... reglas....... Hello...... World..................................................... 14............ 4.1. Creación de la estructura del repositorio 14 4.2. Creación de la regla empresarial 15 4.3. Construcción e implementación 16. Capítulo......... 5... Estudio......... del... desarrollador............... JBoss....... de... Red.... Hat...................................... 18........... 5.1. Instalación de los plugins del estudio del desarrollador JBoss 18 5.2. Configuración del tiempo de ejecución Drools 18 5.3. Configuración del servidor BRMS JBoss 19 5.4. Importación de proyectos desde un repositorio Git en el estudio del desarrollador JBoss 19 5.5. Creación de un proyecto Drools 21. Capítulo......... 6... Planificador............. de... recursos.......... empresariales..................................................... 23........... 6.1. Instalación del planificador de recursos empresariales 23 6.2. Ejecución de los ejemplos del planificador de recursos empresariales 23. Historial......... de... revisiones............................................................................. 24............ 1

2 BRMS JBoss de Red Hat 6 Guía de inicio

Prefacio Prefacio 1. Convenciones del Documento Este manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atención sobre ciertas partes específicas de información. En ediciones PDF y de papel, este manual utiliza tipos de letra procedentes de Liberation Fonts. Liberation Fonts también se utilizan en ediciones de HTML si están instalados en su sistema. Si no, se muestran tipografías alternativas pero equivalentes. Nota: Red Hat Enterprise Linux 5 y siguientes incluyen Liberation Fonts predeterminadas. 1.1. Convenciones tipográficas Se utilizan cuatro convenciones tipográficas para llamar la atención sobre palabras o frases específicas. Dichas convenciones y las circunstancias en que se aplican son las siguientes: Negrita m onoespaciado Utilizado para resaltar la entrada del sistema, incluyendo los comandos de shell, nombres de archivos y rutas. T ambién sirve para resaltar teclas y combinaciones de teclas. Por ejemplo: Para ver el contenido del archivo m y_next_bestselling_novel en su directorio actual de trabajo, escriba el comando cat m y_next_bestselling_novel en el intérprete 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 más que conecta cada partee de la combinación de tecla. Por ejemplo: Pulse Enter para ejecutar el comando. Pulse Ctrl+Alt+F2 para pasar a una terminal virtual. El primer ejemplo resalta una tecla particular a pulsar. El segundo ejemplo, resalta una combinación de teclas: un set de tres teclas pulsadas simultáneamente. Si se discute el código fuente, los nombres de las clase, los métodos, las funciones, los nombres de variables y valores de retorno mencionados dentro de un párrafo serán presentados en Negritam onoespaciado. Por ejemplo: Las clases de archivo relacionadas incluyen filenam e para sistema de archivos, file para archivos y dir para directorios. Cada clase tiene su propio conjunto asociado de permisos. Negrita proporcional Esta denota palabras o frases encontradas en un sistema, incluyendo nombres de aplicación, texto de cuadro de diálogo, botones etiquetados, etiquetas de cajilla de verificación y botón de radio; títulos de menú y títulos del submenú. Por ejemplo: Seleccione Sistema Preferencias Ratón desde la barra del menú principal para lanzar Preferencias de ratón. En la pestaña de Botones, seleccione la cajilla de ratón 3

BRMS JBoss de Red Hat 6 Guía de inicio de m ano izquierda y luego haga clic en Cerrar para cambiar el botón principal del ratón de la izquierda a la derecha (adecuando el ratón para la mano izquierda). Para insertar un carácter especial en un archivo gedit, seleccione Aplicaciones Accesorios Mapa de caracteres de la barra del menú. Luego, seleccione Búsqueda Buscar de la barra del menú de Mapa de caracteres, escriba el nombre del carácter en el campo de Búsqueda y haga clic en Siguiente. El carácter que buscó será resaltado en la T abla de caracteres. Haga doble clic en ese carácter resaltado para colocarlo en el campo de Texto a copiar y luego haga clic en el botón Copiar. Ahora regrese al documento y elija Modificar Pegar de la barra de menú de gedit. El texto anterior incluye nombres de aplicación; nombres y elementos del menú de todo el sistema; nombres de menú de aplicaciones específicas y botones y texto hallados dentro de una interfaz gráfica de usuario, todos presentados en negrita proporcional y distinguibles por contexto. Itálicas-negrita monoespaciado o Itálicas-negrita proporcional Ya sea negrita monoespaciado o negrita proporcional, la adición de itálicas indica texto reemplazable o variable. Las itálicas denotan texto que usted no escribe literalmente o texto mostrado que cambia dependiendo de la circunstancia. Por ejemplo: Para conectar a una máquina remota utilizando ssh, teclee ssh nombre de usuario@ dominio.nombre en un intérprete de comandos de shell. Si la máquina remota es example.com y su nombre de usuario en esa máquina es john, teclee ssh john@ exam ple.com. El comando m ount -o rem ount file-system remonta el sistema de archivo llamado. Por ejemplo, para volver a montar el sistema de archivo /home, el comando es mount -o rem ount /hom e. Para ver la versión de un paquete actualmente instalado, utilice el comando rpm -q paquete. Éste entregará el resultado siguiente: paquete-versión-lanzamiento. Observe que las palabras resaltadas en itálicas nombre de usuario, dominio.nombre, sistema de archivo, paquete, versión y lanzamiento. Cada palabra es un marcador de posición, ya sea de texto a ingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema. Aparte del uso estándar para presentar el título de un trabajo, las itálicas denotan el primer uso de un término nuevo e importante. Por ejemplo: Publican es un sistema de publicación de DocBook. 1.2. Convenciones del documento Los mensajes de salida de la terminal o fragmentos de código fuente se distinguen visualmente del texto circundante. Los mensajes de salida enviados a una terminal se muestran en romano monoespaciado y se presentan así: books Desktop documentation drafts mss photos stuff svn books_tests Desktop1 downloads images notes scripts svgs Los listados de código fuente también se muestran en rom ano m onoespaciado, pero se presentan y resaltan de la siguiente manera: 4

Prefacio package org.jboss.book.jca.ex1; import javax.naming.initialcontext; public class ExClient { public static void main(string args[]) throws Exception { InitialContext inictx = new InitialContext(); Object ref = inictx.lookup("echobean"); EchoHome home = (EchoHome) ref; Echo echo = home.create(); System.out.println("Created Echo"); } } System.out.println("Echo.echo('Hello') = " + echo.echo("hello")); 1.3. Notas y Advertencias Finalmente, utilizamos tres estilos visuales para llamar la atención sobre la información que de otro modo se podría pasar por alto. Nota Una nota es una sugerencia, atajo o enfoque alternativo para una tarea determinada. Ignorar una nota no debería tener consecuencias negativas, pero podría perderse de algunos trucos que pueden facilitarle las cosas. Importante Los cuadros con el título de importante dan detalles de cosas que se pueden pasar por alto fácilmente: cambios de configuración únicamente aplicables a la sesión actual, o servicios que necesitan reiniciarse antes de que se aplique una actualización. Ignorar estos cuadros no ocasionará pérdida de datos, pero puede causar enfado y frustración. Aviso Las advertencias no deben ignorarse. Ignorarlas muy probablemente ocasionará pérdida de datos. 2. Cómo obtener ayuda y hacer sus comentarios 2.1. Necesita ayuda? 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 través del portal del cliente, usted podrá: 5

BRMS JBoss de Red Hat 6 Guía de inicio buscar o navegar a través de la base de artículos de soporte técnico sobre productos de Red Hat. enviar un caso de soporte a Servicios de Soporte Global de Red Hat (GSS) acceder a otra documentación del producto. Red Hat alberga una lista grande de correos electrónicos para discutir sobre software de Red Hat y tecnología. Encontrará un listado de las listas de correo disponibles al público 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. Necesitamos sus comentarios! Si encuentra algun error o si se le ocurre una manera de mejorar este manual, nos encantaría escuchar sus sugerencias. Complete un reporte en Bugzilla frente al producto JBoss BRMS Platform 6 y el componente Docum entation. El siguiente enlace le llevará a un reporte de error ya completado para este producto: https://bugzilla.redhat.com/. Llene la siguiente plantilla en el campo de Description de Bugzilla. Sea tan especifico como le sea posible al describir el problema, esto ayudará a asegurarnos de que lo podemos solucionar rápidamente. URL del documento: Número de la sección y nombre: Describa el problema: Sugerencias para mejorar: Información adicional: Asegúrese de darnos su nombre para poder darle todo el crédito por reportar el problema. 6

Capítulo 1. Introducción Capítulo 1. Introducción 1.1. Sobre JBoss BRMS de Red Hat JBoss BRMS de Red Hat es una plataforma de gestión de decisiones de código abierto que combina la administración de reglas empresariales y el procesamiento de eventos complejos. Automatiza decisiones empresariales y hace disponible la lógica empresarial para toda la compañía. JBoss BRMS de Red Hat usa un repositorio centralizado en donde todos los recursos se almacenan. Esto asegura consistencia, transparencia y la habilidad para realizar auditorías a través de la empresa. Los usuarios empresariales pueden modificar la lógica empresarial sin requerir ayuda del personal de sistemas. El planificador de recursos empresariales se incluye como un avance de tecnología con este lanzamiento. 1.2. Ejemplo: administración de decisiones empresariales en la industria aseguradora con JBoss BRMS BRMS comprende una máquina de reglas de alto rendimiento del proyecto Drools, un repositorio de reglas y herramientas de autoría de reglas de fácil uso del proyecto Drools Guvnor y extensiones de máquinas de reglas del procesamiento de eventos complejos del proyecto Drools Fusion. T ambién incluye OptaPlanner, un solucionador para problemas complejos de planeamiento como un avance de tecnología. El mercado de aseguradoras del consumidor es extremadamente competitivo y es imperativo que los clientes reciban servicios eficientes, competitivos y completos al acceder a las cotizaciones en línea para seguros. Un proveedor de seguros incrementó sus ingresos al proporcionar cotizaciones en línea impulsando a los visitantes de la página a comprar productos adicionales durante el proceso de cotización. JBoss BRMS se integró con la infraestructura del proveedor de seguros de manera que cuando se procesaba una petición de aseguramiento, se le consultaba a BRMS para presentar productos adicionales apropiados junto con la cotización de seguro: 7

BRMS JBoss de Red Hat 6 Guía de inicio Figura 1.1. Ejemplo de uso de BRMS: toma de decisiones en la industria aseguradora BRMS proporcionó la funcionalidad de gestión de decisiones, es decir, la determinación automática de los productos a presentar al solicitante con base en las reglas definidas por los analistas empresariales. Las reglas se implementaron como tablas de decisiones de manera que se pudieran entender fácilmente y que se pudieran modificar sin requerir soporte adicional de los ingenieros de sistemas. 8

Capítulo 2. Instalación Capítulo 2. Instalación 2.1. Descarga de JBoss BRMS de Red Hat para la plataforma de aplicaciones empresariales JBoss 1. Vaya al portal del cliente de Red Hat e inicie sesión. 2. Seleccione Downloads Red Hat JBoss Middleware Descargar Software. 3. Del menú desplegable Product seleccione Plataform a BRMS. 4. Del menú desplegable Version selecione la versión 6.0.0. 5. Seleccione Red Hat JBoss BRMS 6.0.0 im plem entable para EAP 6.1.1 y haga clic en Descargar. 2.2. Instalación de JBoss BRMS de Red Hat para la plataforma de aplicaciones empresariales JBoss de Red Hat JBoss BRMS de Red Hat se puede instalar en la plataforma de aplicaciones empresariales de JBoss 6.1.1. Para instalar el paquete implementable para la plataforma de aplicaciones empresariales JBoss de Red Hat, haga lo siguiente: 1. Mueva el archivador zip descargado al directorio de inicio de la plataforma de aplicaciones empresariales JBoss de Red Hat (EAP_HOME; el directorio jboss-eap-6.1). 2. Descomprima el archivador zip descargado: asegúrese de que se ha unido en el directorio EAP_HOME (jboss-eap-6.1). 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. Es necesario sobreescribir los archivos que ya existen en el directorio EAP_HOME con sus versiones del archivador zip descargado. Cuando se le pida, acepte la sobreescritura de los archivos originales. En Red Hat Enterprise Linux puede utilizar el siguiente comando para extraer el archivo zip BRMS y unirlo con su directorio EAP correctamente en un paso: unzip -u jboss-brms-version-redhat-version-deloyable-eap6.x.zip -d EAP_HOME_PARENT_DIR Ejemplo 2.1. El comando para descomprimir unzip -u jboss-brms-6.0.0-redhat-7-deployable-eap6.x.zip -d /home/john/myeap/ 9

BRMS JBoss de Red Hat 6 Guía de inicio 2.3. Definición de roles Antes de iniciar el servidor e iniciar sesión en la central empresarial necesitará crear algunas cuentas de usuarios. Esta sección describe los diferentes roles de usuario que se pueden crear en BRMS JBoss de Red Hat: admin: los usuarios con el rol admin son los administradores de la aplicación. Los administradores pueden administrar los usuarios, administrar los repositorios (crear y clonar) y tienen acceso completo para realizar los cambios requeridos en la aplicación. Admins tienen acceso a todas las áreas dentro del sistema. analyst: Un rol de analista tiene acceso a todas las funcionalidades de alto nivel para modelar proyectos. Ciertas funcionalidades de bajo vivel diseñadas para los desarrolladores, tal como la vista del repositorio de activos, están escondidas para este rol. Un usuario con este rol no puede acceder el repositorio de activos. 2.4. Creación 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. 2. Ingrese b para seleccionar un usuario de la aplicación 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: helloworlduser. 5. Cree la contraseña del usuario en el campo de la contraseña y reingrese la contraseña. Por ejemplo: Helloworld@ 123. Nota La contraseña debe tener por lo menos 8 caracteres de largo y debe tener caracteres en mayúsculas y minúsculas (por ejemplo, A-Z, a-z) por lo menos un caracter numérico (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 Sección 2.3, Definición de roles ). Los usuarios de la central empresarial necesitan tener el rol analyst o adm in. 7. Confirme que quiere agregar el usuario. 8. Ingrese si en el siguiente campo (esto es para habilitar el uso de clústers en el futuro si se requiere). 2.5. Instalación de Red Hat JBoss BRMS en el servidor de red JBoss de Red Hat El paquete implementable genérico se proporciona para que los clientes instalen Red Hat JBoss BRMS 10

Capítulo 2. Instalación 6 en un servidor de aplicaciones existente. El siguiente procedimiento proporciona instrucciones para instalar en una instancia ya existente del servidor de red JBoss de Red Hat 2.0.1. Procedimiento 2.1. Instalación del paquete implementable genérico 1. Para descargar el archivo zip del paquete implementable genérico del portal de soporte al cliente de Red Hat, vaya a https://access.redhat.com e inicie sesión. 2. Seleccione Downloads Red Hat JBoss Middleware Descargar Software. 3. Del menú desplegable Producto, seleccione Plataform a BRMS. 4. Del menú desplegable Version selecione la versión del producto. 5. Seleccione el paquete Red Hat JBoss BRMS 6.0.0 im plem entable para todos los contenedores soportados y luego haga clic en Descargar. 6. El extraer el archivador descargado crea los siguientes archivadores zip: jboss-brm s-engine.zip jboss-brm s-m anager.zip 7. Extraiga business-central.war del archivador jboss-brms-manager.zip y cópielo en tom cat7/webapps/. 8. Borre la extensión.war del business-central.war de manera que el directorio ahora se llame business-central. 9. Extraiga el jboss-brms-engine del archivador jboss-brms-engine.zip y cópielo en tom cat7/webapps/. 10. Defina los usuarios y roles en tomcat7/conf/tomcat-users.xml tal como se puede ver a continuación: <role rolename="tomcat"/><role rolename="analyst"/><user username="tomcat" password="tomcat" roles="tomcat,analyst"/> 11. Copie el archivo jar kie-tom cat-integration en tom cat7/lib. 12. Copie el archivo jar jacc lib en tom cat7/lib (javax.security.jacc-api en el repositorio maven jboss). 13. Agregue la siguiente declaración de válvula T omcat en tom cat7/conf/server.xm l (dentro del elemento <host> relevante): <Valve classname="org.kie.integration.tomcat.jaccvalve"/< 14. Renombre org.uberfire.security.auth.authenticationsource como org.uberfire.security.auth.authenticationsource-origin y org.uberfire.security.auth.authenticationsource-tomcat-jee-security como org.uberfire.security.auth.authenticationsource dentro del businesscentral.war/web-inf/classes/met A-INF/services 2.6. Iniciación del servidor Ahora puede iniciar su servidor en uno de los dos modos. El script de arranque predeterminado, standalone.sh con el que se envía BRMS JBoss de Red Hat está optimizado para rendimiento. Para ejecutar su servidor en modo de rendimiento, haga lo siguiente: 11

BRMS JBoss de Red Hat 6 Guía de inicio 1. En la línea de comandos vaya al directorio $SERVER_HOME/bin/. 2. En un entorno Unix ejecute:./standalone.sh En un entorno Windows ejecute:./standalone.bat Red Hat JBoss BRMS también se envía con un script separado, standalone-secure.sh que está optimizado para la seguridad. Este script aplica una política de seguridad por defecto que protege en contra de alguna vulnerabilidad de seguridad conocida. Nota Se recomienda que los entornos de producción utilicen el script standalone-secure.sh. Aviso El uso de un administrador de seguridad impone una sanción importante en el rendimiento que debe tener en mente. El intercambio entre la seguridad y el rendimiento se debe realizar teniendo en consideración las circunstancias individuales. Para ejecutar su servidor en el modo seguro con este script, haga lo siguiente: 1. En la línea de comandos vaya al directorio $SERVER_HOME/bin/. 2. En un entorno Unix ejecute:./standalone-secure.sh En un entorno Windows ejecute:./standalone-secure.bat 12

Capítulo 3. Inicio de sesión en la central empresarial Capítulo 3. Inicio de sesión en la central empresarial Inicio de sesión en la central empresarial después de que el servidor ha iniciado exitósamente. 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 localhost para el nombre del dominio. Por ejemplo http://www.example.com:8080/business-central. 2. Inicie sesión con las credenciales de usuario que se crearon durante la instalación. Por ejemplo: User = helloworlduser and password = Helloworld@ 123. 13

BRMS JBoss de Red Hat 6 Guía de inicio Capítulo 4. Ejemplo de reglas Hello World Para demostrar las funcionalidades básicas de JBoss BRMS, este ejemplo le mostrará cómo configurar el proyecto Hello World con una regla empresarial Hello World. T endrá que hacer lo siguiente: 1. Crear un repositorio Hello World en el repositorio Artifact. 2. Crear el proyecto Hello World. 3. Crear la regla Hello World. 4. Construir e implementar el proyecto. 4.1. Creación de la estructura del repositorio T odos 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 estrutura lógica de "directorio". Cualquier paquete puede contener sus activos empresariales (para mayor información 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 sesión como usuario con el rol adm in (helloworlduser). 2. Cree una unidad organizacional en el repositorio Artifact: a. Vaya a Authoring Administration. b. En el menú de perspectivas haga clic en Organizational Units Manage Organizational Units. c. En la vista que se presenta Organizational Unit Manager haga clic en Add. En la ventana que se presenta Add New Organizational Unit defina las propiedades de las unidades y haga clic en OK: Nombre: helloworld Propietario: helloworlduser 3. Cree un nuevo repositorio en la unidad organizacional helloworld: a. Vaya a Authoring Administration. b. En el menú de perspectivas haga clic en Repositories New repository. c. En la ventana que se presenta Create Repository defina las propiedades del repositorio: Nombre del repositorio: helloworldrepo Unidad organizacional: helloworld 4. Vaya a Authoring Project Authoring. 5. En el explorador de proyectos en la casilla desplegable de la unidad organizacional, seleccione helloworld y en la casilla desplegable del repositorio seleccione helloworldrepo. 14

Capítulo 4. Ejemplo de reglas Hello World Figura 4.1. Seleccione el repositorio helloworldrepo en la unidad organizacional helloworld en el explorador de proyectos 6. Cree un proyecto en el repositorio helloworld: a. En el menú de perspectivas vaya a New Item Project b. En la ventana que se presenta Create new defina sus propiedades del proyecto: Nombre del recurso (nombre del proyecto): HelloWorld Ruta: default://m aster@ helloworldrepo/ c. En el diálogo New Project Wizard defina las propiedades maven del proyecto. Presione Intro después de realiza cada entrada: Id del grupo: org.brms Id del arterfacto: HelloWorld Id de la versión: 1 d. Haga clic en Finish. 4.2. Creación 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 años, pueden acceder el contenido particular). Las reglas empresariales se almacenan en archivos DRL. Para definir la regla empresarial helloworldrule en el proyecto HelloWorld haga lo siguiente: 1. En el Project Explorer seleccione la unidad organizacional helloworld, el repositorio helloworldrepo, el proyecto HelloWorld y el paquete default. Selección de paquetes Asegúrese de seleccionar el paquete default. El seleccionar un paquete incorrecto causa que la implementación falle. 2. Crear el archivo DRL: 15

BRMS JBoss de Red Hat 6 Guía de inicio a. En el menú de perspectivas haga clic en New Item DRL file. b. En la casilla Create new defina el nombre del recurso como helloworldrule y verifique que la ruta destino sea default://m aster@ helloworldrepo/helloworld/src/m ain/resources. c. Haga clic en Aceptar. 3. En el editor DRL que se presenta con el archivo helloworldrule.drl defina la regla: rule "helloworldrule" ruleflow-group "helloworld" when then System.out.println("Hello World!"); end Esta regla no define ninguna condición cuando, es decir que siempre será verdadera cuando se dispare (llamada a ejecutar) y se imprimirá la frase Hello World!. 4. Haga clic en Save. 5. Se presenta un campo Save this item. Ingrese el Check-in com m ent y haga clic en guardar. Nota El comentario de registro sería una descripción corta de la clase de cambio que realizó y se tiene que ingresar cada vez que se guarda un activo. 4.3. Construcción e implementación Construya todo el proyecto e impleméntelo en el servidor de ejecución: 1. Abra el menú principal de la central empresarial y vaya a Authoring Project Authoring. 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 Tools Project Editor. 4. Verifique que los detalles del proyecto estén correctos en el Project Screen y haga clic en el botón Build & Deploy en la esquina superior derecha de la vista de la pantalla del proyecto. 16

Capítulo 4. Ejemplo de reglas Hello World Figura 4.2. Editor de proyectos con las siguientes propiedades del proyecto helloworld Aparece una notificación en verde en la parte superior de la pantalla informándole que el proyecto se construyó y que está disponible para ser instanciado. Note que la versión anterior de la implementación helloworld se substituye con la nueva versión con la tarea de la regla empresarial. Para mantener ambas implementaciones, cambie el número de la versión del proyecto en el editor de proyectos. 17

BRMS JBoss de Red Hat 6 Guía de inicio Capítulo 5. Estudio del desarrollador JBoss de Red Hat Red Hat JBoss Developer Studio es el entorno de desarrollo integrado de JBoss (IDE del inglés 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 Developer Studio proporciona plug-ins con herramientas e interfaces para Red Hat JBoss BRMS y la Suite BPM JBoss de Red Hat. Estos plugins se basan en la versión de la comunidad de estos productos. Así que el plugin BRMS se llama el plugin Drools y el plugin de la suite BPM se llama plugin jbpm. Consulte la documentación de Red Hat JBoss Developer Studio para ver las instrucciones de instalación y configuración. 5.1. Instalación de los plugins del estudio del desarrollador JBoss Los plugins Drools para el estudio desarrollador JBoss están disponibles a través del sitio de actualización. Procedimiento 5.1. Instalación del plugin del estudio desarrollador JBoss Drools 1. Inicie el estudio desarrollador JBoss. 2. Seleccione Help Install New Software. 3. Haga clic en Add para ingresar el menú Add Repository. 4. Dele un nombre al sitio software junto al campo Name y agregue la siguiente url en el campo Location: https://devstudio.jboss.com/updates/7.0/integration-stack/ 5. Haga clic en OK 6. Seleccione la funcionalidad JBoss Business Process and Rule Developm ent de las opciones disponibles y haga clic en Next y luego Next de nuevo. 7. Lea la licencia y acéptela seleccionando el botón apropiado y haga clic en Finish. 8. Después de que la instalación de los plug-ins se haya completado, reinicie el estudio desarrollador JBoss. 5.2. Configuración del tiempo de ejecución Drools Con el fin de utilizar el plugin BRMS JBoss con el estudio desarrollador JBoss de Red Hat es necesario establecer el tiempo de ejecución. Un tiempo de ejecución es una colección de archivos jar que representan un lanzamiento específico del software y proporciona las bibliotecas que se necesitan para la compilación y ejecución de sus activos empresariales. Extraiga los archivos jars de tiempo de ejecución que se encuentran en el archivador jboss-brmsengine.zip del archivador zip implementable genérico JBoss BRMS (no el archivador zip implementable EAP6) (disponible en el portal del cliente de Red Hat). Procedimiento 5.2. Configuración del tiempo de ejecución BRMS 18 1. Del menú del estudio desarrollador JBoss de Red Hat seleccione Window y haga clic en Preferences. 2. Seleccione Drools Installed Drools Runtimes.

Capítulo 5. Estudio del desarrollador JBoss de Red Hat 3. Haga clic en Add...; proporcione un nombre para el nuevo tiempo de ejecución y haga clic en Browse para navegar al directorio en donde se encuentra el tiempo de ejecución. 4. Haga clic en OK, seleccione el nuevo tiempo de ejecución y haga clic en OK de nuevo. Si tiene proyectos existentes una ventana de diálogo indicará que JBDS se debe reiniciar para actualizar el tiempo de ejecución. 5.3. Configuración del servidor BRMS JBoss El estudio desarrollador JBoss se puede configurar para ejecutar el servidor BRMS JBoss de Red Hat. Procedimiento 5.3. Configuración del servidor 1. Abra la vista Drools seleccionando Window Open Perspective Other y seleccione Drools y haga clic en OK. 2. Agregue la vista del servidor seleccionando Window Show View Other... y seleccione Server Servers. 3. Abra el menú del servidor haciendo clic con el botón derecho del ratón en el panel del servidor y seleccione New Server. 4. Defina el servidor seleccionando JBoss Enterprise Middleware JBoss Enterprise Application Platform 6.1+ y haciendo clic en Next. 5. Establezca el directorio de inicio haciendo clic en el enlace Add... y luego en el botón Browse. Navegue hasta el directorio de instalación y selecciónelo para JBoss EAP 6.1.1, el cual tiene JBoss BRMS instalado. 6. Proporcione un nombre para el servidor en el campo Name, asegúrese de que el archivo de configuración se establece como standalone.xm l y haga clic en Finish. 7. Haga clic en Next dos veces y luego haga clic en Finish para agregar el servidor. 5.4. Importación de proyectos desde un repositorio Git en el estudio del desarrollador JBoss 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 clonar un repositorio remoto GIT. Procedimiento 5.4. Importación de un repositorio local GIT 1. Inicie el servidor BRMS JBoss de Red Hat (si todavía no está ejecutando) seleccionando el servidor de la pestaña de servidores y haga clic en el ícono de inicio. 2. Seleccione File Import... y navegue a la carpeta Git. Abra la carptea Git para seleccionar Projects from Git y haga clic en siguiente. 3. Seleccione la fuente del repositorio Existing local repository y haga clic en siguiente. 19

BRMS JBoss de Red Hat 6 Guía de inicio Figura 5.1. Detalles del repositorio Git 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. Procedimiento 5.5. Clonación de un repositorio remoto GIT 1. Inicie el servidor BRMS JBoss de Red Hat (si todavía no está ejecutando) seleccionando el servidor de la pestaña de servidores y haga clic en el ícono de inicio. 2. De manera simultánea inicie una shell segura ejecutando el siguiente comando: /sbin/service sshd restart 3. Seleccione File Import... y navegue a la carpeta Git. Abra la carptea Git para seleccionar Projects from Git y haga clic en siguiente. 4. Seleccione la fuente del repositorio Clone URI y haga clic en siguiente. 5. Ingrese los detalles del repositorio Git en la siguiente ventana y haga clic en siguiente. 20

Capítulo 5. Estudio del desarrollador JBoss de Red Hat Figura 5.2. Detalles del repositorio Git 6. Seleccione la rama que quiere importar en la siguiente ventana y haga clic en siguiente. 7. Se le presentará la opción de definir el almacenamiento local para este proyecto. Ingrese (o seleccione) un directorio que no esté vacío, haga los cambios en la configuración 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. 5.5. Creación de un proyecto Drools Procedimiento 5.6. Creación de un nuevo proyecto JBDS 1. Del menú principal seleccione File New Project. 21

BRMS JBoss de Red Hat 6 Guía de inicio Seleccione Drools Drools Project y haga clic en Next. 2. Ingrese un nombre para el proyecto en la casilla Project name: y haga clic en Next. NOTA JBDS proporciona la opción para agregar un archivo de reglas HelloWorld de ejemplo al proyecto. Acepte esta opción predeterminada haciendo clic en Next para probar el proyecto de ejemplo en los siguientes pasos. 3. Seleccione el tiempo de ejecución Drools (o use el predeterminado). 4. Seleccione el código compatible con Drools 6.0.x. Ingrese un GroupID, un ArtifactID y la Version y haga clic en Finish. 5. Para probar el proyecto, haga clic con el botón derecho del ratón en el archivo Java que contiene el método prinicpal y seleccione Run run as Java Application. La salida se presentará en la pestaña de la consola. 22

Capítulo 6. Planificador de recursos empresariales Capítulo 6. Planificador de recursos empresariales El planificador de recursos empresariales está disponible como un avance ténico con BRMS JBoss de Red Hat. El planeador de recursos empresariales es una máquina ligera incluíble de planeación que optimiza los problemas de planeación. Ayuda a los programadores TM Java normales a resolver problemas de planeación de manera eficiente y combina heurística de optimización y metaheurística con cálculos muy eficientes. El planificador ayuda a solucionar varios casos como los siguientes: Empleados/lista de pacientes. En planificador ayuda a crear horarios para las enfermeras y mantiene registros de la administración de las camas de los pacientes. Horarios educacionales. El planificador ayuda a programar clases, cursos, exámenes y presentaciones de conferencias. Horarios del taller: El planificador mantiene registros de las cadenas de fabricación, planeación de colas de máquinas y planeación de tareas del personal. Recorte de recursos: El planificador minimiza los desperdicios reduciendo el consumo de recursos tal como papel y acero. 6.1. Instalación del planificador de recursos empresariales 1. Navegue al portal del cliente de Red Hat e inicie sesión con sus credenciales de usuario. 2. Seleccione Downloads Red Hat JBoss Middleware Descargar Software. 3. Del menú desplegable Products seleccione BPM Suite. 4. Del menú desplegable Version seleccione la versión del producto 6.0.0. 5. Seleccione Red Hat JBoss BPM Suite 6.0.0 Business Resource Planner y haga clic en Download. 6.2. Ejecución de los ejemplos del planificador de recursos empresariales 1. En la línea de comandos vaya hasta el directorio exam ples/. 2. En un entorno Unix ejecute el siguiente comando:./runexamples.sh En un entorno Windows ejecute el siguiente comando:./runexamples.bat 3. Escoja un ejemplo de la aplicación GUI de ejemplos que se abre y ejecútelo en su IDE favorito. 23

BRMS JBoss de Red Hat 6 Guía de inicio Historial de revisiones Revisión 1.0.0-1 T hu Mar 20 2014 CS Builder Robot Built from Content Specification: 13667, Revision: 581011 24