jboss enterprise brms platform-5-brms administrator guide-es-es

61
Landmann JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Para administradores de JBoss Edición 5.2.0

Upload: leonardo-benitez

Post on 22-Oct-2015

72 views

Category:

Documents


7 download

TRANSCRIPT

Page 1: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Landmann

JBoss Enterprise BRMS Platform5Manual del administrador BRMS

Para administradores de JBossEdicioacuten 520

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

Para administradores de JBossEdicioacuten 520

Landmannrlandmannredhatcom

Legal Notice

Copyright copy 2010 Red Hat Inc

This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 30 UnportedLicense If you distribute this document or a modified version of it you must provide attribution to RedHat Inc and provide a link to the original If the document is modified all Red Hat trademarks must beremoved

Red Hat as the licensor of this document waives the right to enforce and agrees not to assert Section4d of CC-BY-SA to the fullest extent permitted by applicable law

Red Hat Red Hat Enterprise Linux the Shadowman logo JBoss MetaMatrix Fedora the Infinity Logoand RHCE are trademarks of Red Hat Inc registered in the United States and other countries

Linux reg is the registered trademark of Linus Torvalds in the United States and other countries

Java reg is a registered trademark of Oracle andor its affiliates

XFS reg is a trademark of Silicon Graphics International Corp or its subsidiaries in the United Statesandor other countries

MySQL reg is a registered trademark of MySQL AB in the United States the European Union and othercountries

Nodejs reg is an official trademark of Joyent Red Hat Software Collections is not formally related to orendorsed by the official Joyent Nodejs open source or commercial project

The OpenStack reg Word Mark and OpenStack Logo are either registered trademarksservice marks ortrademarksservice marks of the OpenStack Foundation in the United States and other countries andare used with the OpenStack Foundations permission We are not affiliated with endorsed orsponsored by the OpenStack Foundation or the OpenStack community

All other trademarks are the property of their respective owners

Abstract

Este documento proporciona instrucciones de instalacioacuten configuracioacuten y personalizacioacuten para JBossEnterprise BRMS Platform

Table of Contents

Prefacio1 Convenciones del Documento

11 Convenciones tipograacuteficas12 Convenciones del documento13 Notas y Advertencias

2 Coacutemo obtener ayuda y hacer sus comentarios21 iquestNecesita ayuda22 iexclNecesitamos sus comentarios

Capiacutetulo 1 Introduccioacuten11 Cosas nuevas en esta edicioacuten12 JBoss Enterprise BRMS Platform

Capiacutetulo 2 Instalacioacuten de una21 Paquetes software22 Instrucciones de instalacioacuten

221 Instale el paquete autoacutenomo222 Instalar el paquete implementable223 Instalar y habilitar ModeShape

23 Inicio de sesioacuten por primera vez24 Inicio de sesioacuten resolucioacuten de problemas

Capiacutetulo 3 Localizacioacuten

Capiacutetulo 4 Configuracioacuten de la base de datos41 Configuracioacuten de la base de datos para Apache Jackrabbit

411 Configure la base de datos Workspace412 Configurar la base de datos Versions413 Buacutesqueda y uso de iacutendices

42 la configuracioacuten de la base de datos para ModeShape43 Configuracioacuten del repositorio

431 Cambiar la ubicacioacuten del repositorio JackRabbit432 Configure BRMS para utilizar un RDBMS externo

Capiacutetulo 5 Administracioacuten de datos51 Copia de seguridad de datos52 Importacioacuten y exportacioacuten53 Migracioacuten de datos entre versiones de BRMS54 Re-construccioacuten de paquetes binarios

Capiacutetulo 6 Seguridad61 Autenticacioacuten

611 Ejemplo de autenticacioacuten UserRolesLoginModule612 Ejemplo de autenticacioacuten LDAP

62 Autorizacioacuten63 Firma de paquetes de reglas

631 Configuracioacuten de propiedades de serializacioacuten

Capiacutetulo 7 Registros

Capiacutetulo 8 Personalizacioacuten81 Personalizar la interfaz del usuario82 Personalizacioacuten de selectores para la construccioacuten de paquetes

44456667

888

99

101012141819

21

232324242526262628

3131313133

34343536384145

4 7

4 84848

Table of Contents

1

Capiacutetulo 9 Monitoreamiento91 Instale el plug-in JBoss Operations Network92 Descubra la instancia BRMS

Implementacioacuten de JBoss BRMS en EWS

Instalacioacuten de Apache Ant

Ejemplo de configuraciones del administrador de persistencia

Historial de revisiones

505051

52

54

56

58

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

2

Table of Contents

3

Prefacio

1 Convenciones del DocumentoEste manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atencioacutensobre ciertas partes especiacuteficas de informacioacuten

En ediciones PDF y de papel este manual utiliza tipos de letra procedentes de Liberation FontsLiberation Fonts tambieacuten se utilizan en ediciones de HTML si estaacuten instalados en su sistema Si no semuestran tipografiacuteas alternativas pero equivalentes Nota Red Hat Enterprise Linux 5 y siguientesincluyen Liberation Fonts predeterminadas

11 Convenciones tipograacuteficasSe utilizan cuatro convenciones tipograacuteficas para llamar la atencioacuten sobre palabras o frasesespeciacuteficas Dichas convenciones y las circunstancias en que se aplican son las siguientes

Negrita monoespaciado

Utilizado para resaltar la entrada del sistema incluyendo los comandos de shell nombres de archivos yrutas Tambieacuten sirve para resaltar teclas y combinaciones de teclas Por ejemplo

Para ver el contenido del archivo my_next_bestselling_novel en su directorio actualde trabajo escriba el comando cat my_next_bestselling_novel en el inteacuterprete decomandos de shell y pulse Enter para ejecutar el comando

El ejemplo anterior incluye un nombre de archivo un comando de shell y una tecla Todo se presentaen negrita-monoespaciado y distinguible gracias al contexto

Las combinaciones de teclas se pueden distinguir de las individuales con el signo maacutes que conectacada partee de la combinacioacuten de tecla Por ejemplo

Pulse Enter para ejecutar el comando

Pulse Ctrl+Alt+F2 para pasar a una terminal virtual

El primer ejemplo resalta una tecla particular a pulsar El segundo ejemplo resalta una combinacioacuten deteclas un set de tres teclas pulsadas simultaacuteneamente

Si se discute el coacutedigo fuente los nombres de las clase los meacutetodos las funciones los nombres devariables y valores de retorno mencionados dentro de un paacuterrafo seraacuten presentados en Negrita-monoespaciado Por ejemplo

Las clases de archivo relacionadas incluyen filename para sistema de archivos filepara archivos y dir para directorios Cada clase tiene su propio conjunto asociado depermisos

Negrita proporcional

Esta denota palabras o frases encontradas en un sistema incluyendo nombres de aplicacioacuten texto decuadro de diaacutelogo botones etiquetados etiquetas de cajilla de verificacioacuten y botoacuten de radio tiacutetulos demenuacute y tiacutetulos del submenuacute Por ejemplo

Seleccione Sistema rarr Preferencias rarr Ratoacuten desde la barra del menuacute principal paralanzar Preferencias de ratoacuten En la pestantildea de Botones seleccione la cajilla de ratoacuten

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

4

de mano izquierda y luego haga clic en Cerrar para cambiar el botoacuten principal delratoacuten de la izquierda a la derecha (adecuando el ratoacuten para la mano izquierda)

Para insertar un caraacutecter especial en un archivo gedit seleccione Aplicaciones rarrAccesorios rarr Mapa de caracteres de la barra del menuacute Luego seleccione Buacutesquedararr Buscarhellip de la barra del menuacute de Mapa de caracteres escriba el nombre delcaraacutecter en el campo de Buacutesqueda y haga clic en Siguiente El caraacutecter que buscoacute seraacuteresaltado en la Tabla de caracteres Haga doble clic en ese caraacutecter resaltado paracolocarlo en el campo de Texto a copiar y luego haga clic en el botoacuten Copiar Ahoraregrese al documento y elija Modificar rarr Pegar de la barra de menuacute de gedit

El texto anterior incluye nombres de aplicacioacuten nombres y elementos del menuacute de todo el sistemanombres de menuacute de aplicaciones especiacuteficas y botones y texto hallados dentro de una interfaz graacuteficade usuario todos presentados en negrita proporcional y distinguibles por contexto

Itaacutelicas-negrita monoespaciado o Itaacutelicas-negrita proporcional

Ya sea negrita monoespaciado o negrita proporcional la adicioacuten de itaacutelicas indica texto reemplazable ovariable Las itaacutelicas denotan texto que usted no escribe literalmente o texto mostrado que cambiadependiendo de la circunstancia Por ejemplo

Para conectar a una maacutequina remota utilizando ssh teclee ssh nombre de usuariodominionombre en un inteacuterprete de comandos de shell Si la maacutequina remotaes examplecom y su nombre de usuario en esa maacutequina es john teclee ssh johnexamplecom

El comando mount -o remount file-system remonta el sistema de archivo llamadoPor ejemplo para volver a montar el sistema de archivo home el comando es mount -o remount home

Para ver la versioacuten de un paquete actualmente instalado utilice el comando rpm -q paquete Eacuteste entregaraacute el resultado siguiente paquete-versioacuten-lanzamiento

Observe que las palabras resaltadas en itaacutelicas mdash nombre de usuario dominionombre sistema dearchivo paquete versioacuten y lanzamiento Cada palabra es un marcador de posicioacuten ya sea de texto aingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema

Aparte del uso estaacutendar para presentar el tiacutetulo de un trabajo las itaacutelicas denotan el primer uso de unteacutermino nuevo e importante Por ejemplo

Publican es un sistema de publicacioacuten de DocBook

12 Convenciones del documentoLos mensajes de salida de la terminal o fragmentos de coacutedigo fuente se distinguen visualmente deltexto circundante

Los mensajes de salida enviados a una terminal se muestran en romano monoespaciado y sepresentan asiacute

books Desktop documentation drafts mss photos stuff svnbooks_tests Desktop1 downloads images notes scripts svgs

Los listados de coacutedigo fuente tambieacuten se muestran en romano monoespaciado pero se presentany resaltan de la siguiente manera

Prefacio

5

package orgjbossbookjcaex1

import javaxnamingInitialContext

public class ExClient public static void main(String args[]) throws Exception InitialContext iniCtx = new InitialContext() Object ref = iniCtxlookup(EchoBean) EchoHome home = (EchoHome) ref Echo echo = homecreate()

Systemoutprintln(Created Echo)

Systemoutprintln(Echoecho(Hello) = + echoecho(Hello))

13 Notas y AdvertenciasFinalmente utilizamos tres estilos visuales para llamar la atencioacuten sobre la informacioacuten que de otromodo se podriacutea pasar por alto

Nota

Una nota es una sugerencia atajo o enfoque alternativo para una tarea determinada Ignorar unanota no deberiacutea tener consecuencias negativas pero podriacutea perderse de algunos trucos quepueden facilitarle las cosas

Importante

Los cuadros con el tiacutetulo de importante dan detalles de cosas que se pueden pasar por altofaacutecilmente cambios de configuracioacuten uacutenicamente aplicables a la sesioacuten actual o servicios quenecesitan reiniciarse antes de que se aplique una actualizacioacuten Ignorar estos cuadros noocasionaraacute peacuterdida de datos pero puede causar enfado y frustracioacuten

Aviso

Las advertencias no deben ignorarse Ignorarlas muy probablemente ocasionaraacute peacuterdida dedatos

2 Coacutemo obtener ayuda y hacer sus comentarios

21 iquestNecesita ayudaSi encuentra dificultades con alguno de los procedimientos descritos en este documento visite el Portaldel cliente de Red Hat en httpaccessredhatcom A traveacutes del portal del cliente usted podraacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

6

buscar o navegar a traveacutes de la base de artiacuteculos de soporte teacutecnico sobre productos de Red Hat

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

acceder a otra documentacioacuten del producto

Red Hat alberga una lista grande de correos electroacutenicos para discutir sobre software de Red Hat ytecnologiacutea Encontraraacute un listado de las listas de correo disponibles al puacuteblico enhttpswwwredhatcommailmanlistinfo Haga clic en el nombre de la lista a la que quiera suscribirse opara acceder a los archivos de listados

22 iexclNecesitamos sus comentariosSi encuentra algun error o si se le ocurre una manera de mejorar este manual nos encantariacutea escucharsus sugerencias Complete un reporte en Bugzilla frente al producto JBoss Enterprise BRMS Platform 5 y el componente doc-BRMS_Administrator_Guide El siguiente enlace le llevaraacute aun reporte de error ya completado para este producto httpbugzillaredhatcom

Llene la siguiente plantilla en el campo de Description de Bugzilla Sea tan especifico como le seaposible al describir el problema esto ayudaraacute a asegurarnos de que lo podemos solucionarraacutepidamente

URL del documento

Nuacutemero de la seccioacuten y nombre

Describa el problema

Sugerencias para mejorar

Informacioacuten adicional

Aseguacuterese de darnos su nombre para poder darle todo el creacutedito por reportar el problema

Prefacio

7

Capiacutetulo 1 Introduccioacuten

11 Cosas nuevas en esta edicioacutenTabla 11 Cosas nuevas en esta edicioacuten

Funcionalidad Cambio

Seccioacuten 223 ldquo Instalar y habilitar ModeShaperdquo Una nueva seccioacuten sobre la instalacioacuten deModeshape como repositorio

Seccioacuten 42 ldquo la configuracioacuten de la base dedatos para ModeShaperdquo

Una nueva seccioacuten sobre la configuracioacuten de unafuente de datos para Modeshape

Seccioacuten 432 ldquo Configure BRMS para utilizar unRDBMS externordquo

Una nueva seccioacuten sobre la configuracioacuten deBRMS para utilizar un RDBMS externo

Capiacutetulo 9 Monitoreamiento Un nuevo capiacutetulo sobre el monitoreamiento deBRMS con un plug-in de Jboss OperationsNetwork

Apeacutendice A Implementacioacuten de JBoss BRMS enEWS

Un nuevo apeacutendice con instrucciones parainstalar JBoss BRMS en Jboss Enterprise WebServer

12 JBoss Enterprise BRMS PlatformJBoss Enterprise BRMS Platform es un sistema de administracioacuten de reglas empresariales basado enJBoss Rules Proporciona una solucioacuten multi-usuario del lado del servidor para la administracioacutenalmacenamiento modificacioacuten e implementacioacuten de reglas y otros activos de JBoss Rules Se brinda unainterfaz de usuario basado en la web asiacute como integracioacuten para JBoss Developer Studio 4

Importante

En varios lugares de JBoss Enterprise BRMS Platform y de su documentacioacuten se refiere aGuvnor Drools Guvnor es el nombre del proyecto de coacutedigo abierto sobre el cual se haconstruiacutedo JBoss Enterprise BRMS Platform Las referencias a Guvnor permanecen en la API lasURLs y en las herramientas de JBoss Developer Studio

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

8

Capiacutetulo 2 Instalacioacuten de unaEn este capiacutetulo aprenderaacute a instalar la plataforma JBoss Enterprise BRMS

JBoss Enterprise BRMS Platform estaacute soportada en diferentes configuraciones del sistema Puedeencoentrar una lista completa de todos los servidores de aplicaciones Java soportados Maacutequinasvirtuales Java y servidores de bases de datos enhttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

Ademaacutes de un servidor de aplicaciones Java una maacutequina virtual Java y un sistema operativosoportados el implementar BRMS en un entorno de produccioacuten requiere un servidor de base de datossoportado para el almacenamiento de activps de reglas

21 Paquetes softwarePuede descargar JBoss Enterprise BRMS Platform del portal de soporte al cleinte de Red Hat enhttpsaccessredhatcom navegando a Descargas Plataforma BRMS y luego seleccionar laversioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombres depaquetes para 520 pero tambieacuten aplican a versiones anteriores excepto donde se observa que no

JBoss Enterprise BRMS Platform se encuentra disponible en dos paquetes diferentes

Paquete autoacutenomoEste paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMSPlatform ya implementado y no requiere un servidor de aplicaciones ya existente

El paquete autoacutenomo estaacute disponible con la versioacuten 510 y posteriores

Si descarga la versioacuten 510 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 51

Aplicacioacuten web JBoss Enterprise BRMS Platform 510 implementado en los perfiles default y production

Si descarga la versioacuten 520 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 511

Aplicacioacuten web JBoss Enterprise BRMS Platform 520 implementado en los perfiles default y production

Consulte Seccioacuten 221 ldquo Instale el paquete autoacutenomordquo y alliacute encontraraacute las instrucciones parainstalar estos paquetes

Paquete implementableEl paquete implementable es un archivo ZIP que contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform empacada como un archivo WAR que se debe implementar en un servidor deaplicaciones soportado ya existente El paquete ZIP tambieacuten contiene componentes opcionales

El paquete implementable contiene los siguientes archivos

jboss-brms-managerzip - la aplicacioacuten web JBoss Enterprise BRMS Platform

jboss-brms-enginezip - las bibliotecas de clientes JBoss Enterprise BRMS Platform

modeshapezip - los archivos necesarios para instalar el repositorio ModeShape

Capiacutetulo 2 Instalacioacuten de una

9

Nota

modeshapezip solo se incluye en la descarga 52 como avance de tecnologiacutea

Consulte Seccioacuten 222 ldquo Instalar el paquete implementablerdquo para ver las instrucciones de coacutemoinstalar este paquete

22 Instrucciones de instalacioacutenLea esta seccioacuten para aprender coacutemo instalar JBoss Enterprise BRMS Platform Siga las instruccionespara el paquete relevante autoacutenomo o implementable

Los pasos opcionales de instalacioacuten estaacute etiquetados como tal y se refieren a los capiacutetulos de estemanual que contienen mayor informacioacuten

221 Instale el paquete autoacutenomoEl paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform yaimplementado como un fichero explotado Siga el procedimiento a continuacioacuten para instalarlo yconfigurarlo

Nota

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para cualquier configuracioacutenadicional requerida para su entorno especifico httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

Procedimiento 21 Instale el paquete autoacutenomo

1 DescargueDescargue el archivo zip del paquete autoacutenomo del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom Navegue a Descargas luego Plataforma BRMS y luego seleccionela versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombresde paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos de que seobserve lo opuesto

2 ExtraacuteigaEl paquete autoacutenomo contiene un directorio uacutenico que contiene la instalacioacuten de JBoss EnterpriseWeb Platform con la aplicaicoacuten web JBoss Enterprise BRMS Platform ya implementada Extraiga elcontenido del archivo zip al directorio en donde se instalaraacute

[localhost ]$ unzip brms-standalone-520zip

JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms-standalone-520jboss-as-webserverPROFILEdeployjboss-brmswar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

10

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 2: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

Para administradores de JBossEdicioacuten 520

Landmannrlandmannredhatcom

Legal Notice

Copyright copy 2010 Red Hat Inc

This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 30 UnportedLicense If you distribute this document or a modified version of it you must provide attribution to RedHat Inc and provide a link to the original If the document is modified all Red Hat trademarks must beremoved

Red Hat as the licensor of this document waives the right to enforce and agrees not to assert Section4d of CC-BY-SA to the fullest extent permitted by applicable law

Red Hat Red Hat Enterprise Linux the Shadowman logo JBoss MetaMatrix Fedora the Infinity Logoand RHCE are trademarks of Red Hat Inc registered in the United States and other countries

Linux reg is the registered trademark of Linus Torvalds in the United States and other countries

Java reg is a registered trademark of Oracle andor its affiliates

XFS reg is a trademark of Silicon Graphics International Corp or its subsidiaries in the United Statesandor other countries

MySQL reg is a registered trademark of MySQL AB in the United States the European Union and othercountries

Nodejs reg is an official trademark of Joyent Red Hat Software Collections is not formally related to orendorsed by the official Joyent Nodejs open source or commercial project

The OpenStack reg Word Mark and OpenStack Logo are either registered trademarksservice marks ortrademarksservice marks of the OpenStack Foundation in the United States and other countries andare used with the OpenStack Foundations permission We are not affiliated with endorsed orsponsored by the OpenStack Foundation or the OpenStack community

All other trademarks are the property of their respective owners

Abstract

Este documento proporciona instrucciones de instalacioacuten configuracioacuten y personalizacioacuten para JBossEnterprise BRMS Platform

Table of Contents

Prefacio1 Convenciones del Documento

11 Convenciones tipograacuteficas12 Convenciones del documento13 Notas y Advertencias

2 Coacutemo obtener ayuda y hacer sus comentarios21 iquestNecesita ayuda22 iexclNecesitamos sus comentarios

Capiacutetulo 1 Introduccioacuten11 Cosas nuevas en esta edicioacuten12 JBoss Enterprise BRMS Platform

Capiacutetulo 2 Instalacioacuten de una21 Paquetes software22 Instrucciones de instalacioacuten

221 Instale el paquete autoacutenomo222 Instalar el paquete implementable223 Instalar y habilitar ModeShape

23 Inicio de sesioacuten por primera vez24 Inicio de sesioacuten resolucioacuten de problemas

Capiacutetulo 3 Localizacioacuten

Capiacutetulo 4 Configuracioacuten de la base de datos41 Configuracioacuten de la base de datos para Apache Jackrabbit

411 Configure la base de datos Workspace412 Configurar la base de datos Versions413 Buacutesqueda y uso de iacutendices

42 la configuracioacuten de la base de datos para ModeShape43 Configuracioacuten del repositorio

431 Cambiar la ubicacioacuten del repositorio JackRabbit432 Configure BRMS para utilizar un RDBMS externo

Capiacutetulo 5 Administracioacuten de datos51 Copia de seguridad de datos52 Importacioacuten y exportacioacuten53 Migracioacuten de datos entre versiones de BRMS54 Re-construccioacuten de paquetes binarios

Capiacutetulo 6 Seguridad61 Autenticacioacuten

611 Ejemplo de autenticacioacuten UserRolesLoginModule612 Ejemplo de autenticacioacuten LDAP

62 Autorizacioacuten63 Firma de paquetes de reglas

631 Configuracioacuten de propiedades de serializacioacuten

Capiacutetulo 7 Registros

Capiacutetulo 8 Personalizacioacuten81 Personalizar la interfaz del usuario82 Personalizacioacuten de selectores para la construccioacuten de paquetes

44456667

888

99

101012141819

21

232324242526262628

3131313133

34343536384145

4 7

4 84848

Table of Contents

1

Capiacutetulo 9 Monitoreamiento91 Instale el plug-in JBoss Operations Network92 Descubra la instancia BRMS

Implementacioacuten de JBoss BRMS en EWS

Instalacioacuten de Apache Ant

Ejemplo de configuraciones del administrador de persistencia

Historial de revisiones

505051

52

54

56

58

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

2

Table of Contents

3

Prefacio

1 Convenciones del DocumentoEste manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atencioacutensobre ciertas partes especiacuteficas de informacioacuten

En ediciones PDF y de papel este manual utiliza tipos de letra procedentes de Liberation FontsLiberation Fonts tambieacuten se utilizan en ediciones de HTML si estaacuten instalados en su sistema Si no semuestran tipografiacuteas alternativas pero equivalentes Nota Red Hat Enterprise Linux 5 y siguientesincluyen Liberation Fonts predeterminadas

11 Convenciones tipograacuteficasSe utilizan cuatro convenciones tipograacuteficas para llamar la atencioacuten sobre palabras o frasesespeciacuteficas Dichas convenciones y las circunstancias en que se aplican son las siguientes

Negrita monoespaciado

Utilizado para resaltar la entrada del sistema incluyendo los comandos de shell nombres de archivos yrutas Tambieacuten sirve para resaltar teclas y combinaciones de teclas Por ejemplo

Para ver el contenido del archivo my_next_bestselling_novel en su directorio actualde trabajo escriba el comando cat my_next_bestselling_novel en el inteacuterprete decomandos de shell y pulse Enter para ejecutar el comando

El ejemplo anterior incluye un nombre de archivo un comando de shell y una tecla Todo se presentaen negrita-monoespaciado y distinguible gracias al contexto

Las combinaciones de teclas se pueden distinguir de las individuales con el signo maacutes que conectacada partee de la combinacioacuten de tecla Por ejemplo

Pulse Enter para ejecutar el comando

Pulse Ctrl+Alt+F2 para pasar a una terminal virtual

El primer ejemplo resalta una tecla particular a pulsar El segundo ejemplo resalta una combinacioacuten deteclas un set de tres teclas pulsadas simultaacuteneamente

Si se discute el coacutedigo fuente los nombres de las clase los meacutetodos las funciones los nombres devariables y valores de retorno mencionados dentro de un paacuterrafo seraacuten presentados en Negrita-monoespaciado Por ejemplo

Las clases de archivo relacionadas incluyen filename para sistema de archivos filepara archivos y dir para directorios Cada clase tiene su propio conjunto asociado depermisos

Negrita proporcional

Esta denota palabras o frases encontradas en un sistema incluyendo nombres de aplicacioacuten texto decuadro de diaacutelogo botones etiquetados etiquetas de cajilla de verificacioacuten y botoacuten de radio tiacutetulos demenuacute y tiacutetulos del submenuacute Por ejemplo

Seleccione Sistema rarr Preferencias rarr Ratoacuten desde la barra del menuacute principal paralanzar Preferencias de ratoacuten En la pestantildea de Botones seleccione la cajilla de ratoacuten

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

4

de mano izquierda y luego haga clic en Cerrar para cambiar el botoacuten principal delratoacuten de la izquierda a la derecha (adecuando el ratoacuten para la mano izquierda)

Para insertar un caraacutecter especial en un archivo gedit seleccione Aplicaciones rarrAccesorios rarr Mapa de caracteres de la barra del menuacute Luego seleccione Buacutesquedararr Buscarhellip de la barra del menuacute de Mapa de caracteres escriba el nombre delcaraacutecter en el campo de Buacutesqueda y haga clic en Siguiente El caraacutecter que buscoacute seraacuteresaltado en la Tabla de caracteres Haga doble clic en ese caraacutecter resaltado paracolocarlo en el campo de Texto a copiar y luego haga clic en el botoacuten Copiar Ahoraregrese al documento y elija Modificar rarr Pegar de la barra de menuacute de gedit

El texto anterior incluye nombres de aplicacioacuten nombres y elementos del menuacute de todo el sistemanombres de menuacute de aplicaciones especiacuteficas y botones y texto hallados dentro de una interfaz graacuteficade usuario todos presentados en negrita proporcional y distinguibles por contexto

Itaacutelicas-negrita monoespaciado o Itaacutelicas-negrita proporcional

Ya sea negrita monoespaciado o negrita proporcional la adicioacuten de itaacutelicas indica texto reemplazable ovariable Las itaacutelicas denotan texto que usted no escribe literalmente o texto mostrado que cambiadependiendo de la circunstancia Por ejemplo

Para conectar a una maacutequina remota utilizando ssh teclee ssh nombre de usuariodominionombre en un inteacuterprete de comandos de shell Si la maacutequina remotaes examplecom y su nombre de usuario en esa maacutequina es john teclee ssh johnexamplecom

El comando mount -o remount file-system remonta el sistema de archivo llamadoPor ejemplo para volver a montar el sistema de archivo home el comando es mount -o remount home

Para ver la versioacuten de un paquete actualmente instalado utilice el comando rpm -q paquete Eacuteste entregaraacute el resultado siguiente paquete-versioacuten-lanzamiento

Observe que las palabras resaltadas en itaacutelicas mdash nombre de usuario dominionombre sistema dearchivo paquete versioacuten y lanzamiento Cada palabra es un marcador de posicioacuten ya sea de texto aingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema

Aparte del uso estaacutendar para presentar el tiacutetulo de un trabajo las itaacutelicas denotan el primer uso de unteacutermino nuevo e importante Por ejemplo

Publican es un sistema de publicacioacuten de DocBook

12 Convenciones del documentoLos mensajes de salida de la terminal o fragmentos de coacutedigo fuente se distinguen visualmente deltexto circundante

Los mensajes de salida enviados a una terminal se muestran en romano monoespaciado y sepresentan asiacute

books Desktop documentation drafts mss photos stuff svnbooks_tests Desktop1 downloads images notes scripts svgs

Los listados de coacutedigo fuente tambieacuten se muestran en romano monoespaciado pero se presentany resaltan de la siguiente manera

Prefacio

5

package orgjbossbookjcaex1

import javaxnamingInitialContext

public class ExClient public static void main(String args[]) throws Exception InitialContext iniCtx = new InitialContext() Object ref = iniCtxlookup(EchoBean) EchoHome home = (EchoHome) ref Echo echo = homecreate()

