Guía de instalación


Red Hat JBoss BPM Suite 6.1

Para los administradores Red Hat JBoss

Kanchan Desai

Doug Hoffman

Eva Kopalova

B Long

Red Hat Servicios de contenido de ingeniería

Petr Penicka

Red Hat Content Services

Gemma Sheldon

Red Hat Servicios de contenido de ingeniería

Resumen

Esta guía proporciona los pasos necesarios para que los administradores instalen Red Hat JBoss BPM Suite, los complementos para Red Hat JBoss Developer Studio, y provee las instrucciones para ejecutar proyectos de ejemplo.

Capítulo 1. Introducción

1.1. Acerca de Red Hat JBoss BPM Suite

La suite BPM JBoss de Red Hat es un paquete de gestión de procesos empresariales de código abierto que combina la administración de procesos empresariales y la gestión de reglas empresariales y habilita las empresas y los usuarios informáticos para crear, administrar e implementar procesos y reglas empresariales.
Red Hat JBoss BRMS y Red Hat JBoss BPM Suite usan un repositorio centralizado donde se almacenan todos los recursos. Este repositorio garantiza consistencia, transparencia y la capacidad de auditar a través de empresas. Los usurarios empresariales pueden modificar lógica de negocio y procesos empresariales sin requerir asistencia de personal de ingeniería informática.
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 en este lanzamiento.
Para instalar Red Hat JBoss BPM Suite cuenta con soporte para usar con Red Hat Enterprise Linux 7 (RHEL7).

1.2. Plataformas con soporte

Red Hat JBoss BPM Suite y Red Hat JBoss BRMS reciben soporte en los siguientes contenedores:
  • Red Hat JBoss Enterprise Application Platform 6.4
  • Red Hat JBoss Web Server 2.1 (Tomcat 7) on JDK 1.7
  • IBM WebSphere Application Server 8.5.5.0
  • Oracle WebLogic Server 12.1.3 (12c)
Esta sección describe un caso de uso de implementación JBoss BPM Suite para automatizar procesos empresariales (tales como procesos de aprobación de préstamos) en un banco minorista. Este caso de uso es un proceso típico de JBoss BPM Suite a través de una empresa. Aprovecha las funcionalidades de reglas empresariales y procesos de JBoss BPM Suite.
Un banco minorista ofrece varios tipos de productos de préstamo con diferentes términos y requerimientos de selección. Los clientes que requieren un préstamo deben llenar una aplicación de préstamo, la cual es procesada por el banco en varios pasos, como por ejemplo: verificando el criterio de selección, determinando los términos, verificando actividades fraudulentas y determinando el producto de préstamo más apropiado. Una vez aprobado, el banco crea y establece una cuenta de préstamo para el solicitante del préstamo, quien luego puede acceder a los fondos. El banco debe asegurarse de cumplir con todos los requerimientos relevantes en cada paso del proceso y debe administrar su portafolio de préstamo para maximizar sus ganancias. Las políticas tienen lugar para ayudar a tomar decisiones en cada paso y esas políticas están administradas activamente para optimizar resultados para el banco.
Los analistas empresariales en el banco modelan los procesos de aplicación para préstamos usando las herramientas de autor BPMN3 (diseñador de procesos) en JBoss BPM Suite. Vea a continuación el flujo de procesos:

Figura 1.1. Flujo de procesos de aplicación para préstamos de alto nivel

Las reglas empresariales se desarrollan con las herramientas de autor de reglas en JBoss BPM Suite para aplicar políticas y tomar decisiones. Las reglas están enlazadas con los modelos de procesos para reforzar las políticas correctas en cada paso del proceso.
La sección de sistemas del banco implementa JBoss BPM Suite de manera que todo el proceso de aplicación para préstamos se pueda automatizar.

Figura 1.2. Automatización del proceso de aplicación para préstamos

Todo el proceso de préstamo y de reglas se puede modificar en cualquier momento por parte de los analistas empresariales del banco. El banco tiene la habilidad de mantener constante cumplimiento de los requerimientos de acuerdo con las regulaciones cambiantes; puede introducir de manera rápida nuevos productos de préstamo; mejorar las políticas de préstamos para competir efectivamente y dirigir la rentabilidad.

Parte I. Instalador de Red Hat JBoss BPM Suite

Capítulo 2. Opciones de instalación

Red Hat JBoss BPM Suite viene en dos versiones:
  • Instalador JAR para la instalación en Red Hat JBoss Enterprise Application Platform (EAP) 6.4.
  • Archivo comprimido de instalación, el cual viene en dos versiones:
    • jboss-bpmsuite-6.MINOR_VERSION-deployable-eap6.x.zip: versión adaptada para implementación en Red Hat JBoss Enterprise Application Platform (EAP 6.4).
    • jboss-bpmsuite-6.MINOR_VERSION-deployable-generic.zip: la versión implementable con bibliotecas adicionales adaptadas para la implementación en el Red Hat JBoss Web Server (EWS), Apache Tomcat 6 y Apache Tomcat 7.
Según su entorno, puede seleccionar la opción de instalación que mejor se ajuste a las necesidades del proyecto.

Nota

Red Hat JBoss BPM Suite está diseñado para trabajar con codificación UTF-8. Si el JVM subyacente, utiliza un sistema de codificación diferente, se presentarán errores inesperados. Para asegurarse que UTF-8 sea utilizado por el JVM, use la siguiente propiedad de sistema "-Dfile.encoding=UTF-8".

Importante

A partir de BPM Suite JBoss 6.1 y subsiguientes, debe tener JBoss instalado EAP 6.4 o superior antes de intentar instalar BPM Suite de JBoss.

2.1. Instalación de Red Hat JBoss BPM Suite Installer

Esta sección describe los pasos requeridos para instalar Red Hat JBoss BPM Suite mediante el método de instalación del instalador del archivo JAR. El archivo JAR es un archivo ejecutable que instala JBoss BPM Suite en una instalación JBoss EAP 6.
A partir de JBoss BPM Suite 6.1 y subsiguientes, debe ya tener instalado JBoss EAP 6.4 o mejor para instalar JBoss BPM Suite.

Nota

Debido a que IBM DJK no puede usar keystores en otros JDK, no es posible instalar JBoss BPM Suite en un JBoss EAP que se ejecute en IBM JDK con keystores generadas en otro JDK.

2.1.1. Descarga de Red Hat JBoss BPM Suite for JBoss EAP

  1. Vaya al portal del cliente de Red Hat e inicie sesión.
  2. Haga clic en DescargasDescarga de productos.
  3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite.
  4. En el menú desplegable Versión, seleccione la versión 6.1.
  5. Seleccione Red Hat JBoss BPM 6.1 Suite for EAP 6.4 y haga clic en Descargar.
El instalador para Red Hat JBoss BPM Suite es un archivo JAR ejecutable. Usted puede usarlo para instalar JBoss BPM Suite en una instalación EAP 6.4 existente.

Nota

Por razones de seguridad, debe ejecutar el instalador como un non-root user.
Prerrequisito

Antes de intentar instalar JBoss BPM Suite, asegúrese de que ya tenga instalado Red Hat JBoss EAP 6.4 o superior.

  1. Configuración de ubicación y usuarios
    En un indicador de comandos, vaya a la carpeta en la que descargó el archivo de instalador y ejecute el siguiente comando:
    java -jar jboss-bpmsuite-6.1.0.GA-installer.jar

    Nota

    Si ejecuta el instalador en Windows, le pedirán las credenciales de administrador durante la instalación. Para evitar que esto suceda, agregue la opción izpack.mode=privileged al comando de instalación: java -Dizpack.mode=privileged -jar jboss-bpmsuite-6.1.0.GA-installer.jar
  2. El instalador gráfico ejecutará y desplegará una pantalla de inicio y la página de acuerdo de licencia. Acepte la licencia y prosiga.
  3. En la siguiente pantalla, proporcione la ubicación padre de una EAP JBoss donde JBoss BPM Suite debe instalarse. La instantánea a continuación muestra un ejemplo de ruta de directorio:

    Figura 2.1. Red Hat JBoss BPM Suite for JBoss EAP Directory Path

  4. En las siguientes dos pantallas, cree dos usuarios: el primero para la consola de administración de la EAP (ManagementRealm) y el segundo para administrar JBoss BPM Suite (ApplicationRealm).
    La creación del primer usuario para la consola de administración de JBoss EAP es opcional y puede ignorar este paso si no se requiere.
    Haga una nota de los nombres de usuarios y contraseñas, ya que los necesitará para acceder el servidor JBoss EAP (si sí desea crearlo) y la aplicación JBoss BPM Suite respectivamente.
    A menos que la configuración avanzada se realice, la contraseña de usuario JBoss BPM Suite se utilizará de forma predeterminada para las keystores JMS SSL de cliente y servidor y para las keystores de contraseñas Vault.

    Nota

    El nombre de usuario que usted cree no debe ser igual al de los roles predefinidos (Consulte Sección 4.1, “Definición de roles”).
    Las contraseñas que usted cree deben tener por lo menos 8 caracteres y deben contener al menos un número y un caracter no alfanumérico (a excepción del caracter &).

    Nota

    El rol de aplicaciones para el segundo usuario que usted cree es el rol admin. Usted puede asignar roles adicionales a este usuario en esta etapa.
  5. Configure el entorno de seguridad
    Luego, usted configurará el entorno de seguridad de su nueva instalación JBoss BPM Suite. Decida si habilita o no el Gestor de seguridad de Java al hacer clic en la casilla de verificación. El Gestor de seguridad de Java protege más su sistema pero reduce el rendimiento. Deberá tomar una decisión con base en su entorno.
  6. Elija si desea configurar IPv6 pura en el servidor en la que se realiza la instalación. Esta acción le permitirá establecer más adelante configuraciones específicas de tiempo de ejecución IPv6.
  7. Configure el entorno de tiempo de ejecución

    Este paso ofrece la opción de usar una configuración predeterminada o especificar una configuración avanzada.
    • Configuración predeterminada

      Elija la configuración predeterminada para el entorno de tiempo de ejecución en el siguiente paso y haga clic en siguiente para revisar la información de instalación. Si está de acuerdo con la información, haga clic en siguiente para iniciar la instalación real o haga clic en anterior para devolverse y hacer cambios.
    • Configuración avanzada

      Seleccione para activar las opciones de configuración avanzada. Seleccione "Perform advanced configuration" y elija las opciones de configuración avanzada para su entorno mediante las casillas de verificación.

      Figura 2.2. Opciones de configuración avanzada

      • Configure la contraseña Vault

        Las contraseñas Vault sirven para confundir las contraseñas en los descriptores de servidor con el uso de la llave secreta java durante el proceso de instalación o de forma manual con keytool. Esta acción evita que las contraseñas se almacenen como texto plano en los descriptores. Los parámetros iteration count y salt son para el proceso de cifrado.
        En el caso de JBoss BPM Suite, siempre se instala una contraseña Vault, incluso si el usuario no selecciona instalar una con sus propios parámetros. Cuando esto ocurre, se utilizarán los valores predeterminados.
        Para obtener más información sobre contraseñas Vault, consulte la Guía de seguridad Red Hat JBoss EAP.

        Figura 2.3. Configure la contraseña Vault

      • Seguridad SSL

        Esta pantalla le permite agregar los elementos <ssl> y <truststore> al reino de seguridad ManagementRealm mediante la keystore provista.
        • El elemento <ssl> hace que el servidor presente el certificado dentro de keystore como su identidad, lo cual le permite al usuario aplicar su certificado oficial.
        • El elemento <truststore> habilita la autenticación "Client-Cert". Es decir que si un cliente remoto intenta conectarse a cualquier recurso administrado mediante el ManagementRealm, el cliente puede presentar un certificado y si coincide con una entrada en truststore, será autenticado sin necesidad de proporcionar nombre de usuario/contraseña.
        El resultado final es una conexión cifrada y segura entre el cliente y el servidor para el ManagementReal.

        Figura 2.4. Configuración de seguridad SSL

      • Seguridad LDAP

        Este paso en el instalador le permite al usuario definir el servidor LDAP, el cual a su vez define los usuarios que deberían estar autorizados para autenticarse con ManagementReal. Este paso remplaza la configuración predeterminada.
        La pantalla Conexión LDAP le permite a los usuarios definir cómo conectarse al servidor LDAP.
        • El nombre distinguido (DN): el usuario puede conectarse al servidor LDAP. Por lo general, el DN definirá únicamente un usuario especial para este propósito.

        Figura 2.5. Configuración de conexión LDAP

        Seguridad LDAP (Consola de administración)
        La pantalla Configuración LDAP de consola de administración le permite configurar un reino de seguridad. Esta acción define el elemento <security-realm> para ser agregado a los descriptores y utiliza la conexión definida anteriormente.

        Figura 2.6. Configuración LDAP de consola de administración

        • Nombre distinguido de base: Por lo general definirá una 'búsqueda de base' o 'contexto root' para comenzar a buscar usuarios.
        • Tipo de filtro: Le indica a JBoss EAP cómo encontrar el atributo LDAP que define un usuario; puede ser un atributo simple, pero también puede ser un 'filtro LDAP' complejo.
        • Atributo de nombre de usuario: El atributo LDAP que guarda los valores de nombre de usuario. Un nombre de usuario ingresado en este campo sirve para solicitudes de búsquedas como un valor del atributo 'uid'. Si un usuario elije 'la solicitud de sintaxis LDAP' como un tipo de filtro, esta solicitud debe estar especificada en el campo.
        • Búsqueda recursiva de directorio: Si está habilitada, JBoss EAP atravesará el árbol LDAP de modo recursivo, iniciando por el Nombre Distinguido de base. De lo contrario, la búsqueda se limitará al Nombre distinguido de base.
        Seguridad LDAP (Business Central)
        La mayoría de los siguientes campos es similar al Nombre distinguido de base. Se utiliza para buscar los roles, los cuales le permiten autorizar además de autenticar. De lo contrario, los campos context son análogos al Nombre distinguido de base de los anteriores, y campos attribute son análogos al atributo Nombre de usuario. Se aceptarán los filtros que permiten control de grano fino sobre varios valores del atributo especificado.
        En JBoss BPM Suite, los archivos jbpm.usergroup.callback.properties y jbpm.user.info.properties utilizados por los componentes LDAPUserGroupInfo y LDAPUserInfo del Servicio de tareas, completados por los valores ingresados en la página de configuración LDAP de Business Central.
        Los valores de entrada de la página de configuración LDAP de la Central empresarial se utilizan para configurar un nuevo dominio de seguridad, el cual hace uso del módulo de inicio LdapExtended. Este dominio de seguridad se establece como predeterminado para la aplicación web Business Central. Para obtener más información sobre los dominios de seguridad y módulos de inicio, consulte la Guía de seguridad Red Hat JBoss EAP.

        Figura 2.7. Configuración LDAP de Business Central

      • Dominio de seguridad y JSSE

        La pantalla de dominio de seguridad le permite configurar todos los elementos del subsistema de seguridad <security-domain> para administrar información de seguridad, incluidos configuración JSSE. Para información más detallada sobre cómo configurar dominios de seguridad, consulte la Guía de seguridad Red Hat JBoss EAP.

        Figura 2.8. Dominio de seguridad

        Figura 2.9. Configuración JSSE

      • Configuración de keystores JMS SSL

        Esta pantalla permite el cifrado de mensajes JMS enviados a la Central empresarial. Las keystore de cliente se distribuyen a sistemas que necesitan comunicarse con el servidor para facilitar comunicaciones cifradas. Los usuarios pueden usar sus keystores preexistentes o generar unos nuevos.

        Figura 2.10. Configuración de keystores JMS SSL

  8. El instalador efectuará los pasos para instalar JBoss BPM Suite así como los pasos de configuración de posinstalación cuando usted hace clic en siguiente. El instalador también iniciará el servidor JBoss BPM Suite y lo conectará para validar la instalación. Haga clic en siguiente para obtener la última pantalla en la que usted puede generar el script de instalación y el archivo de propiedades. Haga clic en hecho para salir del instalador.
