Guía de inicio

1. Vaya al portal del cliente de Red Hat e inicie sesión.
2. Seleccione Downloads → Red Hat JBoss Middleware → Download Software.
3. Del menú desplegable Producto, seleccione Plataforma BRMS.
4. Del menú desplegable Version selecione la versión 6.0.2.
5. Seleccione Red Hat JBoss BRMS 6.0.2 Deployable for EAP 6.1.1 y haga clic en Descargar.

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.
3. 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.

1. Descargue el archivador comprimido y prepárese para agrupar manualmente archivos en el directorio de inicio de Red Hat JBoss Enterprise Application Platform (EAP_HOME; el directorio jboss-eap-6.1).
2. Descomprima el archivador comprimido descargado; sin embargo, no sobreescriba todos los archivos. Agrupe manualmente los siguientes archivos en el directorio EAP_HOME (jboss-eap-6.1):
   • jboss-eap-6.1/domain/configuration/*
   • jboss-eap-6.1/standalone/configuration/*
   • jboss-eap-6.1/modules/layers.conf
   • jboss-eap-6.1/bin/product.conf

   Aviso

   Asegúrese de realizar este paso con la misma cuenta de usuario que se utilizó para instalar EAP. Esta cuenta no debe ser la cuenta del superusuario.
3. Asegúrese de que el EAP de destino no incluya una implementación con un nombre que cree conflictos. Copie la carpeta jboss-eap-6.1/standalone/deployments en el directorio EAP_HOME de la distribución BRMS.
4. Asegúrese de que no se ha llamado antes la capa del módulo EAP llamada BRMS y copie la carpeta jboss-eap-6.1/modules/system/layers/brms en la carpeta EAP 6.1.1.

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 3.3, “Definición de roles”).
   Los usuarios de la central empresarial necesitan tener el rol analyst o admin.
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).

Procedimiento 3.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 → Download Software.
3. Del menú desplegable Producto, seleccione Plataforma BRMS.
4. Del menú desplegable Version seleccione la versión del producto.
5. Seleccione el paquete Red Hat JBoss BRMS 6.0.2 Deployable for all supported containers y luego haga clic en Descargar.
6. El extraer el archivador descargado crea los siguientes archivadores zip:
   • jboss-brms-engine.zip
   • jboss-brms-manager.zip
7. Extraiga business-central.war del archivador jboss-brms-manager.zip y cópielo en tomcat7/webapps/.
8. Borre la extensión .war del business-central.war de manera que el directorio ahora se llame business-central.
9. Defina los usuarios y roles en tomcat7/conf/tomcat-users.xml tal como se puede ver a continuación:

     <role rolename="admin"/>
     <role rolename="analyst"/>
     <user username="user" password="password" roles="admin,analyst"/>

   Copy to Clipboard Toggle word wrap
10. Modifique el archivo web.xml en el directorio tomcat7/webapps/business-central/WEB-INF borrando el comentario de todas las entradas marcadas con TOMCAT-JEE-SECURITY. Por ejemplo:

    <!-- TOMCAT-JEE-SECURITY -->
        <!--
        <init-param>
          <param-name>org.uberfire.auth.scheme</param-name>
          <param-value>org.uberfire.security.server.auth.JACCAuthenticationScheme</param-value>
        </init-param>
        -->
    
    

    Copy to Clipboard Toggle word wrap
    Se debe borrar el comentario así como el siguiente:

    <!-- TOMCAT-JEE-SECURITY -->
    
        <init-param>
          <param-name>org.uberfire.auth.scheme</param-name>
          <param-value>org.uberfire.security.server.auth.JACCAuthenticationScheme</param-value>
        </init-param>
    
    

    Copy to Clipboard Toggle word wrap
11. Copie el archivo kie-tomcat-integration-VERSION.jar de business-central/WEB-INF/lib en la distribución BRMS a tomcat7/lib.
12. Copie el archivo slf4j-api-VERSION.jar y el archivo slf4j-ext-VERSION.jar de business-central/WEB-INF/lib en la distribución BRMS a tomcat7/lib.
13. Descargue el archivo a continuación y póngalo en el directorio tomcat7/lib.
    • javax.security.jacc-api.jar
14. Agregue la siguiente declaración de válvula Tomcat en tomcat7/conf/server.xml (dentro del elemento <host> relevante):

    <Valve className="org.kie.integration.tomcat.JACCValve"/>

    Copy to Clipboard Toggle word wrap
15. 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 business-central/WEB-INF/classes/META-INF/services
16. Inicie el servidor de red JBoss ejecutando startup.sh en el directorio tomcat7/bin.

    ./startup.sh

    Copy to Clipboard Toggle word wrap
17. Navegue hasta http://localhost:8080/business-central en un navegador de red.
18. Inicie sesión con el nombre de usuario/contraseña correctos tal como aparece en el archivo tomcat-users.xml en donde definió los roles de usuario.

1. En la línea de comandos vaya al directorio $SERVER_HOME/bin/.
2. En un entorno Unix ejecute:

   ./standalone.sh

   Copy to Clipboard Toggle word wrap
   En un entorno Windows ejecute:

   ./standalone.bat

   Copy to Clipboard Toggle word wrap

1. En la línea de comandos vaya al directorio $SERVER_HOME/bin/.
2. En un entorno Unix ejecute:

   ./standalone-secure.sh

   Copy to Clipboard Toggle word wrap
   En un entorno Windows ejecute:

   ./standalone-secure.bat

   Copy to Clipboard Toggle word wrap

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 admin (helloworlduser).
2. Cree una unidad organizacional en el repositorio Artifact:
   1. Vaya a Authoring → Administration.
   2. En el menú de perspectivas haga clic en Organizational Units → Manage Organizational Units.
   3. 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:
   1. Vaya a Authoring → Administration.
   2. En el menú de perspectivas haga clic en Repositories → New repository.
   3. 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.
   

   View larger image

   

   Figura 5.1. Seleccione el repositorio helloworldrepo en la unidad organizacional helloworld en el explorador de proyectos

6. Cree un proyecto en el repositorio helloworld:
   1. En el menú de perspectivas vaya a New Item → Project
   2. En la ventana que se presenta Create new defina sus propiedades del proyecto:
      • Nombre del recurso (nombre del proyecto): HelloWorld
      • Ruta: default://master@helloworldrepo/
   3. 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.0
   4. Haga clic en Finish.

1. En el Project Explorer seleccione la unidad organizacional helloworld, el repositorio helloworldrepo, el proyecto HelloWorld y el paquete default.

   Nota

   Asegúrese de seleccionar el paquete default. El seleccionar un paquete incorrecto causa que la implementación falle.
2. Crear el archivo DRL:
   1. En el menú de perspectivas haga clic en New Item → DRL file.
   2. En la casilla Create new defina el nombre del recurso como helloworldrule y verifique que la ruta destino sea default://master@helloworldrepo/HelloWorld/src/main/resources.
   3. Haga clic en Aceptar.
3. En el editor DRL que se presenta con el archivo helloworldrule.drl defina la regla:

   rule "helloworldrule"
   ruleflow-group "helloworldgroup"
   when 
   then
   	System.out.println("Hello World!");
   end
   

   Copy to Clipboard Toggle word wrap
   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 comment 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.

1. En el menú principal de la central empresarial 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.
   

   View larger image

   

   Figura 5.2. Editor de proyectos con las siguientes propiedades del proyecto helloWorld

Procedimiento 6.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 Development 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.

Procedimiento 6.2. Configuración del tiempo de ejecución BRMS

1. Del menú JBoss Developer Studiot seleccione Window y haga clic en Preferences.
2. Seleccione Drools → Installed Drools Runtimes.
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. Haga clic en OK para registrar el tiempo de ejecución seleccionado en JBDS.
4. Marca el tiempo de ejecución que usted ha creado como el tiempo de ejecución Drools predeterminado haciendo clic en la casilla al lado de este.
5. Haga clic en OK. Si tiene proyectos existentes, una ventana de diálogo indicará que tiene que reiniciar JBoss Developer Studio para actualizar el tiempo de ejecución.

Procedimiento 6.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 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 instalado JBoss BRMS.
6. Proporcione un nombre para el servidor en el campo Name, asegúrese de que el archivo de configuración se establece como y haga clic en Finish.

Procedimiento 6.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 carpeta 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.
   

   View larger image

   

   Figura 6.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 6.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. Al mismo tiempo inicie el servidor de la shell segura, si todavía no está ejecutando, usando el siguiente comando. Este comando es específico para Linux y Mac sólamente. En estas plataformas, si sshd ya se inició entonces este comando fallará y puede ignorar de manera segura este paso.

   /sbin/service sshd start

   Copy to Clipboard Toggle word wrap
3. Seleccione File → Import... y navegue a la carpeta Git. Abra la carpeta 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.

   

   View larger image

   

   Figura 6.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.

Procedimiento 6.6. Creación de un nuevo proyecto Red Hat JBoss Developer Studio

1. Del menú principal seleccione File → New → Project.
   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

   JBoss Developer Studio 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 principal y seleccione Run → run as → Java Application.
   La salida se presentará en la pestaña de la consola.

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 → Download Software.
3. Del menú desplegable Products seleccione BPM Suite.
4. Del menú desplegable Version seleccione la versión del producto 6.0.2.
5. Seleccione Red Hat JBoss BPM Suite 6.0.2 Business Resource Planner y haga clic en Download.

1. En la línea de comandos vaya hasta el directorio examples/.
2. En un entorno Unix ejecute el siguiente comando:

   ./runExamples.sh

   Copy to Clipboard Toggle word wrap
   En un entorno Windows ejecute el siguiente comando:

   ./runExamples.bat

   Copy to Clipboard Toggle word wrap
3. Escoja un ejemplo de la aplicación GUI de ejemplos que se abre y ejecútelo en su IDE favorito.