Systemoutprintln(Created Echo)

Systemoutprintln(Echoecho(Hello) = + echoecho(Hello))

13 Notas y AdvertenciasFinalmente utilizamos tres estilos visuales para llamar la atencioacuten sobre la informacioacuten que de otromodo se podriacutea pasar por alto

Nota

Una nota es una sugerencia atajo o enfoque alternativo para una tarea determinada Ignorar unanota no deberiacutea tener consecuencias negativas pero podriacutea perderse de algunos trucos quepueden facilitarle las cosas

Importante

Los cuadros con el tiacutetulo de importante dan detalles de cosas que se pueden pasar por altofaacutecilmente cambios de configuracioacuten uacutenicamente aplicables a la sesioacuten actual o servicios quenecesitan reiniciarse antes de que se aplique una actualizacioacuten Ignorar estos cuadros noocasionaraacute peacuterdida de datos pero puede causar enfado y frustracioacuten

Aviso

Las advertencias no deben ignorarse Ignorarlas muy probablemente ocasionaraacute peacuterdida dedatos

2 Coacutemo obtener ayuda y hacer sus comentarios

21 iquestNecesita ayudaSi encuentra dificultades con alguno de los procedimientos descritos en este documento visite el Portaldel cliente de Red Hat en httpaccessredhatcom A traveacutes del portal del cliente usted podraacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

6

buscar o navegar a traveacutes de la base de artiacuteculos de soporte teacutecnico sobre productos de Red Hat

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

acceder a otra documentacioacuten del producto

Red Hat alberga una lista grande de correos electroacutenicos para discutir sobre software de Red Hat ytecnologiacutea Encontraraacute un listado de las listas de correo disponibles al puacuteblico enhttpswwwredhatcommailmanlistinfo Haga clic en el nombre de la lista a la que quiera suscribirse opara acceder a los archivos de listados

22 iexclNecesitamos sus comentariosSi encuentra algun error o si se le ocurre una manera de mejorar este manual nos encantariacutea escucharsus sugerencias Complete un reporte en Bugzilla frente al producto JBoss Enterprise BRMS Platform 5 y el componente doc-BRMS_Administrator_Guide El siguiente enlace le llevaraacute aun reporte de error ya completado para este producto httpbugzillaredhatcom

Llene la siguiente plantilla en el campo de Description de Bugzilla Sea tan especifico como le seaposible al describir el problema esto ayudaraacute a asegurarnos de que lo podemos solucionarraacutepidamente

URL del documento

Nuacutemero de la seccioacuten y nombre

Describa el problema

Sugerencias para mejorar

Informacioacuten adicional

Aseguacuterese de darnos su nombre para poder darle todo el creacutedito por reportar el problema

Prefacio

7

Capiacutetulo 1 Introduccioacuten

11 Cosas nuevas en esta edicioacutenTabla 11 Cosas nuevas en esta edicioacuten

Funcionalidad Cambio

Seccioacuten 223 ldquo Instalar y habilitar ModeShaperdquo Una nueva seccioacuten sobre la instalacioacuten deModeshape como repositorio

Seccioacuten 42 ldquo la configuracioacuten de la base dedatos para ModeShaperdquo

Una nueva seccioacuten sobre la configuracioacuten de unafuente de datos para Modeshape

Seccioacuten 432 ldquo Configure BRMS para utilizar unRDBMS externordquo

Una nueva seccioacuten sobre la configuracioacuten deBRMS para utilizar un RDBMS externo

Capiacutetulo 9 Monitoreamiento Un nuevo capiacutetulo sobre el monitoreamiento deBRMS con un plug-in de Jboss OperationsNetwork

Apeacutendice A Implementacioacuten de JBoss BRMS enEWS

Un nuevo apeacutendice con instrucciones parainstalar JBoss BRMS en Jboss Enterprise WebServer

12 JBoss Enterprise BRMS PlatformJBoss Enterprise BRMS Platform es un sistema de administracioacuten de reglas empresariales basado enJBoss Rules Proporciona una solucioacuten multi-usuario del lado del servidor para la administracioacutenalmacenamiento modificacioacuten e implementacioacuten de reglas y otros activos de JBoss Rules Se brinda unainterfaz de usuario basado en la web asiacute como integracioacuten para JBoss Developer Studio 4

Importante

En varios lugares de JBoss Enterprise BRMS Platform y de su documentacioacuten se refiere aGuvnor Drools Guvnor es el nombre del proyecto de coacutedigo abierto sobre el cual se haconstruiacutedo JBoss Enterprise BRMS Platform Las referencias a Guvnor permanecen en la API lasURLs y en las herramientas de JBoss Developer Studio

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

8

Capiacutetulo 2 Instalacioacuten de unaEn este capiacutetulo aprenderaacute a instalar la plataforma JBoss Enterprise BRMS

JBoss Enterprise BRMS Platform estaacute soportada en diferentes configuraciones del sistema Puedeencoentrar una lista completa de todos los servidores de aplicaciones Java soportados Maacutequinasvirtuales Java y servidores de bases de datos enhttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

Ademaacutes de un servidor de aplicaciones Java una maacutequina virtual Java y un sistema operativosoportados el implementar BRMS en un entorno de produccioacuten requiere un servidor de base de datossoportado para el almacenamiento de activps de reglas

21 Paquetes softwarePuede descargar JBoss Enterprise BRMS Platform del portal de soporte al cleinte de Red Hat enhttpsaccessredhatcom navegando a Descargas Plataforma BRMS y luego seleccionar laversioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombres depaquetes para 520 pero tambieacuten aplican a versiones anteriores excepto donde se observa que no

JBoss Enterprise BRMS Platform se encuentra disponible en dos paquetes diferentes

Paquete autoacutenomoEste paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMSPlatform ya implementado y no requiere un servidor de aplicaciones ya existente

El paquete autoacutenomo estaacute disponible con la versioacuten 510 y posteriores

Si descarga la versioacuten 510 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 51

Aplicacioacuten web JBoss Enterprise BRMS Platform 510 implementado en los perfiles default y production

Si descarga la versioacuten 520 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 511

Aplicacioacuten web JBoss Enterprise BRMS Platform 520 implementado en los perfiles default y production

Consulte Seccioacuten 221 ldquo Instale el paquete autoacutenomordquo y alliacute encontraraacute las instrucciones parainstalar estos paquetes

Paquete implementableEl paquete implementable es un archivo ZIP que contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform empacada como un archivo WAR que se debe implementar en un servidor deaplicaciones soportado ya existente El paquete ZIP tambieacuten contiene componentes opcionales

El paquete implementable contiene los siguientes archivos

jboss-brms-managerzip - la aplicacioacuten web JBoss Enterprise BRMS Platform

jboss-brms-enginezip - las bibliotecas de clientes JBoss Enterprise BRMS Platform

modeshapezip - los archivos necesarios para instalar el repositorio ModeShape

Capiacutetulo 2 Instalacioacuten de una

9

Nota

modeshapezip solo se incluye en la descarga 52 como avance de tecnologiacutea

Consulte Seccioacuten 222 ldquo Instalar el paquete implementablerdquo para ver las instrucciones de coacutemoinstalar este paquete

22 Instrucciones de instalacioacutenLea esta seccioacuten para aprender coacutemo instalar JBoss Enterprise BRMS Platform Siga las instruccionespara el paquete relevante autoacutenomo o implementable

Los pasos opcionales de instalacioacuten estaacute etiquetados como tal y se refieren a los capiacutetulos de estemanual que contienen mayor informacioacuten

221 Instale el paquete autoacutenomoEl paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform yaimplementado como un fichero explotado Siga el procedimiento a continuacioacuten para instalarlo yconfigurarlo

Nota

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para cualquier configuracioacutenadicional requerida para su entorno especifico httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

Procedimiento 21 Instale el paquete autoacutenomo

1 DescargueDescargue el archivo zip del paquete autoacutenomo del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom Navegue a Descargas luego Plataforma BRMS y luego seleccionela versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombresde paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos de que seobserve lo opuesto

2 ExtraacuteigaEl paquete autoacutenomo contiene un directorio uacutenico que contiene la instalacioacuten de JBoss EnterpriseWeb Platform con la aplicaicoacuten web JBoss Enterprise BRMS Platform ya implementada Extraiga elcontenido del archivo zip al directorio en donde se instalaraacute

[localhost ]$ unzip brms-standalone-520zip

JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms-standalone-520jboss-as-webserverPROFILEdeployjboss-brmswar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

10

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 3: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Legal Notice

Copyright copy 2010 Red Hat Inc

This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 30 UnportedLicense If you distribute this document or a modified version of it you must provide attribution to RedHat Inc and provide a link to the original If the document is modified all Red Hat trademarks must beremoved

Red Hat as the licensor of this document waives the right to enforce and agrees not to assert Section4d of CC-BY-SA to the fullest extent permitted by applicable law

Red Hat Red Hat Enterprise Linux the Shadowman logo JBoss MetaMatrix Fedora the Infinity Logoand RHCE are trademarks of Red Hat Inc registered in the United States and other countries

Linux reg is the registered trademark of Linus Torvalds in the United States and other countries

Java reg is a registered trademark of Oracle andor its affiliates

XFS reg is a trademark of Silicon Graphics International Corp or its subsidiaries in the United Statesandor other countries

MySQL reg is a registered trademark of MySQL AB in the United States the European Union and othercountries

Nodejs reg is an official trademark of Joyent Red Hat Software Collections is not formally related to orendorsed by the official Joyent Nodejs open source or commercial project

The OpenStack reg Word Mark and OpenStack Logo are either registered trademarksservice marks ortrademarksservice marks of the OpenStack Foundation in the United States and other countries andare used with the OpenStack Foundations permission We are not affiliated with endorsed orsponsored by the OpenStack Foundation or the OpenStack community

All other trademarks are the property of their respective owners

Abstract

Este documento proporciona instrucciones de instalacioacuten configuracioacuten y personalizacioacuten para JBossEnterprise BRMS Platform

Table of Contents

Prefacio1 Convenciones del Documento

11 Convenciones tipograacuteficas12 Convenciones del documento13 Notas y Advertencias

2 Coacutemo obtener ayuda y hacer sus comentarios21 iquestNecesita ayuda22 iexclNecesitamos sus comentarios

Capiacutetulo 1 Introduccioacuten11 Cosas nuevas en esta edicioacuten12 JBoss Enterprise BRMS Platform

Capiacutetulo 2 Instalacioacuten de una21 Paquetes software22 Instrucciones de instalacioacuten

221 Instale el paquete autoacutenomo222 Instalar el paquete implementable223 Instalar y habilitar ModeShape

23 Inicio de sesioacuten por primera vez24 Inicio de sesioacuten resolucioacuten de problemas

Capiacutetulo 3 Localizacioacuten

Capiacutetulo 4 Configuracioacuten de la base de datos41 Configuracioacuten de la base de datos para Apache Jackrabbit

411 Configure la base de datos Workspace412 Configurar la base de datos Versions413 Buacutesqueda y uso de iacutendices

42 la configuracioacuten de la base de datos para ModeShape43 Configuracioacuten del repositorio

431 Cambiar la ubicacioacuten del repositorio JackRabbit432 Configure BRMS para utilizar un RDBMS externo

Capiacutetulo 5 Administracioacuten de datos51 Copia de seguridad de datos52 Importacioacuten y exportacioacuten53 Migracioacuten de datos entre versiones de BRMS54 Re-construccioacuten de paquetes binarios

Capiacutetulo 6 Seguridad61 Autenticacioacuten

611 Ejemplo de autenticacioacuten UserRolesLoginModule612 Ejemplo de autenticacioacuten LDAP

62 Autorizacioacuten63 Firma de paquetes de reglas

631 Configuracioacuten de propiedades de serializacioacuten

Capiacutetulo 7 Registros

Capiacutetulo 8 Personalizacioacuten81 Personalizar la interfaz del usuario82 Personalizacioacuten de selectores para la construccioacuten de paquetes

44456667

888

99

101012141819

21

232324242526262628

3131313133

34343536384145

4 7

4 84848

Table of Contents

1

Capiacutetulo 9 Monitoreamiento91 Instale el plug-in JBoss Operations Network92 Descubra la instancia BRMS

Implementacioacuten de JBoss BRMS en EWS

Instalacioacuten de Apache Ant

Ejemplo de configuraciones del administrador de persistencia

Historial de revisiones

505051

52

54

56

58

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

2

Table of Contents

3

Prefacio

1 Convenciones del DocumentoEste manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atencioacutensobre ciertas partes especiacuteficas de informacioacuten

En ediciones PDF y de papel este manual utiliza tipos de letra procedentes de Liberation FontsLiberation Fonts tambieacuten se utilizan en ediciones de HTML si estaacuten instalados en su sistema Si no semuestran tipografiacuteas alternativas pero equivalentes Nota Red Hat Enterprise Linux 5 y siguientesincluyen Liberation Fonts predeterminadas

11 Convenciones tipograacuteficasSe utilizan cuatro convenciones tipograacuteficas para llamar la atencioacuten sobre palabras o frasesespeciacuteficas Dichas convenciones y las circunstancias en que se aplican son las siguientes

Negrita monoespaciado

Utilizado para resaltar la entrada del sistema incluyendo los comandos de shell nombres de archivos yrutas Tambieacuten sirve para resaltar teclas y combinaciones de teclas Por ejemplo

Para ver el contenido del archivo my_next_bestselling_novel en su directorio actualde trabajo escriba el comando cat my_next_bestselling_novel en el inteacuterprete decomandos de shell y pulse Enter para ejecutar el comando

El ejemplo anterior incluye un nombre de archivo un comando de shell y una tecla Todo se presentaen negrita-monoespaciado y distinguible gracias al contexto

Las combinaciones de teclas se pueden distinguir de las individuales con el signo maacutes que conectacada partee de la combinacioacuten de tecla Por ejemplo

Pulse Enter para ejecutar el comando

Pulse Ctrl+Alt+F2 para pasar a una terminal virtual

El primer ejemplo resalta una tecla particular a pulsar El segundo ejemplo resalta una combinacioacuten deteclas un set de tres teclas pulsadas simultaacuteneamente

Si se discute el coacutedigo fuente los nombres de las clase los meacutetodos las funciones los nombres devariables y valores de retorno mencionados dentro de un paacuterrafo seraacuten presentados en Negrita-monoespaciado Por ejemplo

Las clases de archivo relacionadas incluyen filename para sistema de archivos filepara archivos y dir para directorios Cada clase tiene su propio conjunto asociado depermisos

Negrita proporcional

Esta denota palabras o frases encontradas en un sistema incluyendo nombres de aplicacioacuten texto decuadro de diaacutelogo botones etiquetados etiquetas de cajilla de verificacioacuten y botoacuten de radio tiacutetulos demenuacute y tiacutetulos del submenuacute Por ejemplo

Seleccione Sistema rarr Preferencias rarr Ratoacuten desde la barra del menuacute principal paralanzar Preferencias de ratoacuten En la pestantildea de Botones seleccione la cajilla de ratoacuten

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

4

de mano izquierda y luego haga clic en Cerrar para cambiar el botoacuten principal delratoacuten de la izquierda a la derecha (adecuando el ratoacuten para la mano izquierda)

Para insertar un caraacutecter especial en un archivo gedit seleccione Aplicaciones rarrAccesorios rarr Mapa de caracteres de la barra del menuacute Luego seleccione Buacutesquedararr Buscarhellip de la barra del menuacute de Mapa de caracteres escriba el nombre delcaraacutecter en el campo de Buacutesqueda y haga clic en Siguiente El caraacutecter que buscoacute seraacuteresaltado en la Tabla de caracteres Haga doble clic en ese caraacutecter resaltado paracolocarlo en el campo de Texto a copiar y luego haga clic en el botoacuten Copiar Ahoraregrese al documento y elija Modificar rarr Pegar de la barra de menuacute de gedit

El texto anterior incluye nombres de aplicacioacuten nombres y elementos del menuacute de todo el sistemanombres de menuacute de aplicaciones especiacuteficas y botones y texto hallados dentro de una interfaz graacuteficade usuario todos presentados en negrita proporcional y distinguibles por contexto

Itaacutelicas-negrita monoespaciado o Itaacutelicas-negrita proporcional

Ya sea negrita monoespaciado o negrita proporcional la adicioacuten de itaacutelicas indica texto reemplazable ovariable Las itaacutelicas denotan texto que usted no escribe literalmente o texto mostrado que cambiadependiendo de la circunstancia Por ejemplo

Para conectar a una maacutequina remota utilizando ssh teclee ssh nombre de usuariodominionombre en un inteacuterprete de comandos de shell Si la maacutequina remotaes examplecom y su nombre de usuario en esa maacutequina es john teclee ssh johnexamplecom

El comando mount -o remount file-system remonta el sistema de archivo llamadoPor ejemplo para volver a montar el sistema de archivo home el comando es mount -o remount home

Para ver la versioacuten de un paquete actualmente instalado utilice el comando rpm -q paquete Eacuteste entregaraacute el resultado siguiente paquete-versioacuten-lanzamiento

Observe que las palabras resaltadas en itaacutelicas mdash nombre de usuario dominionombre sistema dearchivo paquete versioacuten y lanzamiento Cada palabra es un marcador de posicioacuten ya sea de texto aingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema

Aparte del uso estaacutendar para presentar el tiacutetulo de un trabajo las itaacutelicas denotan el primer uso de unteacutermino nuevo e importante Por ejemplo

Publican es un sistema de publicacioacuten de DocBook

12 Convenciones del documentoLos mensajes de salida de la terminal o fragmentos de coacutedigo fuente se distinguen visualmente deltexto circundante

Los mensajes de salida enviados a una terminal se muestran en romano monoespaciado y sepresentan asiacute

books Desktop documentation drafts mss photos stuff svnbooks_tests Desktop1 downloads images notes scripts svgs

Los listados de coacutedigo fuente tambieacuten se muestran en romano monoespaciado pero se presentany resaltan de la siguiente manera

Prefacio

5

package orgjbossbookjcaex1

import javaxnamingInitialContext

public class ExClient public static void main(String args[]) throws Exception InitialContext iniCtx = new InitialContext() Object ref = iniCtxlookup(EchoBean) EchoHome home = (EchoHome) ref Echo echo = homecreate()

Systemoutprintln(Created Echo)

Systemoutprintln(Echoecho(Hello) = + echoecho(Hello))

13 Notas y AdvertenciasFinalmente utilizamos tres estilos visuales para llamar la atencioacuten sobre la informacioacuten que de otromodo se podriacutea pasar por alto

Nota

Una nota es una sugerencia atajo o enfoque alternativo para una tarea determinada Ignorar unanota no deberiacutea tener consecuencias negativas pero podriacutea perderse de algunos trucos quepueden facilitarle las cosas

Importante

Los cuadros con el tiacutetulo de importante dan detalles de cosas que se pueden pasar por altofaacutecilmente cambios de configuracioacuten uacutenicamente aplicables a la sesioacuten actual o servicios quenecesitan reiniciarse antes de que se aplique una actualizacioacuten Ignorar estos cuadros noocasionaraacute peacuterdida de datos pero puede causar enfado y frustracioacuten

Aviso

Las advertencias no deben ignorarse Ignorarlas muy probablemente ocasionaraacute peacuterdida dedatos

2 Coacutemo obtener ayuda y hacer sus comentarios

21 iquestNecesita ayudaSi encuentra dificultades con alguno de los procedimientos descritos en este documento visite el Portaldel cliente de Red Hat en httpaccessredhatcom A traveacutes del portal del cliente usted podraacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

6

buscar o navegar a traveacutes de la base de artiacuteculos de soporte teacutecnico sobre productos de Red Hat

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

acceder a otra documentacioacuten del producto

Red Hat alberga una lista grande de correos electroacutenicos para discutir sobre software de Red Hat ytecnologiacutea Encontraraacute un listado de las listas de correo disponibles al puacuteblico enhttpswwwredhatcommailmanlistinfo Haga clic en el nombre de la lista a la que quiera suscribirse opara acceder a los archivos de listados

22 iexclNecesitamos sus comentariosSi encuentra algun error o si se le ocurre una manera de mejorar este manual nos encantariacutea escucharsus sugerencias Complete un reporte en Bugzilla frente al producto JBoss Enterprise BRMS Platform 5 y el componente doc-BRMS_Administrator_Guide El siguiente enlace le llevaraacute aun reporte de error ya completado para este producto httpbugzillaredhatcom

Llene la siguiente plantilla en el campo de Description de Bugzilla Sea tan especifico como le seaposible al describir el problema esto ayudaraacute a asegurarnos de que lo podemos solucionarraacutepidamente

URL del documento

Nuacutemero de la seccioacuten y nombre

Describa el problema

Sugerencias para mejorar

Informacioacuten adicional

Aseguacuterese de darnos su nombre para poder darle todo el creacutedito por reportar el problema

Prefacio

7

Capiacutetulo 1 Introduccioacuten

11 Cosas nuevas en esta edicioacutenTabla 11 Cosas nuevas en esta edicioacuten

Funcionalidad Cambio

Seccioacuten 223 ldquo Instalar y habilitar ModeShaperdquo Una nueva seccioacuten sobre la instalacioacuten deModeshape como repositorio

Seccioacuten 42 ldquo la configuracioacuten de la base dedatos para ModeShaperdquo

Una nueva seccioacuten sobre la configuracioacuten de unafuente de datos para Modeshape

Seccioacuten 432 ldquo Configure BRMS para utilizar unRDBMS externordquo

Una nueva seccioacuten sobre la configuracioacuten deBRMS para utilizar un RDBMS externo

Capiacutetulo 9 Monitoreamiento Un nuevo capiacutetulo sobre el monitoreamiento deBRMS con un plug-in de Jboss OperationsNetwork

Apeacutendice A Implementacioacuten de JBoss BRMS enEWS

Un nuevo apeacutendice con instrucciones parainstalar JBoss BRMS en Jboss Enterprise WebServer

12 JBoss Enterprise BRMS PlatformJBoss Enterprise BRMS Platform es un sistema de administracioacuten de reglas empresariales basado enJBoss Rules Proporciona una solucioacuten multi-usuario del lado del servidor para la administracioacutenalmacenamiento modificacioacuten e implementacioacuten de reglas y otros activos de JBoss Rules Se brinda unainterfaz de usuario basado en la web asiacute como integracioacuten para JBoss Developer Studio 4

Importante

En varios lugares de JBoss Enterprise BRMS Platform y de su documentacioacuten se refiere aGuvnor Drools Guvnor es el nombre del proyecto de coacutedigo abierto sobre el cual se haconstruiacutedo JBoss Enterprise BRMS Platform Las referencias a Guvnor permanecen en la API lasURLs y en las herramientas de JBoss Developer Studio

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

8

Capiacutetulo 2 Instalacioacuten de unaEn este capiacutetulo aprenderaacute a instalar la plataforma JBoss Enterprise BRMS

JBoss Enterprise BRMS Platform estaacute soportada en diferentes configuraciones del sistema Puedeencoentrar una lista completa de todos los servidores de aplicaciones Java soportados Maacutequinasvirtuales Java y servidores de bases de datos enhttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

Ademaacutes de un servidor de aplicaciones Java una maacutequina virtual Java y un sistema operativosoportados el implementar BRMS en un entorno de produccioacuten requiere un servidor de base de datossoportado para el almacenamiento de activps de reglas

21 Paquetes softwarePuede descargar JBoss Enterprise BRMS Platform del portal de soporte al cleinte de Red Hat enhttpsaccessredhatcom navegando a Descargas Plataforma BRMS y luego seleccionar laversioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombres depaquetes para 520 pero tambieacuten aplican a versiones anteriores excepto donde se observa que no

JBoss Enterprise BRMS Platform se encuentra disponible en dos paquetes diferentes

Paquete autoacutenomoEste paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMSPlatform ya implementado y no requiere un servidor de aplicaciones ya existente

El paquete autoacutenomo estaacute disponible con la versioacuten 510 y posteriores

Si descarga la versioacuten 510 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 51

Aplicacioacuten web JBoss Enterprise BRMS Platform 510 implementado en los perfiles default y production

Si descarga la versioacuten 520 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 511

Aplicacioacuten web JBoss Enterprise BRMS Platform 520 implementado en los perfiles default y production

Consulte Seccioacuten 221 ldquo Instale el paquete autoacutenomordquo y alliacute encontraraacute las instrucciones parainstalar estos paquetes

Paquete implementableEl paquete implementable es un archivo ZIP que contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform empacada como un archivo WAR que se debe implementar en un servidor deaplicaciones soportado ya existente El paquete ZIP tambieacuten contiene componentes opcionales

El paquete implementable contiene los siguientes archivos

jboss-brms-managerzip - la aplicacioacuten web JBoss Enterprise BRMS Platform

jboss-brms-enginezip - las bibliotecas de clientes JBoss Enterprise BRMS Platform

modeshapezip - los archivos necesarios para instalar el repositorio ModeShape

Capiacutetulo 2 Instalacioacuten de una

9

Nota

modeshapezip solo se incluye en la descarga 52 como avance de tecnologiacutea

Consulte Seccioacuten 222 ldquo Instalar el paquete implementablerdquo para ver las instrucciones de coacutemoinstalar este paquete

22 Instrucciones de instalacioacutenLea esta seccioacuten para aprender coacutemo instalar JBoss Enterprise BRMS Platform Siga las instruccionespara el paquete relevante autoacutenomo o implementable

Los pasos opcionales de instalacioacuten estaacute etiquetados como tal y se refieren a los capiacutetulos de estemanual que contienen mayor informacioacuten

221 Instale el paquete autoacutenomoEl paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform yaimplementado como un fichero explotado Siga el procedimiento a continuacioacuten para instalarlo yconfigurarlo

Nota

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para cualquier configuracioacutenadicional requerida para su entorno especifico httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

Procedimiento 21 Instale el paquete autoacutenomo

1 DescargueDescargue el archivo zip del paquete autoacutenomo del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom Navegue a Descargas luego Plataforma BRMS y luego seleccionela versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombresde paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos de que seobserve lo opuesto

2 ExtraacuteigaEl paquete autoacutenomo contiene un directorio uacutenico que contiene la instalacioacuten de JBoss EnterpriseWeb Platform con la aplicaicoacuten web JBoss Enterprise BRMS Platform ya implementada Extraiga elcontenido del archivo zip al directorio en donde se instalaraacute

[localhost ]$ unzip brms-standalone-520zip

JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms-standalone-520jboss-as-webserverPROFILEdeployjboss-brmswar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

10

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 4: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Table of Contents

Prefacio1 Convenciones del Documento

11 Convenciones tipograacuteficas12 Convenciones del documento13 Notas y Advertencias

2 Coacutemo obtener ayuda y hacer sus comentarios21 iquestNecesita ayuda22 iexclNecesitamos sus comentarios

Capiacutetulo 1 Introduccioacuten11 Cosas nuevas en esta edicioacuten12 JBoss Enterprise BRMS Platform

Capiacutetulo 2 Instalacioacuten de una21 Paquetes software22 Instrucciones de instalacioacuten

221 Instale el paquete autoacutenomo222 Instalar el paquete implementable223 Instalar y habilitar ModeShape

23 Inicio de sesioacuten por primera vez24 Inicio de sesioacuten resolucioacuten de problemas

Capiacutetulo 3 Localizacioacuten

Capiacutetulo 4 Configuracioacuten de la base de datos41 Configuracioacuten de la base de datos para Apache Jackrabbit

411 Configure la base de datos Workspace412 Configurar la base de datos Versions413 Buacutesqueda y uso de iacutendices

42 la configuracioacuten de la base de datos para ModeShape43 Configuracioacuten del repositorio

431 Cambiar la ubicacioacuten del repositorio JackRabbit432 Configure BRMS para utilizar un RDBMS externo

Capiacutetulo 5 Administracioacuten de datos51 Copia de seguridad de datos52 Importacioacuten y exportacioacuten53 Migracioacuten de datos entre versiones de BRMS54 Re-construccioacuten de paquetes binarios

Capiacutetulo 6 Seguridad61 Autenticacioacuten

611 Ejemplo de autenticacioacuten UserRolesLoginModule612 Ejemplo de autenticacioacuten LDAP

62 Autorizacioacuten63 Firma de paquetes de reglas

631 Configuracioacuten de propiedades de serializacioacuten

Capiacutetulo 7 Registros

Capiacutetulo 8 Personalizacioacuten81 Personalizar la interfaz del usuario82 Personalizacioacuten de selectores para la construccioacuten de paquetes