Usted ha instalado correctamente Red Hat JBoss BPM Suite mediante el instalador.
El instalador para Red Hat JBoss BPM Suite también puede ejecutarse mediante la interfaz de línea de comandos(CLI). El procedimiento a continuación demuestra los pasos que podría encontrar con esta opción para instalar JBoss BPM Suite.
Prerrequisito

Antes de intentar instalar JBoss BPM Suite, asegúrese de que ya tenga instalado Red Hat JBoss EAP 6.4 o superior.

  1. En un indicador de comandos, vaya a la carpeta en la que descargó el archivo de instalador y ejecute el siguiente comando:
    java -jar jboss-bpmsuite-6.1.0.GA-installer.jar -console
    Copy to Clipboard Toggle word wrap
  2. El proceso interactivo de línea de comandos iniciará y desplegará el Acuerdo de licencia de usuario final. Se le indicará seleccionar una opción al final de esta licencia:
    presione 1 para continuar, 2 para salir, 3 para volver a mostrar.
    
    Copy to Clipboard Toggle word wrap
  3. Ingrese 1 para comenzar la instalación y escriba en el directorio padre de una instalación EAP existente.
    The location below must specify the JBOSS_HOME of an existing EAP installation. 
    
    [/home/user/BPMSuite-6.1.0/jboss-eap-6.4]
    
    Copy to Clipboard Toggle word wrap
    El instalador verificará la ubicación de la instalación JBoss EAP en la ubicación provista. Ingrese 1 para confirmar y prosiga.
  4. Opcional: Cree un usuario para la consola de administración de JBoss EAP (Management Realm):
    Create an administrative user
    This user will be added to the host container's management realm for administrative purposes. It can be used to access the management console, the management CLI or other applications secured in this realm.
    Copy to Clipboard Toggle word wrap
    Ingrese 0 para no crear ningún usuario administrativo o 1 para crear un uno. Si decide crear un usuario administrativo, siga los siguientes pasos:
    1. Ingrese un nombre de usuario:
      Admin username: [admin]
      Copy to Clipboard Toggle word wrap
    2. Cree y confirme una contraseña para el usuario de la consola de administración EAP:
      The password must have at least 8 characters, and contain at least one number and one non-alphanumeric symbol (not including the character &).
      			
      Admin password: [] 
      
      Confirm admin password: [******************************]
      
      Copy to Clipboard Toggle word wrap
      Después de haber creado correctamente este usuario, prosiga al siguiente paso.
  5. Cree un usuario administrador JBoss BPM Suite
    Create a Business Process Management Suite Admin User
    Create a BPM Suite admin user. The user will be added to the ApplicationRealm, and can be used to access the Business Central Console. The User will be assigned the 'admin' application roles. The BPM Suite username cannot be any of the following: 'admin', 'analyst', 'user', 'manager' or 'developer'.
    
    
    BPM Suite username: [bpmsAdmin]
    Copy to Clipboard Toggle word wrap
  6. Ingrese un nombre de usuario para este usuario y luego cree y confirme una contraseña.
    The password must have at least 8 characters, and contain at least one number and one non-alphanumeric symbol (not including the character &).
    
    BPM Suite password: [] 
    
    Confirm BPM Suite password: [****************]
    
    Copy to Clipboard Toggle word wrap
  7. Después de haber entrado las contraseñas y confirmado, se le dará un paso opcional para definir otros roles
    (Optional) You can add this user to additional roles that will be used for task management.  These roles are custom named and used again when building your processes with human tasks.  Add your custom named roles in a comma separated list below.
    
    Additional user roles: []
    Copy to Clipboard Toggle word wrap
  8. Configure el Gestor de Seguridad Java ya sea presionando 1 o 0 para desmarcarlo.
    Configure the Java Security Manager
    A Java security manager offers JVM level security beyond what is provided by the application container. It enforces access rules at the JVM runtime based on one or more security policies.
    
    This installer will place two security policies in the installation directory with the filenames 'security.policy' and 'kie.policy' regardless of choice. Those policies will be enabled at runtime if the option below is selected. 
    
    Please note that a security manager imposes a significant performance overhead when enabled. It is suggested the included policies be applied in production if user requirements call for a stronger measure than what is already provided by the application container's authentication and authorization mechanism. 
    
    Please see the JBoss Business Process Management Suite administrative documentation for further details and consideration.
      [ ] Enable the Java security manager
    Input 1 to select, 0 to deselect:
    
    Copy to Clipboard Toggle word wrap
  9. Después de elegir el Gestor de seguridad Java, seleccione una opción en el indicador a continuación:
    presione 1 para continuar, 2 para salir, 3 para volver a mostrar.
    
    Copy to Clipboard Toggle word wrap
  10. Especifique si está utilizando IPv6 o no.
    IPv6 configuration
    
    If this computer is using a pure IPv6 configuration, please check the box below. A pure IPv6 setup requires additional configuration at runtime to ensure the proper bindings of the management and http interfaces.
      [ ] Enable pure IPv6 configuration
    Input 1 to select, 0 to deselect:
    
    Copy to Clipboard Toggle word wrap
    Después de seleccionar o desmarcar la configuración IPv6, seleccione una de las siguientes opciones:
    Presione 1 para continuar, 2 para salir, 3 para volver a mostrar.
    Copy to Clipboard Toggle word wrap
  11. Configure el entorno de tiempo de ejecución ya sea al elegir la configuración predeterminada o las opciones avanzadas.
    Configure runtime environment
    Red Hat JBoss Business Process Management Suite can be further customized at this time.
    0  [x] Perform default configuration
    1  [ ] Perform advanced configuration
    Copy to Clipboard Toggle word wrap
    Si selecciona 1, "Perform advanced configuration," complete las siguientes configuraciones:
    •   [ ] Install password vault
      Input 1 to select, 0 to deselect:
      Copy to Clipboard Toggle word wrap
    •   [ ] Enable SSL security
      Input 1 to select, 0 to deselect:
      Copy to Clipboard Toggle word wrap
    •   [ ] Secure EAP Management Console with LDAP
      Input 1 to select, 0 to deselect:
      Copy to Clipboard Toggle word wrap
    •   [ ] Secure Business Central with LDAP
      Input 1 to select, 0 to deselect:
      Copy to Clipboard Toggle word wrap
    •   [ ] Add a security-domain
      Input 1 to select, 0 to deselect:
      Copy to Clipboard Toggle word wrap
    •   [ ] Generate JMS Client Keystores
      Input 1 to select, 0 to deselect:
      Copy to Clipboard Toggle word wrap
  12. Luego, elija la opción del indicador a continuación:
    presione 1 para continuar, 2 para salir, 3 para volver a mostrar.
    
    Copy to Clipboard Toggle word wrap
  13. El archivo .jar comenzará a ejecutar upack y configuración.
  14. Después de hacer la instalación, la línea de comandos le preguntará si desea generar un script de instalación automática y un archivo de propiedades.
    Installation has completed successfully.
    Application installed on /home/user/BPMSuite-6.1.0/jboss-eap-6.4
    Would you like to generate an automatic intallation script and properties file? 
    (y/n) [n]:
    Copy to Clipboard Toggle word wrap
  15. Si selecciona [ y ], proporcione una ruta para el script de instalación automática:
    Select path for the automatic installation script: [/home/user/BPMSuite-6.1.0/jboss-eap-6.4/<auto script filename>]
    
    Copy to Clipboard Toggle word wrap
    Este script generado le permitirá al usuario ejecutar el instalador de la siguiente forma para futuras instalaciones:
    java -jar jboss-bpmsuite-6.1.0.GA-installer.jar <auto script filename>
    Copy to Clipboard Toggle word wrap

    Nota

    Al ejecutar el instalador de esta forma, se producirá una instalación idéntica a la instalación desde la cual se generó el script. Observe que los valores confidenciales, tales como contraseñas, deberán proporcionarse desde un archivo externo o en el momento de la autoinstalación. El argumento opcional le permite al usuario proporcionar estos valores de forma automática
    -variablefile <variable filename>
    Copy to Clipboard Toggle word wrap
    Los valores confidenciasl pueden proporcionarse mediante el siguiente argumento:
    -variables key1=value1,key2=value2
    Copy to Clipboard Toggle word wrap
  16. La línea de comandos proporcionará el siguiente mensaje tras la creación correcta de un script automático o de una instalación de consola:
    XML written successfully.
    [ Console installation done ]
    [BPMS_Installer]$
    Copy to Clipboard Toggle word wrap
  17. Inicie JBoss EAP al ejecutar standalone.sh en el directorio jboss-eap-6.4/bin.
    ./standalone.sh
    Copy to Clipboard Toggle word wrap
  18. Vaya a http://localhost:8080/business-central en un navegador web.
  19. Ingrese con el nombre de usuario y contraseña otorgada al usuario JBoss BPM en el paso "Crear y confirmar una contraseña para el usuario JBoss BPM".

2.1.4. Instalación de Red Hat JBoss BPM en modo de dominio

Para instalar el paquete implementable para JBoss EAP en el modo de dominio, siga los siguientes pasos:
  1. Descargue y extraiga el archivo ZIP Red Hat JBoss BPM Suite 6.1.0 Deployable for EAP 6 desde el Portal del cliente de Red Hat y copie los siguientes directorios en la instalación local de EAP 6.4:
    • bin
    • domain
    Ignore el directorio standalone.
  2. En la línea de comandos, desplácese al directorio /domain e inicie el dominio:
    En un entorno Unix, ejecute:
    ./domain.sh
    Copy to Clipboard Toggle word wrap
    En un entorno Windows, ejecute:
    ./domain.bat
    Copy to Clipboard Toggle word wrap
  3. Implemente el archivo a través de ${jboss-eap-home}/bin/jboss-cli.sh / ${jboss-eap-home}/bin/jboss-cli.bat, o mediante la Interfaz de usuario web de administración (localhost:9990/):

    Nota

    Las aplicaciones web business-central.war y dashbuilder.war provistas en los binarios implementables EAP son directorios, pero para implementación en el dominio, debe usar archivos WAR. Para crearlos, simplemente comprima el contenido de los directorios business-central.war y dashbuilder.war.
    1. Para implementar el archivo a través de ${jboss-eap-home}/bin/jboss-cli.sh o ${jboss-eap-home}/bin/jboss-cli.bat, desplácese al directorio ${jboss-eap-home}/bin directory e implemente el archivo WAR:
      En un entorno Unix, ejecute:
      ./jboss-cli.sh
      Copy to Clipboard Toggle word wrap
      En un entorno Windows, ejecute:
      ./jboss-cli.bat
      Copy to Clipboard Toggle word wrap
    2. Para implementar el archivo a través de la interfaz de usuario web de administración (localhost:9990/):
      • Inicie sesión en su cuenta administrativa EAP
      • Seleccione Dominio -> Administrar -> Implementaciones -> Repositorio de contenido-> Añadir
      • Seleccione el archivo web desde el sistema de archivos, suba el archivo web
      • Seleccione la implementación, haga clic en el botón Asignar
      • Seleccione el grupo de servidores

Nota