44456667

888

99

101012141819

21

232324242526262628

3131313133

34343536384145

4 7

4 84848

Table of Contents

1

Capiacutetulo 9 Monitoreamiento91 Instale el plug-in JBoss Operations Network92 Descubra la instancia BRMS

Implementacioacuten de JBoss BRMS en EWS

Instalacioacuten de Apache Ant

Ejemplo de configuraciones del administrador de persistencia

Historial de revisiones

505051

52

54

56

58

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

2

Table of Contents

3

Prefacio

1 Convenciones del DocumentoEste manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atencioacutensobre ciertas partes especiacuteficas de informacioacuten

En ediciones PDF y de papel este manual utiliza tipos de letra procedentes de Liberation FontsLiberation Fonts tambieacuten se utilizan en ediciones de HTML si estaacuten instalados en su sistema Si no semuestran tipografiacuteas alternativas pero equivalentes Nota Red Hat Enterprise Linux 5 y siguientesincluyen Liberation Fonts predeterminadas

11 Convenciones tipograacuteficasSe utilizan cuatro convenciones tipograacuteficas para llamar la atencioacuten sobre palabras o frasesespeciacuteficas Dichas convenciones y las circunstancias en que se aplican son las siguientes

Negrita monoespaciado

Utilizado para resaltar la entrada del sistema incluyendo los comandos de shell nombres de archivos yrutas Tambieacuten sirve para resaltar teclas y combinaciones de teclas Por ejemplo

Para ver el contenido del archivo my_next_bestselling_novel en su directorio actualde trabajo escriba el comando cat my_next_bestselling_novel en el inteacuterprete decomandos de shell y pulse Enter para ejecutar el comando

El ejemplo anterior incluye un nombre de archivo un comando de shell y una tecla Todo se presentaen negrita-monoespaciado y distinguible gracias al contexto

Las combinaciones de teclas se pueden distinguir de las individuales con el signo maacutes que conectacada partee de la combinacioacuten de tecla Por ejemplo

Pulse Enter para ejecutar el comando

Pulse Ctrl+Alt+F2 para pasar a una terminal virtual

El primer ejemplo resalta una tecla particular a pulsar El segundo ejemplo resalta una combinacioacuten deteclas un set de tres teclas pulsadas simultaacuteneamente

Si se discute el coacutedigo fuente los nombres de las clase los meacutetodos las funciones los nombres devariables y valores de retorno mencionados dentro de un paacuterrafo seraacuten presentados en Negrita-monoespaciado Por ejemplo

Las clases de archivo relacionadas incluyen filename para sistema de archivos filepara archivos y dir para directorios Cada clase tiene su propio conjunto asociado depermisos

Negrita proporcional

Esta denota palabras o frases encontradas en un sistema incluyendo nombres de aplicacioacuten texto decuadro de diaacutelogo botones etiquetados etiquetas de cajilla de verificacioacuten y botoacuten de radio tiacutetulos demenuacute y tiacutetulos del submenuacute Por ejemplo

Seleccione Sistema rarr Preferencias rarr Ratoacuten desde la barra del menuacute principal paralanzar Preferencias de ratoacuten En la pestantildea de Botones seleccione la cajilla de ratoacuten

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

4

de mano izquierda y luego haga clic en Cerrar para cambiar el botoacuten principal delratoacuten de la izquierda a la derecha (adecuando el ratoacuten para la mano izquierda)

Para insertar un caraacutecter especial en un archivo gedit seleccione Aplicaciones rarrAccesorios rarr Mapa de caracteres de la barra del menuacute Luego seleccione Buacutesquedararr Buscarhellip de la barra del menuacute de Mapa de caracteres escriba el nombre delcaraacutecter en el campo de Buacutesqueda y haga clic en Siguiente El caraacutecter que buscoacute seraacuteresaltado en la Tabla de caracteres Haga doble clic en ese caraacutecter resaltado paracolocarlo en el campo de Texto a copiar y luego haga clic en el botoacuten Copiar Ahoraregrese al documento y elija Modificar rarr Pegar de la barra de menuacute de gedit

El texto anterior incluye nombres de aplicacioacuten nombres y elementos del menuacute de todo el sistemanombres de menuacute de aplicaciones especiacuteficas y botones y texto hallados dentro de una interfaz graacuteficade usuario todos presentados en negrita proporcional y distinguibles por contexto

Itaacutelicas-negrita monoespaciado o Itaacutelicas-negrita proporcional

Ya sea negrita monoespaciado o negrita proporcional la adicioacuten de itaacutelicas indica texto reemplazable ovariable Las itaacutelicas denotan texto que usted no escribe literalmente o texto mostrado que cambiadependiendo de la circunstancia Por ejemplo

Para conectar a una maacutequina remota utilizando ssh teclee ssh nombre de usuariodominionombre en un inteacuterprete de comandos de shell Si la maacutequina remotaes examplecom y su nombre de usuario en esa maacutequina es john teclee ssh johnexamplecom

El comando mount -o remount file-system remonta el sistema de archivo llamadoPor ejemplo para volver a montar el sistema de archivo home el comando es mount -o remount home

Para ver la versioacuten de un paquete actualmente instalado utilice el comando rpm -q paquete Eacuteste entregaraacute el resultado siguiente paquete-versioacuten-lanzamiento

Observe que las palabras resaltadas en itaacutelicas mdash nombre de usuario dominionombre sistema dearchivo paquete versioacuten y lanzamiento Cada palabra es un marcador de posicioacuten ya sea de texto aingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema

Aparte del uso estaacutendar para presentar el tiacutetulo de un trabajo las itaacutelicas denotan el primer uso de unteacutermino nuevo e importante Por ejemplo

Publican es un sistema de publicacioacuten de DocBook

12 Convenciones del documentoLos mensajes de salida de la terminal o fragmentos de coacutedigo fuente se distinguen visualmente deltexto circundante

Los mensajes de salida enviados a una terminal se muestran en romano monoespaciado y sepresentan asiacute

books Desktop documentation drafts mss photos stuff svnbooks_tests Desktop1 downloads images notes scripts svgs

Los listados de coacutedigo fuente tambieacuten se muestran en romano monoespaciado pero se presentany resaltan de la siguiente manera

Prefacio

5

package orgjbossbookjcaex1

import javaxnamingInitialContext

public class ExClient public static void main(String args[]) throws Exception InitialContext iniCtx = new InitialContext() Object ref = iniCtxlookup(EchoBean) EchoHome home = (EchoHome) ref Echo echo = homecreate()

Systemoutprintln(Created Echo)

Systemoutprintln(Echoecho(Hello) = + echoecho(Hello))

13 Notas y AdvertenciasFinalmente utilizamos tres estilos visuales para llamar la atencioacuten sobre la informacioacuten que de otromodo se podriacutea pasar por alto

Nota

Una nota es una sugerencia atajo o enfoque alternativo para una tarea determinada Ignorar unanota no deberiacutea tener consecuencias negativas pero podriacutea perderse de algunos trucos quepueden facilitarle las cosas

Importante

Los cuadros con el tiacutetulo de importante dan detalles de cosas que se pueden pasar por altofaacutecilmente cambios de configuracioacuten uacutenicamente aplicables a la sesioacuten actual o servicios quenecesitan reiniciarse antes de que se aplique una actualizacioacuten Ignorar estos cuadros noocasionaraacute peacuterdida de datos pero puede causar enfado y frustracioacuten

Aviso

Las advertencias no deben ignorarse Ignorarlas muy probablemente ocasionaraacute peacuterdida dedatos

2 Coacutemo obtener ayuda y hacer sus comentarios

21 iquestNecesita ayudaSi encuentra dificultades con alguno de los procedimientos descritos en este documento visite el Portaldel cliente de Red Hat en httpaccessredhatcom A traveacutes del portal del cliente usted podraacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

6

buscar o navegar a traveacutes de la base de artiacuteculos de soporte teacutecnico sobre productos de Red Hat

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

acceder a otra documentacioacuten del producto

Red Hat alberga una lista grande de correos electroacutenicos para discutir sobre software de Red Hat ytecnologiacutea Encontraraacute un listado de las listas de correo disponibles al puacuteblico enhttpswwwredhatcommailmanlistinfo Haga clic en el nombre de la lista a la que quiera suscribirse opara acceder a los archivos de listados

22 iexclNecesitamos sus comentariosSi encuentra algun error o si se le ocurre una manera de mejorar este manual nos encantariacutea escucharsus sugerencias Complete un reporte en Bugzilla frente al producto JBoss Enterprise BRMS Platform 5 y el componente doc-BRMS_Administrator_Guide El siguiente enlace le llevaraacute aun reporte de error ya completado para este producto httpbugzillaredhatcom

Llene la siguiente plantilla en el campo de Description de Bugzilla Sea tan especifico como le seaposible al describir el problema esto ayudaraacute a asegurarnos de que lo podemos solucionarraacutepidamente

URL del documento

Nuacutemero de la seccioacuten y nombre

Describa el problema

Sugerencias para mejorar

Informacioacuten adicional

Aseguacuterese de darnos su nombre para poder darle todo el creacutedito por reportar el problema

Prefacio

7

Capiacutetulo 1 Introduccioacuten

11 Cosas nuevas en esta edicioacutenTabla 11 Cosas nuevas en esta edicioacuten

Funcionalidad Cambio

Seccioacuten 223 ldquo Instalar y habilitar ModeShaperdquo Una nueva seccioacuten sobre la instalacioacuten deModeshape como repositorio

Seccioacuten 42 ldquo la configuracioacuten de la base dedatos para ModeShaperdquo

Una nueva seccioacuten sobre la configuracioacuten de unafuente de datos para Modeshape

Seccioacuten 432 ldquo Configure BRMS para utilizar unRDBMS externordquo

Una nueva seccioacuten sobre la configuracioacuten deBRMS para utilizar un RDBMS externo

Capiacutetulo 9 Monitoreamiento Un nuevo capiacutetulo sobre el monitoreamiento deBRMS con un plug-in de Jboss OperationsNetwork

Apeacutendice A Implementacioacuten de JBoss BRMS enEWS

Un nuevo apeacutendice con instrucciones parainstalar JBoss BRMS en Jboss Enterprise WebServer

12 JBoss Enterprise BRMS PlatformJBoss Enterprise BRMS Platform es un sistema de administracioacuten de reglas empresariales basado enJBoss Rules Proporciona una solucioacuten multi-usuario del lado del servidor para la administracioacutenalmacenamiento modificacioacuten e implementacioacuten de reglas y otros activos de JBoss Rules Se brinda unainterfaz de usuario basado en la web asiacute como integracioacuten para JBoss Developer Studio 4

Importante

En varios lugares de JBoss Enterprise BRMS Platform y de su documentacioacuten se refiere aGuvnor Drools Guvnor es el nombre del proyecto de coacutedigo abierto sobre el cual se haconstruiacutedo JBoss Enterprise BRMS Platform Las referencias a Guvnor permanecen en la API lasURLs y en las herramientas de JBoss Developer Studio

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

8

Capiacutetulo 2 Instalacioacuten de unaEn este capiacutetulo aprenderaacute a instalar la plataforma JBoss Enterprise BRMS

JBoss Enterprise BRMS Platform estaacute soportada en diferentes configuraciones del sistema Puedeencoentrar una lista completa de todos los servidores de aplicaciones Java soportados Maacutequinasvirtuales Java y servidores de bases de datos enhttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

Ademaacutes de un servidor de aplicaciones Java una maacutequina virtual Java y un sistema operativosoportados el implementar BRMS en un entorno de produccioacuten requiere un servidor de base de datossoportado para el almacenamiento de activps de reglas

21 Paquetes softwarePuede descargar JBoss Enterprise BRMS Platform del portal de soporte al cleinte de Red Hat enhttpsaccessredhatcom navegando a Descargas Plataforma BRMS y luego seleccionar laversioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombres depaquetes para 520 pero tambieacuten aplican a versiones anteriores excepto donde se observa que no

JBoss Enterprise BRMS Platform se encuentra disponible en dos paquetes diferentes

Paquete autoacutenomoEste paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMSPlatform ya implementado y no requiere un servidor de aplicaciones ya existente

El paquete autoacutenomo estaacute disponible con la versioacuten 510 y posteriores

Si descarga la versioacuten 510 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 51

Aplicacioacuten web JBoss Enterprise BRMS Platform 510 implementado en los perfiles default y production

Si descarga la versioacuten 520 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 511

Aplicacioacuten web JBoss Enterprise BRMS Platform 520 implementado en los perfiles default y production

Consulte Seccioacuten 221 ldquo Instale el paquete autoacutenomordquo y alliacute encontraraacute las instrucciones parainstalar estos paquetes

Paquete implementableEl paquete implementable es un archivo ZIP que contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform empacada como un archivo WAR que se debe implementar en un servidor deaplicaciones soportado ya existente El paquete ZIP tambieacuten contiene componentes opcionales

El paquete implementable contiene los siguientes archivos

jboss-brms-managerzip - la aplicacioacuten web JBoss Enterprise BRMS Platform

jboss-brms-enginezip - las bibliotecas de clientes JBoss Enterprise BRMS Platform

modeshapezip - los archivos necesarios para instalar el repositorio ModeShape

Capiacutetulo 2 Instalacioacuten de una

9

Nota

modeshapezip solo se incluye en la descarga 52 como avance de tecnologiacutea

Consulte Seccioacuten 222 ldquo Instalar el paquete implementablerdquo para ver las instrucciones de coacutemoinstalar este paquete

22 Instrucciones de instalacioacutenLea esta seccioacuten para aprender coacutemo instalar JBoss Enterprise BRMS Platform Siga las instruccionespara el paquete relevante autoacutenomo o implementable

Los pasos opcionales de instalacioacuten estaacute etiquetados como tal y se refieren a los capiacutetulos de estemanual que contienen mayor informacioacuten

221 Instale el paquete autoacutenomoEl paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform yaimplementado como un fichero explotado Siga el procedimiento a continuacioacuten para instalarlo yconfigurarlo

Nota

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para cualquier configuracioacutenadicional requerida para su entorno especifico httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

Procedimiento 21 Instale el paquete autoacutenomo

1 DescargueDescargue el archivo zip del paquete autoacutenomo del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom Navegue a Descargas luego Plataforma BRMS y luego seleccionela versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombresde paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos de que seobserve lo opuesto

2 ExtraacuteigaEl paquete autoacutenomo contiene un directorio uacutenico que contiene la instalacioacuten de JBoss EnterpriseWeb Platform con la aplicaicoacuten web JBoss Enterprise BRMS Platform ya implementada Extraiga elcontenido del archivo zip al directorio en donde se instalaraacute

[localhost ]$ unzip brms-standalone-520zip

JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms-standalone-520jboss-as-webserverPROFILEdeployjboss-brmswar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

10

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 5: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Capiacutetulo 9 Monitoreamiento91 Instale el plug-in JBoss Operations Network92 Descubra la instancia BRMS

Implementacioacuten de JBoss BRMS en EWS

Instalacioacuten de Apache Ant

Ejemplo de configuraciones del administrador de persistencia

Historial de revisiones

505051

52

54

56

58

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

2

Table of Contents

3

Prefacio

1 Convenciones del DocumentoEste manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atencioacutensobre ciertas partes especiacuteficas de informacioacuten

En ediciones PDF y de papel este manual utiliza tipos de letra procedentes de Liberation FontsLiberation Fonts tambieacuten se utilizan en ediciones de HTML si estaacuten instalados en su sistema Si no semuestran tipografiacuteas alternativas pero equivalentes Nota Red Hat Enterprise Linux 5 y siguientesincluyen Liberation Fonts predeterminadas

11 Convenciones tipograacuteficasSe utilizan cuatro convenciones tipograacuteficas para llamar la atencioacuten sobre palabras o frasesespeciacuteficas Dichas convenciones y las circunstancias en que se aplican son las siguientes

Negrita monoespaciado

Utilizado para resaltar la entrada del sistema incluyendo los comandos de shell nombres de archivos yrutas Tambieacuten sirve para resaltar teclas y combinaciones de teclas Por ejemplo

Para ver el contenido del archivo my_next_bestselling_novel en su directorio actualde trabajo escriba el comando cat my_next_bestselling_novel en el inteacuterprete decomandos de shell y pulse Enter para ejecutar el comando

El ejemplo anterior incluye un nombre de archivo un comando de shell y una tecla Todo se presentaen negrita-monoespaciado y distinguible gracias al contexto

Las combinaciones de teclas se pueden distinguir de las individuales con el signo maacutes que conectacada partee de la combinacioacuten de tecla Por ejemplo

Pulse Enter para ejecutar el comando

Pulse Ctrl+Alt+F2 para pasar a una terminal virtual

El primer ejemplo resalta una tecla particular a pulsar El segundo ejemplo resalta una combinacioacuten deteclas un set de tres teclas pulsadas simultaacuteneamente

Si se discute el coacutedigo fuente los nombres de las clase los meacutetodos las funciones los nombres devariables y valores de retorno mencionados dentro de un paacuterrafo seraacuten presentados en Negrita-monoespaciado Por ejemplo

Las clases de archivo relacionadas incluyen filename para sistema de archivos filepara archivos y dir para directorios Cada clase tiene su propio conjunto asociado depermisos

Negrita proporcional

Esta denota palabras o frases encontradas en un sistema incluyendo nombres de aplicacioacuten texto decuadro de diaacutelogo botones etiquetados etiquetas de cajilla de verificacioacuten y botoacuten de radio tiacutetulos demenuacute y tiacutetulos del submenuacute Por ejemplo

Seleccione Sistema rarr Preferencias rarr Ratoacuten desde la barra del menuacute principal paralanzar Preferencias de ratoacuten En la pestantildea de Botones seleccione la cajilla de ratoacuten

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

4

de mano izquierda y luego haga clic en Cerrar para cambiar el botoacuten principal delratoacuten de la izquierda a la derecha (adecuando el ratoacuten para la mano izquierda)

Para insertar un caraacutecter especial en un archivo gedit seleccione Aplicaciones rarrAccesorios rarr Mapa de caracteres de la barra del menuacute Luego seleccione Buacutesquedararr Buscarhellip de la barra del menuacute de Mapa de caracteres escriba el nombre delcaraacutecter en el campo de Buacutesqueda y haga clic en Siguiente El caraacutecter que buscoacute seraacuteresaltado en la Tabla de caracteres Haga doble clic en ese caraacutecter resaltado paracolocarlo en el campo de Texto a copiar y luego haga clic en el botoacuten Copiar Ahoraregrese al documento y elija Modificar rarr Pegar de la barra de menuacute de gedit

El texto anterior incluye nombres de aplicacioacuten nombres y elementos del menuacute de todo el sistemanombres de menuacute de aplicaciones especiacuteficas y botones y texto hallados dentro de una interfaz graacuteficade usuario todos presentados en negrita proporcional y distinguibles por contexto

Itaacutelicas-negrita monoespaciado o Itaacutelicas-negrita proporcional

Ya sea negrita monoespaciado o negrita proporcional la adicioacuten de itaacutelicas indica texto reemplazable ovariable Las itaacutelicas denotan texto que usted no escribe literalmente o texto mostrado que cambiadependiendo de la circunstancia Por ejemplo

Para conectar a una maacutequina remota utilizando ssh teclee ssh nombre de usuariodominionombre en un inteacuterprete de comandos de shell Si la maacutequina remotaes examplecom y su nombre de usuario en esa maacutequina es john teclee ssh johnexamplecom

El comando mount -o remount file-system remonta el sistema de archivo llamadoPor ejemplo para volver a montar el sistema de archivo home el comando es mount -o remount home

Para ver la versioacuten de un paquete actualmente instalado utilice el comando rpm -q paquete Eacuteste entregaraacute el resultado siguiente paquete-versioacuten-lanzamiento

Observe que las palabras resaltadas en itaacutelicas mdash nombre de usuario dominionombre sistema dearchivo paquete versioacuten y lanzamiento Cada palabra es un marcador de posicioacuten ya sea de texto aingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema

Aparte del uso estaacutendar para presentar el tiacutetulo de un trabajo las itaacutelicas denotan el primer uso de unteacutermino nuevo e importante Por ejemplo

Publican es un sistema de publicacioacuten de DocBook

12 Convenciones del documentoLos mensajes de salida de la terminal o fragmentos de coacutedigo fuente se distinguen visualmente deltexto circundante

Los mensajes de salida enviados a una terminal se muestran en romano monoespaciado y sepresentan asiacute

books Desktop documentation drafts mss photos stuff svnbooks_tests Desktop1 downloads images notes scripts svgs

Los listados de coacutedigo fuente tambieacuten se muestran en romano monoespaciado pero se presentany resaltan de la siguiente manera

Prefacio

5

package orgjbossbookjcaex1

import javaxnamingInitialContext

public class ExClient public static void main(String args[]) throws Exception InitialContext iniCtx = new InitialContext() Object ref = iniCtxlookup(EchoBean) EchoHome home = (EchoHome) ref Echo echo = homecreate()

Systemoutprintln(Created Echo)

Systemoutprintln(Echoecho(Hello) = + echoecho(Hello))

13 Notas y AdvertenciasFinalmente utilizamos tres estilos visuales para llamar la atencioacuten sobre la informacioacuten que de otromodo se podriacutea pasar por alto

Nota

Una nota es una sugerencia atajo o enfoque alternativo para una tarea determinada Ignorar unanota no deberiacutea tener consecuencias negativas pero podriacutea perderse de algunos trucos quepueden facilitarle las cosas

Importante

Los cuadros con el tiacutetulo de importante dan detalles de cosas que se pueden pasar por altofaacutecilmente cambios de configuracioacuten uacutenicamente aplicables a la sesioacuten actual o servicios quenecesitan reiniciarse antes de que se aplique una actualizacioacuten Ignorar estos cuadros noocasionaraacute peacuterdida de datos pero puede causar enfado y frustracioacuten

Aviso

Las advertencias no deben ignorarse Ignorarlas muy probablemente ocasionaraacute peacuterdida dedatos

2 Coacutemo obtener ayuda y hacer sus comentarios

21 iquestNecesita ayudaSi encuentra dificultades con alguno de los procedimientos descritos en este documento visite el Portaldel cliente de Red Hat en httpaccessredhatcom A traveacutes del portal del cliente usted podraacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

6

buscar o navegar a traveacutes de la base de artiacuteculos de soporte teacutecnico sobre productos de Red Hat

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

acceder a otra documentacioacuten del producto

Red Hat alberga una lista grande de correos electroacutenicos para discutir sobre software de Red Hat ytecnologiacutea Encontraraacute un listado de las listas de correo disponibles al puacuteblico enhttpswwwredhatcommailmanlistinfo Haga clic en el nombre de la lista a la que quiera suscribirse opara acceder a los archivos de listados

22 iexclNecesitamos sus comentariosSi encuentra algun error o si se le ocurre una manera de mejorar este manual nos encantariacutea escucharsus sugerencias Complete un reporte en Bugzilla frente al producto JBoss Enterprise BRMS Platform 5 y el componente doc-BRMS_Administrator_Guide El siguiente enlace le llevaraacute aun reporte de error ya completado para este producto httpbugzillaredhatcom

Llene la siguiente plantilla en el campo de Description de Bugzilla Sea tan especifico como le seaposible al describir el problema esto ayudaraacute a asegurarnos de que lo podemos solucionarraacutepidamente

URL del documento

Nuacutemero de la seccioacuten y nombre

Describa el problema

Sugerencias para mejorar

Informacioacuten adicional

Aseguacuterese de darnos su nombre para poder darle todo el creacutedito por reportar el problema

Prefacio

7

Capiacutetulo 1 Introduccioacuten

11 Cosas nuevas en esta edicioacutenTabla 11 Cosas nuevas en esta edicioacuten

Funcionalidad Cambio

Seccioacuten 223 ldquo Instalar y habilitar ModeShaperdquo Una nueva seccioacuten sobre la instalacioacuten deModeshape como repositorio

Seccioacuten 42 ldquo la configuracioacuten de la base dedatos para ModeShaperdquo

Una nueva seccioacuten sobre la configuracioacuten de unafuente de datos para Modeshape

Seccioacuten 432 ldquo Configure BRMS para utilizar unRDBMS externordquo

Una nueva seccioacuten sobre la configuracioacuten deBRMS para utilizar un RDBMS externo

Capiacutetulo 9 Monitoreamiento Un nuevo capiacutetulo sobre el monitoreamiento deBRMS con un plug-in de Jboss OperationsNetwork

Apeacutendice A Implementacioacuten de JBoss BRMS enEWS

Un nuevo apeacutendice con instrucciones parainstalar JBoss BRMS en Jboss Enterprise WebServer

12 JBoss Enterprise BRMS PlatformJBoss Enterprise BRMS Platform es un sistema de administracioacuten de reglas empresariales basado enJBoss Rules Proporciona una solucioacuten multi-usuario del lado del servidor para la administracioacutenalmacenamiento modificacioacuten e implementacioacuten de reglas y otros activos de JBoss Rules Se brinda unainterfaz de usuario basado en la web asiacute como integracioacuten para JBoss Developer Studio 4

Importante

En varios lugares de JBoss Enterprise BRMS Platform y de su documentacioacuten se refiere aGuvnor Drools Guvnor es el nombre del proyecto de coacutedigo abierto sobre el cual se haconstruiacutedo JBoss Enterprise BRMS Platform Las referencias a Guvnor permanecen en la API lasURLs y en las herramientas de JBoss Developer Studio

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

8

Capiacutetulo 2 Instalacioacuten de unaEn este capiacutetulo aprenderaacute a instalar la plataforma JBoss Enterprise BRMS

JBoss Enterprise BRMS Platform estaacute soportada en diferentes configuraciones del sistema Puedeencoentrar una lista completa de todos los servidores de aplicaciones Java soportados Maacutequinasvirtuales Java y servidores de bases de datos enhttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

Ademaacutes de un servidor de aplicaciones Java una maacutequina virtual Java y un sistema operativosoportados el implementar BRMS en un entorno de produccioacuten requiere un servidor de base de datossoportado para el almacenamiento de activps de reglas

21 Paquetes softwarePuede descargar JBoss Enterprise BRMS Platform del portal de soporte al cleinte de Red Hat enhttpsaccessredhatcom navegando a Descargas Plataforma BRMS y luego seleccionar laversioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombres depaquetes para 520 pero tambieacuten aplican a versiones anteriores excepto donde se observa que no

JBoss Enterprise BRMS Platform se encuentra disponible en dos paquetes diferentes

Paquete autoacutenomoEste paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMSPlatform ya implementado y no requiere un servidor de aplicaciones ya existente

El paquete autoacutenomo estaacute disponible con la versioacuten 510 y posteriores

Si descarga la versioacuten 510 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 51

Aplicacioacuten web JBoss Enterprise BRMS Platform 510 implementado en los perfiles default y production

Si descarga la versioacuten 520 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 511

Aplicacioacuten web JBoss Enterprise BRMS Platform 520 implementado en los perfiles default y production

Consulte Seccioacuten 221 ldquo Instale el paquete autoacutenomordquo y alliacute encontraraacute las instrucciones parainstalar estos paquetes

Paquete implementableEl paquete implementable es un archivo ZIP que contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform empacada como un archivo WAR que se debe implementar en un servidor deaplicaciones soportado ya existente El paquete ZIP tambieacuten contiene componentes opcionales

El paquete implementable contiene los siguientes archivos

jboss-brms-managerzip - la aplicacioacuten web JBoss Enterprise BRMS Platform

jboss-brms-enginezip - las bibliotecas de clientes JBoss Enterprise BRMS Platform

modeshapezip - los archivos necesarios para instalar el repositorio ModeShape

Capiacutetulo 2 Instalacioacuten de una

9

Nota

modeshapezip solo se incluye en la descarga 52 como avance de tecnologiacutea

Consulte Seccioacuten 222 ldquo Instalar el paquete implementablerdquo para ver las instrucciones de coacutemoinstalar este paquete

22 Instrucciones de instalacioacutenLea esta seccioacuten para aprender coacutemo instalar JBoss Enterprise BRMS Platform Siga las instruccionespara el paquete relevante autoacutenomo o implementable

Los pasos opcionales de instalacioacuten estaacute etiquetados como tal y se refieren a los capiacutetulos de estemanual que contienen mayor informacioacuten

221 Instale el paquete autoacutenomoEl paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform yaimplementado como un fichero explotado Siga el procedimiento a continuacioacuten para instalarlo yconfigurarlo

Nota

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para cualquier configuracioacutenadicional requerida para su entorno especifico httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

Procedimiento 21 Instale el paquete autoacutenomo

1 DescargueDescargue el archivo zip del paquete autoacutenomo del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom Navegue a Descargas luego Plataforma BRMS y luego seleccionela versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombresde paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos de que seobserve lo opuesto

2 ExtraacuteigaEl paquete autoacutenomo contiene un directorio uacutenico que contiene la instalacioacuten de JBoss EnterpriseWeb Platform con la aplicaicoacuten web JBoss Enterprise BRMS Platform ya implementada Extraiga elcontenido del archivo zip al directorio en donde se instalaraacute

[localhost ]$ unzip brms-standalone-520zip

JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms-standalone-520jboss-as-webserverPROFILEdeployjboss-brmswar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

10

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 6: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Table of Contents

3

Prefacio

1 Convenciones del DocumentoEste manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atencioacutensobre ciertas partes especiacuteficas de informacioacuten

En ediciones PDF y de papel este manual utiliza tipos de letra procedentes de Liberation FontsLiberation Fonts tambieacuten se utilizan en ediciones de HTML si estaacuten instalados en su sistema Si no semuestran tipografiacuteas alternativas pero equivalentes Nota Red Hat Enterprise Linux 5 y siguientesincluyen Liberation Fonts predeterminadas

11 Convenciones tipograacuteficasSe utilizan cuatro convenciones tipograacuteficas para llamar la atencioacuten sobre palabras o frasesespeciacuteficas Dichas convenciones y las circunstancias en que se aplican son las siguientes

Negrita monoespaciado

Utilizado para resaltar la entrada del sistema incluyendo los comandos de shell nombres de archivos yrutas Tambieacuten sirve para resaltar teclas y combinaciones de teclas Por ejemplo

Para ver el contenido del archivo my_next_bestselling_novel en su directorio actualde trabajo escriba el comando cat my_next_bestselling_novel en el inteacuterprete decomandos de shell y pulse Enter para ejecutar el comando

El ejemplo anterior incluye un nombre de archivo un comando de shell y una tecla Todo se presentaen negrita-monoespaciado y distinguible gracias al contexto

Las combinaciones de teclas se pueden distinguir de las individuales con el signo maacutes que conectacada partee de la combinacioacuten de tecla Por ejemplo

Pulse Enter para ejecutar el comando

Pulse Ctrl+Alt+F2 para pasar a una terminal virtual

El primer ejemplo resalta una tecla particular a pulsar El segundo ejemplo resalta una combinacioacuten deteclas un set de tres teclas pulsadas simultaacuteneamente

Si se discute el coacutedigo fuente los nombres de las clase los meacutetodos las funciones los nombres devariables y valores de retorno mencionados dentro de un paacuterrafo seraacuten presentados en Negrita-monoespaciado Por ejemplo

Las clases de archivo relacionadas incluyen filename para sistema de archivos filepara archivos y dir para directorios Cada clase tiene su propio conjunto asociado depermisos

Negrita proporcional

Esta denota palabras o frases encontradas en un sistema incluyendo nombres de aplicacioacuten texto decuadro de diaacutelogo botones etiquetados etiquetas de cajilla de verificacioacuten y botoacuten de radio tiacutetulos demenuacute y tiacutetulos del submenuacute Por ejemplo

Seleccione Sistema rarr Preferencias rarr Ratoacuten desde la barra del menuacute principal paralanzar Preferencias de ratoacuten En la pestantildea de Botones seleccione la cajilla de ratoacuten

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

4

de mano izquierda y luego haga clic en Cerrar para cambiar el botoacuten principal delratoacuten de la izquierda a la derecha (adecuando el ratoacuten para la mano izquierda)

Para insertar un caraacutecter especial en un archivo gedit seleccione Aplicaciones rarrAccesorios rarr Mapa de caracteres de la barra del menuacute Luego seleccione Buacutesquedararr Buscarhellip de la barra del menuacute de Mapa de caracteres escriba el nombre delcaraacutecter en el campo de Buacutesqueda y haga clic en Siguiente El caraacutecter que buscoacute seraacuteresaltado en la Tabla de caracteres Haga doble clic en ese caraacutecter resaltado paracolocarlo en el campo de Texto a copiar y luego haga clic en el botoacuten Copiar Ahoraregrese al documento y elija Modificar rarr Pegar de la barra de menuacute de gedit

El texto anterior incluye nombres de aplicacioacuten nombres y elementos del menuacute de todo el sistemanombres de menuacute de aplicaciones especiacuteficas y botones y texto hallados dentro de una interfaz graacuteficade usuario todos presentados en negrita proporcional y distinguibles por contexto

Itaacutelicas-negrita monoespaciado o Itaacutelicas-negrita proporcional

Ya sea negrita monoespaciado o negrita proporcional la adicioacuten de itaacutelicas indica texto reemplazable ovariable Las itaacutelicas denotan texto que usted no escribe literalmente o texto mostrado que cambiadependiendo de la circunstancia Por ejemplo

Para conectar a una maacutequina remota utilizando ssh teclee ssh nombre de usuariodominionombre en un inteacuterprete de comandos de shell Si la maacutequina remotaes examplecom y su nombre de usuario en esa maacutequina es john teclee ssh johnexamplecom

El comando mount -o remount file-system remonta el sistema de archivo llamadoPor ejemplo para volver a montar el sistema de archivo home el comando es mount -o remount home

Para ver la versioacuten de un paquete actualmente instalado utilice el comando rpm -q paquete Eacuteste entregaraacute el resultado siguiente paquete-versioacuten-lanzamiento

Observe que las palabras resaltadas en itaacutelicas mdash nombre de usuario dominionombre sistema dearchivo paquete versioacuten y lanzamiento Cada palabra es un marcador de posicioacuten ya sea de texto aingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema

Aparte del uso estaacutendar para presentar el tiacutetulo de un trabajo las itaacutelicas denotan el primer uso de unteacutermino nuevo e importante Por ejemplo

Publican es un sistema de publicacioacuten de DocBook

12 Convenciones del documentoLos mensajes de salida de la terminal o fragmentos de coacutedigo fuente se distinguen visualmente deltexto circundante

Los mensajes de salida enviados a una terminal se muestran en romano monoespaciado y sepresentan asiacute

books Desktop documentation drafts mss photos stuff svnbooks_tests Desktop1 downloads images notes scripts svgs

Los listados de coacutedigo fuente tambieacuten se muestran en romano monoespaciado pero se presentany resaltan de la siguiente manera

Prefacio

5

package orgjbossbookjcaex1

import javaxnamingInitialContext

public class ExClient public static void main(String args[]) throws Exception InitialContext iniCtx = new InitialContext() Object ref = iniCtxlookup(EchoBean) EchoHome home = (EchoHome) ref Echo echo = homecreate()

Systemoutprintln(Created Echo)

Systemoutprintln(Echoecho(Hello) = + echoecho(Hello))

13 Notas y AdvertenciasFinalmente utilizamos tres estilos visuales para llamar la atencioacuten sobre la informacioacuten que de otromodo se podriacutea pasar por alto

Nota

Una nota es una sugerencia atajo o enfoque alternativo para una tarea determinada Ignorar unanota no deberiacutea tener consecuencias negativas pero podriacutea perderse de algunos trucos quepueden facilitarle las cosas

Importante

Los cuadros con el tiacutetulo de importante dan detalles de cosas que se pueden pasar por altofaacutecilmente cambios de configuracioacuten uacutenicamente aplicables a la sesioacuten actual o servicios quenecesitan reiniciarse antes de que se aplique una actualizacioacuten Ignorar estos cuadros noocasionaraacute peacuterdida de datos pero puede causar enfado y frustracioacuten

Aviso

Las advertencias no deben ignorarse Ignorarlas muy probablemente ocasionaraacute peacuterdida dedatos

2 Coacutemo obtener ayuda y hacer sus comentarios

21 iquestNecesita ayudaSi encuentra dificultades con alguno de los procedimientos descritos en este documento visite el Portaldel cliente de Red Hat en httpaccessredhatcom A traveacutes del portal del cliente usted podraacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

6

buscar o navegar a traveacutes de la base de artiacuteculos de soporte teacutecnico sobre productos de Red Hat

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

acceder a otra documentacioacuten del producto

Red Hat alberga una lista grande de correos electroacutenicos para discutir sobre software de Red Hat ytecnologiacutea Encontraraacute un listado de las listas de correo disponibles al puacuteblico enhttpswwwredhatcommailmanlistinfo Haga clic en el nombre de la lista a la que quiera suscribirse opara acceder a los archivos de listados

22 iexclNecesitamos sus comentariosSi encuentra algun error o si se le ocurre una manera de mejorar este manual nos encantariacutea escucharsus sugerencias Complete un reporte en Bugzilla frente al producto JBoss Enterprise BRMS Platform 5 y el componente doc-BRMS_Administrator_Guide El siguiente enlace le llevaraacute aun reporte de error ya completado para este producto httpbugzillaredhatcom

Llene la siguiente plantilla en el campo de Description de Bugzilla Sea tan especifico como le seaposible al describir el problema esto ayudaraacute a asegurarnos de que lo podemos solucionarraacutepidamente

URL del documento

Nuacutemero de la seccioacuten y nombre

Describa el problema

Sugerencias para mejorar

Informacioacuten adicional

Aseguacuterese de darnos su nombre para poder darle todo el creacutedito por reportar el problema

Prefacio

7

Capiacutetulo 1 Introduccioacuten

11 Cosas nuevas en esta edicioacutenTabla 11 Cosas nuevas en esta edicioacuten

Funcionalidad Cambio

Seccioacuten 223 ldquo Instalar y habilitar ModeShaperdquo Una nueva seccioacuten sobre la instalacioacuten deModeshape como repositorio

Seccioacuten 42 ldquo la configuracioacuten de la base dedatos para ModeShaperdquo

Una nueva seccioacuten sobre la configuracioacuten de unafuente de datos para Modeshape

Seccioacuten 432 ldquo Configure BRMS para utilizar unRDBMS externordquo

Una nueva seccioacuten sobre la configuracioacuten deBRMS para utilizar un RDBMS externo

Capiacutetulo 9 Monitoreamiento Un nuevo capiacutetulo sobre el monitoreamiento deBRMS con un plug-in de Jboss OperationsNetwork

Apeacutendice A Implementacioacuten de JBoss BRMS enEWS

Un nuevo apeacutendice con instrucciones parainstalar JBoss BRMS en Jboss Enterprise WebServer

12 JBoss Enterprise BRMS PlatformJBoss Enterprise BRMS Platform es un sistema de administracioacuten de reglas empresariales basado enJBoss Rules Proporciona una solucioacuten multi-usuario del lado del servidor para la administracioacutenalmacenamiento modificacioacuten e implementacioacuten de reglas y otros activos de JBoss Rules Se brinda unainterfaz de usuario basado en la web asiacute como integracioacuten para JBoss Developer Studio 4

Importante

En varios lugares de JBoss Enterprise BRMS Platform y de su documentacioacuten se refiere aGuvnor Drools Guvnor es el nombre del proyecto de coacutedigo abierto sobre el cual se haconstruiacutedo JBoss Enterprise BRMS Platform Las referencias a Guvnor permanecen en la API lasURLs y en las herramientas de JBoss Developer Studio

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

8

Capiacutetulo 2 Instalacioacuten de unaEn este capiacutetulo aprenderaacute a instalar la plataforma JBoss Enterprise BRMS

JBoss Enterprise BRMS Platform estaacute soportada en diferentes configuraciones del sistema Puedeencoentrar una lista completa de todos los servidores de aplicaciones Java soportados Maacutequinasvirtuales Java y servidores de bases de datos enhttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

Ademaacutes de un servidor de aplicaciones Java una maacutequina virtual Java y un sistema operativosoportados el implementar BRMS en un entorno de produccioacuten requiere un servidor de base de datossoportado para el almacenamiento de activps de reglas

21 Paquetes softwarePuede descargar JBoss Enterprise BRMS Platform del portal de soporte al cleinte de Red Hat enhttpsaccessredhatcom navegando a Descargas Plataforma BRMS y luego seleccionar laversioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombres depaquetes para 520 pero tambieacuten aplican a versiones anteriores excepto donde se observa que no

JBoss Enterprise BRMS Platform se encuentra disponible en dos paquetes diferentes

Paquete autoacutenomoEste paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMSPlatform ya implementado y no requiere un servidor de aplicaciones ya existente

El paquete autoacutenomo estaacute disponible con la versioacuten 510 y posteriores

Si descarga la versioacuten 510 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 51

Aplicacioacuten web JBoss Enterprise BRMS Platform 510 implementado en los perfiles default y production

Si descarga la versioacuten 520 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 511

Aplicacioacuten web JBoss Enterprise BRMS Platform 520 implementado en los perfiles default y production

Consulte Seccioacuten 221 ldquo Instale el paquete autoacutenomordquo y alliacute encontraraacute las instrucciones parainstalar estos paquetes

Paquete implementableEl paquete implementable es un archivo ZIP que contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform empacada como un archivo WAR que se debe implementar en un servidor deaplicaciones soportado ya existente El paquete ZIP tambieacuten contiene componentes opcionales

El paquete implementable contiene los siguientes archivos

jboss-brms-managerzip - la aplicacioacuten web JBoss Enterprise BRMS Platform

jboss-brms-enginezip - las bibliotecas de clientes JBoss Enterprise BRMS Platform

modeshapezip - los archivos necesarios para instalar el repositorio ModeShape

Capiacutetulo 2 Instalacioacuten de una

9

Nota

modeshapezip solo se incluye en la descarga 52 como avance de tecnologiacutea

Consulte Seccioacuten 222 ldquo Instalar el paquete implementablerdquo para ver las instrucciones de coacutemoinstalar este paquete

22 Instrucciones de instalacioacutenLea esta seccioacuten para aprender coacutemo instalar JBoss Enterprise BRMS Platform Siga las instruccionespara el paquete relevante autoacutenomo o implementable

Los pasos opcionales de instalacioacuten estaacute etiquetados como tal y se refieren a los capiacutetulos de estemanual que contienen mayor informacioacuten

221 Instale el paquete autoacutenomoEl paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform yaimplementado como un fichero explotado Siga el procedimiento a continuacioacuten para instalarlo yconfigurarlo

Nota

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para cualquier configuracioacutenadicional requerida para su entorno especifico httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

Procedimiento 21 Instale el paquete autoacutenomo

1 DescargueDescargue el archivo zip del paquete autoacutenomo del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom Navegue a Descargas luego Plataforma BRMS y luego seleccionela versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombresde paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos de que seobserve lo opuesto

2 ExtraacuteigaEl paquete autoacutenomo contiene un directorio uacutenico que contiene la instalacioacuten de JBoss EnterpriseWeb Platform con la aplicaicoacuten web JBoss Enterprise BRMS Platform ya implementada Extraiga elcontenido del archivo zip al directorio en donde se instalaraacute

[localhost ]$ unzip brms-standalone-520zip

JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms-standalone-520jboss-as-webserverPROFILEdeployjboss-brmswar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

10

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 7: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Prefacio

1 Convenciones del DocumentoEste manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atencioacutensobre ciertas partes especiacuteficas de informacioacuten

En ediciones PDF y de papel este manual utiliza tipos de letra procedentes de Liberation FontsLiberation Fonts tambieacuten se utilizan en ediciones de HTML si estaacuten instalados en su sistema Si no semuestran tipografiacuteas alternativas pero equivalentes Nota Red Hat Enterprise Linux 5 y siguientesincluyen Liberation Fonts predeterminadas

11 Convenciones tipograacuteficasSe utilizan cuatro convenciones tipograacuteficas para llamar la atencioacuten sobre palabras o frasesespeciacuteficas Dichas convenciones y las circunstancias en que se aplican son las siguientes

Negrita monoespaciado

Utilizado para resaltar la entrada del sistema incluyendo los comandos de shell nombres de archivos yrutas Tambieacuten sirve para resaltar teclas y combinaciones de teclas Por ejemplo

Para ver el contenido del archivo my_next_bestselling_novel en su directorio actualde trabajo escriba el comando cat my_next_bestselling_novel en el inteacuterprete decomandos de shell y pulse Enter para ejecutar el comando

El ejemplo anterior incluye un nombre de archivo un comando de shell y una tecla Todo se presentaen negrita-monoespaciado y distinguible gracias al contexto

Las combinaciones de teclas se pueden distinguir de las individuales con el signo maacutes que conectacada partee de la combinacioacuten de tecla Por ejemplo

Pulse Enter para ejecutar el comando

Pulse Ctrl+Alt+F2 para pasar a una terminal virtual

El primer ejemplo resalta una tecla particular a pulsar El segundo ejemplo resalta una combinacioacuten deteclas un set de tres teclas pulsadas simultaacuteneamente

Si se discute el coacutedigo fuente los nombres de las clase los meacutetodos las funciones los nombres devariables y valores de retorno mencionados dentro de un paacuterrafo seraacuten presentados en Negrita-monoespaciado Por ejemplo

Las clases de archivo relacionadas incluyen filename para sistema de archivos filepara archivos y dir para directorios Cada clase tiene su propio conjunto asociado depermisos

Negrita proporcional

Esta denota palabras o frases encontradas en un sistema incluyendo nombres de aplicacioacuten texto decuadro de diaacutelogo botones etiquetados etiquetas de cajilla de verificacioacuten y botoacuten de radio tiacutetulos demenuacute y tiacutetulos del submenuacute Por ejemplo

Seleccione Sistema rarr Preferencias rarr Ratoacuten desde la barra del menuacute principal paralanzar Preferencias de ratoacuten En la pestantildea de Botones seleccione la cajilla de ratoacuten

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

4

de mano izquierda y luego haga clic en Cerrar para cambiar el botoacuten principal delratoacuten de la izquierda a la derecha (adecuando el ratoacuten para la mano izquierda)

Para insertar un caraacutecter especial en un archivo gedit seleccione Aplicaciones rarrAccesorios rarr Mapa de caracteres de la barra del menuacute Luego seleccione Buacutesquedararr Buscarhellip de la barra del menuacute de Mapa de caracteres escriba el nombre delcaraacutecter en el campo de Buacutesqueda y haga clic en Siguiente El caraacutecter que buscoacute seraacuteresaltado en la Tabla de caracteres Haga doble clic en ese caraacutecter resaltado paracolocarlo en el campo de Texto a copiar y luego haga clic en el botoacuten Copiar Ahoraregrese al documento y elija Modificar rarr Pegar de la barra de menuacute de gedit

El texto anterior incluye nombres de aplicacioacuten nombres y elementos del menuacute de todo el sistemanombres de menuacute de aplicaciones especiacuteficas y botones y texto hallados dentro de una interfaz graacuteficade usuario todos presentados en negrita proporcional y distinguibles por contexto

Itaacutelicas-negrita monoespaciado o Itaacutelicas-negrita proporcional

Ya sea negrita monoespaciado o negrita proporcional la adicioacuten de itaacutelicas indica texto reemplazable ovariable Las itaacutelicas denotan texto que usted no escribe literalmente o texto mostrado que cambiadependiendo de la circunstancia Por ejemplo

Para conectar a una maacutequina remota utilizando ssh teclee ssh nombre de usuariodominionombre en un inteacuterprete de comandos de shell Si la maacutequina remotaes examplecom y su nombre de usuario en esa maacutequina es john teclee ssh johnexamplecom

El comando mount -o remount file-system remonta el sistema de archivo llamadoPor ejemplo para volver a montar el sistema de archivo home el comando es mount -o remount home

Para ver la versioacuten de un paquete actualmente instalado utilice el comando rpm -q paquete Eacuteste entregaraacute el resultado siguiente paquete-versioacuten-lanzamiento

Observe que las palabras resaltadas en itaacutelicas mdash nombre de usuario dominionombre sistema dearchivo paquete versioacuten y lanzamiento Cada palabra es un marcador de posicioacuten ya sea de texto aingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema

Aparte del uso estaacutendar para presentar el tiacutetulo de un trabajo las itaacutelicas denotan el primer uso de unteacutermino nuevo e importante Por ejemplo

Publican es un sistema de publicacioacuten de DocBook

12 Convenciones del documentoLos mensajes de salida de la terminal o fragmentos de coacutedigo fuente se distinguen visualmente deltexto circundante

Los mensajes de salida enviados a una terminal se muestran en romano monoespaciado y sepresentan asiacute

books Desktop documentation drafts mss photos stuff svnbooks_tests Desktop1 downloads images notes scripts svgs

Los listados de coacutedigo fuente tambieacuten se muestran en romano monoespaciado pero se presentany resaltan de la siguiente manera

Prefacio

5

package orgjbossbookjcaex1

import javaxnamingInitialContext

public class ExClient public static void main(String args[]) throws Exception InitialContext iniCtx = new InitialContext() Object ref = iniCtxlookup(EchoBean) EchoHome home = (EchoHome) ref Echo echo = homecreate()

Systemoutprintln(Created Echo)

Systemoutprintln(Echoecho(Hello) = + echoecho(Hello))

13 Notas y AdvertenciasFinalmente utilizamos tres estilos visuales para llamar la atencioacuten sobre la informacioacuten que de otromodo se podriacutea pasar por alto

Nota

Una nota es una sugerencia atajo o enfoque alternativo para una tarea determinada Ignorar unanota no deberiacutea tener consecuencias negativas pero podriacutea perderse de algunos trucos quepueden facilitarle las cosas

Importante

Los cuadros con el tiacutetulo de importante dan detalles de cosas que se pueden pasar por altofaacutecilmente cambios de configuracioacuten uacutenicamente aplicables a la sesioacuten actual o servicios quenecesitan reiniciarse antes de que se aplique una actualizacioacuten Ignorar estos cuadros noocasionaraacute peacuterdida de datos pero puede causar enfado y frustracioacuten

Aviso

Las advertencias no deben ignorarse Ignorarlas muy probablemente ocasionaraacute peacuterdida dedatos

2 Coacutemo obtener ayuda y hacer sus comentarios

21 iquestNecesita ayudaSi encuentra dificultades con alguno de los procedimientos descritos en este documento visite el Portaldel cliente de Red Hat en httpaccessredhatcom A traveacutes del portal del cliente usted podraacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

6

buscar o navegar a traveacutes de la base de artiacuteculos de soporte teacutecnico sobre productos de Red Hat

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

acceder a otra documentacioacuten del producto

Red Hat alberga una lista grande de correos electroacutenicos para discutir sobre software de Red Hat ytecnologiacutea Encontraraacute un listado de las listas de correo disponibles al puacuteblico enhttpswwwredhatcommailmanlistinfo Haga clic en el nombre de la lista a la que quiera suscribirse opara acceder a los archivos de listados

22 iexclNecesitamos sus comentariosSi encuentra algun error o si se le ocurre una manera de mejorar este manual nos encantariacutea escucharsus sugerencias Complete un reporte en Bugzilla frente al producto JBoss Enterprise BRMS Platform 5 y el componente doc-BRMS_Administrator_Guide El siguiente enlace le llevaraacute aun reporte de error ya completado para este producto httpbugzillaredhatcom

Llene la siguiente plantilla en el campo de Description de Bugzilla Sea tan especifico como le seaposible al describir el problema esto ayudaraacute a asegurarnos de que lo podemos solucionarraacutepidamente

URL del documento

Nuacutemero de la seccioacuten y nombre

Describa el problema

Sugerencias para mejorar

Informacioacuten adicional

Aseguacuterese de darnos su nombre para poder darle todo el creacutedito por reportar el problema

Prefacio

7

Capiacutetulo 1 Introduccioacuten

11 Cosas nuevas en esta edicioacutenTabla 11 Cosas nuevas en esta edicioacuten

Funcionalidad Cambio

Seccioacuten 223 ldquo Instalar y habilitar ModeShaperdquo Una nueva seccioacuten sobre la instalacioacuten deModeshape como repositorio

Seccioacuten 42 ldquo la configuracioacuten de la base dedatos para ModeShaperdquo

Una nueva seccioacuten sobre la configuracioacuten de unafuente de datos para Modeshape

Seccioacuten 432 ldquo Configure BRMS para utilizar unRDBMS externordquo

Una nueva seccioacuten sobre la configuracioacuten deBRMS para utilizar un RDBMS externo

Capiacutetulo 9 Monitoreamiento Un nuevo capiacutetulo sobre el monitoreamiento deBRMS con un plug-in de Jboss OperationsNetwork

Apeacutendice A Implementacioacuten de JBoss BRMS enEWS

Un nuevo apeacutendice con instrucciones parainstalar JBoss BRMS en Jboss Enterprise WebServer

12 JBoss Enterprise BRMS PlatformJBoss Enterprise BRMS Platform es un sistema de administracioacuten de reglas empresariales basado enJBoss Rules Proporciona una solucioacuten multi-usuario del lado del servidor para la administracioacutenalmacenamiento modificacioacuten e implementacioacuten de reglas y otros activos de JBoss Rules Se brinda unainterfaz de usuario basado en la web asiacute como integracioacuten para JBoss Developer Studio 4

Importante

En varios lugares de JBoss Enterprise BRMS Platform y de su documentacioacuten se refiere aGuvnor Drools Guvnor es el nombre del proyecto de coacutedigo abierto sobre el cual se haconstruiacutedo JBoss Enterprise BRMS Platform Las referencias a Guvnor permanecen en la API lasURLs y en las herramientas de JBoss Developer Studio

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

8

Capiacutetulo 2 Instalacioacuten de unaEn este capiacutetulo aprenderaacute a instalar la plataforma JBoss Enterprise BRMS

JBoss Enterprise BRMS Platform estaacute soportada en diferentes configuraciones del sistema Puedeencoentrar una lista completa de todos los servidores de aplicaciones Java soportados Maacutequinasvirtuales Java y servidores de bases de datos enhttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

Ademaacutes de un servidor de aplicaciones Java una maacutequina virtual Java y un sistema operativosoportados el implementar BRMS en un entorno de produccioacuten requiere un servidor de base de datossoportado para el almacenamiento de activps de reglas

21 Paquetes softwarePuede descargar JBoss Enterprise BRMS Platform del portal de soporte al cleinte de Red Hat enhttpsaccessredhatcom navegando a Descargas Plataforma BRMS y luego seleccionar laversioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombres depaquetes para 520 pero tambieacuten aplican a versiones anteriores excepto donde se observa que no

JBoss Enterprise BRMS Platform se encuentra disponible en dos paquetes diferentes

Paquete autoacutenomoEste paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMSPlatform ya implementado y no requiere un servidor de aplicaciones ya existente

El paquete autoacutenomo estaacute disponible con la versioacuten 510 y posteriores

Si descarga la versioacuten 510 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 51

Aplicacioacuten web JBoss Enterprise BRMS Platform 510 implementado en los perfiles default y production

Si descarga la versioacuten 520 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 511

Aplicacioacuten web JBoss Enterprise BRMS Platform 520 implementado en los perfiles default y production

Consulte Seccioacuten 221 ldquo Instale el paquete autoacutenomordquo y alliacute encontraraacute las instrucciones parainstalar estos paquetes

Paquete implementableEl paquete implementable es un archivo ZIP que contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform empacada como un archivo WAR que se debe implementar en un servidor deaplicaciones soportado ya existente El paquete ZIP tambieacuten contiene componentes opcionales

El paquete implementable contiene los siguientes archivos

jboss-brms-managerzip - la aplicacioacuten web JBoss Enterprise BRMS Platform

jboss-brms-enginezip - las bibliotecas de clientes JBoss Enterprise BRMS Platform

modeshapezip - los archivos necesarios para instalar el repositorio ModeShape

Capiacutetulo 2 Instalacioacuten de una

9

Nota

modeshapezip solo se incluye en la descarga 52 como avance de tecnologiacutea

Consulte Seccioacuten 222 ldquo Instalar el paquete implementablerdquo para ver las instrucciones de coacutemoinstalar este paquete

22 Instrucciones de instalacioacutenLea esta seccioacuten para aprender coacutemo instalar JBoss Enterprise BRMS Platform Siga las instruccionespara el paquete relevante autoacutenomo o implementable

Los pasos opcionales de instalacioacuten estaacute etiquetados como tal y se refieren a los capiacutetulos de estemanual que contienen mayor informacioacuten

221 Instale el paquete autoacutenomoEl paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform yaimplementado como un fichero explotado Siga el procedimiento a continuacioacuten para instalarlo yconfigurarlo

Nota

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para cualquier configuracioacutenadicional requerida para su entorno especifico httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