Para ingresar a la Central empresarial implementada en las máquinas del Controlador de hosts (HC), el usuario creado en la Máquina de controlador de dominio también debe crearse en las máquinas de controlador de hosts, siguiendo los pasos en la sección Sección 4.2, “Creación de usuarios”.
Instalación de instancias de JBoss BPM Suite Server
En algunas situaciones, los usuarios pueden desear agrupar una serie de nodos EAP 6 en la misma máquina y darles un nombre significativo para facilitar el mantenimiento. Se deben incorporar valores únicos para propiedades de sistemas para cada instancia de servidor. A continuación se enumeran las propiedades comunes que pueden especificarse con un nodo individual JBoss BPM Suite para cambiar la configuración predeterminada; sin embargo, deben especificarse para múltiples nodos que se ejecutan en una máquina individual, de tal manera que apunten a un directorio diferente:
  • org.uberfire.nio.git.dir
  • org.uberfire.metadata.index.dir
  • org.uberfire.nio.git.ssh.cert.dir
Cuando se utilizan múltiples nodos JBoss BPM Suite en una máquina individual, se deben especificar las siguientes propiedades:
  • org.uberfire.nio.git.daemon.host - puede dejarse predeterminada para vincularse al localhost.
  • org.uberfire.nio.git.daemon.port
  • org.uberfire.nio.git.ssh.host - puede dejarse en predeterminada para vincularse al localhost.
  • org.uberfire.nio.git.ssh.port

Nota

Tanto org.uberfire.nio.git.daemon.port como org.uberfire.nio.git.ssh.port requieren valores de puerto diferentes para evitar conflictos de puerto.
Incorpore las propiedades anteriores en el archivo $EAP_HOME/domain/configuration/host.xml como se ilustra abajo en los dos nodos:
Nodo A:
<system-properties>
    <property name="org.uberfire.nio.git.dir" value="/valid/path/.." boot-time="false"/>
    <property name="org.uberfire.metadata.index.dir" value="/valid/path/.." boot-time="false"/>
    <property name="org.uberfire.nio.git.ssh.cert.dir" value="/valid/path/.." boot-time="false"/>

    <property name="org.uberfire.nio.git.daemon.host" value="10.10.10.10" boot-time="false"/>
    <property name="org.uberfire.nio.git.daemon.port" value="9417" boot-time="false"/>
    <property name="org.uberfire.nio.git.ssh.host" value="10.10.10.10" boot-time="false"/>
    <property name="org.uberfire.nio.git.ssh.port" value="8002" boot-time="false"/>
</system-properties>
Copy to Clipboard Toggle word wrap
Nodo B:
<system-properties>
    <property name="org.uberfire.nio.git.dir" value="/valid/path/.." boot-time="false"/>
    <property name="org.uberfire.metadata.index.dir" value="/valid/path/.." boot-time="false"/>
    <property name="org.uberfire.nio.git.ssh.cert.dir" value="/valid/path/.." boot-time="false"/>

    <property name="org.uberfire.nio.git.daemon.host" value="10.10.10.10" boot-time="false"/>
    <property name="org.uberfire.nio.git.daemon.port" value="9418" boot-time="false"/>
    <property name="org.uberfire.nio.git.ssh.host" value="10.10.10.10" boot-time="false"/>
    <property name="org.uberfire.nio.git.ssh.port" value="8003" boot-time="false"/>
</system-properties>
Copy to Clipboard Toggle word wrap
Las propiedades del sistema descritas arriba deben indicar el host, puerto o ubicación de los archivos .index o .niogit. Estos archivos, que deberían ser utilizados por el nodo respectivo, se deben agrupar en un dominio determinado.

2.2. La instalación agrupada genérica implementable

Para instalar Red Hat JBoss BPM Suite en el Red Hat JBoss Web Server (EWS), necesita utilizar el paquete implementable genérico del producto.
Para la instalación en EWS, el paquete implementable genérico contiene bibliotecas de seguridad y administradores de transacciones adicionales que no son parte de Red Hat JBoss EWS.
Observe que el paquete implementable genérico, requiere los siguientes archivos ZIP:
  • jboss-bpmsuite-VERSION-deployable-generic.zip: contiene las aplicaciones web business-central.war, dashbuilder.war y kie-server.war.
  • jboss-bpmsuite-VERSION-engine.zip: bibliotecas de motor de ejecución para incorporar el motor en su aplicación y otras bibliotecas necesarias para implementación genérica.

2.2.1. Descargar el paquete genérico implementable

Para descargar el paquete genérico implementable Red Hat JBoss BPM Suite para JBoss Web Server, siga lo siguiente:
  1. Vaya al portal del cliente de Red Hat e inicie sesión.
  2. Haga clic en Descargas.
  3. En la lista de productos haga clic en Red Hat JBoss BPM Suite.
  4. Desde el menú desplegable Versión, seleccióne la version 6.1 (si aún no ha seleccionado.)
  5. En la sección de Descargas de software que aparece, navegue Red Hat JBoss BPM Suite 6.1 Deployable for all supported containers y luego haga clic en Descargar.
  6. También navegue a los archivos Red Hat JBoss BPM Suite 6.1 Engine y haga clic en Descargar para descargar los archivos JBoss BPM Suite Engine.

2.2.2. Instalación del paquete implementable genérico

Para instalar el paquete implementable genérico, necesita configurar lo siguiente después de haber instalado la plataforma subyacente (Red Hat JBoss WS):
  1. Extraiga el paquete zip genérico implementable que descargó del Portal del cliente de Red Hat a una ubicación temporal. Este paquete zip contiene los siguientes tres archivos de aplicaciones web: business-central.war, dashbuilder.war y kie-server.war en un formato utilizado. Renombre estas carpetas para retirar la extensión .war.
  2. Copie estas carpetas directamente en la carpeta $TOMCAT_DIR/webapps.
    Al final debe tener tres carpetas en formato en un formato explotado: $TOMCAT_DIR/webapps/business-central, $TOMCAT_DIR/webapps/dashbuilder and $TOMCAT_DIR/webapps/kie-server.

    Nota

    $TOMCAT_DIR se refiere al directorio de inicio en donde se encuentra su servidor de red. Remplácelo con la ruta a su directorio de inicio del servidor de red, por ejemplo: /home/john/jboss-ews-2.1/tomcat7/
  3. Extraiga el contenido de los archivos JBoss BPM Suite Engine del archivador a una ubicación temporal desde donde puede copiar las bibliotecas requeridas. Esta carpeta ahora contiene todas las bibliotecas centrales JBoss BPM Suite en la carpeta extraída y una carpeta lib.
  4. Instale el gestor de transacciones.

    Aviso

    Por favor observe que la siguiente sección describe la configuración de un gestor de transacción, Bitronix que no recibe oficialmente soporte de Red Hat.
    Copie las siguientes bibliotecas JAR del administrador de transacciones de la carpeta lib al directorio $TOMCAT_DIR/lib/:
    • btm-VERSION.jar
    • btm-tomcat55-lifecycle-VERSION.jar
    • jta-VERSION.jar
    • slf4j-api-VERSION.jar
    • slf4j-jdk14-VERSION.jar
    Además, descargue la siguiente biblioteca y cópiela en la carpeta $TOMCAT_DIR/lib/ también:
  5. Instale el controlador en su base de datos
    Copie el archivo jar con el controlador de base de datos importante para $TOMCAT_DIR/lib/.

    Nota

    Si utiliza la base de datos H2 integrada, el controlador está disponible en business-central/WEB-INF/lib/.
  6. Cree los archivos de configuración del gestor de transacciones en $TOMCAT_DIR/conf/:
    • btm-config.properties
      bitronix.tm.serverId=tomcat-btm-node0
      bitronix.tm.journal.disk.logPart1Filename=${btm.root}/work/btm1.tlog
      bitronix.tm.journal.disk.logPart2Filename=${btm.root}/work/btm2.tlog
      bitronix.tm.resource.configuration=${btm.root}/conf/resources.properties
      
      Copy to Clipboard Toggle word wrap
    • resources.properties (el resource.ds1.uniqueName define el nombre de la fuente de datos utilizado después en la definición de recursos tomcat - tome nota de este valor).
      Asegúrese de cambiar los valores en las siguientes definiciones para que coincidan con su entorno.

      Ejemplo 2.1. Definición de la fuente de datos H2

      resource.ds1.className=bitronix.tm.resource.jdbc.lrc.LrcXADataSource
      resource.ds1.uniqueName=jdbc/jbpm
      resource.ds1.minPoolSize=10
      resource.ds1.maxPoolSize=20
      resource.ds1.driverProperties.driverClassName=org.h2.Driver
      resource.ds1.driverProperties.url=jdbc:h2:file:~/jbpm
      resource.ds1.driverProperties.user=sa
      resource.ds1.driverProperties.password=
      resource.ds1.allowLocalTransactions=true
      Copy to Clipboard Toggle word wrap

      Ejemplo 2.2. Definición de la fuente de datos MySQL 5.5

      resource.ds1.className=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
      resource.ds1.uniqueName=jdbc/jbpm
      resource.ds1.minPoolSize=0
      resource.ds1.maxPoolSize=10
      resource.ds1.driverProperties.URL=jdbc:mysql://localhost:3306/sampledb
      resource.ds1.driverProperties.user=dbuser
      resource.ds1.driverProperties.password=dbpassword
      resource.ds1.allowLocalTransactions=true
      Copy to Clipboard Toggle word wrap

      Ejemplo 2.3. Definición de la fuente de datos DB2 Type 4

      resource.ds1.className=com.ibm.db2.jcc.DB2Driver
      resource.ds1.uniqueName=jdbc/jbpm
      resource.ds1.minPoolSize=0
      resource.ds1.maxPoolSize=10
      resource.ds1.driverProperties.URL=jdbc:db2://localhost:50000/sampledb
      resource.ds1.driverProperties.user=dbuser
      resource.ds1.driverProperties.password=dbpassword
      resource.ds1.allowLocalTransactions=true
      Copy to Clipboard Toggle word wrap

      Ejemplo 2.4. Definición de la fuente de datos Oracle

      resource.ds1.className=oracle.jdbc.xa.client.OracleXADataSource
      resource.ds1.uniqueName=jdbc/jbpm
      resource.ds1.minPoolSize=0
      resource.ds1.maxPoolSize=10
      resource.ds1.driverProperties.URL=jdbc:oracle:thin:@//localhost:1521/bpms 
      resource.ds1.driverProperties.user=dbuser
      resource.ds1.driverProperties.password=dbpassword
      resource.ds1.allowLocalTransactions=true
      Copy to Clipboard Toggle word wrap

      Ejemplo 2.5. Definición de la fuente de datos del servidor Microsoft SQL

      resource.ds1.className=com.microsoft.sqlserver.jdbc.SQLServerDriver
      resource.ds1.uniqueName=jdbc/jbpm
      resource.ds1.minPoolSize=0
      resource.ds1.maxPoolSize=10
      resource.ds1.driverProperties.URL=jdbc:sqlserver://localhost:1433;databaseName=bpms;
      resource.ds1.driverProperties.user=dbuser
      resource.ds1.driverProperties.password=dbpassword
      resource.ds1.allowLocalTransactions=true
      Copy to Clipboard Toggle word wrap
  7. Configure el escucha de gestor de transacciones en $TOMCAT_DIR/conf/server.xml para iniciar y detener Bitronix en el arranque y detención del contenedor:
    Agregue el siguiente elemento como el último elemento <Listener> en el elemento <Server>:
    <Listener className="bitronix.tm.integration.tomcat55.BTMLifecycleListener" />
    Copy to Clipboard Toggle word wrap
  8. Defina la propiedad del sistema btm.root y la ubicación en donde se ubica el archivo de configuración bitronix:
    En $TOMCAT_DIR/bin/, cree el archivo setenv.sh con el siguiente contenido:
    CATALINA_OPTS="-Xmx512M -XX:MaxPermSize=512m -Djava.security.auth.login.config=$CATALINA_HOME/webapps/business-central/WEB-INF/classes/login.config -Dbtm.root=$CATALINA_HOME -Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow -Djbpm.tsr.jndi.lookup=java:comp/env/TransactionSynchronizationRegistry"
    Copy to Clipboard Toggle word wrap
    La propiedad org.jbpm.designer.perspective se establece a RuleFlow para que la perspectiva para el diseñador sea RuleFlow en lugar de Full. Otórguele al archivo permisos de ejecución si Grant the file execute permissions if applicable.
    La propiedad java.security.auth.login.config debe establecerse para que el clon ssh del repositorio git funcione.

    Importante

    En sistemas Microsoft Windows remplace el valor $CATALINA_HOME 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 "CATALINA_OPTS=-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=C:/Tomcat -Dbitronix.tm.configuration=C:/Tomcat/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow"
    Copy to Clipboard Toggle word wrap