Procedimiento 21 Instale el paquete autoacutenomo

1 DescargueDescargue el archivo zip del paquete autoacutenomo del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom Navegue a Descargas luego Plataforma BRMS y luego seleccionela versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombresde paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos de que seobserve lo opuesto

2 ExtraacuteigaEl paquete autoacutenomo contiene un directorio uacutenico que contiene la instalacioacuten de JBoss EnterpriseWeb Platform con la aplicaicoacuten web JBoss Enterprise BRMS Platform ya implementada Extraiga elcontenido del archivo zip al directorio en donde se instalaraacute

[localhost ]$ unzip brms-standalone-520zip

JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms-standalone-520jboss-as-webserverPROFILEdeployjboss-brmswar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

10

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 8: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

de mano izquierda y luego haga clic en Cerrar para cambiar el botoacuten principal delratoacuten de la izquierda a la derecha (adecuando el ratoacuten para la mano izquierda)

Para insertar un caraacutecter especial en un archivo gedit seleccione Aplicaciones rarrAccesorios rarr Mapa de caracteres de la barra del menuacute Luego seleccione Buacutesquedararr Buscarhellip de la barra del menuacute de Mapa de caracteres escriba el nombre delcaraacutecter en el campo de Buacutesqueda y haga clic en Siguiente El caraacutecter que buscoacute seraacuteresaltado en la Tabla de caracteres Haga doble clic en ese caraacutecter resaltado paracolocarlo en el campo de Texto a copiar y luego haga clic en el botoacuten Copiar Ahoraregrese al documento y elija Modificar rarr Pegar de la barra de menuacute de gedit

El texto anterior incluye nombres de aplicacioacuten nombres y elementos del menuacute de todo el sistemanombres de menuacute de aplicaciones especiacuteficas y botones y texto hallados dentro de una interfaz graacuteficade usuario todos presentados en negrita proporcional y distinguibles por contexto

Itaacutelicas-negrita monoespaciado o Itaacutelicas-negrita proporcional

Ya sea negrita monoespaciado o negrita proporcional la adicioacuten de itaacutelicas indica texto reemplazable ovariable Las itaacutelicas denotan texto que usted no escribe literalmente o texto mostrado que cambiadependiendo de la circunstancia Por ejemplo

Para conectar a una maacutequina remota utilizando ssh teclee ssh nombre de usuariodominionombre en un inteacuterprete de comandos de shell Si la maacutequina remotaes examplecom y su nombre de usuario en esa maacutequina es john teclee ssh johnexamplecom

El comando mount -o remount file-system remonta el sistema de archivo llamadoPor ejemplo para volver a montar el sistema de archivo home el comando es mount -o remount home

Para ver la versioacuten de un paquete actualmente instalado utilice el comando rpm -q paquete Eacuteste entregaraacute el resultado siguiente paquete-versioacuten-lanzamiento

Observe que las palabras resaltadas en itaacutelicas mdash nombre de usuario dominionombre sistema dearchivo paquete versioacuten y lanzamiento Cada palabra es un marcador de posicioacuten ya sea de texto aingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema

Aparte del uso estaacutendar para presentar el tiacutetulo de un trabajo las itaacutelicas denotan el primer uso de unteacutermino nuevo e importante Por ejemplo

Publican es un sistema de publicacioacuten de DocBook

12 Convenciones del documentoLos mensajes de salida de la terminal o fragmentos de coacutedigo fuente se distinguen visualmente deltexto circundante

Los mensajes de salida enviados a una terminal se muestran en romano monoespaciado y sepresentan asiacute

books Desktop documentation drafts mss photos stuff svnbooks_tests Desktop1 downloads images notes scripts svgs

Los listados de coacutedigo fuente tambieacuten se muestran en romano monoespaciado pero se presentany resaltan de la siguiente manera

Prefacio

5

package orgjbossbookjcaex1

import javaxnamingInitialContext

public class ExClient public static void main(String args[]) throws Exception InitialContext iniCtx = new InitialContext() Object ref = iniCtxlookup(EchoBean) EchoHome home = (EchoHome) ref Echo echo = homecreate()

Systemoutprintln(Created Echo)

Systemoutprintln(Echoecho(Hello) = + echoecho(Hello))

13 Notas y AdvertenciasFinalmente utilizamos tres estilos visuales para llamar la atencioacuten sobre la informacioacuten que de otromodo se podriacutea pasar por alto

Nota

Una nota es una sugerencia atajo o enfoque alternativo para una tarea determinada Ignorar unanota no deberiacutea tener consecuencias negativas pero podriacutea perderse de algunos trucos quepueden facilitarle las cosas

Importante

Los cuadros con el tiacutetulo de importante dan detalles de cosas que se pueden pasar por altofaacutecilmente cambios de configuracioacuten uacutenicamente aplicables a la sesioacuten actual o servicios quenecesitan reiniciarse antes de que se aplique una actualizacioacuten Ignorar estos cuadros noocasionaraacute peacuterdida de datos pero puede causar enfado y frustracioacuten

Aviso

Las advertencias no deben ignorarse Ignorarlas muy probablemente ocasionaraacute peacuterdida dedatos

2 Coacutemo obtener ayuda y hacer sus comentarios

21 iquestNecesita ayudaSi encuentra dificultades con alguno de los procedimientos descritos en este documento visite el Portaldel cliente de Red Hat en httpaccessredhatcom A traveacutes del portal del cliente usted podraacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

6

buscar o navegar a traveacutes de la base de artiacuteculos de soporte teacutecnico sobre productos de Red Hat

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

acceder a otra documentacioacuten del producto

Red Hat alberga una lista grande de correos electroacutenicos para discutir sobre software de Red Hat ytecnologiacutea Encontraraacute un listado de las listas de correo disponibles al puacuteblico enhttpswwwredhatcommailmanlistinfo Haga clic en el nombre de la lista a la que quiera suscribirse opara acceder a los archivos de listados

22 iexclNecesitamos sus comentariosSi encuentra algun error o si se le ocurre una manera de mejorar este manual nos encantariacutea escucharsus sugerencias Complete un reporte en Bugzilla frente al producto JBoss Enterprise BRMS Platform 5 y el componente doc-BRMS_Administrator_Guide El siguiente enlace le llevaraacute aun reporte de error ya completado para este producto httpbugzillaredhatcom

Llene la siguiente plantilla en el campo de Description de Bugzilla Sea tan especifico como le seaposible al describir el problema esto ayudaraacute a asegurarnos de que lo podemos solucionarraacutepidamente

URL del documento

Nuacutemero de la seccioacuten y nombre

Describa el problema

Sugerencias para mejorar

Informacioacuten adicional

Aseguacuterese de darnos su nombre para poder darle todo el creacutedito por reportar el problema

Prefacio

7

Capiacutetulo 1 Introduccioacuten

11 Cosas nuevas en esta edicioacutenTabla 11 Cosas nuevas en esta edicioacuten

Funcionalidad Cambio

Seccioacuten 223 ldquo Instalar y habilitar ModeShaperdquo Una nueva seccioacuten sobre la instalacioacuten deModeshape como repositorio

Seccioacuten 42 ldquo la configuracioacuten de la base dedatos para ModeShaperdquo

Una nueva seccioacuten sobre la configuracioacuten de unafuente de datos para Modeshape

Seccioacuten 432 ldquo Configure BRMS para utilizar unRDBMS externordquo

Una nueva seccioacuten sobre la configuracioacuten deBRMS para utilizar un RDBMS externo

Capiacutetulo 9 Monitoreamiento Un nuevo capiacutetulo sobre el monitoreamiento deBRMS con un plug-in de Jboss OperationsNetwork

Apeacutendice A Implementacioacuten de JBoss BRMS enEWS

Un nuevo apeacutendice con instrucciones parainstalar JBoss BRMS en Jboss Enterprise WebServer

12 JBoss Enterprise BRMS PlatformJBoss Enterprise BRMS Platform es un sistema de administracioacuten de reglas empresariales basado enJBoss Rules Proporciona una solucioacuten multi-usuario del lado del servidor para la administracioacutenalmacenamiento modificacioacuten e implementacioacuten de reglas y otros activos de JBoss Rules Se brinda unainterfaz de usuario basado en la web asiacute como integracioacuten para JBoss Developer Studio 4

Importante

En varios lugares de JBoss Enterprise BRMS Platform y de su documentacioacuten se refiere aGuvnor Drools Guvnor es el nombre del proyecto de coacutedigo abierto sobre el cual se haconstruiacutedo JBoss Enterprise BRMS Platform Las referencias a Guvnor permanecen en la API lasURLs y en las herramientas de JBoss Developer Studio

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

8

Capiacutetulo 2 Instalacioacuten de unaEn este capiacutetulo aprenderaacute a instalar la plataforma JBoss Enterprise BRMS

JBoss Enterprise BRMS Platform estaacute soportada en diferentes configuraciones del sistema Puedeencoentrar una lista completa de todos los servidores de aplicaciones Java soportados Maacutequinasvirtuales Java y servidores de bases de datos enhttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

Ademaacutes de un servidor de aplicaciones Java una maacutequina virtual Java y un sistema operativosoportados el implementar BRMS en un entorno de produccioacuten requiere un servidor de base de datossoportado para el almacenamiento de activps de reglas

21 Paquetes softwarePuede descargar JBoss Enterprise BRMS Platform del portal de soporte al cleinte de Red Hat enhttpsaccessredhatcom navegando a Descargas Plataforma BRMS y luego seleccionar laversioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombres depaquetes para 520 pero tambieacuten aplican a versiones anteriores excepto donde se observa que no

JBoss Enterprise BRMS Platform se encuentra disponible en dos paquetes diferentes

Paquete autoacutenomoEste paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMSPlatform ya implementado y no requiere un servidor de aplicaciones ya existente

El paquete autoacutenomo estaacute disponible con la versioacuten 510 y posteriores

Si descarga la versioacuten 510 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 51

Aplicacioacuten web JBoss Enterprise BRMS Platform 510 implementado en los perfiles default y production

Si descarga la versioacuten 520 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 511

Aplicacioacuten web JBoss Enterprise BRMS Platform 520 implementado en los perfiles default y production

Consulte Seccioacuten 221 ldquo Instale el paquete autoacutenomordquo y alliacute encontraraacute las instrucciones parainstalar estos paquetes

Paquete implementableEl paquete implementable es un archivo ZIP que contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform empacada como un archivo WAR que se debe implementar en un servidor deaplicaciones soportado ya existente El paquete ZIP tambieacuten contiene componentes opcionales

El paquete implementable contiene los siguientes archivos

jboss-brms-managerzip - la aplicacioacuten web JBoss Enterprise BRMS Platform

jboss-brms-enginezip - las bibliotecas de clientes JBoss Enterprise BRMS Platform

modeshapezip - los archivos necesarios para instalar el repositorio ModeShape

Capiacutetulo 2 Instalacioacuten de una

9

Nota

modeshapezip solo se incluye en la descarga 52 como avance de tecnologiacutea

Consulte Seccioacuten 222 ldquo Instalar el paquete implementablerdquo para ver las instrucciones de coacutemoinstalar este paquete

22 Instrucciones de instalacioacutenLea esta seccioacuten para aprender coacutemo instalar JBoss Enterprise BRMS Platform Siga las instruccionespara el paquete relevante autoacutenomo o implementable

Los pasos opcionales de instalacioacuten estaacute etiquetados como tal y se refieren a los capiacutetulos de estemanual que contienen mayor informacioacuten

221 Instale el paquete autoacutenomoEl paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform yaimplementado como un fichero explotado Siga el procedimiento a continuacioacuten para instalarlo yconfigurarlo

Nota

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para cualquier configuracioacutenadicional requerida para su entorno especifico httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

Procedimiento 21 Instale el paquete autoacutenomo

1 DescargueDescargue el archivo zip del paquete autoacutenomo del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom Navegue a Descargas luego Plataforma BRMS y luego seleccionela versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombresde paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos de que seobserve lo opuesto

2 ExtraacuteigaEl paquete autoacutenomo contiene un directorio uacutenico que contiene la instalacioacuten de JBoss EnterpriseWeb Platform con la aplicaicoacuten web JBoss Enterprise BRMS Platform ya implementada Extraiga elcontenido del archivo zip al directorio en donde se instalaraacute

[localhost ]$ unzip brms-standalone-520zip

JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms-standalone-520jboss-as-webserverPROFILEdeployjboss-brmswar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

10

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 9: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

package orgjbossbookjcaex1

import javaxnamingInitialContext

public class ExClient public static void main(String args[]) throws Exception InitialContext iniCtx = new InitialContext() Object ref = iniCtxlookup(EchoBean) EchoHome home = (EchoHome) ref Echo echo = homecreate()

Systemoutprintln(Created Echo)

Systemoutprintln(Echoecho(Hello) = + echoecho(Hello))

13 Notas y AdvertenciasFinalmente utilizamos tres estilos visuales para llamar la atencioacuten sobre la informacioacuten que de otromodo se podriacutea pasar por alto

Nota

Una nota es una sugerencia atajo o enfoque alternativo para una tarea determinada Ignorar unanota no deberiacutea tener consecuencias negativas pero podriacutea perderse de algunos trucos quepueden facilitarle las cosas

Importante

Los cuadros con el tiacutetulo de importante dan detalles de cosas que se pueden pasar por altofaacutecilmente cambios de configuracioacuten uacutenicamente aplicables a la sesioacuten actual o servicios quenecesitan reiniciarse antes de que se aplique una actualizacioacuten Ignorar estos cuadros noocasionaraacute peacuterdida de datos pero puede causar enfado y frustracioacuten

Aviso

Las advertencias no deben ignorarse Ignorarlas muy probablemente ocasionaraacute peacuterdida dedatos

2 Coacutemo obtener ayuda y hacer sus comentarios

21 iquestNecesita ayudaSi encuentra dificultades con alguno de los procedimientos descritos en este documento visite el Portaldel cliente de Red Hat en httpaccessredhatcom A traveacutes del portal del cliente usted podraacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

6

buscar o navegar a traveacutes de la base de artiacuteculos de soporte teacutecnico sobre productos de Red Hat

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

acceder a otra documentacioacuten del producto

Red Hat alberga una lista grande de correos electroacutenicos para discutir sobre software de Red Hat ytecnologiacutea Encontraraacute un listado de las listas de correo disponibles al puacuteblico enhttpswwwredhatcommailmanlistinfo Haga clic en el nombre de la lista a la que quiera suscribirse opara acceder a los archivos de listados

22 iexclNecesitamos sus comentariosSi encuentra algun error o si se le ocurre una manera de mejorar este manual nos encantariacutea escucharsus sugerencias Complete un reporte en Bugzilla frente al producto JBoss Enterprise BRMS Platform 5 y el componente doc-BRMS_Administrator_Guide El siguiente enlace le llevaraacute aun reporte de error ya completado para este producto httpbugzillaredhatcom

Llene la siguiente plantilla en el campo de Description de Bugzilla Sea tan especifico como le seaposible al describir el problema esto ayudaraacute a asegurarnos de que lo podemos solucionarraacutepidamente

URL del documento

Nuacutemero de la seccioacuten y nombre

Describa el problema

Sugerencias para mejorar

Informacioacuten adicional

Aseguacuterese de darnos su nombre para poder darle todo el creacutedito por reportar el problema

Prefacio

7

Capiacutetulo 1 Introduccioacuten

11 Cosas nuevas en esta edicioacutenTabla 11 Cosas nuevas en esta edicioacuten

Funcionalidad Cambio

Seccioacuten 223 ldquo Instalar y habilitar ModeShaperdquo Una nueva seccioacuten sobre la instalacioacuten deModeshape como repositorio

Seccioacuten 42 ldquo la configuracioacuten de la base dedatos para ModeShaperdquo

Una nueva seccioacuten sobre la configuracioacuten de unafuente de datos para Modeshape

Seccioacuten 432 ldquo Configure BRMS para utilizar unRDBMS externordquo

Una nueva seccioacuten sobre la configuracioacuten deBRMS para utilizar un RDBMS externo

Capiacutetulo 9 Monitoreamiento Un nuevo capiacutetulo sobre el monitoreamiento deBRMS con un plug-in de Jboss OperationsNetwork

Apeacutendice A Implementacioacuten de JBoss BRMS enEWS

Un nuevo apeacutendice con instrucciones parainstalar JBoss BRMS en Jboss Enterprise WebServer

12 JBoss Enterprise BRMS PlatformJBoss Enterprise BRMS Platform es un sistema de administracioacuten de reglas empresariales basado enJBoss Rules Proporciona una solucioacuten multi-usuario del lado del servidor para la administracioacutenalmacenamiento modificacioacuten e implementacioacuten de reglas y otros activos de JBoss Rules Se brinda unainterfaz de usuario basado en la web asiacute como integracioacuten para JBoss Developer Studio 4

Importante

En varios lugares de JBoss Enterprise BRMS Platform y de su documentacioacuten se refiere aGuvnor Drools Guvnor es el nombre del proyecto de coacutedigo abierto sobre el cual se haconstruiacutedo JBoss Enterprise BRMS Platform Las referencias a Guvnor permanecen en la API lasURLs y en las herramientas de JBoss Developer Studio

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

8

Capiacutetulo 2 Instalacioacuten de unaEn este capiacutetulo aprenderaacute a instalar la plataforma JBoss Enterprise BRMS

JBoss Enterprise BRMS Platform estaacute soportada en diferentes configuraciones del sistema Puedeencoentrar una lista completa de todos los servidores de aplicaciones Java soportados Maacutequinasvirtuales Java y servidores de bases de datos enhttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

Ademaacutes de un servidor de aplicaciones Java una maacutequina virtual Java y un sistema operativosoportados el implementar BRMS en un entorno de produccioacuten requiere un servidor de base de datossoportado para el almacenamiento de activps de reglas

21 Paquetes softwarePuede descargar JBoss Enterprise BRMS Platform del portal de soporte al cleinte de Red Hat enhttpsaccessredhatcom navegando a Descargas Plataforma BRMS y luego seleccionar laversioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombres depaquetes para 520 pero tambieacuten aplican a versiones anteriores excepto donde se observa que no

JBoss Enterprise BRMS Platform se encuentra disponible en dos paquetes diferentes

Paquete autoacutenomoEste paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMSPlatform ya implementado y no requiere un servidor de aplicaciones ya existente

El paquete autoacutenomo estaacute disponible con la versioacuten 510 y posteriores

Si descarga la versioacuten 510 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 51

Aplicacioacuten web JBoss Enterprise BRMS Platform 510 implementado en los perfiles default y production

Si descarga la versioacuten 520 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 511

Aplicacioacuten web JBoss Enterprise BRMS Platform 520 implementado en los perfiles default y production

Consulte Seccioacuten 221 ldquo Instale el paquete autoacutenomordquo y alliacute encontraraacute las instrucciones parainstalar estos paquetes

Paquete implementableEl paquete implementable es un archivo ZIP que contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform empacada como un archivo WAR que se debe implementar en un servidor deaplicaciones soportado ya existente El paquete ZIP tambieacuten contiene componentes opcionales

El paquete implementable contiene los siguientes archivos

jboss-brms-managerzip - la aplicacioacuten web JBoss Enterprise BRMS Platform

jboss-brms-enginezip - las bibliotecas de clientes JBoss Enterprise BRMS Platform

modeshapezip - los archivos necesarios para instalar el repositorio ModeShape

Capiacutetulo 2 Instalacioacuten de una

9

Nota

modeshapezip solo se incluye en la descarga 52 como avance de tecnologiacutea

Consulte Seccioacuten 222 ldquo Instalar el paquete implementablerdquo para ver las instrucciones de coacutemoinstalar este paquete

22 Instrucciones de instalacioacutenLea esta seccioacuten para aprender coacutemo instalar JBoss Enterprise BRMS Platform Siga las instruccionespara el paquete relevante autoacutenomo o implementable

Los pasos opcionales de instalacioacuten estaacute etiquetados como tal y se refieren a los capiacutetulos de estemanual que contienen mayor informacioacuten

221 Instale el paquete autoacutenomoEl paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform yaimplementado como un fichero explotado Siga el procedimiento a continuacioacuten para instalarlo yconfigurarlo

Nota

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para cualquier configuracioacutenadicional requerida para su entorno especifico httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

Procedimiento 21 Instale el paquete autoacutenomo

1 DescargueDescargue el archivo zip del paquete autoacutenomo del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom Navegue a Descargas luego Plataforma BRMS y luego seleccionela versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombresde paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos de que seobserve lo opuesto

2 ExtraacuteigaEl paquete autoacutenomo contiene un directorio uacutenico que contiene la instalacioacuten de JBoss EnterpriseWeb Platform con la aplicaicoacuten web JBoss Enterprise BRMS Platform ya implementada Extraiga elcontenido del archivo zip al directorio en donde se instalaraacute

[localhost ]$ unzip brms-standalone-520zip

JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms-standalone-520jboss-as-webserverPROFILEdeployjboss-brmswar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

10

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 10: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

buscar o navegar a traveacutes de la base de artiacuteculos de soporte teacutecnico sobre productos de Red Hat

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

acceder a otra documentacioacuten del producto

Red Hat alberga una lista grande de correos electroacutenicos para discutir sobre software de Red Hat ytecnologiacutea Encontraraacute un listado de las listas de correo disponibles al puacuteblico enhttpswwwredhatcommailmanlistinfo Haga clic en el nombre de la lista a la que quiera suscribirse opara acceder a los archivos de listados

22 iexclNecesitamos sus comentariosSi encuentra algun error o si se le ocurre una manera de mejorar este manual nos encantariacutea escucharsus sugerencias Complete un reporte en Bugzilla frente al producto JBoss Enterprise BRMS Platform 5 y el componente doc-BRMS_Administrator_Guide El siguiente enlace le llevaraacute aun reporte de error ya completado para este producto httpbugzillaredhatcom

Llene la siguiente plantilla en el campo de Description de Bugzilla Sea tan especifico como le seaposible al describir el problema esto ayudaraacute a asegurarnos de que lo podemos solucionarraacutepidamente

URL del documento

Nuacutemero de la seccioacuten y nombre

Describa el problema

Sugerencias para mejorar

Informacioacuten adicional

Aseguacuterese de darnos su nombre para poder darle todo el creacutedito por reportar el problema

Prefacio

7

Capiacutetulo 1 Introduccioacuten

11 Cosas nuevas en esta edicioacutenTabla 11 Cosas nuevas en esta edicioacuten

Funcionalidad Cambio

Seccioacuten 223 ldquo Instalar y habilitar ModeShaperdquo Una nueva seccioacuten sobre la instalacioacuten deModeshape como repositorio

Seccioacuten 42 ldquo la configuracioacuten de la base dedatos para ModeShaperdquo

Una nueva seccioacuten sobre la configuracioacuten de unafuente de datos para Modeshape

Seccioacuten 432 ldquo Configure BRMS para utilizar unRDBMS externordquo

Una nueva seccioacuten sobre la configuracioacuten deBRMS para utilizar un RDBMS externo

Capiacutetulo 9 Monitoreamiento Un nuevo capiacutetulo sobre el monitoreamiento deBRMS con un plug-in de Jboss OperationsNetwork

Apeacutendice A Implementacioacuten de JBoss BRMS enEWS

Un nuevo apeacutendice con instrucciones parainstalar JBoss BRMS en Jboss Enterprise WebServer

12 JBoss Enterprise BRMS PlatformJBoss Enterprise BRMS Platform es un sistema de administracioacuten de reglas empresariales basado enJBoss Rules Proporciona una solucioacuten multi-usuario del lado del servidor para la administracioacutenalmacenamiento modificacioacuten e implementacioacuten de reglas y otros activos de JBoss Rules Se brinda unainterfaz de usuario basado en la web asiacute como integracioacuten para JBoss Developer Studio 4

Importante

En varios lugares de JBoss Enterprise BRMS Platform y de su documentacioacuten se refiere aGuvnor Drools Guvnor es el nombre del proyecto de coacutedigo abierto sobre el cual se haconstruiacutedo JBoss Enterprise BRMS Platform Las referencias a Guvnor permanecen en la API lasURLs y en las herramientas de JBoss Developer Studio

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

8

Capiacutetulo 2 Instalacioacuten de unaEn este capiacutetulo aprenderaacute a instalar la plataforma JBoss Enterprise BRMS

JBoss Enterprise BRMS Platform estaacute soportada en diferentes configuraciones del sistema Puedeencoentrar una lista completa de todos los servidores de aplicaciones Java soportados Maacutequinasvirtuales Java y servidores de bases de datos enhttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

Ademaacutes de un servidor de aplicaciones Java una maacutequina virtual Java y un sistema operativosoportados el implementar BRMS en un entorno de produccioacuten requiere un servidor de base de datossoportado para el almacenamiento de activps de reglas

21 Paquetes softwarePuede descargar JBoss Enterprise BRMS Platform del portal de soporte al cleinte de Red Hat enhttpsaccessredhatcom navegando a Descargas Plataforma BRMS y luego seleccionar laversioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombres depaquetes para 520 pero tambieacuten aplican a versiones anteriores excepto donde se observa que no

JBoss Enterprise BRMS Platform se encuentra disponible en dos paquetes diferentes

Paquete autoacutenomoEste paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMSPlatform ya implementado y no requiere un servidor de aplicaciones ya existente

El paquete autoacutenomo estaacute disponible con la versioacuten 510 y posteriores

Si descarga la versioacuten 510 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 51

Aplicacioacuten web JBoss Enterprise BRMS Platform 510 implementado en los perfiles default y production

Si descarga la versioacuten 520 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 511

Aplicacioacuten web JBoss Enterprise BRMS Platform 520 implementado en los perfiles default y production

Consulte Seccioacuten 221 ldquo Instale el paquete autoacutenomordquo y alliacute encontraraacute las instrucciones parainstalar estos paquetes

Paquete implementableEl paquete implementable es un archivo ZIP que contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform empacada como un archivo WAR que se debe implementar en un servidor deaplicaciones soportado ya existente El paquete ZIP tambieacuten contiene componentes opcionales

El paquete implementable contiene los siguientes archivos

jboss-brms-managerzip - la aplicacioacuten web JBoss Enterprise BRMS Platform

jboss-brms-enginezip - las bibliotecas de clientes JBoss Enterprise BRMS Platform

modeshapezip - los archivos necesarios para instalar el repositorio ModeShape

Capiacutetulo 2 Instalacioacuten de una

9

Nota

modeshapezip solo se incluye en la descarga 52 como avance de tecnologiacutea

Consulte Seccioacuten 222 ldquo Instalar el paquete implementablerdquo para ver las instrucciones de coacutemoinstalar este paquete

22 Instrucciones de instalacioacutenLea esta seccioacuten para aprender coacutemo instalar JBoss Enterprise BRMS Platform Siga las instruccionespara el paquete relevante autoacutenomo o implementable

Los pasos opcionales de instalacioacuten estaacute etiquetados como tal y se refieren a los capiacutetulos de estemanual que contienen mayor informacioacuten

221 Instale el paquete autoacutenomoEl paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform yaimplementado como un fichero explotado Siga el procedimiento a continuacioacuten para instalarlo yconfigurarlo

Nota

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para cualquier configuracioacutenadicional requerida para su entorno especifico httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

Procedimiento 21 Instale el paquete autoacutenomo

1 DescargueDescargue el archivo zip del paquete autoacutenomo del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom Navegue a Descargas luego Plataforma BRMS y luego seleccionela versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombresde paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos de que seobserve lo opuesto

2 ExtraacuteigaEl paquete autoacutenomo contiene un directorio uacutenico que contiene la instalacioacuten de JBoss EnterpriseWeb Platform con la aplicaicoacuten web JBoss Enterprise BRMS Platform ya implementada Extraiga elcontenido del archivo zip al directorio en donde se instalaraacute

[localhost ]$ unzip brms-standalone-520zip

JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms-standalone-520jboss-as-webserverPROFILEdeployjboss-brmswar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

10

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 11: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Capiacutetulo 1 Introduccioacuten

11 Cosas nuevas en esta edicioacutenTabla 11 Cosas nuevas en esta edicioacuten

Funcionalidad Cambio

Seccioacuten 223 ldquo Instalar y habilitar ModeShaperdquo Una nueva seccioacuten sobre la instalacioacuten deModeshape como repositorio

Seccioacuten 42 ldquo la configuracioacuten de la base dedatos para ModeShaperdquo

Una nueva seccioacuten sobre la configuracioacuten de unafuente de datos para Modeshape

Seccioacuten 432 ldquo Configure BRMS para utilizar unRDBMS externordquo

Una nueva seccioacuten sobre la configuracioacuten deBRMS para utilizar un RDBMS externo

Capiacutetulo 9 Monitoreamiento Un nuevo capiacutetulo sobre el monitoreamiento deBRMS con un plug-in de Jboss OperationsNetwork

Apeacutendice A Implementacioacuten de JBoss BRMS enEWS

Un nuevo apeacutendice con instrucciones parainstalar JBoss BRMS en Jboss Enterprise WebServer

12 JBoss Enterprise BRMS PlatformJBoss Enterprise BRMS Platform es un sistema de administracioacuten de reglas empresariales basado enJBoss Rules Proporciona una solucioacuten multi-usuario del lado del servidor para la administracioacutenalmacenamiento modificacioacuten e implementacioacuten de reglas y otros activos de JBoss Rules Se brinda unainterfaz de usuario basado en la web asiacute como integracioacuten para JBoss Developer Studio 4

Importante

En varios lugares de JBoss Enterprise BRMS Platform y de su documentacioacuten se refiere aGuvnor Drools Guvnor es el nombre del proyecto de coacutedigo abierto sobre el cual se haconstruiacutedo JBoss Enterprise BRMS Platform Las referencias a Guvnor permanecen en la API lasURLs y en las herramientas de JBoss Developer Studio

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

8

Capiacutetulo 2 Instalacioacuten de unaEn este capiacutetulo aprenderaacute a instalar la plataforma JBoss Enterprise BRMS

JBoss Enterprise BRMS Platform estaacute soportada en diferentes configuraciones del sistema Puedeencoentrar una lista completa de todos los servidores de aplicaciones Java soportados Maacutequinasvirtuales Java y servidores de bases de datos enhttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

Ademaacutes de un servidor de aplicaciones Java una maacutequina virtual Java y un sistema operativosoportados el implementar BRMS en un entorno de produccioacuten requiere un servidor de base de datossoportado para el almacenamiento de activps de reglas

21 Paquetes softwarePuede descargar JBoss Enterprise BRMS Platform del portal de soporte al cleinte de Red Hat enhttpsaccessredhatcom navegando a Descargas Plataforma BRMS y luego seleccionar laversioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombres depaquetes para 520 pero tambieacuten aplican a versiones anteriores excepto donde se observa que no

JBoss Enterprise BRMS Platform se encuentra disponible en dos paquetes diferentes

Paquete autoacutenomoEste paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMSPlatform ya implementado y no requiere un servidor de aplicaciones ya existente

El paquete autoacutenomo estaacute disponible con la versioacuten 510 y posteriores

Si descarga la versioacuten 510 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 51

Aplicacioacuten web JBoss Enterprise BRMS Platform 510 implementado en los perfiles default y production

Si descarga la versioacuten 520 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 511

Aplicacioacuten web JBoss Enterprise BRMS Platform 520 implementado en los perfiles default y production

Consulte Seccioacuten 221 ldquo Instale el paquete autoacutenomordquo y alliacute encontraraacute las instrucciones parainstalar estos paquetes

Paquete implementableEl paquete implementable es un archivo ZIP que contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform empacada como un archivo WAR que se debe implementar en un servidor deaplicaciones soportado ya existente El paquete ZIP tambieacuten contiene componentes opcionales

El paquete implementable contiene los siguientes archivos

jboss-brms-managerzip - la aplicacioacuten web JBoss Enterprise BRMS Platform

jboss-brms-enginezip - las bibliotecas de clientes JBoss Enterprise BRMS Platform

modeshapezip - los archivos necesarios para instalar el repositorio ModeShape

Capiacutetulo 2 Instalacioacuten de una

9

Nota

modeshapezip solo se incluye en la descarga 52 como avance de tecnologiacutea

Consulte Seccioacuten 222 ldquo Instalar el paquete implementablerdquo para ver las instrucciones de coacutemoinstalar este paquete

22 Instrucciones de instalacioacutenLea esta seccioacuten para aprender coacutemo instalar JBoss Enterprise BRMS Platform Siga las instruccionespara el paquete relevante autoacutenomo o implementable

Los pasos opcionales de instalacioacuten estaacute etiquetados como tal y se refieren a los capiacutetulos de estemanual que contienen mayor informacioacuten

221 Instale el paquete autoacutenomoEl paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform yaimplementado como un fichero explotado Siga el procedimiento a continuacioacuten para instalarlo yconfigurarlo

Nota

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para cualquier configuracioacutenadicional requerida para su entorno especifico httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

Procedimiento 21 Instale el paquete autoacutenomo

1 DescargueDescargue el archivo zip del paquete autoacutenomo del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom Navegue a Descargas luego Plataforma BRMS y luego seleccionela versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombresde paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos de que seobserve lo opuesto

2 ExtraacuteigaEl paquete autoacutenomo contiene un directorio uacutenico que contiene la instalacioacuten de JBoss EnterpriseWeb Platform con la aplicaicoacuten web JBoss Enterprise BRMS Platform ya implementada Extraiga elcontenido del archivo zip al directorio en donde se instalaraacute

[localhost ]$ unzip brms-standalone-520zip

JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms-standalone-520jboss-as-webserverPROFILEdeployjboss-brmswar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

10

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 12: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Capiacutetulo 2 Instalacioacuten de unaEn este capiacutetulo aprenderaacute a instalar la plataforma JBoss Enterprise BRMS

JBoss Enterprise BRMS Platform estaacute soportada en diferentes configuraciones del sistema Puedeencoentrar una lista completa de todos los servidores de aplicaciones Java soportados Maacutequinasvirtuales Java y servidores de bases de datos enhttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

Ademaacutes de un servidor de aplicaciones Java una maacutequina virtual Java y un sistema operativosoportados el implementar BRMS en un entorno de produccioacuten requiere un servidor de base de datossoportado para el almacenamiento de activps de reglas

21 Paquetes softwarePuede descargar JBoss Enterprise BRMS Platform del portal de soporte al cleinte de Red Hat enhttpsaccessredhatcom navegando a Descargas Plataforma BRMS y luego seleccionar laversioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombres depaquetes para 520 pero tambieacuten aplican a versiones anteriores excepto donde se observa que no

JBoss Enterprise BRMS Platform se encuentra disponible en dos paquetes diferentes

Paquete autoacutenomoEste paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMSPlatform ya implementado y no requiere un servidor de aplicaciones ya existente

El paquete autoacutenomo estaacute disponible con la versioacuten 510 y posteriores

Si descarga la versioacuten 510 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 51

Aplicacioacuten web JBoss Enterprise BRMS Platform 510 implementado en los perfiles default y production

Si descarga la versioacuten 520 el paquete autoacutenomo contiene

JBoss Enterprise Web Platform 511

Aplicacioacuten web JBoss Enterprise BRMS Platform 520 implementado en los perfiles default y production

Consulte Seccioacuten 221 ldquo Instale el paquete autoacutenomordquo y alliacute encontraraacute las instrucciones parainstalar estos paquetes

Paquete implementableEl paquete implementable es un archivo ZIP que contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform empacada como un archivo WAR que se debe implementar en un servidor deaplicaciones soportado ya existente El paquete ZIP tambieacuten contiene componentes opcionales

El paquete implementable contiene los siguientes archivos

jboss-brms-managerzip - la aplicacioacuten web JBoss Enterprise BRMS Platform

jboss-brms-enginezip - las bibliotecas de clientes JBoss Enterprise BRMS Platform

modeshapezip - los archivos necesarios para instalar el repositorio ModeShape

Capiacutetulo 2 Instalacioacuten de una

9

Nota

modeshapezip solo se incluye en la descarga 52 como avance de tecnologiacutea

Consulte Seccioacuten 222 ldquo Instalar el paquete implementablerdquo para ver las instrucciones de coacutemoinstalar este paquete

22 Instrucciones de instalacioacutenLea esta seccioacuten para aprender coacutemo instalar JBoss Enterprise BRMS Platform Siga las instruccionespara el paquete relevante autoacutenomo o implementable

Los pasos opcionales de instalacioacuten estaacute etiquetados como tal y se refieren a los capiacutetulos de estemanual que contienen mayor informacioacuten

221 Instale el paquete autoacutenomoEl paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform yaimplementado como un fichero explotado Siga el procedimiento a continuacioacuten para instalarlo yconfigurarlo

Nota

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para cualquier configuracioacutenadicional requerida para su entorno especifico httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

Procedimiento 21 Instale el paquete autoacutenomo

1 DescargueDescargue el archivo zip del paquete autoacutenomo del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom Navegue a Descargas luego Plataforma BRMS y luego seleccionela versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombresde paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos de que seobserve lo opuesto

2 ExtraacuteigaEl paquete autoacutenomo contiene un directorio uacutenico que contiene la instalacioacuten de JBoss EnterpriseWeb Platform con la aplicaicoacuten web JBoss Enterprise BRMS Platform ya implementada Extraiga elcontenido del archivo zip al directorio en donde se instalaraacute

[localhost ]$ unzip brms-standalone-520zip

JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms-standalone-520jboss-as-webserverPROFILEdeployjboss-brmswar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

10

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 13: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Nota

modeshapezip solo se incluye en la descarga 52 como avance de tecnologiacutea

Consulte Seccioacuten 222 ldquo Instalar el paquete implementablerdquo para ver las instrucciones de coacutemoinstalar este paquete

22 Instrucciones de instalacioacutenLea esta seccioacuten para aprender coacutemo instalar JBoss Enterprise BRMS Platform Siga las instruccionespara el paquete relevante autoacutenomo o implementable

Los pasos opcionales de instalacioacuten estaacute etiquetados como tal y se refieren a los capiacutetulos de estemanual que contienen mayor informacioacuten

221 Instale el paquete autoacutenomoEl paquete autoacutenomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform yaimplementado como un fichero explotado Siga el procedimiento a continuacioacuten para instalarlo yconfigurarlo

Nota

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para cualquier configuracioacutenadicional requerida para su entorno especifico httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

Procedimiento 21 Instale el paquete autoacutenomo

1 DescargueDescargue el archivo zip del paquete autoacutenomo del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom Navegue a Descargas luego Plataforma BRMS y luego seleccionela versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usan los nombresde paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos de que seobserve lo opuesto

2 ExtraacuteigaEl paquete autoacutenomo contiene un directorio uacutenico que contiene la instalacioacuten de JBoss EnterpriseWeb Platform con la aplicaicoacuten web JBoss Enterprise BRMS Platform ya implementada Extraiga elcontenido del archivo zip al directorio en donde se instalaraacute

[localhost ]$ unzip brms-standalone-520zip

JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms-standalone-520jboss-as-webserverPROFILEdeployjboss-brmswar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

10

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 14: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

3 Habilite los usuariosLa configuracioacuten predeterminada usa el perfil de aplicacioacuten JAAS brms Este perfil almacenanombres de usuario y contrasentildeas en el archivo PROFILEconfpropsbrms-usersproperties

Los usuarios se agregan antildeadiendo entradas a este archivo en el formato username=passwordSe puede ignorar los comentarios agregando un caracter de numeral () al principio de la liacutenea

admin=passwordjsmith=srhSm1thtandrews=pp3rrss0nn3ll

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener detalles sobre coacutemo cambiar el perfil JAAS auno que soporte un sistema de autenticacioacuten diferente tal como LDAP

4 OPCIONAL Instale el repositorio ModeShapeModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Consulte Seccioacuten 223 ldquo Instalar y habilitarModeShaperdquo para obtener mayor informacioacuten

NOTA

Modeshape es un avance tecnoloacutegico en BRMS 52

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas utilizan bases de datos incluiacutedas que no son apropiadas osoportadas para entornos de produccioacuten Antes de implementar en un entorno de produccioacutenesta configuracioacuten se debe cambiar a un servidor soportado de base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-

Capiacutetulo 2 Instalacioacuten de una

11

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 15: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicio de sesioacuten de pruebaInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

222 Instalar el paquete implementableEl paquete de implementacioacuten contiene el software tal como se describe en Seccioacuten 21 ldquoPaquetessoftware rdquo Siga el procedimiento a continuacioacuten para instalar y configurar el software

Procedimiento 22 Instale el paquete implementable

1 DescargueDescargue el archivo zip del paquete de implementacioacuten del portal de soporte al cliente de RedHat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS y luegoseleccione la versioacuten La versioacuten actual es 520 Todas las instrucciones a continuacioacuten usanlos nombres de paquete para 520 pero tambieacuten aplican a las versiones anteriores a menos deque se observe lo opuesto

2 Extraiga el softwareExtraiga los archivos implementables BRMS del paquete zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos

jboss-brmsenginezip

jboss-brmsmanagerzip

modeshapezip

Nota

modeshapezip solo se incluye con el paquete implementable para BRMS 52 comoavance de tecnologiacutea

Extraiga el jboss-brmswar de jboss-brms-managerzip

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicacioacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas del cliente de jboss-brms-enginezip a un directorio

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes

3 Copielo al servidor de aplicacionesCopie el fichero expandido de la aplicacioacuten web en el directorio de implementacioacuten de su servidor

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

12

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 16: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

de aplicaciones Aseguacuterese de que el nombre de archivo del fichero expandido de la aplicacioacutenweb es jboss-brmswar El ejemplo a continuacioacuten demuestra esta operacioacuten realizaacutendola enla liacutenea de comandos en Linux

[localhost ]$ cp -rf ~tempjboss-brmswar optbrms-serverjboss-asserverproductiondeploy

La aplicacioacuten no se implementaraacute hasta que se inicie el servidor de aplicaciones

Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor deaplicaciones cuando se necesite Consulte la documentacioacuten del servidor de aplicaciones paraobtener mayores detalles

4 Habilite los usuariosLa configuracioacuten de autenticacioacuten predeterminada usa el perfil JAAS jmx-console Siimplementa en un servidor de aplicaciones ya existente es posible que este perfil ya se hayamodificado En ese caso consulte la documentacioacuten del servidor de aplicaciones para obtenerinstrucciones sobre coacutemo agregar nuevos usuarios

Nota

Cualquier usuario definido en el servidor de aplicaciones podraacute iniciar sesioacuten en lainstalacioacuten de JBoss Enterprise BRMS Platform

Red Hat recomienda que se utilice un sistema de autenticacioacuten separado para los usuarios deJBoss Enterprise BRMS Platform Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para aprender coacutemocambiar el perfil JAAS

La configuracioacuten predeterminada para el perfil jmx-console en los productos JBoss Platformusan el moacutedulo de inicio de sesioacuten UsersRolesLoginModule para almacenar nombres deusuarios y contrasentildeas en el archivo PROFILEconfpropsjmx-console-usersproperties

Se pueden agregar usuarios antildeadiendo entradas a este archivo con el formato username=password Las entradas se pueden comentar anteponiendo el caracter numeral () enuna liacutenea

admin=sekretzjsmith=srhSm1thtandrews=p3r50n311

Nota

Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default

5 OPCIONAL Habilite la firma de paquetes de reglasLa funcionalidad de firma de paquetes de reglas utiliza criptografiacutea con llave puacuteblica paraasegurarse de que los paquetes de reglas no estaacuten dantildeados o no se alteren durante ladescarga Red Hat recomienda que esta funcionalidad esteacute habilitada en un entorno deproduccioacuten

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo para aprender un poco maacutes sobre estetema

Capiacutetulo 2 Instalacioacuten de una

13

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 17: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

6 Configuracioacuten de la base de datosLas configuraciones predeterminadas usan bases de datos incluiacutedas que no son apropiadas nisoportadas en entornos de produccioacuten Antes de implementarlo en un entorno de produccioacuten estaconfiguracioacuten se debe modificar a un servidor de bases de datos que sea soportado

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos

7 Inicie el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en sistemas UNIX oLinux o ejecute runbat en un sistema Microsoft Windows El paraacutemetro -c se debe utilizar paraespecificar cual perfil de servidor utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciarl el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

8 Inicie sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Consulte Apeacutendice A Implementacioacuten de JBoss BRMS en EWS

223 Instalar y habilitar ModeShape

Importante

ModeShape viene junto con la versioacuten 52 de JBoss Enterprise BRMS Platform como avance detecnologiacutea

Lea esta seccioacuten para aprender a remplazar el repositorio predeterminado Apache Jackrabbit conModeShape para una instancia autoacutenoma BRMS

ModeShape es un repositorio de contenido Java (JCR del ingleacutes Java Content Repository) que sepuede utilizar en lugar de Apache Jackrabbit Procedimiento 23 ldquoConfigurar ModeShaperdquo proporcionauna sinopsis del proceso de instalacioacuten de los servicios ModeShape y la configuracioacuten del servidor deJBoss Enterprise BRMS Platform para utilizar ModeShape

Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape

El paquete autoacutenomo BRMS se ha descargado y extraiacutedo consulte Seccioacuten 221 ldquo Instale elpaquete autoacutenomordquo para obtener mayores detalles

Nota

Modeshape es un avance tecnoloacutegico y por lo tanto no se soporta el migrar una instalacioacutenya existente a ModeShape

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

14

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 18: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Apache Ant se instala Consulte Apeacutendice B Instalacioacuten de Apache Ant para obtener detalles

Se requiere una base de datos soportada para una implementacioacuten en produccioacuten

La instancia de la base de datos que se va a utilizar ya se creoacute

Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos

El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio lib dela configuracioacuten del servidor

Consulte httpwwwjbosscomproductsplatformsbrmssupportedconfigurations para obtener una listacompleta de los servidores de la base de datos que son soportados

Procedimiento 23 Configurar ModeShape

1 Descargar y extraer

Nota

Este paso solo es necesario para 510 El paquete autoacutenomo 520 viene con ModeShapeincluiacutedo

Descargue el paquete ModeShape (modeshapezip) del portal de soporte al cliente de Red Hat enhttpsaccessredhatcom

Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalacioacutenBRMS Para la versioacuten autoacutenoma de JBoss Enterprise BRMS Platform este es brms-standalone-510

[localhost ]$ unzip modeshapezip

Despueacutes de la extraccioacuten tendraacute la siguiente estructura