Para establecer la central empresarial haga lo siguiente:
  1. Configure Valve para que la aplicación web Business Central web pueda cargar los usuarios configurados en Tomcat:
    1. Defina los usuarios y roles en $TOMCAT_DIR/conf/tomcat-users.xml. Note que la central empresarial requiere que los usuarios tengan los roles especificados como admin y/o analyst (fpara más información sobre definiciones de roles y usuarios consulte la documentación de Tomcat 7).
      El programa listado a continuación muestra un ejemplo de cómo se agregarían estos dos roles y se le asignarán estos roles al usuario llamado bpmsadmin.

      Nota

      Asegúrese de que los nombres de usuario no estén en conflicto con los roles conocidos. Por ejemplo, no debe crear un usuario con el nombre de usuario admin.
        <role rolename="admin"/>
        <role rolename="analyst" />
        <user username="bpmsadmin" password="P@ssw0rd" roles="admin,analyst"/>
      
      Copy to Clipboard Toggle word wrap
    2. Desplace (no copie) kie-tomcat-integration-VERSION.jar de $TOMCAT_DIR/webapps/business-central/WEB-INF/lib/ a $TOMCAT_DIR/lib/.
    3. Copie jboss-jaxb-api-VERSION.jar from $TOMCAT_DIR/webapps/business-central/WEB-INF/lib/ en $TOMCAT_DIR/lib/.
    4. En $TOMCAT_DIR/conf/server.xml agregue la declaración de válvula Tomcat en el elemento relevante <host>:
      <Valve className="org.kie.integration.tomcat.JACCValve" />
      Copy to Clipboard Toggle word wrap
  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.
    En este procedimiento se configura una fuente de datos con el nombre JNDI jdbc/myDatasource tal como se define en uniqueName=jdbc/jbpm en el archivo bitronix resources.properties (para la opción MySQL):
    1. En business-central/META-INF/context.xml reemplace el nombre JNDI de la fuente de datos en el elemento <Resource>. El atributo uniqueName se refiere a la propiedad resource.ds1.uniqueName establecida en resources.properties:
      <Resource name="jdbc/myDatasource" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>
      Copy to Clipboard Toggle word wrap
    2. En business-central/WEB-INF/web.xml remplace el nombre JNDI de la fuente de datos en el elemento <res-ref-name> con su nombre de fuente de datos:
      <resource-ref>
              <description>Console DS</description>
              <res-ref-name>jdbc/myDatasource</res-ref-name>
              <res-type>javax.sql.DataSource</res-type>
              <res-auth>Container</res-auth>
      </resource-ref>
      Copy to Clipboard Toggle word wrap
    3. Cambie business-central/WEB-INF/classes/META-INF/persistence.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 código a continuación demuestra la información de la base de datos original para persistence.xml:
      <property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/>
      Copy to Clipboard Toggle word wrap
      Esta información se puede actualizar de la siguiente manera (tal como se demuestra con la base de datos MySQL a continuación):
      <property name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect"/>
      Copy to Clipboard Toggle word wrap

      Nota

      El dialecto para DB2 es org.hibernate.dialect.DB2Dialect, para DB2 en AS/400 es org.hibernate.dialect.DB2400Dialect, para Oracle es org.hibernate.dialect.Oracle10gDialect y para el servidor Microsoft SQL es org.hibernate.dialect.SQLServerDialect
    4. Cambie el archivo business-central/WEB-INF/classes/META-INF/persistence.xml de manera que la máquina de procesos JBoss BPM Suite pueda usar la nueva base de datos.
      El código a continuación demuestra la información de la fuente de datos original para persistence.xml:
      <jta-data-source>java:comp/env/jdbc/jbpm</jta-data-source>
      Copy to Clipboard Toggle word wrap
      Cambie este valor a la fuente de datos definida anteriormente:
      <jta-data-source>java:comp/env/jdbc/myDatasource</jta-data-source>
      Copy to Clipboard Toggle word wrap
  3. Ahora puede iniciar JBoss Web Server para iniciar sesión en la central empresarial.
    1. Ejecute startup.sh en el directorio $TOMCAT_HOME/bin.
      ./startup.sh
      Copy to Clipboard Toggle word wrap
    2. Vaya a http://localhost:8080/business-central en un navegador web.
    3. Inicie sesión con el nombre de usuario/contraseña definidos en el archivo tomcat-users.xml.

Nota

Antes de configurar Dashbuilder en Red Hat JBoss Web Server, debe asegurarse de tener instalada correctamente la Central Empresarial como se describe en Sección 2.2.2.2, “Configuración de una central empresarial para Red Hat JBoss Web Server 2.1 (Tomcat 7)”. Dashbuilder necesita las tablas de base de datos del registro de historia para existir, las cuales únicamente son provistas por la Central empresarial. Si estas tablas no están presentes en la base de datos antes de intentar los pasos de abajo, es posible que se presenten errores de inicialización.
Para establecer un panel de construcción en el servidor de red JBoss Red Hat, haga lo siguiente:
  1. Defina usuarios y roles en $TOMCAT_DIR/conf/tomcat-users.xml. Observe que Dashbuilder requiere que los usuarios tengan el rol especificado como admin y/o analyst. Si ya definió estos usuarios para la Central empresarial entonces no necesita definirlos de nuevo.
  2. Habilite el inicio de sesión único entre Dashbuilder y la Central empresarial borrando el comentario de las siguientes líneas en el archivo $TOMCAT_DIR/conf/server.xml:
    <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
    Copy to Clipboard Toggle word wrap
  3. Como con la configuración de la Central empresarial, si está utilizando una base de datos diferente a la predeterminada y una base de datos integrada H2, deberá configurar persistencia.
    En este procedimiento, configure una fuente de datos con el nombre JNDI jdbc/dashbuilderDS como se define en uniqueName=jdbc/jbpm en el archivo bitronix resources.properties .
    1. En dashbuilder/META-INF/context.xml reemplace el nombre JNDI de la fuente de datos en el elemento <Resource>. El atributo uniqueName se refiere a la propiedad resource.ds1.uniqueName establecida en resources.properties:
      <Resource name="jdbc/dashbuilderDS" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>
      Copy to Clipboard Toggle word wrap

      Nota

      Dependiendo de su base de datos es posible que necesite definir otras propiedades aquí también. Por ejemplo, en un entorno Oracle esta entrada puede verse como el siguiente listado.
      <Resource name="jdbc/jbpm" uniqueName="jdbc/jbpm" auth="Container"  removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource" username="username" password="password"  driverClassName="oracle.jdbc.xa.client.OracleXADataSource" url="jdbc:oracle:thin:YOUR-URL:1521:YOUR-DB" maxActive="8" />
      
      Copy to Clipboard Toggle word wrap
    2. En dashbuilder/WEB-INF/web.xml agregue el nombre JNDI de la fuente de datos en el elemento <res-ref-name> con su nombre de fuente de datos:
      <resource-ref>
          <description>Dashboard Builder Datasource</description>
          <res-ref-name>jdbc/dashbuilderDS</res-ref-name>
          <res-type>javax.sql.DataSource</res-type>
          <res-auth>Container</res-auth>
      </resource-ref>
      Copy to Clipboard Toggle word wrap
    3. En dashbuilder/META-INF/context.xml defina la fábrica de transacciones:
       <Transaction factory="bitronix.tm.BitronixUserTransactionObjectFactory"/>
      Copy to Clipboard Toggle word wrap
    4. Actualice el nombre JNDI de la fuente de datos en dashbuilder/WEB-INF/etc/hibernate.cfg.xml en el elemento <session-factory>:
      <property name="connection.datasource">java:/comp/env/jdbc/dashbuilderDS</property>
      Copy to Clipboard Toggle word wrap
  4. Reinicie el servidor de red Java para que los cambios tengan efecto. Una vez reiniciado puede navegar al Dashbuilder desde la central empresarial o directamente a través de: http://localhost:8080/dashbuilder.

Capítulo 3. Configuración especial

3.1. Configuración de persistencia para Central empresarial

Red Hat JBoss BPM Suite está configurado para usar una fuente de datos con el nombre de la Interfaz de nombrado y directorio Java (JNDI) java:jboss/datasources/ExampleDS. Para la Central empresarial, esta fuente de datos de ejemplo se localiza en el archivo business-central.war/WEB-INF/classes/META-INF/persistence.xml.
Si desea configurar JBoss BPM Suite para usar una base de datos externa, haga los siguientes cambios. Para el archivo business-central.war/WEB-INF/classes/META-INF/persistence.xml:
  1. Instale el controlador de Conectividad de base de datos Java (JDBC) mediante el enfoque modular para cada configuración subsiguiente (consulte EAP 6 documentation).
  2. Cree una nueva fuente de datos según el ejemplo en la documentación EAP 6 , sección 6.7.1. Ejemplo PostgreSQL Datasource. Esta es la configuración de fuente de datos específica en la base de datos H2 utilizada como predeterminada:
     <subsystem xmlns="urn:jboss:domain:datasources:1.1">
             <datasources>
                <datasource jndi-name="java:jboss/datasources/ExampleDS" pool-name="ExampleDS" enabled="true" use-java-context="true">
                   <connection-url>jdbc:h2:mem:test;DB_CLOSE_DELAY=-1</connection-url>
                   <driver>h2</driver>
                   <security>
                      <user-name>sa</user-name>
                      <password>sa</password>
                   </security>
                </datasource>
                <drivers>
                   <driver name="h2" module="com.h2database.h2">
                      <xa-datasource-class>org.h2.jdbcx.JdbcDataSource</xa-datasource-class>
                   </driver>
                </drivers>
             </datasources>
    Copy to Clipboard Toggle word wrap
  3. Use el nombre JNDI de la fuente de datos para actualizar la siguiente entrada dentro del archivo persistence.xml, el cual se establece como predeterminado para esta entrada.
    <jta-data-source>java:jboss/datasources/ExampleDS</jta-data-source>
    Copy to Clipboard Toggle word wrap

    Importante

    Cuando configure su fuente de datos, asegúrese de habilitar JTA ( por lo general, adicionando la etiqueta jta="true" a la datasource).
  4. Remplace el siguiente texto con el nombre de dialecto hibernate específico en la base de datos apropiada.
    <property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect" />
    Copy to Clipboard Toggle word wrap
    Por ejemplo, para una Oracle Database Express Edition 11g:
    <property name="hibernate.dialect" value="org.hibernate.dialect.Oracle10gDialect" />
    Copy to Clipboard Toggle word wrap

Nota

Cuando JBoss BPM Suite utiliza Oracle 11 como la fuente de datos, se producen múltiples advertencias (WARN) en los registros, sin ninguna actividad de Central empresarial efectuada. Esta es una conducta esperada. Para desactivar estos mensajes, defina los mensajes, defina el nivel de los mensajes, establezca el nivel de categoría org.hibernate.loader del registrador como ERROR en el archivo standalone.xml:
<logger category="org.hibernate.loader">
  <level name="ERROR"/>
</logger>
Copy to Clipboard Toggle word wrap

3.2. Configuración de Persistencia para Dashbuilder

Como Dashbuilder depende de la configuración de la Central empresarial, verifique si la Central Empresarial está configurada según Sección 3.1, “Configuración de persistencia para Central empresarial”. Red Hat JBoss BPM Suite 6 está configurada para usar una fuente de datos con el nombre de la Interfaz de directorio denominada Java (JNDI) java:jboss/datasources/ExampleDS. Si desea que la aplicación funcione con una base de datos diferente a H2, por ejemplo Oracle, MySQL, Postgres, o MS SQL Server, siga los siguientes pasos .

Nota

Si desea usar UTF 8 para visualizar caracteres que no sean en inglés, debe revisar su documentación de base de datos y configurar la codificación en el nivel de base de datos para que Dashbuilder funcione correctamente. Por ejemplo en MySQL, agregue lo siguiente para el archivo de configuración de servidor:
[mysqld]
character-set-server=utf8
collation-server=utf8_general_ci
Copy to Clipboard Toggle word wrap

Importante

En sistemas como Unix, cambie el valor predeterminado de MySQL lower_case_table_names de 0 (case sensitive) a 1 (sensible a las mayúsculas). Las solicitudes JBoss BPM Suite KPI se escriben en minúsculas pero los nombres de tablas se escriben en camelCase. Al cambiar la propiedad lower_case_table_names evitará que se presenten excepciones más adelante.
  1. Instale el controlador de base de datos y cree una nueva fuente de datos según el ejemplo en la EAP 6, sección 6.7.1. Ejemplo de PostgreSQL Datasource. Use el enfoque modular para la instalación del controlador JDBC para facilitar la configuración.
  2. Cree una base de datos vacía.
  3. Modifique el archivo dashbuilder.war/WEB-INF/jboss-web.xml cuya entrada predeterminada es:
      	<jboss-web>
        <context-root>/dashbuilder</context-root>
        <resource-ref>
            <res-ref-name>jdbc/dashbuilder</res-ref-name>
            <res-type>javax.sql.DataSource</res-type>
            <jndi-name>java:jboss/datasources/ExampleDS</jndi-name>
        </resource-ref>
    
    Copy to Clipboard Toggle word wrap
  4. Igualmente, modifique los archivos WEB-INF/jboss-deployment-structure.xml desde las aplicaciones business-central.war y dashbuilder.war, y agregue una dependencia en la sección de dependencias en el módulo de controlador JBDC creado durante la creación. El trozo siguiente muestra un ejemplo de configuración en donde jdbcDriverModuleName es el nombre del módulo de controlador JBoss EAP 6 JDBC.
      <dependencies>
             ...
                <module name="jdbcDriverModuleName" />
                ...
      </dependencies>
    
    Copy to Clipboard Toggle word wrap

3.3. Configuración especial para base de datos IBM DB2

Si usted desea utilizar una base de datos IBM DB2 como la fuente de datos subyacentes para Central empresarial, necesitará incrementar el tamaño de la página para la base de datos. El tamaño de la página predeterminada de 4 KB no es suficiente para el tamaño de las columnas de la tabla Dashbuilder.
Cuando cree la base de datos, aumente el tamaño de la página a 16384 como en el siguiente ejemplo:

Ejemplo 3.1. Ajuste del tamaño de la página

CREATE DATABASE dashb PAGESIZE 16384
Copy to Clipboard Toggle word wrap
Este aumento en el tamaño de la página para la base de datos subyacente debe realizarse antes de que BPM Suite haya sido ejecutado por primera vez.

Capítulo 4. Configuración de usuarios y roles

4.1. 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 utilizan en Red Hat JBoss BPM Suite :
  • 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. Los admin tienen acceso a todas las áreas dentro del sistema.
  • desarrollador: un desarrollador tiene acceso a casi todas las funcionalidades y puede administrar reglas, modelos, flujos de procesos, formas y paneles. Puede administrar el repositorio de activos, crear, construir e implementar proyectos e incluso puede usar Red Hat JBoss Developer Studio para ver procesos. Solamente se ocultan ciertas funciones administrativas como la creación y clonación de un nuevo repositorio para el rol del desarrollador.
  • analista: un rol de analista tiene acceso a todas las funcionalidades de alto nivel para modelar y ejecutar sus proyectos. Sin embargo, el acceso AutoríaAdministración no está disponible para los usuarios con el rol de analista. Ciertas funcionalidades de menor nivel orientadas a los desarrolladores como la vista ImplementaciónRepositorio de artefactos no son accesibles para este rol. Sin embargo, el botón Construir& Implementar está disponible para el rol de analista cuando utiliza el editor de proyectos.
  • usuario: un usuario o un usuario empresarial trabaja en las listas de tareas empresariales que se utilizan para operar cierto proceso. Un usuario con este rol puede acceder el panel y administrar procesos.
  • mánager: un mánager es un observador del sistema que está interesado en las estadísticas relacionadas con los procesos empresariales y su rendimiento, indicadores empresariales y otros reportes del sistema. Un usuario con este rol tiene acceso únicamente al BAM.

Nota

Ingrese los roles mencionados anteriormente durante el proceso de creación del usuario.

4.2. Creación de usuarios

Para comenzar a agregar nuevos usuarios, deberá 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 de nombre del usuario ingrese un nombre de usuario y confirme. Por ejemplo: helloworlduser.

    Nota

    Asegúrese de que los nombres de usuario no estén en conflicto con los grupos conocidos. Por ejemplo, si existe un grupo llamado admin, no debe crear un usuario con el nombre de usuario admin.
  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 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 como mínimo un caracter especial (por ejemplo, ~ ! @ # $ % ^ * ( ) - _ + =).
  6. Ingrese una lista de roles separada por comas en el indicador de roles (consulte Sección 4.1, “Definición de roles”).
    Los usuarios de la central empresarial deben tener por lo menos el rol analyst y los usuarios dashbuilder deben tener el rol admin. Los roles se deben ingresar como una lista separada por comas:
  7. Confirme que desea agregar el usuario.
  8. Ingrese 'Sí' en el siguiente campo (con el fin de habilitar el agrupamiento en el futuro si se requiere).

Capítulo 5. Probando la instalación…

5.1. Inicio del servidor

Si ha instalado Red Hat JBoss BPM Suite mediante la instalación del racimo JBoss EAP 6, ahora puede iniciar su servidor en uno de los dos modos.

Nota

Si instaló JBoss BPM Suite usando la versión implementable genérica en el servidor de red Java de Red Hat, las instrucciones para descargar e instalar también contienen las instrucciones para iniciar el servidor. Puede ignorar la siguiente discusión.
El script de arranque predeterminado,standalone.sh con el que se envía Red Hat JBoss BPM Suite está optimizado para rendimiento. Para ejecutar su servidor en modo de rendimiento, haga lo siguiente:
  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
Red Hat JBoss BPM Suite 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 predeterminada que protege contra 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. Consulte Sección 5.2, “Administrador de seguridad Java y administración de rendimiento”.
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
    Copy to Clipboard Toggle word wrap
    En un entorno Windows ejecute:
    ./standalone-secure.bat
    Copy to Clipboard Toggle word wrap

Nota

Si instaló JBoss BPM Suite con el instalador, recibirá la opción para aplicar la política de seguridad en el momento de la instalación. El instalador no proporciona un script standalone-secure.sh independiente.

Nota

Si usted está iniciando el servidor en el modo de dominio, los scripts correspondientes son domain.sh y domain-secure.sh, respectivamente.

5.2. Administrador de seguridad Java y administración de rendimiento

Como se observó anteriormente, al habilitar el administrador de seguridad Java (JSM, por sus siglas en inglés) un entorno de prueba completo para la evaluación de scripts MVEL en Red Hat JBoss BPM Suite 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 aplicación JBoss BPM Suite. Use las siguientes directrices para implementar aplicaciones seguras JBoss BPM Suite de alto rendimiento.
  • En entornos de alto rendimiento en donde el rendimiento es crítico se recomienda que únicamente se implementen aplicaciones que hayan sido desarrolladas en otros sistemas y que hayan sido revisadas apropiadamente. También se recomienda no crear ningún usuario con el rol de analista en dichos sistemas. Si se tienen en cuenta estas medidas entonces es seguro dejar JSM inhabilitado en estos sistemas de manera que no introduzca ninguna degradación de rendimiento.
  • En entornos de prueba y desarrollo sin altas cargas o en entornos en donde la autoría de reglas y procesos está expuesta a redes externas, se recomienda tener JSM habilitado con el fin de lograr beneficios de seguridad de una evaluación completa del entorno de prueba de MVEL.
No es seguro y no se recomienda permitir que usuarios con el rol Analyst inicien sesión en la consola central empresarial con JSM inhabilitado.

5.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 correctamente.
  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: Usuario = helloworlduser y contraseña = Helloworld@123.

Capítulo 6. Agrupamiento

Al agrupar Red Hat JBoss BPM Suite, considere cuáles componentes deben ser agrupados. Puede agrupar los siguientes:
  • Repositorio GIT: el repositorio VFS (virtual-file-system) que guarda los bienes empresariales para que todos los nodos de clúster usen el mismo repositorio.
  • Servidor de ejecución y aplicaciones Web: el servidor de tiempo de ejecución que reside en el contenedor (como por ejemplo, Red Hat JBoss EAP) junto con las aplicaciones web BRMS y BPM Suite para que los nodos compartan los mismos datos de tiempo de ejecución.
    Para obtener instrucciones sobre cómo agrupar la aplicación, consulte la documentación de agrupamiento de contenedores.
  • Base de datos en segundo plano: la base de datos con los datos de estado, tales como, instancias de procesos, sesiones KIE, registro de historial, etc., para propósitos de conmutación.

Figura 6.1. Esquema del sistema Red Hat JBoss BPM Suite con componentes de sistemas individuales.

Mecanismo de agrupamiento del repositorio Git

Para agrupar el repositorio Git se utiliza lo siguiente:
  • Apache Zookeeper reúne todas las partes.
  • Apache Helix es el componente de administración de clústeres que registra toda la información de clústeres (el clúster, los nodos y los recursos).
El entorno de tiempo de ejecución, es decir el servidor de ejecución, utiliza lo siguiente para proporcionar las funcionalidades de agrupamiento:
  • uberfire framework proporciona la estructura de las aplicaciones web

Figura 6.2. Esquema de agrupamiento con Helix y Zookeeper

Una configuración típica implica lo siguiente:
  • Configurar el clúster mediante Zookeeper y Helix
  • Instalación de la base de datos de segundo plano con configuración y tablas Quartz
  • Configuración de agrupamiento en su contenedor (esta documentación proporciona únicamente las instrucciones de agrupamiento para Red Hat JBoss EAP 6)

Repositorios de agrupamiento Maven

Varias operaciones dentro de los JAR públicos de la Central empresarial al repositorio Maven interno de la Central empresarial.
Este repositorio existe en el sistema de archivos del servidor de aplicaciones como archivos regulares y no tiene en cuenta al clúster. Esta carpeta no se sincroniza a través de varios nodos en el clúster, debe sincronizarse mediante herramientas externas tales como rsync.
Otra forma de usar una herramienta de sincronización externa es establecer la propiedad del sistema org.guvnor.m2repo.dir en cada nodo de clúster para señalar un SAN o NAS. En este caso, no se necesita el agrupamiento de la carpeta del repositorio Maven.

6.1. Configuración de un clúster

Para agrupar su repositorio Git (VFS) en la Central empresarial, haga lo siguiente; si no usa la Central empresarial, puede ignorar esta sección):
  1. Descargue jboss-bpmsuite-brms-VERSIÓN-supplementary-tools.zip, la cual contiene scripts de Apache Zookeeper, Apache Helix y quartz DDL. Después de descargar, descomprima el archivo: se crearán el directorio Zookeeper ($ZOOKEEPER_HOME) y el directorio Helix ($HELIX_HOME).
  2. Ahora configure Zookeeper:
    1. En el directorio Zookeeper, vaya al directorio conf y haga lo siguiente:
      cp zoo_sample.cfg zoo.cfg
      Copy to Clipboard Toggle word wrap
    2. Abra zoo.cfg para modificar y ajustar los parámetros incluidos los siguientes:
      # the directory where the snapshot is stored.
      dataDir=$ZOOKEEPER_HOME/data/
      # the port at which the clients connects
      clientPort=2181
      server.1=server1:2888:3888
      server.2=server2:2888:3888
      server.3=server3:2888:3888
      Copy to Clipboard Toggle word wrap
      Asegúrese de que el sitio dataDir exista y sea accesible.
    3. Asigne un ID de nodo a cada miembro que ejecutará ZooKeeper. Por ejemplo, use "1", "2" y "3" respectivamente para nodo 1, nodo 2 y nodo 3, respectivamente. ZooKeeper debería tener un número de instancias impar, y por lo menos 3 para recuperarse del fallo.
      El ID de nodo es especificado en el campo myid en el directorio de datos de ZooKeeper en cada nodo. Por ejemplo, en nodo 1, ejecute: $ echo "1" > /zookeeper/data/myid
  3. Configure Zookeeper, para que pueda usarlo durante la creación del clúster con Helix:
    1. Vaya al directorio $ZOOKEEPER_HOME/bin/ e inicie ZooKeeper:
      ./zkServer.sh start
      Copy to Clipboard Toggle word wrap
      Puede revisar el registro de Zookeeper en el archivo $ZOOKEEPER_HOME/bin/zookeeper.out. Revise este registro para verificar si el 'ensemble' (clúster) se ha formado correctamente. Uno de los nodos debe ser elegido como líder con los otros dos nodos que los siguen.
  4. Después de iniciar el clúster de Zookeeper, configure e inicie Helix. Helix solamente necesita ser configurado una vez y desde un solo nodo. Luego Zookeeper almacenará y compartirá la configuración como corresponde.
    Establezca el clúster con el servidor Zookeeper como el maestro de la configuración:
    1. Cree el clúster al proporcionar el host y el puerto de Zookeper como una lista separada por comas:
      $HELIX_HOME/bin/helix-admin.sh --zkSvr ZOOKEEPER_HOST:ZOOKEEPER_PORT --addCluster CLUSTER_NAME
      Copy to Clipboard Toggle word wrap
    2. Agregue sus nodos al clúster:
      $HELIX_HOME/bin/helix-admin.sh --zkSvr ZOOKEEPER_HOST:ZOOKEEPER_PORT --addNode CLUSTER_NAME NODE_NAMEUNIQUE_ID
      Copy to Clipboard Toggle word wrap

      Ejemplo 6.1. Adición de los tres nodos de clúster

      ./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addNode bpms-cluster nodeOne:12345
      ./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addNode bpms-cluster nodeTwo:12346 
      ./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addNode bpms-cluster nodeThree:12347
      Copy to Clipboard Toggle word wrap
  5. Agregar recursos al clúster.

    Ejemplo 6.2. Agregar vfs-repo como recurso

    ./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addResource bpms-cluster vfs-repo 1 LeaderStandby AUTO_REBALANCE
    Copy to Clipboard Toggle word wrap
  6. Reequilibrar el clúster con tres nodos.

    Ejemplo 6.3. Reequilibrar bpms-cluster

    ./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --rebalance bpms-cluster vfs-repo 3
    Copy to Clipboard Toggle word wrap
    En el comando anterior, 3 significa para tres nodos zookeeper
  7. Inicie el controlador Helix en todos los nodos en el clúster.

    Ejemplo 6.4. Inicie el controlador Helix

    ./run-helix-controller.sh --zkSvr server1:2181,server2:2181,server3:2181 --cluster bpms-cluster 2>&1 > /tmp/controller.log &
    Copy to Clipboard Toggle word wrap

Nota

Zookeeper debe ser un número impar de instancias, al menos 3 para recuperarlas del fallo. Después de un fallo, el número restante de nodos aún puede formar una mayoría. Por ejemplo, un clúster de cinco nodos Zookeeper puede soportar la pérdida de dos nodos para recuperarse completamente. Una instancia Zookeeper aún es posible, la replicación funcionará, sin embargo las posibilidades de no recuperación estarán disponibles si falla.

Detención de Helix y Zookeeper

Para detener los procesos Helix y el servidor Zookeeper, siga el siguiente procedimiento:

Procedimiento 6.1. Detención de Helix y Zookeeper

  1. Detenga los procesos de servidor JBoss EAP
  2. Detenga el proceso Helix que ha sido creado por run-helix-controller.sh, por ejemplo, kill -15 <pid of HelixControllerMain>.
  3. Detenga el servidor ZooKeeper mediante el comando zkServer.sh stop .

6.2. Configuración de Quartz