- brms-standalone-520 |- jboss-as-web |- mod_cluster |- modeshape |- picketlink |- resteasy `- seam

2 Ejecute el instalador

Nota

Los siguientes pasos son necesarios para 510 y 520 y estas instrucciones se referiraacutena 520 desde este punto en adelante

Para instalar ModeShape en el perfil de servidor requerido use la liacutenea de comandos paraejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalaraacuteModeShape

Capiacutetulo 2 Instalacioacuten de una

15

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 19: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

[localhost modeshape]$ antBuildfile optBRMS510brms-standalone-510modeshapebuildxml

determine_home

set-web-home

set-as-home

set-soa-home

init [echo] JBoss Home is jboss-as-web

prompt [input] Enter profile to install ModeShape to [default]

El script de instalacioacuten instala los servicios ModeShape en el perfil del servidor especificado

3 Configuracioacuten de usuarios y rolesAgregue las cuentas de usuarios admin y mailman y asigne los roles especificados acontinuacioacuten La configuracioacuten predeterminada usa los archivos de texto para almacenar losnombres de usuario las contrasentildeas y los roles asignados Las instrucciones aquiacute asumen queno se ha cambiado la configuracioacuten de la autorizacioacuten Si siacute se ha cambiado entonces agreguelos usuarios de acuerdo con esa configuracioacuten Consulte Capiacutetulo 6 Seguridad para obetnermayores detalles

a Agregue los usuarios admin y mailmanAbra el archivo PROFILEconfpropsbrms-usersproperties en un editor de textoy agregue los usuarios admin y mailman a este archivo como una nueva liacutenea con lasiguiente sintaxis username=password

admin=s3kr3t5mailman=53cur3m1l

b Asignar rolesAsigne los roles especificados a continuacioacuten a los dos usuarios abriendo el archivo PROFILEconfpropsbrms-rolesproperties en un editor de texto y agregandouna nueva liacutenea para cada usuario con la siguiente sintaxis username=role1 role2 role3

Al usuario admin se le deben asignar los roles de JBossAdmin HttpInvoker user y admin

Al usuario mailman se le debe asignar los roles de JBossAdmin readwrite

admin=JBossAdmin HttpInvoker user adminmailman=JBossAdmin readwrite

c OPCIONAL Codificar contrasentildeasOpcionalmente las contrasentildeas se pueden almacenar de forma codificada en lugar de textoplano Para hacer esto ejecute el siguiente comando en el directorio del servidor deaplicaciones (jboss-as o jboss-as-web) para crear la forma codificada de lacontrasentildea reemplazando PASSWORD con la contrasentildea escogida

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

16

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 20: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

[localhost]$ java -cp clientjboss-logging-spijarlibjbosssxjar orgjbossresourcesecuritySecureIdentityLoginModule PASSWORDEncoded password 5f78dc15b9a559cbdf8592078de921bc

Luego reemplace las contrasentildeas almacenadas en PROFILEconfpropsbrms-usersproperties con las versiones codificadas

4 OPCIONAL Configuracioacuten de la base de datosLa configuracioacuten predeterminada para Modeshape usa una base de datos que no es apropiada osoportada en entornos de produccioacuten Antes de implementar en un entorno de produccioacuten sedebe cambiar esta configuracioacuten a un servidor soportado de la base de datos

Consulte Capiacutetulo 4 Configuracioacuten de la base de datos para ver las instrucciones

5 Borre los archivos JAR no utilizadosBorre los siguientes archivos JAR del directorio serverPROFILEdeployjboss-brmswarWEB-INFlib

jackrabbit-api-210jar

jackrabbit-core-210jar

jackrabbit-jcr-commons-210jar

jackrabbit-spi-210jar

hibernate-commons-annotations-310GAjar

hibernate-core-332GAjar

hibernate-validator-310GAjar

lucene-core-241jar

jcr-20jar

6 Habilitar ModeShape en el WARModifique el archivo jboss-brmswarWEB-INFcomponentsxml para borrar laconfiguracioacuten Apache Jackrabbit y agregar la configuracioacuten ModeShape

Para borrar la configuracioacuten Apache Jackrabbit borre o comente la siguiente seccioacuten

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegtlt-- the root directory for the repo storage the directory must exist --gtlt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

En la configuracioacuten predeterminada se ha comentado la configuracioacuten ModeShape Borre elcomentario de la configuracioacuten tal como se muestra

ltproperty name=propertiesgtltkeygtorgdroolsrepositoryconfiguratorltkeygtltvaluegtorgdroolsrepositorymodeshapeModeShapeRepositoryConfiguratorltvaluegtltkeygtorgmodeshapejcrURLltkeygtltvaluegtjndijcrlocalrepositoryName=brmsltvaluegtltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtadminltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtmailmanltvaluegtltpropertygt

Capiacutetulo 2 Instalacioacuten de una

17

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 21: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

7 Establezca las contrasentildeasModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrasentildeaspara estas cuentas se deben especificar en la configuracioacuten ModeShape del paso anterior

ltkeygtorgdroolsrepositorysecurepasswordsltkeygtltvaluegtfalseltvaluegtltkeygtorgdroolsrepositoryadminpasswordltkeygtltvaluegtpasswordltvaluegtltkeygtorgdroolsrepositorymailmanpasswordltkeygtltvaluegtpasswordltvaluegt

8 Iniciar el servidorPara iniciar el servidor desde la liacutenea de comandos use el comando runsh en un sistema UNIXo Linux o runbat en Microsoft Windows El paraacutemetro -c se debe utilizar para especificar elperfil de servidor a utilizar

[localhost ]$ runsh -c production

Los scripts runsh y runbat se encuentra en el directorio bin

Por ejemplo la ruta completa al directorio bin para el servidor autoacutenomo BRMS 520 es brms-standalone-520jboss-as-webbin

Consulte la documentacioacuten de JBoss Enterprise Web Platform 5 para obtener mayores detallessobre los paraacutemetros adicionales para iniciar el servidor httpdocsredhatcomdocsen-USJBoss_Enterprise_Web_Platform

9 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacuteinstalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

23 Inicio de sesioacuten por primera vezJBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para eldesarrollo y administracioacuten de reglas Despueacutes de una instalacioacuten exitosa se puede utilizar unnavegador web para iniciar la sesioacuten en la interfaz

Procedimiento 24 Iniciar sesioacuten en JBoss Enterprise BRMS Platform

1 Abra la URL en un navegadorAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms replacing localhost con el nombre de host del servidor para acceder al diaacutelogo de inicio de sesioacuten

Figura 21 Diaacutelogo de inicio de sesioacuten

2 Inicio de sesioacutenIntroduzca las credenciales del usuario

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

18

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 22: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Si esta es una nueva instalacioacuten entonces se le preguntara si se debe crear un grupo de reglasde ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso

Despueacutes de que las reglas de ejemplo se han instalado se carga la paacutegina Find

Figura 22 Encontrar la paacutegina

Si este procedimiento no funciona tal como se describe consulte Seccioacuten 24 ldquoInicio de sesioacutenresolucioacuten de problemasrdquo

24 Inicio de sesioacuten resolucioacuten de problemasLos siguientes son los problemas comunes que se encuentran al iniciar sesioacuten en JBoss EnterpriseBRMS Platform por primera vez

Abriacute la URL en mi navegador y no hay ninguna paacutegina para iniciar la sesioacuten

Verifique que el servidor de aplicaciones esteacute ejecutando y que ha terminado de iniciarDependiendo de la carga de su servidor el tiempo que toma en iniciar varia

Verifique que la URL sea correcta para la configuracioacuten del servidor Es posible que elservidor de aplicaciones esteacute configurado con un nombre de host o puerto diferente delpredeterminado

Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos estaacutebloqueando el acceso entonces seraacute necesario configurarlo para permitir el acceso en elpuerto en el que el servidor esteacute ejecutando

Verifique que todos los pasos de la instalacioacuten y de la configuracioacuten se han realizado demanera correcta

Obtengo el mensaje de error Debe configurar un almaceacuten de llaves antes de procederal tratar de iniciar la sesioacuten

La firma de paquetes de reglas estaacute habilitada pero no estaacute configurada correctamente

Consulte Seccioacuten 63 ldquo Firma de paquetes de reglasrdquo

Capiacutetulo 2 Instalacioacuten de una

19

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 23: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Al inciar sesioacuten recibo el mensaje Nombre de usuario o contrasentildea equivocadosLos detalles de inicio de sesioacuten son incorrectos o el sistema de autenticacioacuten no estaacuteconfigurado apropiadamente

Verifique el nombre de usuario y la contrasentildea Estas credenciales tienen en cuenta el usode las mayuacutesculas y minuacutesculas

Verifique que cualquier cambio a la configuracioacuten de la autenticacioacuten sea correcto

Consulte Seccioacuten 61 ldquoAutenticacioacutenrdquo para obtener mayores detalles sobre la configuracioacuten dela autenticacioacuten

Si el problema persiste verifique los registros del servidor Por defecto el perfil del servidor production tiene registros limitados configurados por razones de rendimiento Es posible que seanecesario el configurar los registros para que brinde maacutes detalles y ayude en la depuracioacuten pero RedHat recomienda el reestablecer la configuracioacuten original cuando haya resuelto el problema ConsulteCapiacutetulo 7 Registrospara obtener mayor informacioacuten aobre la configuracioacuten de los registros

Si el problema persiste contacte al grupo de soporte de Red Hat

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

20

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 24: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Capiacutetulo 3 LocalizacioacutenLa interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en muacuteltiples idiomas

Ingleacutes Estados Unidos (en-US)

Japoneacutes (ja-JP)

Chino simplificado (zh-CN)

Si no se especifica un idioma entonces se utiliza ingleacutes americano por defecto

Procedimiento 31 Cambiar el idioma de la interfaz web

1 Ubicar el indexjspEl archivo indexjsp se encuentra en el directorio jboss-brmswar

2 Modifique indexjspModifique el archivo indexjsp para especificar un local opcional El archivo predeterminado indexjsp usa ingles americano por defecto

Ejemplo 31 El indexjsp predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtml responsesendRedirect(redirectURL)gt

Para especificar japoneacutes como el idioma predeterminado modifique el archivo asiacute

Ejemplo 32 indexjsp con japoneacutes como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP responsesendRedirect(redirectURL)gt

Para especificar chino simplificado como el idioma predeterminado modifique el archivo asiacute

Ejemplo 33 indexjsp con chino simplificado como idioma predeterminado

lt String redirectURL = orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN responsesendRedirect(redirectURL)gt

Los idiomas soportados se listan en Tabla 31 ldquoURLs para los idiomas soportadosrdquo

Tabla 31 URLs para los idiomas soportados

Idioma Ruta URL

Japoneacutes orgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificado orgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americano orgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

Capiacutetulo 3 Localizacioacuten

21

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 25: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Se puede especificar un idioma opcional para cada sesioacuten introduciendo manualmente la URL con elparaacutemetro locale incluiacutedo

URLs completas para los idiomas soportados

Japoneacuteshttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=ja_JP

Chino simplificadohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=zh_CN

Ingleacutes americanohttpltlocalhostgt8080jboss-brmsorgdroolsguvnorGuvnorGuvnorhtmllocale=en_US

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

22

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 26: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Capiacutetulo 4 Configuracioacuten de la base de datosLea este capiacutetulo para aprender a configurar las bases de datos que el repositorio JBoss EnterpriseBRMS Platform utiliza cambie la ubicacioacuten del repositorio y configure un RDBMS externo

JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshapecomo repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento perocada una estaacute configurada de manera diferente Las siguientes secciones contienen instruccionessobre la configuracioacuten de la base de datos de cada repositorio

Aviso

Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base dedatos incluiacutedas que no se soportan para uso en produccioacuten Derby y Hypersonicrespectivamente Esta configuracioacuten se incluye solo con el propoacutesito de evaluar y demostrar y nose soporta en entornos de produccioacuten La configuracioacuten de una base de datos soportada serequiere para una implementacioacuten soportada en produccioacuten Consultehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations para ver una lista de lossistemas soportados de la base de datos

41 Configuracioacuten de la base de datos para Apache JackrabbitEl repositorio Apache Jackrabbit almacena dos grupos diferentes de informacioacuten Workspace y VersionsWorkspace es el sistema de almacenamiento de propoacutesito general que mantiene activos regla y otrosdatos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions sepueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base dedatos para una faacutecil administracioacuten

El repositorio JBoss Enterprise BRMS Platform administra el acceso a estas bases de datos usandoadministradores de persistencia Se proporciona un administrador geneacuterico de persistencia para basesde datos que cumplen con los requerimientos de JDBC asiacute como otros varios para implementacionesespecificas para bases de datos Consulte httpwikiapacheorgjackrabbitPersistenceManagerFAQpara encontrar mayor informacioacuten sobre los administradores de persistencia y en Apeacutendice C Ejemplode configuraciones del administrador de persistencia encontraraacute ejemplos

Aviso

Use la funcionalidad de importacioacuten y exportacioacuten (consulte Seccioacuten 52 ldquoImportacioacuten yexportacioacutenrdquo) para retener cualquier activo almacenado en la base de datos existente antes decambiar la configuracioacuten de la base de datos

Aseguacuterese de que lo siguiente estaacute disponible antes de proceder

Una base de datos vaciacutea para que JBoss Enterprise BRMS Platform la utilice

Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platformla utilice JBoss Enterprise BRMS Platform generaraacute tablas de la base de datos en la base de datosespecificada si todaviacutea no existen Una vez que esto se logra Red Hat le recomienda el borrar elpermiso del usuario de la base de datos para crear tablas

La JAR del controlador JDBC apropiada para el servidor de la base de datos

Capiacutetulo 4 Configuracioacuten de la base de datos

23

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 27: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

411 Configure la base de datos WorkspaceLa configuracioacuten existenta de la base de datos Workspace se encuentra en el archivo WorkspacesDefaultworkspacexml El archivo repositoryxml contiene la configuracioacutenpredeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar elespacio de trabajo predeterminado ya existente es maacutes faacutecil el borrarlo y actualizar la configuracioacutenplantilla que se encuentra en repositoryxml

Procedimiento 4 1 Cambiar la base de datos del repositorio

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar para la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-as-webPROFILEproductionlib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$wsphomedbcreate=truegt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Laconfiguracioacuten predeterminada usa la variable $wspname la cual contiene el nombre del espaciode trabajo actual

ltparam name=schemaObjectPrefix value=$wspname_gt

6 Borrar el espacio de trabajo viejoBorre el directorio workspacesDefault

7 ReiniciarReiniciar el servidor de aplicaciones

412 Configurar la base de datos VersionsJBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Estose mantiene en un aacuterea de almacenamiento separado para prevenir la degradacioacuten del rendimiento entanto el nuacutemero de versiones incrementa

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

24

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 28: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Esta aacuterea de almacenamiento tiene su propia configuracioacuten de administracioacuten de la persistenciaalmacenada en el archivo repositoryxml De manera opuesta a la configuracioacuten Workspace laconfiguracioacuten de almacenamiento Version no es tan solo una plantillaes la configuracioacuten real que seestaacute utilizando

Procedimiento 4 2 Cambiar la base de datos Versions

1 ApagarApagar el servidor de aplicaciones antes de realizar estos cambios

2 Instalar la JAR del controlador JDBCCopie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos autilizar en la configuracioacuten del servidor en el directorio lib el cual puede ser por ejemplo jboss-asserverPROFILElib

3 Abra repositoryxml en un editor de textoAbra el archivo repositoryxml en un editor de texto Al utilizar JBoss este archivo seencoentraraacute en el directorio bin del servidor de aplicaciones a menos de que se especifique unaubicacioacuten diferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo)

4 Actualice la configuracioacuten del PersistenceManagerUbique el elemento ltPersistenceManagergt el cual se encuentra dentro de ltWorkspacegt

Por ejemplo

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleDerbyPersistenceManagergt ltparam name=url value=jdbcderby$rephomeversiondbcreate=truegt ltparam name=schemaObjectPrefix value=version_gtltPersistenceManagergt

Reemplace esto con la configuracioacuten apropiada para la base de datos que se va a utilizarConsulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verejemplos

5 Establezca el paraacutemetro schemaObjectPrefixEste valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administradapor el administrador de persistencia (esto debe ser uacutenico en cada base de datos) Si se estaacuteutilizando la misma base de datos para Versions y el almacenamiento de datos aseguacuterese deque no se utiliza el mismo schemaObjectPrefix para ambos (la configuracioacuten predeterminada usa version_)

ltparam name=schemaObjectPrefix value=version_gt

6 ReiniciarReiniciar el servidor de aplicaciones

413 Buacutesqueda y uso de iacutendicesLa funcionalidad de buacutesqueda y de uso de iacutendices dentro de JBoss Enterprise BRMS Platform la brindaApache Lucene (httpluceneapacheorg)

Por defecto el iacutendice de buacutesqueda se mantiene en el sistema de archivos local Esto se debe a quebrinda un rendimiento maacutes raacutepido Red Hat no recomienda el cambiar su configuracioacuten predeterminada amenos de que tenga requerimientos especiacuteficos con relacioacuten a esto

Capiacutetulo 4 Configuracioacuten de la base de datos

25

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 29: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Para configurar la ubicacioacuten del iacutendice de buacutesqueda modifique el elemento ltSearchIndexgt delarchivo repositoryxml

ltSearchIndex class=orgapachejackrabbitcorequeryluceneSearchIndexgt ltparam name=path value=$wsphomeindexgt ltparam name=extractorPoolSize value=2gt ltparam name=supportHighlighting value=truegtltSearchIndexgt

42 la configuracioacuten de la base de datos para ModeShapeLa configuracioacuten del repositorio predeterminado Modeshape usa una fuente de datos JNDI mdash ModeShapeBRMSRepo mdash para almacenamiento de datos lo cual se configura en el archivo PROFILEdeploymodeshape-brms-store-dsxml Modifique este archivo para cambiar laconfiguracioacuten fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivoes un archivo estaacutendar de configuracioacuten de fuente de datos JBoss

Consulte el capiacutetulo sobre la configuracioacuten de la fuente de datos de la documentacioacuten del servidor deaplicaciones para obtener mayores detalles sobre coacutemo configurar fuentes de datos JBoss

43 Configuracioacuten del repositorioLea esta seccioacuten para aprender sobre la configuracioacuten del repositorio y para configurar un RDBMSexterno

JBoss Enterprise BRMS Platform usa la especificacioacuten JCR (del ingleacutes Content Repository API for Java)para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementacioacuten JCRque se incluye

431 Cambiar la ubicacioacuten del repositorio JackRabbitLea esta seccioacuten para aprender a cambiar la ubicacioacuten en donde Jackrabbit almacenaraacute el repositorio

Cuando la aplicacioacuten JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio Amenos de que haya cambiado la configuracioacuten predeterminada este repositorio seraacute generado en eldirectorio bin del servidor de aplicaciones

Especifique una ubicacioacuten diferente para este modificando el archivo de ocnfiguracioacuten de JBoss Seam componentsxml para ese WAR Seleccione una ubicacioacuten segura de la que se haga una copia derespaldo de manera regular

Procedimiento 4 3 Cambie la ubicacioacuten del repositorio

1 Apagar el servidor de aplicacionesDetener el servidor de aplicaciones antes de realizar estos cambios

2 Ubique el archivo componentsxmlEl archivo componentsxml se encuentra en el directorio WEB-INF del fichero web BRMS(deployjboss-brmswarWEB-INF) Este es un archivo de configuracoacuten estaacutendar JBossSeam el cual permite la personalizacioacuten de varioas rutas de la aplicacioacuten

3 Ubique el atributo valor-llave repositoryrootdirectoryAbra el archivo componentsxml en un editor de texto y encuentre el atributo valor-llaverepositoryrootdirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentado

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

26

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 30: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt lt-- ltkeygtrepositoryrootdirectoryltkeygtltvaluegtoptyourpathltvaluegt --gtltpropertygt

nota

Para versiones de BRMS antes de 51 siga los siguientes pasosUbique la propiedad homeDirectoryAbra el archivo componentsxml en un editor de texto y encuentre la propiedadhomeDirectory Se encuentra en el componente repositoryConfiguration y por defectoestaacute comentada

ltcomponent name=repositoryConfigurationgt lt-- This is for configuring the home directory for the repository storage the directory must exist ltproperty name=homeDirectorygt homemichaelRulesRepository_001ltpropertygt--gt ltcomponentgt

4 Actualice el atributo valor-llave repositoryrootdirectoryBorre las etiquetas de comentario alrededor del atributo valor-llave repositoryrootdirectory ycambie el valor a la ruta al directorio en donde el almaceacuten de datos se encontraraacute (este directorioya debe existir)

ltproperty name=propertiesgt ltkeygtorgdroolsrepositoryconfiguratorltkeygt ltvaluegtorgdroolsrepositoryjackrabbitJackrabbitRepositoryConfiguratorltvaluegt lt-- the root directory for the repo storage the directory must exist --gt ltkeygtrepositoryrootdirectoryltkeygt ltvaluegtoptbrms-standalone-520BRMSRulesRepositoryltvaluegtltpropertygt

Capiacutetulo 4 Configuracioacuten de la base de datos

27

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 31: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Nota

Para versiones de BRMS antes de 51 el coacutedigo es asiacute

ltcomponent name=repositoryConfigurationgt ltproperty name=homeDirectorygtoptjboss-soa-platformBRMSRulesRepositoryltpropertygtltcomponentgt

5 Mueva el almaceacuten de datos existente (opcional)JBoss Enterprise BRMS Platform crearaacute un nuevo almaceacuten de datos en ese lugar si todaviacutea nohay uno Para mantener un almaceacuten de datos existente copie los archivos existentes en unnuevo lugar antes de reinicra el servidor de aplicaciones

6 Reinicie el servidor de aplicacionesReinicie el servidor de aplicaciones Si el almaceacuten de datos existente no se movioacute al nuevo lugarentonces se crearaacute un nuevo almaceacuten de datos

432 Configure BRMS para utilizar un RDBMS externoJBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almaceacutende datos El archivo repositoryxml contiene informacioacuten sobre doacutende se almacenan los datos en elrepositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puedemodificar manualmente o se puede utilizar la herramienta Repository Configuration en la interfazde usuario BRMS

Para modificar manualmente el archivo repositoryxml ubique el archivo y aacutebralo con un editor detexto el archivo estaacute anotado con comentarios que describen las opciones

A menos de que se especificara un directorio de inicio diferente (tal como se describe en Seccioacuten 431ldquoCambiar la ubicacioacuten del repositorio JackRabbitrdquo) el archivo repositoryxml se encontraraacute en eldiretcorio bin del servidor de aplicaciones

Consulte Apeacutendice C Ejemplo de configuraciones del administrador de persistencia para verconfiguraciones de ejemplo

Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuracioacuten delrepositorio

1 Inicie sesioacuten en la interfaz del usuarioAbra un navegador web e introduzca la URL httplocalhost8080jboss-brms reemplazando localhost con el nombre de host del servidor para acceder la ventana de inicio de sesioacuten

2 Seleccione la herramienta de configuracioacuten del repositorioDel panel de navegacioacuten seleccione Administration luego Repository Configuration

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

28

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 32: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Figura 4 1 La herramienta de configuracioacuten del repositorio

3 Seleccione el t ipo RDBMSDel menuacute desplegable Select RDBMS type seleccione el tipo RDBMS

Figura 4 2 Tipo RDBMS

4 Introduzca los detalles RDBMSSeleccione USE JNDI si JNDI estaacute configurado

Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datosimplementada

Si JNDI no se estaacute utilizando introduzca la informacioacuten requerida RDBMS

Controlador

URL

Usuario

Contrasentildea

Capiacutetulo 4 Configuracioacuten de la base de datos

29

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 33: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Figura 4 3 Informacioacuten RDBMS

5 Generar el archivo de configuracioacuten del repositorioSeleccione Generate repository config para generar el archivo repositoryxml

Corte y pegue el texto generado en un archivo y guaacuterdelo como repositoryxml o seleccioneSave Configuration para descargar el texto como archivo Reemplace el repositoryxmlexistente con el nuevo repositoryxml A menos de que se especifiqeu un directorio inicialdiferente (tal como se describe en Seccioacuten 431 ldquoCambiar la ubicacioacuten del repositorioJackRabbitrdquo) el archivo repositoryxml se encoentraraacute en el directorio bin del servidor deaplicaciones

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

30

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 34: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Capiacutetulo 5 Administracioacuten de datos

51 Copia de seguridad de datosJBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de losdatos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de labase de datos proporciona

Al re-establecer una copia de seguridad Red Hat le recomienda que borre los iacutendices de la base dedatos de manera que se vuelvan a crear y optimizar para los nuevos datos

Aviso

No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridaddel repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que suvenedor de bases de datos le proporciona T iene varias limitacioens tal como se observoacute enSeccioacuten 52 ldquoImportacioacuten y exportacioacutenrdquo las cuales no lo hacen apropiado como herramienta pararealizar copias de seguridad y Red Hat no lo soporta en esa capacidad

52 Importacioacuten y exportacioacutenJBoss Enterprise BRMS Platform proporciona una funcionalidad de importacioacuten y exportacioacuten estaacutendarJCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en unarchivo XML tal como lo definen los estaacutendares JCR Esta funcionalidad se puede acceder desde laseccioacuten de administracioacuten del panel de navigacioacuten

Aviso

La funcionalidad de importacioacutenexportacioacuten no es para realizar copias de seguridad Siempreutilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione

Debe tener en cosideracioacuten los siguientes puntos al importar o exportar

Al importar se borra todo el contenido existente en la base de datos

Las operaciones de importacioacuten y exportacioacuten se deben realizar soacutelamente cuando la base de datosno se esteacute utilizando

El rendimiento depende mucho del tamantildeo de la base de datos y de la memoria disponible para elservidor El importar es un proceso muy intenso para la memoria

El historial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas seraacutere-establecido con la fecha en la que se importaron

53 Migracioacuten de datos entre versiones de BRMSPara migrar el repositorio desde una versioacuten antigua de JBoss Business Rules ManagementSystem a la versioacuten actual es necesario el exportar el repositorio desde la instancia antigua de JBossBusiness Rules Management System (tal como se describe en Procedimiento 51 ldquoExportar elrepositoriordquo) y luego importar el repositorio a la versioacuten actual (tal como se describe enProcedimiento 52 ldquoImportar el repositoriordquo)

Capiacutetulo 5 Administracioacuten de datos

31

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 35: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Procedimiento 51 Exportar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Clic en Importar Exportar

3 Clic en Exportar

El navegador descargaraacute un archivo zip que contiene el repositorio en un archivo XML

Dependiendo del tamantildeo del repositorio esta operacioacuten puede llegar a tomar su tiempo

NOTA

Al importar un repositorio es importante observar que cualquier contenido en el repositorio seborraraacute y se reemplazaraacute con el contenido en el archivo XML que se importa

Procedimiento 52 Importar el repositorio

1 Desde el panel de navegacioacuten del lado izquierdo seleccione Administracioacuten

2 Seleccione el XML desde la maacutequina local que se cargaraacute haciendo clic en Choose File luegohaga clic en Import

3 Clic en Import

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

32

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 36: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Figura 51 Importar y exportar el repositorio

Cuando la importacioacuten ha terminado una ventana reportaraacute Repositorio de reglas importado demanera exitosa El navegador ahora se actualizaraacute para mostrar el nuevo contenido

54 Re-construccioacuten de paquetes binariosLuego de actualizar JBoss Business Rules Management System e importar un repositorio existentees necesario volver a construir los paquetes binarios

Para volver a construir los paquetes binario seleccione Bases de conocimiento del Menuacute denavegacioacuten y haga clic en Re-construir todos los paquetes binarios

Figura 52 Re-construccioacuten de paquetes

Capiacutetulo 5 Administracioacuten de datos

33

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 37: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Capiacutetulo 6 SeguridadLea este capiacutetulo con el fin de aprender a coacutemo habilitar y configurar los diferentes sistemas deseguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aquiacute son

Autenticacioacuten

Autorizacioacuten

Firma de paquetes de reglas

61 AutenticacioacutenLa plataforma JBoss Enterprise BRMS usa el servicios de autorizacioacuten y autenticacioacuten Java paraverificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utilizapara acceder un sistema de autenticacioacuten separado El sistema separado puede ser un protocolo LDAP(del ingleacutes Lightweight Directory Access Protocol) un servidor de directorios activos o una base dedatos JDBC

Importante

Cuando se le otorga acceso a los usuarios a la instalacioacuten de JBoss Enterprise BRMS Platformpotencialmente se les brinda la habilidad de afectar la loacutegica empresarial de otras aplicacionesUse la autorizacioacuten con base en roles para definir lo que puede hacer cada usuario ConsulteSeccioacuten 62 ldquo Autorizacioacutenrdquo para aprender maacutes sobre este tema

Configure el meacutetodo de autenticacioacuten a utilizar por medio del archivo jboss-brmswarWEB-INFcomponentsxml La configuracioacuten predeterminada tiene muchas opciones con comentariospero la configuracioacuten en siacute se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygt ltcomponentgt

NOTA

El archivo componentsxml cambioacute en BRMS 52 En BRMS 51 y versiones anteriores elarchivo se ve asiacute

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=jmx-consolegt ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

34

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 38: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Importante

Esta configuracioacuten predeterminada usa los nombres de cuentas contrasentildeas y roles que sedefinen en la poliacutetica de autenticacioacuten jmx-console Red Hat recomienda el modificar estapoliacutetica para personalizarla de acuerdo con su entorno especifico

Para configurar la autenticacioacuten siga estos pasos

1 Modifique el moacutedulo de inicio de sesioacuten apropiado de JBoss del servidor de aplicaciones

2 Configure JBoss Enterprise BRMS Platform para que utilice ese moacutedulo

Nota

Muchos moacutedulos de inicio de sesioacuten de JBoss brindan una manera de especificar uno o maacutesroles para cada usuario JBoss Enterprise BRMS Platform tiene su propio mecanismo paraadministrar roles de usuarios

Aviso

Si se inhabilita la autorizacioacuten basada en roles de manera efectiva todos los usuarios tienen elpapel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform

Importante

Red Hat recomienda habilitar la authorizacioacuten basada en roles Antes de hacerlo asigne por lomenos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez quese habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas delas tareas administrativas incluyendo el administrar los roles de los usuarios (esto se explica enmaacutes detalle en Seccioacuten 62 ldquo Autorizacioacutenrdquo)

611 Ejemplo de autenticacioacuten UserRolesLoginModuleEste ejemplo ilustra el uso del moacutedulo de inicio de sesioacuten orgjbosssecurityauthspiUsersRolesLoginModule para acceder a un grupo de cuentasde usuarios almacenados en los archivos propsbrms-usersproperties y propsbrms-rolesproperties

Procedimiento 61 Ejemplo de autenticacioacuten UserRolesLoginModule

1 Aseguacuterese de que el sistema de autenticacioacuten estaacute configurado correctamenteEste moacutedulo de inicio de sesioacuten usa dos archivos para almacenar el nombre de inicio de sesioacutenla contrasentildea y los roles asignados a cada usuario Cree los archivos brms-usersproperties y brms-rolesproperties en el directorio jboss-as-webserverPROFILEconfprops y luego especique por lo menos un usuario en brms-usersproperties usando este formato username=password (el archivo brms-rolesproperties se puede dejar vaciacuteo)

Capiacutetulo 6 Seguridad

35

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 39: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

lt--BRMS Platform Security Domain--gtltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiUsersRolesLoginModule flag=requiredgt ltmodule-option name=usersPropertiesgt propsbrms-usersproperties ltmodule-optiongt ltmodule-option name=rolesPropertiesgt propsbrms-rolesproperties ltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployJBoss-BRMSwarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

612 Ejemplo de autenticacioacuten LDAPLDAP es una opcioacuten popular para compantildeias grandes Los pasos baacutesicos de configuracioacuten son losmismos que el ejemplo anterior aunque los detalles de la configuracioacuten seraacuten diferentes

Procedimiento 62 Ejemplo de autenticacioacuten dos LDAP

1 Aseguacuterese de que el servidor LDAP estaacute configurado correctamenteAeguacuterese de que la configuracioacuten de la red y del cortafuegos no esteacuten evitando la comunicacioacutenenter el servidor de aplicaciones y el servidor LDAP

2 Apagar

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

36

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 40: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Apague el servidor de aplicaciones antes de realizar estos cambios

3 Configure el moacutedulo de inicio de sesioacuten de JBossPara configurar los moacutedulos de inicio de sesioacuten de JBoss abra jboss-as-webserverPROFILEconflogin-configxml en un editor de texto Es un archivo XMLque contiene un elemento ltpolicygt con varios elementos hijos ltapplication-policygtCada elemento ltapplication-policygt define un esquema de autenticacioacuten diferenteAgregue el siguiente pedazo XML ltapplication-policygt como un nuevo hijo del elemento ltpolicygt

ltapplication-policy name=brmsgt ltauthenticationgt ltlogin-module code=orgjbosssecurityauthspiLdapExtLoginModule flag=required gt ltmodule-option name=javanamingproviderurlgt ldapldapcompanycom389 ltmodule-optiongt ltmodule-option name=bindDNgtDEPARTMENTsomeadminltmodule-optiongt ltmodule-option name=bindCredentialgtpasswordltmodule-optiongt ltmodule-option name=baseCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=baseFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=rolesCtxDNgtcn=Usersdc=companydc=com ltmodule-optiongt ltmodule-option name=roleFiltergt(sAMAccountName=0)ltmodule-optiongt ltmodule-option name=roleAttributeIDgtmemberOfltmodule-optiongt ltmodule-option name=roleAttributeIsDNgttrueltmodule-optiongt ltmodule-option name=roleNameAttributeIDgtcnltmodule-optiongt ltmodule-option name=roleRecursiongt-1ltmodule-optiongt ltmodule-option name=searchScopegtONELEVEL_SCOPEltmodule-optiongt ltlogin-modulegt ltauthenticationgtltapplication-policygt

Actualice los valores en este archivo de configuracioacuten con los valores apropiados para suservidor LDAP

4 Configure la plataforma BRMS para utilizar el moacutedulo de inicio de sesioacutenAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml Contiene un elemento ltcomponentsgt con varios elementos hijosincluyendo ltsecurityidentitygt

Agregue Comente el elemento ltsecurityidentitygt para evitar conflictos Agregue elsiguiente elemento ltsecurityidentitygt

ltsecurityidentity authenticate-method=authenticatorauthenticate jaas-config-name=brmsgt

La propiedad jaas-config-name debe ser igual que application-policy Si se cambioacute la propiedadapplication-policy en el paso anterior entonces modifique la propiedad jaas-config-name para quecoincidan

5 ReiniciarReinicral el servidor de aplicaciones

Capiacutetulo 6 Seguridad

37

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 41: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Nota

Para aprender maacutes sobre los diferentes escenarios de configuracioacuten de LDAP lea la informacioacutendisponible en estas dos paacuteginas web httpwwwjbossorgcommunitywikiLdapLoginModule yhttpwwwjbossorgcommunitywikiLdapExtLoginModule

62 AutorizacioacutenBRMS usa autorizacioacuten basada en roles para asignar permisos a los usuarios Por defecto laautorizacioacuten basada en roles estaacute inhabilitada y se debe habilitar de manera similar los roles se debenasignar a los usuarios Si no se habilita la autorizacioacuten basada en roles entonces todos los usuariostienen todos los privilegios administrativos

Figura 61 Administracioacuten de los permisos de usuario

Procedimiento 63 Habilitar la autorizacioacuten con base en roles

1 Asignar privilegios administrativos a un usuarioAntes de habilitar la autorizacioacuten con base en roles es necesario asignar por lo menos unusuario confiable al rol de administrador

Consulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

2 ApagarApague el servidor de aplicaciones antes de realizar estos cambios

3 Abra componentsxmlAbra el archivo jboss-as-webserverPROFILEdeployjboss-brmswarWEB-INFcomponentsxml en un editor de texto

4 Ubique el elemento ltproperty name=enableRoleBasedAuthorizationgtEn el archivo predeterminado componentsxml este elemento XML es un hijo de ltcomponentsgt

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgtfalseltpropertygtltcomponentgt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

38

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 42: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=falsegt

5 Actualice el valor del atributo como VerdaderoActualice el valor de la propiedad enable-role-based-authorization como true y guarde el archivo

ltcomponent name=orgjbossseamsecurityroleBasedPermissionResolvergt ltproperty name=enableRoleBasedAuthorizationgttrueltpropertygtltcomponentgt

NOTA

En las versions 51 y anteriores ubique el siguiente XML

ltsecurityrole-based-permission-resolver enable-role-based-authorization=truegt

6 ReiniciarReinicral el servidor de aplicaciones

JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que sonasignados como usuarios BRMS seraacuten visibles en los permisos de usuarios de JBoss Enterprise BRMSPlatform

Procedimiento 64 Agregue un nuevo usuario a BRMS

1 Seleccione los detalles de los permisosSeleccione Administration del navigation pane luego escoja User Permissions

2 Agregue el mapeo de usuariosHaga clic en el botoacuten Create new user mapping Escriba el nombre del usuario en laventana que aparece y luego haga clic en OK

Nota

El nombre de usuario que se especifica para el rol debe coincidir con un nombre deusuario en el servicio de autenticacioacuten o no funcionaraacute

3 Agregar permisosConsulte Procedimiento 65 ldquoAdministracioacuten de los permisos de usuariordquo para obtener mayoresdetalles

Procedimiento 65 Administracioacuten de los permisos de usuario

Capiacutetulo 6 Seguridad

39

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 43: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

1 Seleccionar permisos de usuarioSeleccione Administration del navigation pane luego escoja User Permissions

2 Seleccionar el usuarioHaga clic Open al lado del nombre de usuario

Figura 62 Detalles sobre los permisos

3 Asignar permisos de usuariosHaga clic en el iacutecono con el signo mas para agregar permisos y seleccione los permisosapropiados del menuacute desplegable Permission type Haga clic en OK para confirmar

Figura 63 Modifique los permisos del usuario

4 Borre permisos de usuarioHaga clic en el iacutecono con el menos al lado del permiso que se va a borrar y haga clic en OK paraconfirmar

Aquellos usuarios con el rol de administradores podraacuten modificar los roles y los permisos de otros

A los usuarios se les puede otorgar cualquiera de estos tres roles

admin

analyst

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

40

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 44: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

package

Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo atodas las aacutereas de JBoss Enterprise BRMS Platform

Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos dereglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso

Nota

Al asignar permisos para analistas a un usuario se le pediraacute una categoria Las categorias sonuna manera de agrupar reglas independiente de los paquetes de conocimiento a los quepertenecen

Nota

Tambieacuten hay permisos para analistas de soacutelo lectura para situaciones como cuando un analistaes el responsable de mantener reglas en una categoriacutea pero necesita poder examinar reglas enotra

Importante

Un usuario a quien se le ha otorgado permisos de categoriacutea no podraacute ver ninguna vista depaquete ni detalles solo podraacuten ver la vista de categoriacuteas simples

Al asignar el rol se le pide que seleccione un paquete al que se limitaraacuten los permisos Hay trespermisos de paquetes diferentes de doacutende escoger al asignarle uno a un usuario

Administrador de paquetes

El permiso del administrador de paquetes otorga un control completo sobre el paquete especificadoincluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ninguacutenderecho administrativo a ninguna otra parte de JBoss Enterprise BRMS Platform

Desarrollador de paquetes

El desarrollador de paquetes le permite a los usuarios el crear y modificar objetos dentro del paqueteespecificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar elpaquete

Paquete de soacutelo lectura

El permiso de soacutelo lectura de paquetes es similar al permiso de soacutelo lectura de analistas pero le otorgaacceso a un paquete en lugar de una categoriacutea

63 Firma de paquetes de reglasLea esta seccioacuten apara prender sobre la firma de paquetes de reglas y la configuracioacuten delalmacenamiento de llaves

Capiacutetulo 6 Seguridad

41

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 45: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

La firma de paquetes de reglas asegura que los paquetes no se pueden dantildear o alterar durante ladescarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no estaacutehabilitado por defecto

Importante

Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de produccioacuten

La firma de paquetes de reglas se implementa usando criptografiacutea de llaves puacuteblicas Se utiliza elcomando JDK keytool para crear una llave privada y un certificado digital puacuteblico correspondiente Lospaquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente Lallave privada se almacena en un archivo llamado un almaceacuten de llaves y el servidor lo utiliza para firmarautomaacuteticamente cada paquete El certificado puacuteblico se hace disponible para cada aplicacioacuten cliente enun almaceacuten de llaves conocido como un almaceacuten de confianza El certificado en el almaceacuten de confianzase utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que esteacutendantildeados o que sean modificados durante la descarga seraacuten rechazados por el cliente ya que la firmaya no coincidiraacute con el certificado

El procedimiento a continuacioacuten describe el proceso de configurar el servidor para la firma de paquetesde reglas

Con este proceso es necesario

Crear una llave privada de firma y un certificado digital puacuteblico correspondiente

Hacer disponibles la llave privada de firma y el certificado digital puacuteblico en el servidor en losalmacenes de llaves

Configurar el servidor para utilizar los almacenes de llaves

Procedimiento 66 Configurar la firma de paquetes de reglas

1 Crear un almaceacuten privado de llavesUse el comando keytool para crear el almaceacuten privado de llaves

keytool -genkey -alias ALIAS -keyalg RSA -keystore PRIVATEkeystore

El paraacutemetro -alias especifica el nombre utilizado para enlazar las entidades relacionadas enel almaceacuten de llaves Use el mismo alias para cada uno de estos pasos El alias no detallamayuacutesculas o minuacutesculas El paraacutemetro -keystore proporicona el nombre del archivo que secrearaacute para mantener la llave privada

keytool le pediraacute su informacioacuten de identificacioacuten asiacute como dos contrasentildeas La primeracontrasentildea la contrasentildea del almaceacuten de llaves asegura el almaceacuten de llaves La segundacontrasentildea la contrasentildea clave asegura la llave que se estaacute creando

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

42

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 46: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

[localhost ]$ keytool -genkey -alias BRMSKey -keyalg RSA -keystore PrivateBRMSkeystoreEnter keystore password Re-enter new password What is your first and last name [Unknown] John SmithWhat is the name of your organizational unit [Unknown] AccountsWhat is the name of your organization [Unknown] ACME INCWhat is the name of your City or Locality [Unknown] Captital CityWhat is the name of your State or Province [Unknown] CCWhat is the two-letter country code for this unit [Unknown] USIs CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=US correct [no] yesEnter key password for ltBRMSKeygt (RETURN if same as keystore password) Re-enter new password

2 Crear un certificado digitalUse el comando keytool para crear un certificado digital

keytool -export -alias ALIAS -file CERTIFICATEcrt -keystore PRIVATEkeystore

Use el mismo alias y almaceacuten de llaves que en el paso anterior El paraacutemetro -file es el nombredel archivo del nuevo certificado que se crearaacute El paraacutemetro -keystore proporciona el nombredel archivo del almaceacuten privado de llaves

Introduzca la contrasentildea del almaceacuten de llaves cuando se le pida

[localhost ]$ keytool -export -alias BRMSKey -file BRMSKeycrt -keystore PrivateBRMSkeystoreEnter keystore password Certificate stored in file ltBRMSKeycrtgt

3 Importe el certificado digital en un almaceacuten de confianzaUse el comando keytool para importar el certificado digital en un almaceacuten de llaves

keytool -import -alias ALIAS -file CERTIFICATEcrt -keystore PUBLICkeystore

Esto crearaacute un nuevo almaceacuten de llaves el almaceacuten de confianza el cual contiene el certificadodigital El almaceacuten de confianza hace disponible el certificado digital para las aplicaciones clientes

Capiacutetulo 6 Seguridad

43

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 47: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

[localhost ]$ keytool -import -alias BRMSKey -file BRMSKeycrt -keystore PublicBRMSkeystoreEnter keystore password Re-enter new password Owner CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USIssuer CN=John Smith OU=Accounts O=ACME INC L=Captial City ST=CC C=USSerial number 4ca0021bValid from Sun Sep 26 223155 EDT 2010 until Sat Dec 25 213155 EST 2010Certificate fingerprints MD5 311D1B9859CC0E3C3F5701C2FEF26DC9 SHA1 4C2652CA0A92CC7A8604505380942A4F826F53AD Signature algorithm name SHA1withRSA Version 3Trust this certificate [no] yesCertificate was added to keystore

4 Mueva el almaceacuten privado de llaves en un lugar seguroEs necesario mantener el almaceacuten privado de llaves en un lugar seguro en donde solo lo puedaacceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma maacutequina o enun lugar asegurado de la red que esteacute diponible para esa maacutequina

Importante

JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticacioacuten arecursos en la red Si el almaceacuten privado de llaves se almacena en un lugar seguro d elared entonces los procedimientos de autenticacioacuten se deben realizar de parte del servidorJBoss Enterprise BRMS para hacer el almaceacuten privado de llaves disponible para este Porejemplo el sistema operativo puede autenticar y montar un archivo compartido quemantenga el lamaceacuten privado de llaves como un directorio local para que el servidor JBossEnterprise BRMS Platform tenga acceso a el

5 Mueva el almaceacuten de confianza a un lugar puacuteblicoEs necesario que el almaceacuten de confianza sea accequible para las aplicaciones clientes Esto sepuede lograr poniendo el almaceacuten de confianza en una red compartida o como host en unservidor web

6 Configure las propiedades de serializacioacuten DroolsLas propiedades del sistema de serializacioacuten Drools tienen que establecerse en el servidorEstas son las propiedades que almacenan la informacioacuten requerida para acceder los almacenesde llaves Ya que JBoss Enterprise BRMS Platform tambieacuten contiene componentes cliente tantolas propiedades privadas del almaceacuten de llaves como las del almaceacuten de confianza se tienen queconfigurar en el servidor

Consulte Seccioacuten 631 ldquoConfiguracioacuten de propiedades de serializacioacutenrdquo para obtener detallessobre doacutende se pueden establecer las propiedades

Las propiedades que es necesario configurar son

droolsserializationsign - indica si la firma estaacute habilitada Debe estar configuradocomo true

droolsserializationprivatekeyStoreURL - la URL en donde se encuentra elalmaceacuten privado de llaves

droolsserializationprivatekeyStorePwd - la contrasentildea para el almaceacuten dellaves

droolsserializationprivatekeyAlias - el alias utilizado al crear el almaceacuten de

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

44

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 48: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

llaves

droolsserializationprivatekeyPwd - la contrasentildea llave

droolsserializationpublickeyStoreURL - la URL en donde se encuentra elalmaceacuten de confianza

droolsserializationpublickeyStorePwd - la contrasentildea para el almaceacuten deconfianza

7 Codifique las credenciales del almaceacuten de llavesLa contrasentildea del almaceacuten de llaves actualmente estaacute almacenado en texto simple

Consulte httpsaccessredhatcomkbdocsDOC-47247 para obtener instrucciones sobre coacutemoenmascarar las credenciales del almaceacuten de llaves

Consulte el manual del usuario BRMS para obtener instrucciones sobre coacutemo configurar clientespara que usen paquetes firmados de reglas

631 Configuracioacuten de propiedades de serializacioacutenLas propiedades del sistema para las credenciales del almaceacuten de llaves se pueden configurar envarios lugares tal como se describe a continuacioacuten Es necesario configurar las propiedades en un soacutelolugar y estaraacuten disponibles para todas las aplicaciones ejecutando en la misma instancia del servidorde aplicaciones sin importar en donde se configuran

Servicio de propiedades JBossPAra configurar las propiedades usando el servicio de propiedades JBoss agregue lasiguiente configuracioacuten bean administrada al archivo serverPROFILEdeployproperties-servicexml reemplazando los valores delejemplo con los que sean apropiados para su sistema

ltmbean code=orgjbossvariapropertySystemPropertiesService name=jbosstype=Servicename=SystemPropertiesgt ltattribute name=Propertiesgt Drools Security Serialization specific properties droolsserializationsign=true droolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystore droolsserializationprivatekeyStorePwd=storepassgoeshere droolsserializationprivatekeyAlias=BRMSKey droolsserializationprivatekeyPwd=keypassgoeshere droolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystore droolsserializationpublickeyStorePwd=keypassgoeshere ltattributegtltmbeangt

archivo de propiedades jboss-brmwarPAra configurar las propiedades en el archivo de propiedades jboss-brmswar agregue elsiguiente coacutedigo al archivo jboss-brmswarWEB-INFclassespreferencesproperties

Capiacutetulo 6 Seguridad

45

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 49: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

droolsserializationsign=truedroolsserializationprivatekeyStoreURL=fileoptsecurePrivateBRMSkeystoredroolsserializationprivatekeyStorePwd=storepassgoesheredroolsserializationprivatekeyAlias=BRMSKeydroolsserializationprivatekeyPwd=keypassgoesheredroolsserializationpublickeyStoreURL=fileoptpublicPublicBRMSkeystoredroolsserializationpublickeyStorePwd=keypassgoeshere

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

46

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 50: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Capiacutetulo 7 RegistrosLa aplicacioacuten web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que log4jproporciona

La configuracioacuten incluiacuteda en el WAR WEB-INFclasseslog4jxml enviacutea todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro seincluyen al final del archivo de registro del servidor PROFILElogserverlog Cuando seimplementa en el perfil del servidor default estos mensajes se presentaraacuten en la consola delservidor

Para cambiar el comportamiento de registro modifique el archivo de configuracioacuten log4j para el perfilrelevante de servidor jboss-as-webserverPROFILEconfjboss-log4jxml

Agregue el siguiente XML al perfil del servidor a la configuracioacuten log4j del perfil del servidor defaultpara crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor

ltcategory name=STDOUT additivity=falsegt ltpriority value=INFO gt ltappender-ref ref=FILEgt ltcategorygt

Nota

Consulte la documentacioacuten de JBoss Enterprise Application Platform para aprender un poco maacutessobre los registros

Capiacutetulo 7 Registros

47

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 51: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Capiacutetulo 8 Personalizacioacuten

81 Personalizar la interfaz del usuarioLa interfaz del usuario de BRMS se produce dinaacutemicamente por medio del marco de trabajo GWT Laapariencia de esta interfaz del usuario se puede personalizar para propoacutesitos de integracioacuten o de estilomodificando las imaacutegenes y las hojas de estilo CSS

Los archivos css y algunas de las imaacutegenes se encuentran en el directorio jboss-brmswarorgdroolsguvnorGuvnor (el resto de las imaacutegenes se encuentran en el sub-directorio images) Para acceder a ellas el archivo WAR se debe implementar como un ficheroexplotado tal como se describe en Capiacutetulo 2 Instalacioacuten de una

Modifique o reemplace las imaacutegenes y los archivos CSS y no cambie los nombres de los archivos Siencuentra problemas re-establezca las versiones originales de los archivos desde el fichero WAR

Nota

Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versionespara facilitar el mantenimiento

Para realizar el cambio lo que se hace usualmente es reemplazar las imaacuteges de acuerdo al estilo lascuales son el logo en la parte superior de la pantalla y el iacutecono de sitio favoritos(hdrlogo_brmsgif y droolsgif respectivamente)

El Guvnorcss controla el estilo general de los elementos de la paacutegina

Aviso

Los componentes GWT usan varios archivos CSS adicionales No los cambie

Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementacioacutenllamado jboss-brmswarWEB-INFwebxml Use el mismo proceso para cualquier otra aplicacioacutenweb Java

82 Personalizacioacuten de selectores para la construccioacuten depaquetes

Importante

Este es solaacutemente un avance de tecnologiacutea

Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando lafuncionalidad Packages se puede especificar un selector Un selector filtra la lista de reglasconstruiacutedas en el paquete Introduzca el nombre de un selector tal como esteacute configurando en elservidor en la cajilla de texto selector

[1]

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

48

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 52: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Nota

Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Estoes necesario con el fin de realizar cualquier personalizacioacuten o cualquier tarea de configuracioacutenEncontraraacute mayor informacioacuten sobre esto en Capiacutetulo 2 Instalacioacuten de una

Ubique el archivo selectorsproperties En este archivo hay detalles que explican coacutemoconfigurar un selector personalizado Tambieacuten puede agregar un nuevo archivo selectorsproperties a la ruta de clase del sistema Las opciones son el utilizar un archivo DRL(Drools Rule Language) o el nombre de una clase que implemente la interfaz AssetSelector (ya hayun ejemplo de un archivo DRL en el archivo selectorsproperties)

Aseguacuterese de que a cada selector se le da un nombre uacutenico en este archivo de propiedades Estosseraacuten los nombres que se utilizaraacuten al construir paquetes de conocimiento

[1] El iacuteco no d e favo rito s se p resenta en d iferentes lug ares d ep end iend o d el naveg ad o r y d el s is tema o p erativo Usualmente seve en la b arra d e d ireccio nes d el naveg ad o r en el menuacute d e favo rito s o d e marcad o res la b arra d el tiacutetulo d e la ventana asiacute co moel iacuteco no uti l izad o p ara un atajo URL d el escrito rio d e trab ajo

Capiacutetulo 8 Personalizacioacuten

49

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 53: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Capiacutetulo 9 MonitoreamientoJBoss Operations Network es la suite de administracioacutein del sistema middleware JBoss y s epuedeutilizar para monitorear JBoss Business Rules Management System

JBoss Operations Network estaacute disponible de httpsaccessredhatcom Consulte el JBossOperations Network Installation Guide para ver las instrucciones de instalacioacuten

91 Instale el plug-in JBoss Operations NetworkEl plug-in BRMS JBoss ON se puede instalar por medio de la liacutenea de comandos o por medio de lainterfaz web del usuario JBss ON

Procedimiento 91 Instale el plug-in JBoss Operations Network por medio de la liacutenea decomandos

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Instale el plug-inEs necesario instalar el plug-in en el directorio del servidor JBoss ON Mueva el archivo jardescomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red HatEnterprise Linux con JBoss ON instale en el opt directorio

mv rhq-brms-plugin-520jar optjon-server-240GA1rhq-brms-plugin-520jar

4 Reinicie el servidor JBoss ON

Procedimiento 92 Instale el plug-in JBoss Operations Network por medio de la interfaz webJBOss ON

1 Descargue el plug-in JBoss ONDercague el plug-in JBoss ON del portal del cliente

a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBossOperations Network y despueacutes seleccione JBoss ON for BRMS del menuacutedesplegable

b Haga clic en Download para iniciar la descarga

2 Descomprima la descarga del plug-inDescomprima el archivo jar del archivo zip descargado

unzip jon-plugin-pack-brms-241GAzip

3 Inicie sesioacuten en la interfaz del usuario JBoss ON

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

50

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 54: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Vaya a la paacutegian de inicio de sesioacuten httplocalhost7080Logindo e inicie la sesioacuten

4 Crague el archivo jar plug-inDel menuacute seleccione Administration System Configuration Plugins Haga clic en elbotoacuten Add y seleccione el archivo jar extraiacutedo del paso anterior y haga clic en upload

92 Descubra la instancia BRMSDespueacutes de instalar el plug-in JBoss Operations Network necesita descubrir la instancia BRMS quese estaacute monitoreando

JBoss Operations Network descubriraacute de manera automaacutetica BRMS Sin embargo si esto no ocurreentonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network BasicAdmin Guide para obtener mayores detalles

Despuesde que se ha descubierto BRMS debe ser importado al inventario

Procedimiento 93 Importar BRMS

1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import

2 Del menuacute Resources seleccione servidores

3 Seleccione el servidor JMX para ver el servicio BRMS

NOTA

Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMSLos Mbeans se pueden habilitar pasando el paraacutemetro

-Ddroolsmbeans = enabled

O por medio de la API

KnowledgeBaseConfiguration conf =KnowledgeBaseFactorynewKnowledgeBaseConfiguration()confsetOption( MBeansOptionENABLED )

Capiacutetulo 9 Monitoreamiento

51

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 55: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Implementacioacuten de JBoss BRMS en EWSBRMS se puede instalar en JBoss Enterprise Web Server 101 con Tomcat 5 y 6

Para ver las instrucciones de instalacioacuten y configuracioacuten para JBoss Enterprise Web Server consulteJBoss Enterprise Web Server Installation Guide

Procedimiento A1 Instale el paquete de implementacioacuten en JBoss Enterprise Web Server

1 Descargue BRMSDescargue el archivo zip del paquete de implementacioacuten BRMS del portal de soporte al cliente deRed Hat en httpsaccessredhatcom Navegue hasta Descargas luego Plataforma BRMS yluego seleccione la versioacuten

2 Extraiga el softwareExtraiga los archivos de implementacioacuten BRMS del archivo zip

[localhost ]$ unzip brms-deployable-520zip

Esto crearaacute los siguientes archivos zip

jboss-brmsenginezip

jboss-brmsmanagerzip

Extraiga el jboss-brmswar de jboss-brms-managerzip Por ejemplo

[localhost ]$ unzip brms-managerzip

Esto crearaacute un directorio jboss-brmswar el cual contiene la aplicaicoacuten web JBoss EnterpriseBRMS Platform como fichero expandido

Extraiga las bibliotecas cliente de jboss-brms-enginezip en un directorio Por ejemplo

[localhost ]$ unzip brms-enginezip -d client

Esto crea un directorio que contiene los archivos jar de la biblioteca cliente

3 Copie jboss-brmswar al servidor de aplicacionesCopie el directorio BRMS extraiacutedo jboss-brmswar al siguiente diretcorio EWS tomcatversionwebappsjboss-brmsWEB-INF en donde version es el nuacutemero de laversioacuten 5 o 6

4 Copie las bibliotecas slf4 j a la aplicacioacuten web implementadaCopie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicacioacuten webBRMS implementada

$ cp clientlibslf4j jboss-brmswarWEB-INFlib

5 Habilitar los usuariosCree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentacioacuten de Tomcatpara obtener mayores detalles

6 Inicie el servidorNavegue a tomcatversionbin y use el comando runsh en sistemas UNIX o Linux o runbaten sistemas Microsoft Windows para iniciar el servidor

7 Inicio de sesioacutenInicie sesioacuten en la aplicacioacuten web JBoss Enterprise BRMS Platform para confirmar que estaacute

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

52

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 56: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

instalado y ejecutando correctamente Consulte Seccioacuten 23 ldquo Inicio de sesioacuten por primera vezrdquopara obtener mayores detalles

Implementacioacuten de JBoss BRMS en EWS

53

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 57: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Instalacioacuten de Apache AntLa herramienta de contruccioacuten Java Apache Ant y el plug-in Trax se requiere para la instalacioacuten deJBoss ModeShape No se requiere para la instalacioacuten u operacioacuten normal de JBoss Enterprise BRMSPlatform Apache Ant requiere un JRE (del ingleacutes Java Runtime Environment) correctamente instalado

Si estaacute ejecutando en una estacioacuten de trabajo de desarrollo puede que Apache Ant ya esteacute instalado Elpaquete Apache Ant del sitio web de Apache Ant incluye el plug-in Trax pero Red Hat Enterprise Linux loincluye como un paquete separado

Procedimiento B1 Instalacioacuten de Apache Ant en Red Hat Enterprise Linux

Descargue e instale Apache Ant y el plug-in Trax en Red Hat Enterprise Linux Repository emitiendoeste comando

[localhost]$ sudo yum install ant-trax

Procedimiento B2 Instalacioacuten de Apache Ant en otros sistemas operativos

1 Descargar y extraerDescargue el lanzamiento binario Apache Ant de httpantapacheorgbindownloadcgi

Una vez que esteacute descargado extraacuteigalo en el lugar preferido de instalacioacuten tal como cProgram FilesApacheAnt or optapache-ant-18

2 Agregue la variable de entorno ANT_HOMECree una variable de entorno llamada ANT_HOME Esta variable tiene que tener la ruta creada enel paso anterior

Haga esto en Red Hat Enterprise Linux agregando la siguiente liacutenea al archivo ~bash_profile substituyendo la ruta con la creada en el paso anterior

export ANT_HOME=optapache-ant-181

En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel yluego seleccione System -gt Advanced -gt Environment Variables

Cree una nueva variable llaacutemela ANT_HOME y configuacuterela para que apunte al directorio creadoen el paso anterior

3 Incluya bin en el PATHAgregue el directorio bin de la instalacioacuten Ant a la variable de entorno PATH

En sistemas UnixLinux esto se logra simplemente agregando la siguiente liacutenea al archivo ~bash_profile despueacutes de la que establece la variable ANT_HOME

export PATH=$PATH$ANT_HOMEbin

En Microsoft Windows haga esto abriendo el Control Panel y seleccionando System -gtAdvanced -gt Environment Variables -gt System Variables Modifique la variable PATH y agregue el texto ANT_HOMEbin

Para probar la instalacioacuten Apache Ant ejecute ant -version desde la liacutenea de comandos La salidase debe ver similar a esta

[localhost]$ ant -versionApache Ant version 18 compiled on June 27 2008

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

54

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 58: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Para aprender un poco maacutes sobre Apache Ant visite la paacutegina web del proyecto enhttpantapacheorg

Instalacioacuten de Apache Ant

55

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 59: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Ejemplo de configuraciones del administrador de persistenciaAquiacute hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datossoportadas Tendraacute que actualizar los valores en las configuraciones con los que sean correctos parasu base de datos tal como la URL JDBC y el schemaObjectPrefix

Importante

JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aquiacutehttpwwwjbosscomproductsplatformsbrmssupportedconfigurations

PAra obtener detalles adicionales sobre los administradores de persistencia Apache Jackrabbit debeconsultar httpwikiapacheorgjackrabbitPersistenceManagerFAQ

Ejemplo C1 Configuracioacuten geneacuterica JDBC para MySQL usando BundleDbPersisenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleBundleDbPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhostbrmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schema value=mysqlgt ltparam name=schemaObjectPrefix value=$wspname_gtltPersistenceManagergt

Ejemplo C2 Configuracioacuten MySQL usando MySqlPersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleMySqlPersistenceManagergt ltparam name=driver value=commysqljdbcDrivergt ltparam name=url value=jdbcmysqllocalhost3306brmsgt ltparam name=user value=brms_usergt ltparam name=password value=brms_passwordgt ltparam name=schemaObjectPrefix value=$wspname_gt ltparam name=schema value=mysqlgtltPersistenceManagergt

Ejemplo C3 Configuracioacuten Oracle usando OraclePersistenceManager

ltPersistenceManager class= orgapachejackrabbitcorepersistencebundleOraclePersistenceManagergt ltparam name=driver value=oraclejdbcOracleDrivergt ltparam name=url value=jdbcoraclethinlocalhost1521brms gt ltparam name=schema value=oraclegt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

56

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 60: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Ejemplo C4 Configuracioacuten PostgreSQL usando PostgreSQLPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundlePostgreSQLPersistenceManagergt ltparam name=driver value=orgpostgresqlDrivergt ltparam name=url value=jdbcpostgresqllocalhost5432brms gt ltparam name=schema value=postgresqlgt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo C5 Configuracioacuten Microsoft SQL Server 2005 usando MSSqlPersistenceManager

ltPersistenceManager class=orgapachejackrabbitcorepersistencebundleMSSqlPersistenceManagergt ltparam name=driver value=commicrosoftsqlserverjdbcSQLServerDrivergt ltparam name=url value=jdbcsqlserverlocalhost3918DatabaseName=brms gt ltparam name=user value=brms_user gt ltparam name=password value=brms_password gt ltparam name=schema value=mssqlgt ltparam name=schemaObjectPrefix value=$wspname_ gtltPersistenceManagergt

Ejemplo de configuraciones del administrador de persistencia

57

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones
Page 61: JBoss Enterprise BRMS Platform-5-BRMS Administrator Guide-Es-ES

Historial de revisionesRevisioacuten 520-24 00 2013-10-31 Ruumldiger Landmann

Rebuild with publican 400

Revisioacuten 520-2 2012-07-18 Anthony TownsRebuild for Publican 30

Revisioacuten 520-2 Tue Jul 1 2011 L CarlonActualizado para 520

Se agregoacute la seccioacuten sobre monitoreamientoSe agregaron las instrucciones de instalacioacuten de EWS

Revisioacuten 510-1 Tue Mar 1 2011 Darrin MisonSe agregoacute las instrucciones sobre ModeShape

Revisioacuten 510-0 Tue Aug 17 2010 David Le Sage Darrin MisonCreado para 510

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

58

  • Table of Contents
  • Prefacio
    • 1 Convenciones del Documento
      • 11 Convenciones tipograacuteficas
      • 12 Convenciones del documento
      • 13 Notas y Advertencias
        • 2 Coacutemo obtener ayuda y hacer sus comentarios
          • 21 iquestNecesita ayuda
          • 22 iexclNecesitamos sus comentarios
              • Capiacutetulo 1 Introduccioacuten
                • 11 Cosas nuevas en esta edicioacuten
                • 12 JBoss Enterprise BRMS Platform
                  • Capiacutetulo 2 Instalacioacuten de una
                    • 21 Paquetes software
                    • 22 Instrucciones de instalacioacuten
                      • 221 Instale el paquete autoacutenomo
                      • 222 Instalar el paquete implementable
                      • 223 Instalar y habilitar ModeShape
                        • 23 Inicio de sesioacuten por primera vez
                        • 24 Inicio de sesioacuten resolucioacuten de problemas
                          • Capiacutetulo 3 Localizacioacuten
                          • Capiacutetulo 4 Configuracioacuten de la base de datos
                            • 41 Configuracioacuten de la base de datos para Apache Jackrabbit
                              • 411 Configure la base de datos Workspace
                              • 412 Configurar la base de datos Versions
                              • 413 Buacutesqueda y uso de iacutendices
                                • 42 la configuracioacuten de la base de datos para ModeShape
                                • 43 Configuracioacuten del repositorio
                                  • 431 Cambiar la ubicacioacuten del repositorio JackRabbit
                                  • 432 Configure BRMS para utilizar un RDBMS externo
                                      • Capiacutetulo 5 Administracioacuten de datos
                                        • 51 Copia de seguridad de datos
                                        • 52 Importacioacuten y exportacioacuten
                                        • 53 Migracioacuten de datos entre versiones de BRMS
                                        • 54 Re-construccioacuten de paquetes binarios
                                          • Capiacutetulo 6 Seguridad
                                            • 61 Autenticacioacuten
                                              • 611 Ejemplo de autenticacioacuten UserRolesLoginModule
                                              • 612 Ejemplo de autenticacioacuten LDAP
                                                • 62 Autorizacioacuten
                                                • 63 Firma de paquetes de reglas
                                                  • 631 Configuracioacuten de propiedades de serializacioacuten
                                                      • Capiacutetulo 7 Registros
                                                      • Capiacutetulo 8 Personalizacioacuten
                                                        • 81 Personalizar la interfaz del usuario
                                                        • 82 Personalizacioacuten de selectores para la construccioacuten de paquetes
                                                          • Capiacutetulo 9 Monitoreamiento
                                                            • 91 Instale el plug-in JBoss Operations Network
                                                            • 92 Descubra la instancia BRMS
                                                              • Implementacioacuten de JBoss BRMS en EWS
                                                              • Instalacioacuten de Apache Ant
                                                              • Ejemplo de configuraciones del administrador de persistencia
                                                              • Historial de revisiones