Antes de configurar la base de datos en su servidor de aplicaciones, necesitará preparar la base de datos para que Quartz pueda crear tablas Quartz,las cuales guardarán la fecha de temporizador y el archivo de definición Quartz.
Claro está que si usted no está utilizando temporizadores Quartz en los procesos de su empresa, o si no usa el Execution Server de ninguna manera, puede ignorar esta sección. Por favor, observe que si desea replicar temporizadores en su proceso empresarial, debe usar el componente Quartz.
Para configurarlo, haga lo siguiente:
  1. Configure la base de datos. Asegúrese de usar una la fuente de datos con soporte non-JTA. Observe que debido a que Quartz necesita un fuente de datos non-JTA, usted no puede usar la fuente de datos de la Central empresarial. En el código de ejemplo, se utiliza PostgreSQL con el usuario bpms y la contraseña bpms .
  2. Cree las tablas Quartz en su base de datos para permitir sincronización de eventos de temporizador. Para ello, use el script DDL de su base de datos, el cual está disponible en el archivo zip complementario QUARTZ_HOME/docs/dbTables.
  3. Cree el archivo de configuración quartz-definition.properties en el directorio $JBOSS_HOME/PROFILE/configuration/ y defina las propiedades Quartz.

    Ejemplo 6.5. Archivo de configuración para base de datos PostgreSQL

     #============================================================================
    # Configure Main Scheduler Properties  
    #============================================================================
    
    org.quartz.scheduler.instanceName = jBPMClusteredScheduler
    org.quartz.scheduler.instanceId = AUTO
    
    #============================================================================
    # Configure ThreadPool  
    #============================================================================
    
    org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool
    org.quartz.threadPool.threadCount = 5
    org.quartz.threadPool.threadPriority = 5
    
    #============================================================================
    # Configure JobStore  
    #============================================================================
    
    org.quartz.jobStore.misfireThreshold = 60000
    
    org.quartz.jobStore.class=org.quartz.impl.jdbcjobstore.JobStoreCMT
    org.quartz.jobStore.driverDelegateClass=org.quartz.impl.jdbcjobstore.PostgreSQLDelegate
    org.quartz.jobStore.useProperties=false
    org.quartz.jobStore.dataSource=managedDS
    org.quartz.jobStore.nonManagedTXDataSource=notManagedDS
    org.quartz.jobStore.tablePrefix=QRTZ_
    org.quartz.jobStore.isClustered=true
    org.quartz.jobStore.clusterCheckinInterval = 20000
    
    #============================================================================
    # Configure Datasources  
    #============================================================================
    org.quartz.dataSource.managedDS.jndiURL=jboss/datasources/psbpmsDS
    org.quartz.dataSource.notManagedDS.jndiURL=jboss/datasources/quartzNotManagedDS
    Copy to Clipboard Toggle word wrap
    Observe las fuentes de datos que se acomodarán a los dos esquemas Quartz al final del archivol

    Importante

    El intervalo recomendado para descubrir clúster es de 20 segundos y se establece en el org.quartz.jobStore.clusterCheckinInterval del archivo quartz-definition.properties. Según su configuración considere el impacto de rendimiento y modifique el parámetro si es necesario.
    También observe la propiedad org.quartz.jobStore.driverDelegateClass que define el dialecto de la base de datos a usar para comunicarse con el set de base de datos (en este ejemplo, org.quartz.impl.jdbcjobstore.PostgreSQLDelegate. Para Oracle, use org.quartz.impl.jdbcjobstore.oracle.OracleDelegate).

6.3. Configuración de agrupamiento en Red Hat JBoss EAP

La información provista en esta sección es una fórmula de agrupamiento sencilla. Para obtener información sobre agrupamiento, consulte Red Hat JBoss EAP documentation.
Al utilizar agrupamiento de JBoss EAP , un controlador de dominio JBoss EAP existe con otros esclavos JBoss EAP se conectan como usuarios administrativos. La implementación de Business Central y dashbuilder puede hacerse como un usuario administrativo en controlador de dominio, y las implementaciones WAR se distribuirán a otros miembros del clúster JBoss EAP.
Para configurar agrupamiento en Red Hat JBoss EAP 6, siga el siguiente procedimiento:
  1. Instale su controlador JDBC como un módulo de núcleo: copie el JAR de controlador a $EAP_HOME/modules/system/layers/base/ y cree un archivo module.xml en el directorio.
  2. Modifique el archivo module.xml como el módulo XSD respectivo.

    Ejemplo 6.6. El contenido del archivo module.xml para fuente de datos PostgreSQL

    <module xmlns="urn:jboss:module:1.0" name="org.postgresql">
      <resources>
        <resource-root path="postgresql-jdbc.jar"/>
      </resources>
    
      <dependencies>
        <module name="javax.api"/>
        <module name="javax.transaction.api"/>
      </dependencies>
    </module>
    
    Copy to Clipboard Toggle word wrap
  3. Configure los nodos de servidor individuales en el elemento main-server-group en el archivo $EAP_HOME/domain/configuration/host.xml con propiedades definidas en Tabla 6.1, “Propiedades de nodos de cĺúster”:
    Observe que al configurar un clúster de JBoss EAP con Zookeeper, se puede tener un número de nodos JBoss EAP diferentes a los nodos Zookeeper (tenga en cuenta que debe ser un número de nodos impar). Sin embargo, el tener el mismo conteo de nodos tanto para Zookeeper como JBoss EAP se considera una práctica más efectiva.
    Expand
    Tabla 6.1. Propiedades de nodos de cĺúster
    Nombre de propiedadValorDescripción
    jboss.node.namenodeOne
    único nombre de nodo dentro de un clúster
    org.quartz.properties/bpms/quartz-definition.properties
    ruta absoluta al archivo de configuración quartz
    org.uberfire.cluster.autostarttrue
    Este valor retarda el agrupamiento VFS hasta que la aplicación sea totalmente inicializada para evitar conflictos cuando todos los miembros de clúster crean clones locales.
    org.uberfire.cluster.idbpms-cluster
    Nombre de clúster Helix
    org.uberfire.cluster.local.idnodeOne_12345
    ID único del nodo de clúster Helix
    Observe que : se remplaza por _.
    org.uberfire.cluster.vfs.lockvfs-repo
    nombre del recurso definido en el clúster Helix
    org.uberfire.cluster.zkserver1:2181
    Zookeeper location
    org.uberfire.metadata.index.dir/home/jbpm/node[N]/index
    sitio donde el índice de búsqueda debe ser creado (mantenido por Apache Lucene)
    org.uberfire.nio.git.daemon.hostnodeOneel nombre de la máquina de host de demonio en el clúster físico
    org.uberfire.nio.git.daemon.port9418
    puerto utilizado por el repositorio VFS para aceptar conexiones de clientes
    El puerto debe ser único para cada miembro de clúster.
    org.uberfire.nio.git.dir/home/jbpm/node[N]/repo
    Ubicación del repositorio Git (VFS) en node[N]
    org.uberfire.nio.git.ssh.hostnodeOneel nombre de la máquina de host SSH en el cĺúster físico
    org.uberfire.nio.git.ssh.port8003el único puerto de número de acceso ssh para el repositorio Git para ejecutar un clúster en máquinas físicas
    org.uberfire.nio.git.ssh.hostport and org.uberfire.nio.git.daemon.hostport8003 and 9418En un entorno virtualizado, el puerto externo a ser utilizado

    Ejemplo 6.7. Configuración de clúster nodeONe

    <system-properties>
    				
      <property name="org.uberfire.nio.git.dir" value="/tmp/bpms/nodeone" boot-time="false"/>
      <property name="jboss.node.name" value="nodeOne" boot-time="false"/>
      
      <property name="org.uberfire.cluster.id" value="bpms-cluster" boot-time="false"/>
      <property name="org.uberfire.cluster.zk" value="server1:2181,server2:2181,server3:2181" boot-time="false"/>
      <property name="org.uberfire.cluster.local.id" value="nodeOne_12345" boot-time="false"/>
      <property name="org.uberfire.cluster.vfs.lock" value="vfs-repo" boot-time="false"/>
      <property name="org.uberfire.cluster.autostart" value="true" boot-time="true"/>
      
      <property name="org.uberfire.nio.git.daemon.host" value="nodeOne" />
      <property name="org.uberfire.nio.git.daemon.port" value="9418" boot-time="false"/>
      <property name="org.uberfire.nio.git.daemon.hostport" value="9418" boot-time="false"/>
      
      <property name="org.uberfire.nio.git.ssh.port" value="8003" boot-time="false"/>
      <property name="org.uberfire.nio.git.ssh.hostport" value="8003" boot-time="false"/>
      <property name="org.uberfire.nio.git.ssh.host" value="nodeOne" />
      
      <property name="org.uberfire.metadata.index.dir" value="/tmp/jbpm/nodeone" boot-time="false"/>
      <property name="org.uberfire.nio.git.ssh.cert.dir" value="/tmp/jbpm/nodeone" boot-time="false"/>
      
      <property name="org.quartz.properties" value="/tmp/jbpm/quartz/quartz-db-postgres.properties" boot-time="false"/>
      
    </system-properties>
    Copy to Clipboard Toggle word wrap

    Ejemplo 6.8. Configuración de clúster nodeTwo

    <system-properties>
    				
      <property name="org.uberfire.nio.git.dir" value="/tmp/bpms/nodetwo" boot-time="false"/>
      <property name="jboss.node.name" value="nodeTwo" boot-time="false"/>
      
      <property name="org.uberfire.cluster.id" value="bpms-cluster" boot-time="false"/>
      <property name="org.uberfire.cluster.zk" value="server1:2181,server2:2181,server3:2181" boot-time="false"/>
      <property name="org.uberfire.cluster.local.id" value="nodeTwo_12346" boot-time="false"/>
      <property name="org.uberfire.cluster.vfs.lock" value="vfs-repo" boot-time="false"/>
      <property name="org.uberfire.cluster.autostart" value="true" boot-time="true"/>
      
      <property name="org.uberfire.nio.git.daemon.host" value="nodeTwo" />
      <property name="org.uberfire.nio.git.daemon.port" value="9418" boot-time="false"/>
      <property name="org.uberfire.nio.git.daemon.hostport" value="9418" boot-time="false"/>
      
      <property name="org.uberfire.nio.git.ssh.port" value="8003" boot-time="false"/>
      <property name="org.uberfire.nio.git.ssh.hostport" value="8003" boot-time="false"/>
      <property name="org.uberfire.nio.git.ssh.host" value="nodeTwo" />
      
      <property name="org.uberfire.metadata.index.dir" value="/tmp/jbpm/nodetwo" boot-time="false"/>
      <property name="org.uberfire.nio.git.ssh.cert.dir" value="/tmp/jbpm/nodetwo" boot-time="false"/>
      
      <property name="org.quartz.properties" value="/tmp/jbpm/quartz/quartz-db-postgres.properties" boot-time="false"/>				
    
    
    </system-properties>
    Copy to Clipboard Toggle word wrap

    Ejemplo 6.9. Configuración de clúster nodeThree

    <system-properties>
    				
      <property name="org.uberfire.nio.git.dir" value="/tmp/bpms/nodethree" boot-time="false"/>
      <property name="jboss.node.name" value="nodeThree" boot-time="false"/>
      
      <property name="org.uberfire.cluster.id" value="bpms-cluster" boot-time="false"/>
      <property name="org.uberfire.cluster.zk" value="server1:2181,server2:2181,server3:2181" boot-time="false"/>
      <property name="org.uberfire.cluster.local.id" value="nodeThree_12347" boot-time="false"/>
      <property name="org.uberfire.cluster.vfs.lock" value="vfs-repo" boot-time="false"/>
      <property name="org.uberfire.cluster.autostart" value="true" boot-time="true"/>
      
      <property name="org.uberfire.nio.git.daemon.host" value="nodeThree" />
      <property name="org.uberfire.nio.git.daemon.port" value="9418" boot-time="false"/>
      <property name="org.uberfire.nio.git.daemon.hostport" value="9418" boot-time="false"/>
      
      <property name="org.uberfire.nio.git.ssh.port" value="8003" boot-time="false"/>
      <property name="org.uberfire.nio.git.ssh.hostport" value="8003" boot-time="false"/>
      <property name="org.uberfire.nio.git.ssh.host" value="nodeThree" />
      
      <property name="org.uberfire.metadata.index.dir" value="/tmp/jbpm/nodethree" boot-time="false"/>
      <property name="org.uberfire.nio.git.ssh.cert.dir" value="/tmp/jbpm/nodethree" boot-time="false"/>
      
      <property name="org.quartz.properties" value="/tmp/jbpm/quartz/quartz-db-postgres.properties" boot-time="false"/>				
    
    
    </system-properties>
    Copy to Clipboard Toggle word wrap
  4. Agregue usuarios como se explica en la Guía de configuración y administración para Red Hat JBoss EAP y los usuarios de aplicaciones como se explica en la Guía de administración y configuración Red Hat JBoss BPM Suite .
  5. Inicie el servidor de aplicaciones:
    ]$ $JBOSS_HOME/bin/domain.sh
    Copy to Clipboard Toggle word wrap
  6. Verifique si los nodos están disponibles
Implemente la aplicación Business Central para sus servidores
  1. Cambie la persistencia predefinida de la aplicación a la base de datos requerida (PostgreSQL): en persistence.xml, aplique los siguientes cambios:
    1. el nombre de la fuente jta-data-source para la fuente definida en el servidor de aplicaciones (java:jboss/datasources/psbpmsDS)
    2. hibernate dialect para que coincida el dialecto de fuente de datos (org.hibernate.dialect.PostgreSQLDialect)
  2. Ingrese como usuario administrativo a la consola de administración de servidor de su dominio y agregue las nuevas implementaciones a través de la vista Runtime de la consola. Una vez la implementación es agregada al dominio, asígnela al grupo de servidor correcto (main-server-group).

Nota

Es importante que los usuarios verifiquen la unidad de implementación con cada miembro de clúster
Cuando se crea una unidad de implementación en el nodo de clúster, se tarda un tiempo antes de que sea distribuida entre todos los miembros de clúster. El estatus de implementación puede verificarse a través de la UI y REST, sin embargo, si la solicitud va al nodo donde la implementación fue emitida originalmente, la respuesta es deployed. Cualquier solicitud que se destine a esta unidad de implementación enviada a un miembro de clúster diferente falla con DeploymentNotFoundException.

Capítulo 7. Repositorios Maven

7.1. Acerca de Maven

Apache Maven es una herramienta distribuida de automatización de construcción utilizada en el desarrollo de aplicaciones Java para crear, administrar proyectos de software. Maven usa archivos XML llamados Modelo de objetos de proyecto (conocidos como POM, por sus siglas en inglés) para definir proyectos y administrar el proceso de construcción. Los archivos POM describen el módulo de proyectos y las dependencias de componentes, el orden de construcción y los destinos para el empacado del proyecto resultante y la salida. Esta acción garantiza que los proyectos sea construidos de una manera correcta y uniforme.
Maven usa repositorios para almacenar bibliotecas Java, complementos, y otros artefactos de construcción. Los repositorios pueden ser locales o remotos. Un repositorio local es una descarga de artefactos desde un repositorio remoto en caché en una máquina local. Un repositorio remoto es cualquier otro repositorio que ha sido accedido mediante protocolos comunes, tales como http:// cuando se localizan en un servidor HTTP, o file:// cuando se localizan en un servidor de archivos. El repositorio predeterminado es el repositorio Maven 2 Central Repository remoto público.
La configuración de Maven se realiza al modificar el archivo settings.xml. Usted puede configurar los parámetros globales de Maven en el archivo M2_HOME/conf/settings.xml, o los parámetros user-level en el archivo USER_HOME/.m2/settings.xml.
Para obtener más información sobre Maven, consulte Welcome to Apache Maven.
Para obtener más información sobre repositorios Maven, consulte Apache Maven Project - Introduction to Repositories.
Para obtener más información sobre los archivos POM de Maven, consulte Apache Maven Project POM Reference.

Nota

Su producto Red Hat JBoss ha sido construido con maven 3.0.x . Por lo tanto, esta es la versión Maven recomendada para la construcción de sus propias aplicaciones SwitchYard.

7.2. Acerca de los repositorios Maven provistos

Un set de repositorios que contienen artefactos requeridos para crear aplicaciones basadas en Red Hat JBoss BPM Suite se proporciona con este lanzamiento. Maven debe estar configurado para usar estos repositorios y el Repositorio Central Maven para proporcionar la funcionalidad de construcción correcta.
Dos sets intercambiables de repositorios garantizan la misma funcionalidad. El primer set está disponible para descargar y almacenar en un sistema de archivos locales, el segundo, se aloja en línea para usar como repositorios remotos. Si usted ha proporcionado la ubicación del archivo settings.xml de Maven durante la instalación, Maven ya estará configurado para usar repositorios en línea.

Importante

El set de repositorios remotos en una fuente previa de tecnología de componentes. Como tal, no está en el alcance de parches y únicamente tiene soporte para uso en un entorno de desarrollo. El uso del set de repositorios en línea en un entorno de producción es una fuente potencial de vulnerabilidades de seguridad y por lo tanto, no es un caso de uso con soporte. Para obtener más información, consulte https://access.redhat.com/site/maven-repository.
Visión General

Cuando no se pueden utilizar repositorios en línea, usted podrá descargar y configurar los repositorios locales requeridos

Procedimiento 7.1.

  1. Descargue los siguientes archivos ZIP que contienen los repositorios requeridos:
  2. Descomprima los archivos ZIP en un sitio arbitrario en un sistema de archivos local.
  3. Agregue entradas de los repositorios descomprimidos al archivo settings.xml de Maven. El siguiente ejemplo de código muestra un perfil con los repositorios , la configuración de autenticación para acceder a los repositorios, y una entrada de activación para el perfil:
    <?xml version="1.0" encoding="UTF-8" standalone="no"?>
    <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/xsd/settings-1.0.0.xsd">
      <localRepository/>
      <profiles>
        <!-- Profile with local repositories required by JBoss BRMS/JBoss BPM Suite -->
        <profile>
          <id>brms-bpms-local-profile</id>
          <repositories>
            <repository>
              <id>jboss-brms-bpmsuite-repository</id>
              <name>BRMS/BPMS 6.1.0 GA Repository</name>
              <url>file://<!-- path to the repository -->/jboss-brms-bpmsuite-6.1.0.GA-redhat-2-maven-repository/maven-repository</url>
              <layout>default</layout>
              <releases>
                <enabled>true</enabled>
                <updatePolicy>never</updatePolicy>
              </releases>
              <snapshots>
                <enabled>false</enabled>
                <updatePolicy>never</updatePolicy>
              </snapshots>
            </repository>
          </repositories>
          <pluginRepositories>
            <pluginRepository>
              <id>jboss-brms-bpmsuite-repository</id>
              <name>BRMS/BPMS 6.1.0 GA Repository</name>
              <url>file://<!-- path to the repository -->/jboss-brms-bpmsuite-6.1.0.GA-redhat-2-maven-repository/maven-repository</url>
              <layout>default</layout>
              <releases>
                <enabled>true</enabled>
                <updatePolicy>never</updatePolicy>
              </releases>
              <snapshots>
                <enabled>false</enabled>
                <updatePolicy>never</updatePolicy>
              </snapshots>
            </pluginRepository>
          </pluginRepositories>
        </profile>
      </profiles>
    
      <!-- Configuring pre-emptive authentication for the repository server -->
      <server>
        <id>brms-bpms-m2-repo</id>
        <username>admin</username>
        <password>admin</password>
        <configuration>
          <wagonProvider>httpclient</wagonProvider>
          <httpConfiguration>
            <all>
              <usePreemptive>true</usePreemptive>
            </all>
          </httpConfiguration>
        </configuration>
      </server>
      
      <!-- Alternative to enabling pre-emptive authentication - configuring 
           the Authorization HTTP header with Base64-encoded credentials
      <server>
        <id>brms-bpms-m2-repo</id>
        <configuration>
          <httpHeaders>
            <property>
              <name>Authorization</name>
              <value>Basic YWRtaW46YWRtaW4=</value>
            </property>
          </httpHeaders>
        </configuration>
      </server>
      -->
      
      <activeProfiles>
       <!-- Activation of the JBoss BRMS/JBoss BPM Suite profile -->
       <activeProfile>brms-bpms-local-profile</activeProfile>
      </activeProfiles>
    </settings>
    Copy to Clipboard Toggle word wrap
Resultado:

Los repositorios Maven son descargados, descomprimidos en un sistema de archivos local, registrados en el archivo settings.xml de Maven, y están listos para ser utilizados cuando se realizan las construcciones Maven.

Resolución de problemas

P: ¿Por qué sigo obteniendo errores al construir o implementar mis aplicaciones?
P: ¿Por qué JBoss Developer Studio está utilizando mi configuración de Maven antigua?
P:
¿Por qué sigo obteniendo errores al construir o implementar mis aplicaciones?
R:
Problema

Cuando construya o implemente un proyecto, fallará con uno o los dos errores siguientes:

  • [ERROR] Failed to execute goal on project PROJECT_NAME
  • Could not find artifact ARTIFACT_NAME

Causa

Su repositorio Maven local en caché podría contener artefactos obsoletos.

Resolución

Para resolver este problema, borre el repositorio local en caché – el directorio ~/.m2/repository/ en Linux o el directorio %SystemDrive%\Users\USERNAME\.m2\repository\ en Windows – y luego ejecute mvn clean install -U. Esta acción forzará a Maven a descargar las versiones correctas de artefactos necesarios para realizar una nueva construcción.

P:
¿Por qué JBoss Developer Studio está utilizando mi configuración de Maven antigua?
R:
Problema

Ha actualizado su configuración Maven, pero esta configuración no se refleja en JBoss Developer Studio.

Causa

Si JBoss Developer Studio está en ejecución en el momento en que modifica su archivo settings.xml de Maven, esa configuración no se reflejará en JBoss Developer Studio.

Resolución

Actualice los parámetros de Maven en el IDE. Desde el menú, seleccione VentanaPreferencias. En la ventana Preferencias, expanda Maven y seleccione Parámetros de usuario. Haga clic en el botón Actualizar parámetros para refrescar los parámetros de usuario Maven en JBoss Developer Studio.

Figura 7.1. Actualizar los parámetros de usuario de Maven

7.4. Configuración de Maven para usar los repositorios en línea

Los repositorios en línea requeridos para Red Hat JBoss BPM Suite se localizan en http://maven.repository.redhat.com/techpreview/all/.
Si no configuró el repositorio Maven durante la instalación, usted puede configurarlo mediante el siguiente procedimiento. (También es posible hacerlo con el archivo POM del proyecto, pero no se recomienda).

Procedimiento 7.2. Configuración de Maven para usar los repositorios en línea

  1. Agregue entradas a los repositorios en línea y la configuración de autenticación para acceder en el archivo settings.xml de Maven como se en el ejemplo de código a continuación:
    <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" 
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    
      <profiles>
        <!-- Profile with online repositories required by BRMS/BPMS -->
        <profile>
          <id>brms-bpms-online-profile</id>
          <repositories>
            <repository>
              <id>jboss-ga-repository</id>
              <url>http://maven.repository.redhat.com/techpreview/all</url>
              <releases>
                <enabled>true</enabled>
              </releases>
              <snapshots>
                <enabled>false</enabled>
              </snapshots>
            </repository>
          </repositories>
          <pluginRepositories>
            <pluginRepository>
              <id>jboss-ga-plugin-repository</id>
              <url>http://maven.repository.redhat.com/techpreview/all</url>
              <releases>
                <enabled>true</enabled>
              </releases>
              <snapshots>
                <enabled>false</enabled>
              </snapshots>
            </pluginRepository>
          </pluginRepositories>
        </profile>    
      </profiles>
      
      <!-- Configuring pre-emptive authentication for the repository server -->
      <server>
        <id>brms-bpms-m2-repo</id>
        <username>admin</username>
        <password>admin</password>
        <configuration>
          <wagonProvider>httpclient</wagonProvider>
          <httpConfiguration>
            <all>
              <usePreemptive>true</usePreemptive>
            </all>
          </httpConfiguration>
        </configuration>
      </server>
      
      <!-- Alternative to enabling pre-emptive authentication - configuring 
           the Authorization HTTP header with Base64-encoded credentials
      <server>
        <id>brms-bpms-m2-repo</id>
        <configuration>
          <httpHeaders>
            <property>
              <name>Authorization</name>
              <value>Basic YWRtaW46YWRtaW4=</value>
            </property>
          </httpHeaders>
        </configuration>
      </server>
      -->
    
      <activeProfiles>
        <!-- Activation of the BRMS/BPMS profile -->
        <activeProfile>brms-bpms-online-profile</activeProfile>
      </activeProfiles>
    
    </settings>
    Copy to Clipboard Toggle word wrap
  2. Si usted modificó el archivo settings.xml mientras JBoss Developer Studio estaba en ejecución, actualice los parámetros de Maven en el IDE. Desde el menú, seleccione VentanaPreferencias. En la ventana Preferencias, expanda Maven y seleccione Parámetros de usuario. Haga clic en el botón Actualizar parámetros para refrescar los parámetros de usuario Maven en JBoss Developer Studio.

    Figura 7.2. Actualizar los parámetros de usuario de Maven

Resultado:

Maven ha sido configurado para usar los repositorios en línea para su producto de Red Hat JBoss.

Importante

Si su repositorio Maven local en caché contiene artefactos desactualizados, podría encontrar alguno de los siguientes mensajes de errores de Maven cuando construya o implemente el proyecto:
  • Missing artifact ARTIFACT_NAME
  • [ERROR] Failed to execute goal on project PROJECT_NAME; Could not resolve dependencies for PROJECT_NAME
Para resolver este problema, borre el repositorio local en caché – el directorio ~/.m2/repository/ en Linux, o el directorio %SystemDrive%\Users \USERNAME\.m2\repository\ en Windows. Esta acción forzará a Maven a descargar las versiones correctas de artefactos necesarios para realizar una nueva construcción.

7.5. Administración de dependencias

Para poder utilizar las dependencias Maven correctas en su Red Hat JBoss BPM Suite project, debe agregar los archivos de la Lista de materiales (BOM) al archivo pom.xml del proyecto. La adición de los archivos BOM garantiza las versiones correctas de dependencias transitivas desde los repositorios Maven provistos se incluyen en el proyecto.
El repositorio Maven en 6.1.0 está diseñado para se utilizado únicamente en combinación con Maven Central y no se requieren otros repositorios.
Según los requerimientos del proyecto, declare las dependencias en su archivo POM en la sección de dependencias:
  • org.jboss.bom.brms:jboss-brms-bpmsuite-bom:VERSION: el BOM básico sin ningún soporte de Java EE6.
  • org.jboss.bom.brms:jboss-javaee-6.0-with-brms-bpmsuite:VERSION: proporciona soporte para Java EE6.

Capítulo 8. Red Hat JBoss Developer Studio

8.1. Red Hat JBoss Developer Studio

Red Hat JBoss Developer Studio es JBoss Integrated Development Environment (IDE) basado en Eclipse. Obtenga la versión más reciente de JBoss Developer Studio en Red Hat customer support portal en https://access.redhat.com. JBoss Developer Studio proporciona complementos con herramientas e interfaces para Red Hat JBoss BRMS y Red Hat JBoss BPM Suite. Estos complementos se basan en la versión de la comunidad de estos productos. Por lo tanto, JBoss BRMS plug-in se conoce como el Drools plug-in y JBoss BPM Suite plug-in se conoce como jBPM plug-in.
Consulte la documentación de Red Hat JBoss Developer Studio para obtener instrucciones de instalación y configuración.

Aviso

Debido a un problema en la forma como se manejan los nombres de reglas multibytes, debe verificar si la instancia de JBoss Developer Studio se inicia con el set de codificación del archivo para UTF-8. Para ello, modifique el archivo $JBDS_HOME/studio/jbdevstudio.ini y agregue la siguiente propiedad: "-Dfile.encoding=UTF-8"

8.2. Instalación de JBoss Developer Studio Plug-ins

Los Drools and jBPM plug-ins para JBoss Developer Studio están disponibles a través del sitio de actualización.

Procedimiento 8.1. Instale los Drools y jBPM JBoss Developer Studio Plug-in

  1. Inicie JBoss Developer Studio.
  2. Seleccione AyudaInstalar nuevo software.
  3. Haga clic en Añadir para ingresar el menú Agregar repositorio..
  4. Nombre el sitio de software en el campo Nombre y agregue el URL en el campo Ubicación: https://devstudio.jboss.com/updates/8.0/integration-stack/
  5. Haga clic en Aceptar.
  6. Seleccione la funcionalidad JBoss Business Process and Rule Development de las opciones disponibles, haga clic en Siguiente y luego Siguiente otra vez.
  7. Lea la licencia y acéptela seleccionando el botón de radio apropiado, luego haga clic en Terminar.
  8. Después de que la instalación de los complementos, reinicie JBoss Developer Studio.

8.3. Configuración del tiempo de ejecución Drools

Con el fin de utilizar el complemento Red Hat JBoss BRMS Red Hat JBoss Developer Studio 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 necesarias para la creación y ejecución de sus activos empresariales.

Procedimiento 8.2. Configuración del tiempo de ejecución JBoss BRMS

  1. Extraiga los archivos JAR localizados en el archivo jboss-brms-VERSION-engine.zip que usted puede descargar desde el Portal del cliente de Red Hat.
  2. Desde el menú JBoss Developer Studiot seleccione Ventana y haga clic en Preferencias.
  3. Seleccione DroolsTiempos de ejecución Drools.
  4. Haga clic en Añadir...; proporcione un nombre para el nuevo tiempo de ejecución y haga clic en Navegar para navegar al directorio en donde se encuentran los archivos de tiempo de ejecución en el paso 1. Haga clic en Aceptar para registrar el tiempo de ejecución seleccionado en JBDS.
  5. Indique el tiempo de ejecución que usted ha creado como el tiempo de ejecución Drools predeterminado haciendo clic en la casilla adyacente.
  6. Haga clic en Aceptar. Si tiene proyectos existentes, una ventana de diálogo le indicará que debe reiniciar JBoss Developer Studio para actualizar el tiempo de ejecución.

8.4. Configuración del servidor BPM Suite.

JBoss Developer Studio puede ser configurado para ejecutar el servidor Red Hat JBoss BPM Suite .

Procedimiento 8.3. Configuración del servidor

  1. Abra la vista jBPM seleccionando VentanaAbrir perspectivaOtra, seleccione jBPM y haga clic en Aceptar.
  2. Agregue la vista del servidor seleccionando VentanaMostrar perspectivaOtra... y seleccione ServidorServidores.
  3. Abra el menú del servidor haciendo clic con el botón derecho del ratón en el panel del servidor y seleccione NuevoServidor.
  4. Defina el servidor seleccionando JBoss Enterprise MiddlewareJBoss Enterprise Application Platform 6.4 y haga clic en Siguiente.
  5. Establezca el directorio de inicio haciendo clic en el botón Navegar. Navegue hasta el directorio de instalación y selecciónelo para JBoss EAP 6.4, el cual tiene instalado JBoss BPM Suite.
  6. Proporcione un nombre para el servidor en el campo Nombre, asegúrese de que el archivo de configuración esté definido y haga clic en Terminar.
Usted puede configurar JBoss Developer Studio para conectarse a un repositorio de activos Git central. El repositorio almacena reglas, modelos, funciones y procesos.
Puede clonar un repositorio Git remoto o importar un repositorio local Git.

Procedimiento 8.4. Clonación de un repositorio Git remoto

  1. Inicie el servidor Red Hat JBoss BRMS/BPM Suite (el que pueda aplicarse) al seleccionar el servidor desde la pestaña del servidor y haga clic en el icono 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 solamente. En estas plataformas, si sshd ya se inició entonces este comando fallará. En este caso, puede ignorar este paso.
    /sbin/service sshd start
    Copy to Clipboard Toggle word wrap
  3. En JBoss Developer Studio, seleccione ArchivoImportar... y navegue a la carpeta Git. Abra la carpeta Git para seleccionar Proyectos desde Git y haga clic en Siguiente.
  4. Seleccione la fuente del repositorio como Clonar URI y haga clic en Siguiente.
  5. Ingrese a información sobre el repositorio Git en la siguiente ventana y haga clic en Siguiente.

    Figura 8.1. Información sobre el repositorio Git

  6. Seleccione la rama que quiere importar en la siguiente ventana y haga clic en Siguiente.
  7. Para 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. Dele un nombre al proyecto y haga clic en Terminar.

Procedimiento 8.5. Importación de un repositorio local Git

  1. Inicie el servidor Red Hat JBoss BRMS/BPM Suite (el que pueda aplicarse) al seleccionar el servidor desde la pestaña del servidor y haga clic en el icono de inicio.
  2. En JBoss Developer Studio, seleccione ArchivoImportar... y navegue a la carpeta Git. Abra la carpeta Git para seleccionar Proyectos desde Git y haga clic en Siguiente.
  3. Seleccione la fuente del repositorio Repositorio local existente y haga clic en Siguiente.

    Figura 8.2. Información sobre el repositorio Git

  4. Seleccione el repositorio que va a configurar de la lista de repositorios disponibles y haga clic en Siguiente.
  5. En el diálogo que se abre, seleccione el botón de radio Importar como proyecto general desde el Asistente para grupo de importación de proyectos y haga clic en Siguiente. Nombre el proyecto y haga clic en Terminar.

    Figura 8.3. Asistente para importación de proyecto

Capítulo 9. Parches y actualización de Red Hat JBoss BPM Suite

9.1. Acerca de parches y actualización

Los parches Red Hat JBoss BPM Suite pueden ser una actualización asíncrona o una actualización planeada:
  • Actualizaciones asíncronas: parches individuales que se producen por fuera del ciclo normal de actualización del producto. Estas actualizaciones pueden incluir parches de seguridad así como otros parches individuales proporcionados por los servicios globales de soporte de Red Hat (GSS) para solucionar problemas específicos.
  • Actualizaciones planeadas: los parches acumulativos de un producto existente, que incluyen las actualizaciones desarrolladas anteriormente para esa versión del producto.
Los parches para Red Hat JBoss BPM Suite pueden descargarse desde https://access.redhat.com/downloads/.
Los siguientes archivos se incluyen como parte de un lanzamiento de parches JBoss BRMS y JBoss BPM Suite.
  • Clientes JBoss BRMS - jboss-brms-<version>-patch.zip
  • Clientes JBoss BPM Suite - jboss-bpmsuite-<version>-patch.zip
  • Actualizaciones de repositorios Maven (Tanto para clientes JBoss BRMS como para clientes JBoss BPM Suite) - jboss-brms-bpmsuite-<version>-incremental-maven-repository.zip

9.2. Aplicación de parches en Red Hat JBoss BPM Suite 6.1

En Red Hat JBoss BPM Suite, la herramienta de parches se distribuye como un archivo comprimido que incluye scripts .sh y .bat sencillos, que facilitan la aplicación automática de actualizaciones para una instalación JBoss BPM Suite 6.1 (o superior).

Importante

La herramienta de parches es para usar con JBoss BPM Suite 6.1 o superior, y no debería ser utilizada para versiones anteriores. Para obtener más información, consulte https://access.redhat.com/articles/1455733.
El script requiere dos parámetros obligatorios: <path-to-distribution-root> y <type-of-distribution>. Por ejemplo, el siguiente comando aplica las actualizaciones para el lote de JBoss EAP especificado:

Nota

Las actualizaciones de parches no se deben aplicar cuando se está ejecutando una instancia de Red Hat JBoss BPM Suite. Asegúrese de que el servidor sea apagado antes de ejecutar el siguiente comando.
$ ./apply-updates.sh ~/EAP_HOME/jboss-eap-6.4 eap6.x
Copy to Clipboard Toggle word wrap
A continuación, los tipos de distribución que cuentan con soporte:
  • eap6.x
  • eap6.x-bc
  • eap6.x-kie-server
  • eap6.x-dashbuilder
  • generic
  • generic-bc
  • generic-kie-server
  • generic-dashuilder
  • was8
  • was8-bc
  • was8-kie-server
  • was8-dashbuilder
  • wls12c
  • wls12c-bc
  • wls12c-kie-server
  • wls12c-dashbuilder
  • brms-engine
  • planner-engine
  • supplementary-tools
Los inicios rápidos y la herramienta de migración también se incluyen en el parche y están disponibles para descargar como un archivo ZIP.

Nota

Se incluyen únicamente las actualizaciones para BRMS/BPM Suite en la distribución del parche. Los parches de EAP deben aplicarse mediante el mecanismo de parches EAP. Consulte la Guía de instalación Red Hat JBoss EAP.

Funcionalidad de respaldo

Antes de aplicar las actualizaciones, el script de clientes crea un respaldo de la distribución especificada. Copia el archivo de distribución o el directorio en el subdirectorio backup/<current-timestamp>. El directorio de respaldo de nivel superior es creado en el mismo nivel de sistema de archivos que el script apply-updates.

Funcionalidad de lista negra

La herramienta de parches del cliente proporciona una funcionalidad de lista negra que le permite indicarle al script los archivos que no deben ser actualizados. Esta es una funcionalidad muy útil que le ayuda a evitar que sus archivos de configuración sean sobrescritos de forma automática en el proceso de actualización. Igualmente, usted puede especificar los archivos de no configuración, si se requiere.
Para especificar los archivos en lista negra, abra el archivo blacklist.txt que está presente dentro de la distribución de parches. Ingrese la ruta relativa a los archivos que no deben ser actualizados. Cada archivo debe especificarse en una línea individual.
# lines with a '#' are comment lines, like this one
# blank lines are ignored

# we have made changes to the web.xml that must be preserved
WEB-INF/web.xml

# this file has custom modifications
styles/base.css
Copy to Clipboard Toggle word wrap
Los archivos especificados en el archivo blacklist.txt que tienen el archivo de contenido actualizado, no son modificados por la herramienta de actualización. En su lugar, la herramienta copia el nuevo archivo, el archivo actualizado en la misma ubicación y le agrega el sufijo new. Por ejemplo, después de ejecutar la herramienta de parches, estos dos archivos existirán en la carpeta styles, continuando con el archivo blacklist.txt en el ejemplo de arriba.
$ ls styles
base.css base.css.new
Copy to Clipboard Toggle word wrap
Ahora es usted quien debe comparar los dos archivos y fusionar los cambios.
¿Qué sucede si hay archivos que ya no se distribuyen, pero que usted desea conservar? Póngalos también en el archivo blacklist.txt. La actualización de parches no los borra y en su lugar, creará un archivo marcador vacío con el sufijo removed. Dependerá de usted si desea mantenerlos o borrarlos manualmente.
Continuando con el ejemplo anterior, si el archivo base.css fue retirado y si usted lo tenía en la lista del archivo blacklist.txt, entonces después de ejecutar la herramienta de parches, el contenido de los estilos de directorio sería similar a:
$ ls styles
base.css base.css.removed
Copy to Clipboard Toggle word wrap

9.3. Corrección de otras plataformas y aplicaciones

Los comandos a continuación pueden ser utilizados para actualizar otras plataformas que cuentan con soporte y aplicaciones comunes en Red Hat JBoss BPM Suite.
Patch EAP 6.x Business Central WAR

$ ./apply-updates.[sh|bat] <some-path>/jboss-eap-6.4/standalone/deployments/business-central.war eap6.x-bc
Copy to Clipboard Toggle word wrap

Patch Generic KIE Server WAR

$ ./apply-updates.[sh|bat] <some-path-to-tomcat-home>/webapps/kie-server.war generic-kie-server
Copy to Clipboard Toggle word wrap

Patch Whole WebLogic 12c Bundle

$ ./apply-updates.[sh|bat] <path-to-unzipped-wls12c-bundle> wls12c
Copy to Clipboard Toggle word wrap

Patch Planner Engine Bundle

$ ./apply-updates.[sh|bat] <path-to-unzipped-planner-bundle> planner-engine
Copy to Clipboard Toggle word wrap

Apéndice A. Historia de revisiones

Historial de revisiones
Revisión 1.0.0-1.1Fri Dec 11 2015Red Hat Localization Services
Los archivos de traducción sincronizados con fuentes XML 1.0.0-1
Revisión 1.0.0-1Wed Aug 05 2015Petr Penicka
Construido de la especificación de contenido: 22832, Revisión: 759982 por ppenicka

Aviso Legal

Copyright © 2015 Red Hat, Inc.
This 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, OpenShift, 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.
The 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.
Red Hat logoGithubredditYoutubeTwitter

Aprender

Pruebe, compre y venda

Comunidades

Acerca de la documentación de Red Hat

Ayudamos a los usuarios de Red Hat a innovar y alcanzar sus objetivos con nuestros productos y servicios con contenido en el que pueden confiar. Explore nuestras recientes actualizaciones.

Hacer que el código abierto sea más inclusivo

Red Hat se compromete a reemplazar el lenguaje problemático en nuestro código, documentación y propiedades web. Para más detalles, consulte el Blog de Red Hat.

Acerca de Red Hat

Ofrecemos soluciones reforzadas que facilitan a las empresas trabajar en plataformas y entornos, desde el centro de datos central hasta el perímetro de la red.

Theme

© 2026 Red Hat
Volver arriba