Home

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

1. O redhat JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Para administradores de JBoss Edici n 5 2 0 Landmann JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Para administradores de JBoss Edicion 5 2 0 Landmann rlandmann redhat com Legal Notice Copyright 2010 Red Hat Inc This document is licensed by Red Hat under the Creative Commons Attribution ShareAlike 3 0 Unported License If you distribute this document or a modified version of it you must provide attribution to Red Hat Inc and provide a link to the original If the document is modified all Red Hat trademarks must be removed Red Hat as the licensor of this document waives the right to enforce and agrees not to assert Section 4d of CC BY SA to the fullest extent permitted by applicable law Red Hat Red Hat Enterprise Linux the Shadowman logo JBoss MetaMatrix Fedora the Infinity Logo and RHCE are trademarks of Red Hat Inc registered in the United States and other countries Linux is the registered trademark of Linus Torvalds in the United States and other countries Java is a registered trademark of Oracle and or its affiliates XFS is a trademark of Silicon Graphics International Corp or its subsidiaries in the United States and or other countries MySQL is a registered trademark of MySQL AB in the United States the European Union and other countries Node js is an official trademark of
2. Los detalles de inicio de sesi n son incorrectos o el sistema de autenticaci n no est configurado apropiadamente Verifique el nombre de usuario y la contrase a Estas credenciales tienen en cuenta el uso de las may sculas y min sculas Verifique que cualquier cambio a la configuraci n de la autenticaci n sea correcto la autenticaci n 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 sea necesario el configurar los registros para que brinde m s detalles y ayude en la depuraci n pero Red Hat recomienda el reestablecer la configuraci n original cuando haya resuelto el problema Consulte Si el problema persiste contacte al grupo de soporte de Red Hat 20 Capitulo 3 Localizaci n Cap tulo 3 Localizaci n La interfaz web del usuario de JBoss Enterprise Application Platform se puede ver en m ltiples idiomas gt Ingl s Estados Unidos en US gt Japon s ja JP gt Chino simplificado zh CN Si no se especifica un idioma entonces se utiliza ingl s americano por defecto Procedimiento 3 1 Cambiar el idioma de la interfaz web 1 Ubicar el index jsp El archivo index jsp se encuentra en el directorio jboss brms war 2 Modifique index jsp Modifique el archivo index jsp para especificar un local opcional El archivo predeterminado index jsp usa ingles americano por defecto
3. Ejemplo 3 1 El index jsp predeterminado lt String redirectURL org drools guvnor Guvnor Guvnor htm1 response sendRedirect redirectURL gt Para especificar japon s como el idioma predeterminado modifique el archivo as Ejemplo 3 2 index jsp con japon s como idioma predeterminado lt String redirectURL org drools guvnor Guvnor Guvnor htm1 locale ja_JP response sendRedirect redirectURL gt Para especificar chino simplificado como el idioma predeterminado modifique el archivo asi Ejemplo 3 3 index jsp con chino simplificado como idioma predeterminado lt String redirectURL org drools guvnor Guvnor Guvnor htm1 locale zh_CN response sendRedirect redirectuRL gt Tabla 3 1 URLs para los idiomas soportados Idioma Ruta URL Japon s org drools guvnor Guvnor Guvnor htm1 locale ja_JP Chino simplificado org drools guvnor Guvnor Guvnor htm1 locale zh_CN Ingl s americano org drools guvnor Guvnor Guvnor htm1 locale en_US 21 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Se puede especificar un idioma opcional para cada sesi n introduciendo manualmente la URL con el par metro locale inclu do URLs completas para los idiomas soportados Japon s 22 Cap tulo 4 Configuraci n de la base de datos Cap tulo 4 Configuraci n de la base de datos Lea este cap tulo para aprender a configurar las bases de datos que el repositorio JBoss Enterprise BRMS
4. JBoss Enterprise Web Platform 5 1 1 Aplicaci n web JBoss Enterprise BRMS Platform 5 2 0 implementado en los perfiles default y production instalar estos paquetes Paquete implementable El paquete implementable es un archivo ZIP que contiene la aplicaci n web JBoss Enterprise BRMS Platform empacada como un archivo WAR que se debe implementar en un servidor de aplicaciones soportado ya existente El paquete ZIP tambi n contiene componentes opcionales El paquete implementable contiene los siguientes archivos jboss brms manager zip la aplicaci n web JBoss Enterprise BRMS Platform jboss brms engine zip las bibliotecas de clientes JBoss Enterprise BRMS Platform modeshape zip los archivos necesarios para instalar el repositorio ModeShape JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS K NN modeshape zip solo se incluye en la descarga 5 2 como avance de tecnologia instalar este paquete 2 2 Instrucciones de instalacion Lea esta secci n para aprender c mo instalar JBoss Enterprise BRMS Platform Siga las instrucciones para el paquete relevante aut nomo o implementable Los pasos opcionales de instalaci n est etiquetados como tal y se refieren a los cap tulos de este manual que contienen mayor informaci n 2 2 1 Instale el paquete aut nomo El paquete aut nomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform ya implementado como un fichero explotado Siga el p
5. 26 Cap tulo 4 Configuraci n de la base de datos lt property name properties gt lt key gt org drools repository configurator lt key gt lt value gt org drools repository jackrabbit JackrabbitRepositoryConfigurator lt valu e gt lt the root directory for the repo storage the directory must exist gt lt lt key gt repository root directory lt key gt lt value gt opt yourpath lt value gt gt lt property gt Para versiones de BRMS antes de 5 1 siga los siguientes pasos Ubique la propiedad homeDirectory gt Abra el archivo components xml en un editor de texto y encuentre la propiedad homeDirectory Se encuentra en el componente repositoryConfiguration y por defecto est comentada lt component name repositoryConfiguration gt lb This is for configuring the home directory for the repository storage the directory Mustrexistonsts lt property name homeDirectory gt home michael RulesRepository_001 lt property gt Aa lt component gt 4 Actualice el atributo valor llave repository root directory Borre las etiquetas de comentario alrededor del atributo valor llave repository root directory y cambie el valor a la ruta al directorio en donde el almac n de datos se encontrar este directorio ya debe existir lt property name properties gt lt key gt org drools repository configurator lt key gt lt value gt org drools repository jackrabbit JackrabbitRepositoryC
6. Control Panel y seleccionando System gt Advanced gt Environment Variables gt System Variables Modifique la variable PATH y agregue el texto ANT_HOME bin Para probar la instalaci n Apache Ant ejecute ant version desde la l nea de comandos La salida se debe ver similar a esta localhost ant version Apache Ant version 1 8 compiled on June 27 2008 54 Instalaci n de Apache Ant Para aprender un poco mas sobre Apache Ant visite la pagina web del proyecto en 55 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Ejemplo de configuraciones del administrador de persistencia Aqui hay varios ejemplos de configuraciones del administrador de persistencia para las bases de datos soportadas Tendra que actualizar los valores en las configuraciones con los que sean correctos para su base de datos tal como la URL JDBC y el schemaObjectPrefix OP importante JBoss Enterprise BRMS Platform es soportado en las bases de datos listadas aqui Ejemplo C 1 Configuraci n gen rica JDBC para MySQL usando BundleDbPersisenceManager lt PersistenceManager class org apache jackrabbit core persistence bundle BundleDbPersistenceManager gt lt param name driver value com mysql jdbc Driver gt lt param name url value jdbc mysql localhost brms gt lt param name user value brms_user gt lt param name password value brms_password gt lt param name schema value mysql gt lt param name sch
7. EWS tomcatversion webapps jboss brms WEB INF en donde version es el n mero de la versi n 5 O 6 Copie las bibliotecas slf4j a la aplicaci n web implementada Copie las bibliotecas slf4j del directorio client creado en el paso anterior en la aplicaci n web BRMS implementada cp client lib slf4j jboss brms war WEB INF 1ib Habilitar los usuarios Cree un LoginModule personalizado para Tomcat 5 o 6 consulte la documentaci n de Tomcat para obtener mayores detalles Inicie el servidor Navegue a tomcatversion bin y use el comando run sh en sistemas UNIX o Linux o run bat en sistemas Microsoft Windows para iniciar el servidor Inicio de sesi n Inicie sesi n en la aplicaci n web JBoss Enterprise BRMS Platform para confirmar que est para obtener mayores detalles Implementaci n de JBoss BRMS en EWS 53 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Instalacion de Apache Ant La herramienta de contrucci n Java Apache Ant y el plug in Trax se requiere para la instalaci n de JBoss ModeShape No se requiere para la instalaci n u operaci n normal de JBoss Enterprise BRMS Platform Apache Ant requiere un JRE del ingl s Java Runtime Environment correctamente instalado Si est ejecutando en una estaci n de trabajo de desarrollo puede que Apache Ant ya est instalado El paquete Apache Ant del sitio web de Apache Ant incluye el plug in Trax pero Red Hat Enterprise Linux lo incluye como
8. JBoss Enterprise BRMS Platform proporciona una interfaz de usuario basada en la web para el desarrollo y administraci n de reglas Despu s de una instalaci n exitosa se puede utilizar un navegador web para iniciar la sesi n en la interfaz Procedimiento 2 4 Iniciar sesi n en JBoss Enterprise BRMS Platform 1 Abra la URL en un navegador localhost con el nombre de host del servidor para acceder al di logo de inicio de sesi n Login x 5 Login User name Password oK Figura 2 1 Di logo de inicio de sesi n 2 Inicio de sesi n Introduzca las credenciales del usuario 18 Cap tulo 2 Instalaci n de una Si esta es una nueva instalaci n entonces se le preguntara si se debe crear un grupo de reglas de ejemplo y otros activos Los ejemplos son buenos para aprender probar y demostrar su uso Despu s de que las reglas de ejemplo se han instalado se carga la p gina Find File Edit View History Bookmarks Tools Help lt bg 2 a 19 http localhost 8080 jboss brms org drools guv r Gly a Welcome admin Sign Out Navigate Find Browse Name search Create New v O 9D Assets gt Find items with a name matching 4 Find E 4 Inbox Include archived assets in results C Incoming changes Search Recently Opened k amp Recently Edited O Enter the name or part of a name Alternatively use the categories to browse E t By Status S saa By Category Text search
9. configurar el servidor para la firma de paquetes de reglas Con este proceso es necesario Crear una llave privada de firma y un certificado digital p blico correspondiente Hacer disponibles la llave privada de firma y el certificado digital p blico en el servidor en los almacenes de llaves Configurar el servidor para utilizar los almacenes de llaves Procedimiento 6 6 Configurar la firma de paquetes de reglas 1 Crear un almac n privado de llaves Use el comando keytool para crear el almac n privado de llaves keytool genkey alias ALIAS keyalg RSA keystore PRIVATE keystore El parametro alias especifica el nombre utilizado para enlazar las entidades relacionadas en el almac n de llaves Use el mismo alias para cada uno de estos pasos El alias no detalla may sculas o min sculas El par metro keystore proporicona el nombre del archivo que se crear para mantener la llave privada keytool le pedir su informaci n de identificaci n as como dos contrase as La primera contrase a la contrase a del almac n de llaves asegura el almac n de llaves La segunda contrase a la contrase a clave asegura la llave que se est creando 42 Capitulo 6 Segurida localhost keytool genkey alias BRMSKey keyalg RSA keystore PrivateBRMS keystore Enter keystore password Re enter new password What is your first and last name Unknown John Smith What is the name of your organizational unit Unknown A
10. de un selector tal como est configurando en el servidor en la cajilla de texto selector Capitulo 8 Personalizaci n Para configurar un selector primero implemente el WAR BRMS como un fichero explotado Esto es necesario con el fin de realizar cualquier personalizaci n o cualquier tarea de configuraci n Ubique el archivo selectors properties En este archivo hay detalles que explican c mo configurar un selector personalizado Tambi n puede agregar un nuevo archivo selectors properties 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 hay un ejemplo de un archivo DRL en el archivo selectors properties Aseg rese de que a cada selector se le da un nombre nico en este archivo de propiedades Estos ser n los nombres que se utilizar n al construir paquetes de conocimiento 1 El cono de favoritos se presenta en diferentes lugares dependiendo del navegador y del sistema operativo Usualmente se ve en la barra de direcciones del navegador en el men de favoritos o de marcadores la barra del t tulo de la ventana as como el cono utilizado para un atajo URL del escritorio de trabajo 49 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Capitulo 9 Monitoreamiento JBoss Operations Network es la suite de administraci in del sistema middleware JBoss y s epuede utilizar para monitore
11. downloads images notes scripts svgs Los listados de c digo fuente tambi n se muestran en romano monoespaciado pero se presentan y resaltan de la siguiente manera JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS package org jboss book jca ex1 import javax naming InitialContext public class ExClient public static void main String args throws Exception InitialContext iniCtx new InitialContext Object ref iniCtx lookup EchoBean EchoHome home EchoHome ref Echo echo home create System out println Created Echo System out println Echo echo Hello echo echo Hello 1 3 Notas y Advertencias Finalmente utilizamos tres estilos visuales para llamar la atenci n sobre la informaci n que de otro modo se podr a pasar por alto Una nota es una sugerencia atajo o enfoque alternativo para una tarea determinada Ignorar una nota no deber a tener consecuencias negativas pero podr a perderse de algunos trucos que pueden facilitarle las cosas Importante Los cuadros con el t tulo de importante dan detalles de cosas que se pueden pasar por alto f cilmente cambios de configuraci n nicamente aplicables a la sesi n actual o servicios que necesitan reiniciarse antes de que se aplique una actualizaci n Ignorar estos cuadros no ocasionar p rdida de datos pero puede causar enfado y frustraci n Las advertencias no deben ignorarse Ignorarlas muy probablemente o
12. env a todos los mensajes a STDOUT Cuando se implementa en el perfil del servidor production los mensajes de registro se incluyen al final del archivo de registro del servidor PROFILE 10g server log Cuando se implementa en el perfil del servidor default estos mensajes se presentar n en la consola del servidor Para cambiar el comportamiento de registro modifique el archivo de configuraci n 10943 para el perfil relevante de servidor jboss as web server PROFILE conf jboss 10g4j3 xml Agregue el siguiente XML al perfil del servidor a la configuraci n 10943 del perfil del servidor default para crear una nueva categoria que dirija los mensajes STDOUT al archivo de registros del servidor lt category name STDOUT additivity false gt lt priority value INFO gt lt appender ref ref FILE gt lt category gt K NN Consulte la documentaci n de JBoss Enterprise Application Platform para aprender un poco m s sobre los registros 47 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Capitulo 8 Personalizacion 8 1 Personalizar la interfaz del usuario La interfaz del usuario de BRMS se produce din micamente por medio del marco de trabajo GWT La apariencia de esta interfaz del usuario se puede personalizar para prop sitos de integraci n o de estilo modificando las im genes y las hojas de estilo CSS Los archivos css y algunas de las im genes se encuentran en el directorio jboss brms war
13. interfaz de usuario BRMS Para modificar manualmente el archivo repository xml1 ubique el archivo y bralo con un editor de texto el archivo est anotado con comentarios que describen las opciones Procedimiento 4 4 Configure un RDBMS externo con la herramienta de configuraci n del repositorio 1 Inicie sesi n en la interfaz del usuario localhost con el nombre de host del servidor para acceder la ventana de inicio de sesi n 2 Seleccione la herramienta de configuraci n del repositorio Del panel de navegaci n seleccione Administration luego Repository Configuration 28 Capitulo 4 Configuraci n de la base de datos JBoss BRMS Browse Find Repository Config Category Manager e TET Manage Repository Configuration PQA Package snapshots RDBMS Info Administration Select RDBMS type H2 M category Use JNDI g fe status Continue E Archive Event Log User permission Lal Import Export Y Rules Verification Repository Configuration About e Figura 4 1 La herramienta de configuraci n del repositorio Seleccione el tipo RDBMS Del men desplegable Select RDBMS type seleccione el tipo RDBMS Find Repository Config Category Manager 2 Manage Repository Configuration RDBMS Info Select RDBMS ype Choose Microsoft SQL Server MySQL Oracle 9i Use JNDI Oracle 10g Oracle 11 PostgreSQL Derby H2 Figura 4 2 Tipo RDBMS Introduzca los detalles RDBMS Seleccion
14. la ruta completa al directorio bin para el servidor aut nomo BRMS 5 2 0 es brms JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS standalone 5 2 0 jboss as web bin Consulte la documentaci n de JBoss Enterprise Web Platform 5 para obtener mayores detalles 8 Inicio de sesi n de prueba Inicie sesi n en la aplicaci n web JBoss Enterprise BRMS Platform para confirmar que est para obtener mayores detalles 2 2 2 Instalar el paquete implementable Procedimiento 2 2 Instale el paquete implementable 1 Descargue Descargue el archivo zip del paquete de implementaci n del portal de soporte al cliente de Red seleccione la versi n La versi n actual es 5 2 0 Todas las instrucciones a continuaci n usan los nombres de paquete para 5 2 0 pero tambi n aplican a las versiones anteriores a menos de que se observe lo opuesto 2 Extraiga el software Extraiga los archivos implementables BRMS del paquete zip localhost unzip brms deployable 5 2 0 zip Esto creara los siguientes archivos jboss brms engine zip jboss brms manager zip modeshape zip modeshape zip solo se incluye con el paquete implementable para BRMS 5 2 como avance de tecnolog a Extraiga el j boss brms war de jboss brms manager zip localhost unzip brms manager zip Esto crear un directorio j boss brms war el cual contiene la aplicaci n web JBoss Enterprise BRMS Platform como fichero expandido Extraiga las bibliotecas del clie
15. n 5 1 0 0 Tue Aug 17 2010 David Le Sage Darrin Mison Creado para 5 1 0 58
16. org drools guvnor Guvnor el resto de las im genes se encuentran en el sub directorio images Para acceder a ellas el archivo WAR se debe implementar como un fichero Modifique o reemplace las im genes y los archivos CSS y no cambie los nombres de los archivos Si encuentra problemas re establezca las versiones originales de los archivos desde el fichero WAR Red Hat recomienda agregar cualquier archivo modificado a un sistema de control de versiones para facilitar el mantenimiento Para realizar el cambio lo que se hace usualmente es reemplazar las im ges de acuerdo al estilo las cuales son el logo en la parte superior de la pantalla y el cono de sitio favoritos hdrlogo_brms gif y drools gif respectivamente MH El Guvnor css controla el estilo general de los elementos de la p gina Los componentes GWT usan varios archivos CSS adicionales No los cambie Personalice las URLs que la plataforma BRMS utiliza modificando el descriptor de implementaci n llamado jboss brms war WEB INF web xml Use el mismo proceso para cualquier otra aplicaci n web Java 8 2 Personalizaci n de selectores para la construcci n de paquetes Importante Este es sol mente un avance de tecnolog a Los selectores como una funcionalidad opcional Al construir paquetes de conocimiento utilizando la funcionalidad Packages se puede especificar un selector Un selector filtra la lista de reglas constru das en el paquete Introduzca el nombre
17. un paquete separado Procedimiento B 1 Instalaci n de Apache Ant en Red Hat Enterprise Linux Descargue e instale Apache Ant y el plug in Trax en Red Hat Enterprise Linux Repository emitiendo este comando localhost sudo yum install ant trax Procedimiento B 2 Instalaci n de Apache Ant en otros sistemas operativos 1 Descargar y extraer Una vez que est descargado extr igalo en el lugar preferido de instalaci n tal como c Program Files Apache Ant or opt apache ant 1 8 2 Agregue la variable de entorno ANT_HOME Cree una variable de entorno llamada ANT _HOME Esta variable tiene que tener la ruta creada en el paso anterior Haga esto en Red Hat Enterprise Linux agregando la siguiente linea al archivo bash_profile substituyendo la ruta con la creada en el paso anterior export ANT_HOME opt apache ant 1 8 1 En Microsoft Windows haga esto haciendo clic en el Start Menu abra el Control Panel y luego seleccione System gt Advanced gt Environment Variables Cree una nueva variable ll mela ANT_HOME y config rela para que apunte al directorio creado en el paso anterior 3 Incluya bin en el PATH Agregue el directorio bin de la instalaci n Ant a la variable de entorno PATH En sistemas Unix Linux esto se logra simplemente agregando la siguiente l nea al archivo bash_profile despu s de la que establece la variable ANT_HOME export PATH PATH ANT_HOME bin En Microsoft Windows haga esto abriendo el
18. Attribute search H Knowledge Bases AP QA WF Package snapshots 3 Administration Close all items Done Figura 2 2 Encontrar la pagina 2 4 Inicio de sesi n resoluci n de problemas Los siguientes son los problemas comunes que se encuentran al iniciar sesi n en JBoss Enterprise BRMS Platform por primera vez Abr la URL en mi navegador y no hay ninguna p gina para iniciar la sesi n Verifique que el servidor de aplicaciones est ejecutando y que ha terminado de iniciar Dependiendo de la carga de su servidor el tiempo que toma en iniciar varia Verifique que la URL sea correcta para la configuraci n del servidor Es posible que el servidor de aplicaciones est configurado con un nombre de host o puerto diferente del predeterminado Verifique que no haya un cortafuegos bloqueando el acceso Si el cortafuegos est bloqueando el acceso entonces ser necesario configurarlo para permitir el acceso en el puerto en el que el servidor est ejecutando Verifique que todos los pasos de la instalaci n y de la configuraci n se han realizado de manera correcta Obtengo el mensaje de error Debe configurar un almac n de llaves antes de proceder al tratar de iniciar la sesi n La firma de paquetes de reglas est habilitada pero no est configurada correctamente 19 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Al inciar sesi n recibo el mensaje Nombre de usuario o contrase a equivocados
19. Joyent Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node js open source or commercial project The OpenStack Word Mark and OpenStack Logo are either registered trademarks service marks or trademarks service marks of the OpenStack Foundation in the United States and other countries and are used with the OpenStack Foundation s permission We are not affiliated with endorsed or sponsored by the OpenStack Foundation or the OpenStack community All other trademarks are the property of their respective owners Abstract Este documento proporciona instrucciones de instalaci n configuraci n y personalizaci n para JBoss Enterprise BRMS Platform Table of Contents PIetacio E E eats A O fad od et De E tA dd hued Ak ted Ald ped th Rt AE A 1 Convenciones del Documento 1 1 Convenciones tipogr ficas 1 2 Convenciones del documento 1 3 Notas y Advertencias 2 C mo obtener ayuda y hacer sus comentarios 2 1 Necesita ayuda 2 2 Necesitamos sus comentarios Cap tulo L IntroduCci n 22 52 a5 ced ee ad pla aa Pee as asa daa 1 1 Cosas nuevas en esta edici n 1 2 JBoss Enterprise BRMS Platform Cap tulo 2 Instalaci n de una ten eee nee teens 2 1 Paquetes software 2 2 Instrucciones de instalaci n 2 2 1 Instale el paquete aut nomo 2 2 2 Instalar el paquete implementable 2 2 3 Instalar y habilitar ModeShape 2 3 Inicio de sesi n por primera vez 2 4 Inicio de se
20. Platform 5 Manual del administrador BRMS Cap tulo 9 Monitoreamiento 0 0 aaaeeeaa 50 9 1 Instale el plug in JBoss Operations Network 50 9 2 Descubra la instancia BRMS 51 Implementaci n de JBoss BRMS en EWS 0 0 c cc ct teen eens 52 Instalaci n de Apache Ant 1 cnn ent bene ent n ene nenaes 54 Ejemplo de configuraciones del administrador de persistencia 56 Historial de FeviSiONes Case a O td Ia 58 Table of Contents JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Prefacio 1 Convenciones del Documento Este manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atenci n sobre ciertas partes espec ficas de informaci n Liberation Fonts tambi n se utilizan en ediciones de HT ML si est n instalados en su sistema Si no se muestran tipograf as alternativas pero equivalentes Nota Red Hat Enterprise Linux 5 y siguientes incluyen Liberation Fonts predeterminadas 1 1 Convenciones tipogr ficas Se utilizan cuatro convenciones tipogr ficas para llamar la atenci n sobre palabras o frases espec ficas Dichas convenciones y las circunstancias en que se aplican son las siguientes Negrita monoespaciado Utilizado para resaltar la entrada del sistema incluyendo los comandos de shell nombres de archivos y rutas Tambi n sirve para resaltar teclas y combinaciones de teclas Por ejemplo Para ver el contenido del archivo my_nex
21. Platform utiliza cambie la ubicaci n del repositorio y configure un RDBMS externo JBoss Enterprise BRMS Platform puede utilizar Apache Jackrabbit el predeterminado o Modeshape como repositorio de contenido Ambos repositorios usan una base de datos para almacenamiento pero cada una est configurada de manera diferente Las siguientes secciones contienen instrucciones sobre la configuraci n de la base de datos de cada repositorio Y WIN Las configuraciones predeterminadas para Apache Jackrabbit y Modeshape utilizan base de datos inclu das que no se soportan para uso en producci n Derby y Hypersonic respectivamente Esta configuraci n se incluye solo con el prop sito de evaluar y demostrar y no se soporta en entornos de producci n La configuraci n de una base de datos soportada se requiere para una implementaci n soportada en producci n Consulte sistemas soportados de la base de datos 4 1 Configuraci n de la base de datos para Apache Jackrabbit El repositorio Apache Jackrabbit almacena dos grupos diferentes de informaci n Workspace y Versions Workspace es el sistema de almacenamiento de prop sito general que mantiene activos regla y otros datos Versions almacenan la historia de todos los cambios en Workspace Workspace y Versions se pueden almacenar en bases de datos separadas pero Red Hat recomienda el utilizar una sola base de datos para una f cil administraci n El repositorio JBoss Enterprise BRMS Platform admini
22. a analistas a un usuario se le pedir una categoria Las categorias son una manera de agrupar reglas independiente de los paquetes de conocimiento a los que pertenecen Tambi n hay permisos para analistas de s lo lectura para situaciones como cuando un analista es el responsable de mantener reglas en una categor a pero necesita poder examinar reglas en otra Importante Un usuario a quien se le ha otorgado permisos de categor a no podr ver ninguna vista de paquete ni detalles solo podr n ver la vista de categor as simples Al asignar el rol se le pide que seleccione un paquete al que se limitar n los permisos Hay tres permisos de paquetes diferentes de d nde escoger al asignarle uno a un usuario Administrador de paquetes El permiso del administrador de paquetes otorga un control completo sobre el paquete especificado incluyendo el derecho a implementarlo El permiso del administrador de paquetes no otorga ning n derecho 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 paquete especificado Esto incluye el poder crear y ejecutar pruebas pero no incluye el derecho a implementar el paquete Paquete de s lo lectura El permiso de s lo lectura de paquetes es similar al permiso de s lo lectura de analistas pero le otorga acceso a un paquete en lugar de una categor a 6 3 Fir
23. ackrabbit jcr commons 2 1 0 jar jackrabbit spi 2 1 0 jar hibernate commons annotations 3 1 0 GA jar hibernate core 3 3 2 GA jar hibernate validator 3 1 0 GA jar lucene core 2 4 1 jar jcr 2 0 jar 6 Habilitar ModeShape en el WAR Modifique el archivo jboss brms war WEB INF components xml para borrar la configuraci n Apache Jackrabbit y agregar la configuraci n ModeShape Para borrar la configuraci n Apache Jackrabbit borre o comente la siguiente secci n lt property name properties gt lt key gt org drools repository configurator lt key gt lt value gt org drools repository jackrabbit JackrabbitRepositoryConfigurator lt valu e gt lt the root directory for the repo storage the directory must exist gt lt lt key gt repository root directory lt key gt lt value gt opt yourpath lt value gt gt lt property gt En la configuraci n predeterminada se ha comentado la configuraci n ModeShape Borre el comentario de la configuraci n tal como se muestra lt property name properties gt lt key gt org drools repository configurator lt key gt lt value gt org drools repository modeshape ModeShapeRepositoryConfigurator lt value gt lt key gt org modeshape jcr URL lt key gt lt value gt jndi jcr local repositoryName brms lt value gt lt key gt org drools repository secure passwords lt key gt lt value gt false lt value gt lt key gt org drools repository admin password lt key gt lt value gt adm
24. ajo actual lt param name schema0bjectPrefix value wsp name _ gt Borrar el espacio de trabajo viejo Borre el directorio wrkspaces Default Reiniciar Reiniciar el servidor de aplicaciones 4 1 2 Configurar la base de datos Versions JBoss Enterprise BRMS Platform mantiene un historial de todos los cambios en la base de datos Esto se mantiene en un rea de almacenamiento separado para prevenir la degradaci n del rendimiento en tanto el n mero de versiones incrementa 24 Cap tulo 4 Configuraci n de la base de datos Esta rea de almacenamiento tiene su propia configuraci n de administraci n de la persistencia almacenada en el archivo repository xml De manera opuesta a la configuraci n Workspace la configuraci n de almacenamiento Version no es tan solo una plantilla es la configuraci n real que se est utilizando Procedimiento 4 2 Cambiar la base de datos Versions 1 Apagar Apagar el servidor de aplicaciones antes de realizar estos cambios 2 Instalar la JAR del controlador JDBC Copie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos a utilizar en la configuraci n del servidor en el directorio 1ib el cual puede ser por ejemplo jboss as server PROFILE 1ib 3 Abra repository xml en un editor de texto Abra el archivo repository xml en un editor de texto Al utilizar JBoss este archivo se encoentrar en el directorio bin del servidor de aplicaciones a menos d
25. al del administrador BRMS Capitulo 1 Introduccion 1 1 Cosas nuevas en esta edici n Tabla 1 1 Cosas nuevas en esta edici n Funcionalidad Cambio Una nueva secci n sobre la instalaci n de Modeshape como repositorio Una nueva secci n sobre la configuraci n de una fuente de datos para Modeshape Una nueva secci n sobre la configuraci n de BRMS para utilizar un RDBMS externo Un nuevo cap tulo sobre el monitoreamiento de BRMS con un plug in de Jboss Operations Network Un nuevo ap ndice con instrucciones para instalar JBoss BRMS en Jboss Enterprise Web Server 1 2 JBoss Enterprise BRMS Platform JBoss Enterprise BRMS Platform es un sistema de administraci n de reglas empresariales basado en JBoss Rules Proporciona una soluci n multi usuario del lado del servidor para la administraci n almacenamiento modificaci n e implementaci n de reglas y otros activos de JBoss Rules Se brinda una interfaz de usuario basado en la web as como integraci n para JBoss Developer Studio 4 Importante En varios lugares de JBoss Enterprise BRMS Platform y de su documentaci n se refiere a Guvnor Drools Guvnor es el nombre del proyecto de c digo abierto sobre el cual se ha constru do JBoss Enterprise BRMS Platform Las referencias a Guvnor permanecen en la API las URLs y en las herramientas de JBoss Developer Studio Cap tulo 2 Instalaci n de una Cap tulo 2 Instalaci n de una En este cap tulo aprender a
26. ambia dependiendo de la circunstancia Por ejemplo Para conectar a una m quina remota utilizando ssh teclee ssh nombre de usuario0dominio nombre en un int rprete de comandos de shell Si la m quina remota es example com y su nombre de usuario en esa m quina es john teclee ssh john example com El comando mount o remount file system remonta el sistema de archivo llamado Por ejemplo para volver a montar el sistema de archivo home el comando es mount o remount home Para ver la versi n de un paquete actualmente instalado utilice el comando rpm q paquete ste entregar el resultado siguiente paquete versi n lanzamiento Observe que las palabras resaltadas en italicas nombre de usuario dominio nombre sistema de archivo paquete versi n y lanzamiento Cada palabra es un marcador de posici n ya sea de texto a ingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema Aparte del uso est ndar para presentar el t tulo de un trabajo las it licas denotan el primer uso de un t rmino nuevo e importante Por ejemplo Publican es un sistema de publicaci n de DocBook 1 2 Convenciones del documento Los mensajes de salida de la terminal o fragmentos de c digo fuente se distinguen visualmente del texto circundante Los mensajes de salida enviados a una terminal se muestran en romano monoespaciado y se presentan as books Desktop documentation drafts mss photos stuff svn books_tests Desktop1
27. ar JBoss Business Rules Management System Operations Network Installation Guide para ver las instrucciones de instalaci n 9 1 Instale el plug in JBoss Operations Network El plug in BRMS JBoss ON se puede instalar por medio de la l nea de comandos o por medio de la interfaz web del usuario JBss ON Procedimiento 9 1 Instale el plug in JBoss Operations Network por medio de la l nea de comandos 1 Descargue el plug in JBoss ON a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBoss Operations Network y despu s seleccione JBoss ON for BRMS del men desplegable b Haga clic en Download para iniciar la descarga 2 Descomprima la descarga del plug in Descomprima el archivo jar del archivo zip descargado unzip jon plugin pack brms 2 4 1 GA zip 3 Instale el plug in Es necesario instalar el plug in en el directorio del servidor JBoss ON Mueva el archivo jar descomprimido en el paso anterior al directorio del nivel superior Por ejemplo en Red Hat Enterprise Linux con JBoss ON instale en el opt directorio mv rhq brms plugin 5 2 0 jar opt jon server 2 4 0 GA1 rhq brms plugin 5 2 0 jar 4 Reinicie el servidor JBoss ON Procedimiento 9 2 Instale el plug in JBoss Operations Network por medio de la interfaz web JBOss ON 1 Descargue el plug in JBoss ON a En el portal de soporte al cliente haga clic en Downloads luego haga clic en JBoss Operations Network y despu s seleccione JBoss ON f
28. caci n a utilizar por medio del archivo jboss brms war WEB INF components xml La configuraci n predeterminada tiene muchas opciones con comentarios pero la configuraci n en s se ve as lt security identity authenticate method fauthenticator authenticate jaas config name jmx console gt lt component name org jboss seam security roleBasedPermissionResolver gt lt property name enableRoleBasedAuthorization gt false lt property gt lt component gt El archivo components xm1 cambi en BRMS 5 2 En BRMS 5 1 y versiones anteriores el archivo se ve as lt security identity authenticate method authenticator authenticate jaas config name jmx console gt lt security role based permission resolver enable role based authorization false gt Capitulo 6 Seguridad Importante Esta configuraci n predeterminada usa los nombres de cuentas contrase as y roles que se definen en la pol tica de autenticaci n jmx console Red Hat recomienda el modificar esta pol tica para personalizarla de acuerdo con su entorno especifico Para configurar la autenticaci n siga estos pasos 1 Modifique el m dulo de inicio de sesi n apropiado de JBoss del servidor de aplicaciones 2 Configure JBoss Enterprise BRMS Platform para que utilice ese m dulo Muchos m dulos de inicio de sesi n de JBoss brindan una manera de especificar uno o m s roles para cada usuario JBoss Enterprise BRMS Platfor
29. casionar p rdida de datos 2 C mo obtener ayuda y hacer sus comentarios 2 1 Necesita ayuda Si encuentra dificultades con alguno de los procedimientos descritos en este documento visite el Portal Oo Prefacio buscar o navegar a trav s de la base de art culos de soporte t cnico sobre productos de Red Hat enviar un caso de soporte a Servicios de Soporte Global de Red Hat GSS acceder a otra documentaci n del producto Red Hat alberga una lista grande de correos electr nicos para discutir sobre software de Red Hat y tecnolog a Encontrar un listado de las listas de correo disponibles al p blico en para acceder a los archivos de listados 2 2 Necesitamos sus comentarios Si encuentra algun error o si se le ocurre una manera de mejorar este manual nos encantar a escuchar sus sugerencias Complete un reporte en Bugzilla frente al producto JBoss Enterprise BRMS Platform 5 y el componente doc BRMS_Administrator_Guide El siguiente enlace le llevar a Llene la siguiente plantilla en el campo de Description de Bugzilla Sea tan especifico como le sea posible al describir el problema esto ayudar a asegurarnos de que lo podemos solucionar r pidamente URL del documento N mero de la secci n y nombre Describa el problema Sugerencias para mejorar Informaci n adicional Aseg rese de darnos su nombre para poder darle todo el cr dito por reportar el problema JBoss Enterprise BRMS Platform 5 Manu
30. ccounts What is the name of your organization Unknown ACME INC What is the name of your City or Locality Unknown Captital City What is the name of your State or Province Unknown CC What is the two letter country code for this unit Unknown US Is CN John Smith OU Accounts O ACME INC L Captial City ST CC C US correct no yes Enter key password for lt BRMSKey gt RETURN if same as keystore password Re enter new password 2 Crear un certificado digital Use el comando keytool para crear un certificado digital keytool export alias ALIAS file CERTIFICATE crt keystore PRIVATE keystore Use el mismo alias y almac n de llaves que en el paso anterior El par metro file es el nombre del archivo del nuevo certificado que se crear El par metro keystore proporciona el nombre del archivo del almac n privado de llaves Introduzca la contrase a del almac n de llaves cuando se le pida localhost keytool export alias BRMSKey file BRMSKey crt keystore PrivateBRMS keystore Enter keystore password Certificate stored in file lt BRMSKey crt gt Importe el certificado digital en un almac n de confianza Use el comando keytool para importar el certificado digital en un almac n de llaves keytool import alias ALIAS file CERTIFICATE crt keystore PUBLIC keystore Esto crear un nuevo almac n de llaves el almac n de confianza el cual contiene el certificado digital El almac n de co
31. comienda que se utilice un sistema de autenticaci n separado para los usuarios de cambiar el perfil JAAS La configuraci n predeterminada para el perfil jmx console en los productos JBoss Platform usan el m dulo de inicio de sesi n UsersRolesLoginModule para almacenar nombres de usuarios y contrase as en el archivo PROFILE conf props jmx console users properties Se pueden agregar usuarios a adiendo entradas a este archivo con el formato username password Las entradas se pueden comentar anteponiendo el caracter numeral en una l nea f admin sekretz jsmith s r hSmith tandrews p3r50n311 Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default OPCIONAL Habilite la firma de paquetes de reglas La funcionalidad de firma de paquetes de reglas utiliza criptograf a con llave publica para asegurarse de que los paquetes de reglas no est n da ados o no se alteren durante la descarga Red Hat recomienda que esta funcionalidad est habilitada en un entorno de producci n tema JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS 6 Y 00 Configuraci n de la base de datos Las configuraciones predeterminadas usan bases de datos inclu das que no son apropiadas ni soportadas en entornos de producci n Antes de implementarlo en un entorno de producci n esta configuraci n se debe modificar a un servidor de bases de datos que sea soportado Inic
32. drools serialization private keyPwd la contrase a llave drools serialization public keyStoreURL la URL en donde se encuentra el almac n de confianza drools serialization public keyStorePwd la contrase a para el almac n de confianza 7 Codifique las credenciales del almac n de llaves La contrase a del almac n de llaves actualmente est almacenado en texto simple enmascarar las credenciales del almac n de llaves Consulte el manual del usuario BRMS para obtener instrucciones sobre c mo configurar clientes para que usen paquetes firmados de reglas 6 3 1 Configuraci n de propiedades de serializaci n Las propiedades del sistema para las credenciales del almac n de llaves se pueden configurar en varios lugares tal como se describe a continuaci n Es necesario configurar las propiedades en un s lo lugar y estar n disponibles para todas las aplicaciones ejecutando en la misma instancia del servidor de aplicaciones sin importar en donde se configuran Servicio de propiedades JBoss PAra configurar las propiedades usando el servicio de propiedades JBoss agregue la siguiente configuraci n bean administrada al archivo server PROFILE deploy properties service xml reemplazando los valores del ejemplo con los que sean apropiados para su sistema lt mbean code org jboss varia property SystemPropertiesService name jboss type Service name SystemProperties gt lt attribute name Properties gt Drools Security Seriali
33. e USE JNDI si JNDI est configurado Haga clic en Continue e introduzca el nombre JNDI configurado en la fuente de datos implementada Si JNDI no se esta utilizando introduzca la informaci n requerida RDBMS gt Controlador gt URL gt Usuario gt Contrase a 29 30 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Find Repository Config Category Manager 2 Manage Repository Configuration RDBMS Info Select RDBMS type MySQL v Use JNDI a Continue MySQL Info Driver URL User Password Generate repository config Figura 4 3 Informaci n RDBMS 5 Generar el archivo de configuraci n del repositorio Seleccione Generate repository config para generar el archivo repository xml Corte y pegue el texto generado en un archivo y gu rdelo como repository xml o seleccione Save Configuration para descargar el texto como archivo Reemplace el repository xml1 existente con el nuevo repository xm1 A menos de que se especifiqeu un directorio inicial aplicaciones Cap tulo 5 Administraci n de datos Cap tulo 5 Administraci n de datos 5 1 Copia de seguridad de datos JBoss Enterprise BRMS Platform no proporciona una manera de realizar una copia de seguridad de los datos Estas copias de seguridad se deben realizar utilizando las herramientas que el venedor de la base de datos proporciona Al re establecer una copia de seguridad Red Hat le recomienda que borre los ndices de la base de dato
34. e que se especifique una 4 Actualice la configuraci n del PersistenceManager Ubique el elemento lt PersistenceManager gt el cual se encuentra dentro de lt Workspace gt Por ejemplo lt PersistenceManager class org apache jackrabbit core persistence bundle DerbyPersistenceManager gt lt param name url value jdbc derby rep home version db create true gt lt param name schema0bjectPrefix value version_ gt lt PersistenceManager gt Reemplace esto con la configuraci n apropiada para la base de datos que se va a utilizar ejemplos 5 Establezca el par metro schemaObjectPrefix Este valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administrada por el administrador de persistencia esto debe ser nico en cada base de datos Si se est utilizando la misma base de datos para Versions y el almacenamiento de datos aseg rese de que no se utiliza el mismo schemaObjectPrefix para ambos la configuraci n predeterminada usa version_ lt param name schema0bjectPrefix value version_ gt 6 Reiniciar Reiniciar el servidor de aplicaciones 4 1 3 B squeda y uso de ndices La funcionalidad de b squeda y de uso de ndices dentro de JBoss Enterprise BRMS Platform la brinda Por defecto el ndice de b squeda se mantiene en el sistema de archivos local Esto se debe a que brinda un rendimiento m s r pido Red Hat no recomienda el cambiar su configuraci n predeterminada a men
35. e 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 admin mailman JBossAdmin readwrite c OPCIONAL Codificar contrase as Opcionalmente las contrase as se pueden almacenar de forma codificada en lugar de texto plano Para hacer esto ejecute el siguiente comando en el directorio del servidor de aplicaciones jboss as o jboss as web para crear la forma codificada de la contrase a reemplazando PASSWORD con la contrase a escogida Capitulo 2 Instalaci n de una localhost java cp client jboss logging spi jar lib jbosssx jar org jboss resource security SecureldentityLoginModule PASSWORD Encoded password 5f78dc15b9a559cbdf8592078de921bc Luego reemplace las contrase as almacenadas en PROFILE conf props brms users properties con las versiones codificadas 4 OPCIONAL Configuraci n de la base de datos La configuraci n predeterminada para Modeshape usa una base de datos que no es apropiada o soportada en entornos de producci n Antes de implementar en un entorno de producci n se debe cambiar esta configuraci n a un servidor soportado de la base de datos 5 Borre los archivos JAR no utilizados Borre los siguientes archivos JAR del directorio server PROFILE deploy jboss brms war WEB INF 1ib jackrabbit api 2 1 0 jar jackrabbit core 2 1 0 jar j
36. eBaseConfiguration _ conf setOption MBeansOption ENABLED 51 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Implementaci n de JBoss BRMS en EWS BRMS se puede instalar en JBoss Enterprise Web Server 1 0 1 con Tomcat 5 y 6 Para ver las instrucciones de instalaci n y configuraci n para JBoss Enterprise Web Server consulte JBoss Enterprise Web Server Installation Guide Procedimiento A 1 Instale el paquete de implementaci n en JBoss Enterprise Web Server 1 52 Descargue BRMS Descargue el archivo zip del paquete de implementaci n BRMS del portal de soporte al cliente de luego seleccione la versi n Extraiga el software Extraiga los archivos de implementaci n BRMS del archivo zip localhost unzip brms deployable 5 2 0 zip Esto crear los siguientes archivos zip jboss brms engine zip jboss brms manager zip Extraiga el j boss brms war de jboss brms manager zip Por ejemplo localhost unzip brms manager zip Esto crear un directorio j boss brms war el cual contiene la aplicaic n web JBoss Enterprise BRMS Platform como fichero expandido Extraiga las bibliotecas cliente de jboss brms engine zip en un directorio Por ejemplo localhost unzip brms engine zip d client Esto crea un directorio que contiene los archivos jar de la biblioteca cliente Copie jboss brms war al servidor de aplicaciones Copie el directorio BRMS extra do jboss brms war al siguiente diretcorio
37. ected refresh list m name Administrator Sermiesione permiesions OP mailman Yes Open a admin Open jsmith Open guest Open 4 4 1 40f4 Figura 6 2 Detalles sobre los permisos 3 Asignar permisos de usuarios Haga clic en el cono con el signo mas para agregar permisos y seleccione los permisos apropiados del men desplegable Permission type Haga clic en OK para confirmar Edit user sally x ga Edit user sally Users are athenticated by a directory service here you can define Guvnor specific permissions as needed analyst for category Commercial Mortgage El analyst readonly for category Home Mortgage El E Save changes Figura 6 3 Modifique los permisos del usuario 4 Borre permisos de usuario Haga clic en el cono con el menos al lado del permiso que se va a borrar y haga clic en OK para confirmar Aquellos usuarios con el rol de administradores podr n modificar los roles y los permisos de otros Alos usuarios se les puede otorgar cualquiera de estos tres roles admin analyst 40 Capitulo 6 Seguridad package Aquellos usuarios a los que se les ha asignado el rol de administradores tienen acceso completo a todas las reas de JBoss Enterprise BRMS Platform Los permisos para analistas son para aquellos usuarios responsables de mantener los recursos de reglas A los desarrolladores y analistas empresariales se les debe otorgar este nivel de permiso Al asignar permisos par
38. el formato username password Se puede ignorar los comentarios agregando un caracter de numeral al principio de la l nea admin password jsmith s r hSmith tandrews pp3rrssenn311 uno que soporte un sistema de autenticaci n diferente tal como LDAP OPCIONAL Instale el repositorio ModeShape ModeShape es un repositorio de contenido Java JCR del ingl s Java Content Repository que se K NN Modeshape es un avance tecnol gico en BRMS 5 2 OPCIONAL Habilite la firma de paquetes de reglas La funcionalidad de firma de paquetes de reglas utiliza criptograf a con llave p blica para asegurarse de que los paquetes de reglas no est n da ados o no se alteren durante la descarga Red Hat recomienda que esta funcionalidad est habilitada en un entorno de producci n tema Configuraci n de la base de datos Las configuraciones predeterminadas utilizan bases de datos inclu das que no son apropiadas o soportadas para entornos de producci n Antes de implementar en un entorno de producci n esta configuraci n se debe cambiar a un servidor soportado de base de datos Inicie el servidor Para iniciar el servidor desde la l nea de comandos use el comando run sh en un sistema UNIX o Linux o run bat en Microsoft Windows El par metro c se debe utilizar para especificar el perfil de servidor a utilizar localhost run sh c production do Los scripts run sh y run bat se encuentra en el directorio bin Por ejemplo
39. ema0bjectPrefix value wsp name _ gt lt PersistenceManager gt Ejemplo C 2 Configuraci n MySQL usando MySq1PersistenceManager lt PersistenceManager class org apache jackrabbit core persistence bundle MySqlPersistenceManager gt lt param name driver value com mysql jdbc Driver gt lt param name url value jdbc mysql localhost 3306 brms gt lt param name user value brms_user gt lt param name password value brms_password gt lt param name schema0bjectPrefix value wsp name _ gt lt param name schema value mysql gt lt PersistenceManager gt Ejemplo C 3 Configuraci n Oracle usando OraclePersistenceManager lt PersistenceManager class org apache jackrabbit core persistence bundle OraclePersistenceManager gt lt param name driver value oracle jdbc OracleDriver gt lt param name url value jdbc oracle thin localhost 1521 brms gt lt param name schema value oracle gt lt param name user value brms_user gt lt param name password value brms_password gt lt param name schema0bjectPrefix value wsp name _ gt lt PersistenceManager gt 56 Ejemplo de configuraciones del administrador de persistencia Ejemplo C 4 Configuraci n PostgreSQL usando PostgreSQLPersistenceManager lt PersistenceManager class org apache jackrabbit core persistence bundle PostgreSQLPersistenceManager gt lt param name driver value org po
40. especifique el perfil del servidor en el que se instalar ModeShape 15 16 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS localhost modeshape ant Buildfile opt BRMS 5 1 0 brms standalone 5 1 0 modeshape build xml 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 instalaci n instala los servicios ModeShape en el perfil del servidor especificado 3 Configuraci n de usuarios y roles Agregue las cuentas de usuarios admin y mailman y asigne los roles especificados a continuaci n La configuraci n predeterminada usa los archivos de texto para almacenar los nombres de usuario las contrase as y los roles asignados Las instrucciones aqu asumen que no se ha cambiado la configuraci n de la autorizaci n Si s se ha cambiado entonces agregue mayores detalles a Agregue los usuarios admin y mailman Abra el archivo PROFILE conf props brms users properties en un editor de texto y agregue los usuarios admin y mailman a este archivo como una nueva l nea con la siguiente sintaxis username password admin s3kr3t5 mailman 53cur3m 11 b Asignar roles Asigne los roles especificados a continuaci n a los dos usuarios abriendo el archivo PROFILE conf props brms roles properties en un editor de texto y agregando una nueva l nea para cada usuario con la siguiente sintaxis usernam
41. ferencias gt Rat n desde la barra del men principal para lanzar Preferencias de rat n En la pesta a de Botones seleccione la cajilla de rat n Prefacio de mano izquierda y luego haga clic en Cerrar para cambiar el bot n principal del rat n de la izquierda a la derecha adecuando el rat n para la mano izquierda Para insertar un car cter especial en un archivo gedit seleccione Aplicaciones Accesorios gt Mapa de caracteres de la barra del men Luego seleccione B squeda gt Buscar de la barra del men de Mapa de caracteres escriba el nombre del car cter en el campo de B squeda y haga clic en Siguiente El car cter que busc ser resaltado en la Tabla de caracteres Haga doble clic en ese car cter resaltado para colocarlo en el campo de Texto a copiar y luego haga clic en el bot n Copiar Ahora regrese al documento y elija Modificar Pegar de la barra de men de gedit El texto anterior incluye nombres de aplicaci n nombres y elementos del men de todo el sistema nombres de men de aplicaciones espec ficas y botones y texto hallados dentro de una interfaz gr fica de usuario todos presentados en negrita proporcional y distinguibles por contexto It licas negrita monoespaciado o It licas negrita proporcional Ya sea negrita monoespaciado o negrita proporcional la adici n de italicas indica texto reemplazable o variable Las it licas denotan texto que usted no escribe literalmente o texto mostrado que c
42. i n con los valores apropiados para su servidor LDAP Configure la plataforma BRMS para utilizar el m dulo de inicio de sesi n Abra el archivo jboss as web server PROFILE deploy jboss brms war WEB INF components xm1 Contiene un elemento lt components gt con varios elementos hijos incluyendo lt security identity gt Agregue Comente el elemento lt security identity gt para evitar conflictos Agregue el siguiente elemento lt security identity gt lt security identity authenticate method authenticator authenticate jaas config name brms gt La propiedad jaas config name debe ser igual que application policy Si se cambi la propiedad application policy en el paso anterior entonces modifique la propiedad jaas config name para que coincidan Reiniciar Reinicral el servidor de aplicaciones 37 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Para aprender m s sobre los diferentes escenarios de configuraci n de LDAP lea la informaci n 6 2 Autorizaci n BRMS usa autorizaci n basada en roles para asignar permisos a los usuarios Por defecto la autorizaci n basada en roles est inhabilitada y se debe habilitar de manera similar los roles se deben asignar a los usuarios Si no se habilita la autorizaci n basada en roles entonces todos los usuarios tienen todos los privilegios administrativos Edit user jsmith Ye Edit user jsmith Users are authenticated by a directory service he
43. ie el servidor Para iniciar el servidor desde la l nea de comandos use el comando run sh en sistemas UNIX o Linux o ejecute run bat en un sistema Microsoft Windows El par metro c se debe utilizar para especificar cual perfil de servidor utilizar localhost run sh c production lt Los scripts run sh y run bat se encuentra en el directorio bin Por ejemplo la ruta completa al directorio bin para el servidor aut nomo BRMS 5 2 0 es brms standalone 5 2 0 jboss as web bin Consulte la documentaci n de JBoss Enterprise Web Platform 5 para obtener mayores detalles Inicie sesi n Inicie sesi n en la aplicaci n web JBoss Enterprise BRMS Platform para confirmar que est 2 2 3 Instalar y habilitar ModeShape p lt P Importante ModeShape viene junto con la versi n 5 2 de JBoss Enterprise BRMS Platform como avance de tecnolog a Lea esta secci n para aprender a remplazar el repositorio predeterminado Apache Jackrabbit con ModeShape para una instancia aut noma BRMS ModeShape es un repositorio de contenido Java JCR del ingl s Java Content Repository que se una sinopsis del proceso de instalaci n de los servicios ModeShape y la configuraci n del servidor de JBoss Enterprise BRMS Platform para utilizar ModeShape Debe cumplir con los siguientes requerimientos antes de poder instalar ModeShape K Modeshape es un avance tecnol gico y por lo tanto no se soporta el migrar una instalaci n ya ex
44. in lt value gt lt key gt org drools repository mailman password lt key gt lt value gt mailman lt value gt lt property gt 17 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS 7 Establezca las contrase as ModeShape requiere que existan dos cuentas de usuario admin y mailman Las contrase as para estas cuentas se deben especificar en la configuraci n ModeShape del paso anterior lt key gt org drools repository secure passwords lt key gt lt value gt false lt value gt lt key gt org drools repository admin password lt key gt lt value gt password lt value gt lt key gt org drools repository mailman password lt key gt lt value gt password lt value gt 8 Iniciar el servidor Para iniciar el servidor desde la l nea de comandos use el comando run sh en un sistema UNIX o Linux o run bat en Microsoft Windows El par metro c se debe utilizar para especificar el perfil de servidor a utilizar localhost run sh c production Los scripts run sh y run bat se encuentra en el directorio bin Por ejemplo la ruta completa al directorio bin para el servidor aut nomo BRMS 5 2 0 es brms standalone 5 2 0 jboss as web bin Consulte la documentaci n de JBoss Enterprise Web Platform 5 para obtener mayores detalles 9 Inicio de sesi n Inicie sesi n en la aplicaci n web JBoss Enterprise BRMS Platform para confirmar que est para obtener mayores detalles 2 3 Inicio de sesi n por primera vez
45. instalar la plataforma JBoss Enterprise BRMS JBoss Enterprise BRMS Platform est soportada en diferentes configuraciones del sistema Puede encoentrar una lista completa de todos los servidores de aplicaciones Java soportados M quinas virtuales Java y servidores de bases de datos en Adem s de un servidor de aplicaciones Java una m quina virtual Java y un sistema operativo soportados el implementar BRMS en un entorno de producci n requiere un servidor de base de datos soportado para el almacenamiento de activps de reglas 2 1 Paquetes software Puede descargar JBoss Enterprise BRMS Platform del portal de soporte al cleinte de Red Hat en versi n La versi n actual es 5 2 0 Todas las instrucciones a continuaci n usan los nombres de paquetes para 5 2 0 pero tambi n aplican a versiones anteriores excepto donde se observa que no JBoss Enterprise BRMS Platform se encuentra disponible en dos paquetes diferentes Paquete aut nomo Este paquete aut nomo contiene JBoss Enterprise Web Platform con JBoss Enterprise BRMS Platform ya implementado y no requiere un servidor de aplicaciones ya existente El paquete aut nomo est disponible con la versi n 5 1 0 y posteriores Si descarga la versi n 5 1 0 el paquete aut nomo contiene JBoss Enterprise Web Platform 5 1 Aplicaci n web JBoss Enterprise BRMS Platform 5 1 0 implementado en los perfiles default y production Si descarga la versi n 5 2 0 el paquete aut nomo contiene
46. ione Administraci n 2 Seleccione el XML desde la m quina local que se cargar haciendo clic en Choose File luego haga clic en Import 3 Clic en Import JBoss BRMS V Browse Find Repository Config Category Manager Import Export Knowledge Bases gt Import Export PQA 7 Package snapshots 7 dl Administration Choose File No file chosen Import Category Export w Status Archive b Event Log amp user permission lal Import Export Rules Verification Repository Configuration o About Cap tulo 5 Administraci n de datos Figura 5 1 Importar y exportar el repositorio Cuando la importaci n ha terminado una ventana reportar Repositorio de reglas importado de manera exitosa El navegador ahora se actualizar para mostrar el nuevo contenido 5 4 Re construcci n de paquetes binarios Luego de actualizar JBoss Business Rules Management System e importar un repositorio existente es necesario volver a construir los paquetes binarios Para volver a construir los paquetes binario seleccione Bases de conocimiento del Men de navegaci n y haga clic en Re construir todos los paquetes binarios Browse Find Impor Export Knowledge Bases g File Edit Source 82 New Package sss Packages ar 9 gt New Spring Context Create New gt defaultPackage o esa New WorkingSet mortgages a New Rule ses Global Area s New Rule Template Upload POJO Model jar New Dec
47. istente a ModeShape Cap tulo 2 Instalaci n de una gt Se requiere una base de datos soportada para una implementaci n en producci n La instancia de la base de datos que se va a utilizar ya se cre e Ya existe un usuario de la base de datos con el permiso para cambiar la base de datos e El archivo JAR del controlador JDBC para la base de datos se encuentra en el directorio 1ib de la configuraci n del servidor completa de los servidores de la base de datos que son soportados Procedimiento 2 3 Configurar ModeShape 1 Descargar y extraer Este paso solo es necesario para 5 1 0 El paquete aut nomo 5 2 0 viene con ModeShape inclu do Descargue el paquete ModeShape modeshape zip del portal de soporte al cliente de Red Hat en Extraiga el directorio modeshape del archivo ZIP del paquete en el directorio de instalaci n BRMS Para la versi n aut noma de JBoss Enterprise BRMS Platform este es brms standalone 5 1 0 localhost unzip modeshape zip Despu s de la extracci n tendr la siguiente estructura brms standalone 5 2 0 jboss as web mod_cluster modeshape picketlink resteasy seam 2 Ejecute el instalador Los siguientes pasos son necesarios para 5 1 0 y 5 2 0 y estas instrucciones se referiran a 5 2 0 desde este punto en adelante Para instalar ModeShape en el perfil de servidor requerido use la linea de comandos para ejecutar ant y cuando se le pida
48. larative Model New BPEL package 69 New Function New DSL R New RuleFlow AR New BPMN2 Process New Enumeration Y New Test Scenario amp Create afile amp Rebuild all package binaries ae Figura 5 2 Re construcci n de paquetes 33 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Capitulo 6 Seguridad Lea este cap tulo con el fin de aprender a c mo habilitar y configurar los diferentes sistemas de seguridad en la plataforma JBoss Enterprise BRMS Los diferentes temas que abordamos aqu son Autenticaci n gt Autorizaci n Firma de paquetes de reglas 6 1 Autenticaci n La plataforma JBoss Enterprise BRMS usa el servicios de autorizaci n y autenticaci n Java para verificar las credenciales del usuario Este servicio lo proporciona el servidor de aplicaciones y se utiliza para acceder un sistema de autenticaci n separado El sistema separado puede ser un protocolo LDAP del ingl s Lightweight Directory Access Protocol un servidor de directorios activos o una base de datos JDBC A EP Importante Cuando se le otorga acceso a los usuarios a la instalaci n de JBoss Enterprise BRMS Platform potencialmente se les brinda la habilidad de afectar la l gica empresarial de otras aplicaciones Use la autorizaci n con base en roles para definir lo que puede hacer cada usuario Consulte Secci Autorizaci n para aprender m s sobre este tema Configure el m todo de autenti
49. lication policy gt Cada elemento lt application policy gt define un esquema de autenticaci n diferente Agregue el siguiente pedazo XML lt application policy gt como un nuevo hijo del elemento lt policy gt lt application policy name brms gt lt authentication gt lt login module code org jboss security auth spi LdapExtLoginModule flag required gt lt module option name java naming provider url1 gt 1dap 1dap company com 389 lt module option gt lt module option name bindDN gt DEPARTMENTAsomeadmin lt module option gt lt module option name bindCredential gt password lt module option gt lt module option name baseCtxDN gt cn Users dc company dc com lt module option gt lt module option name baseFilter gt sAMAccountName 0 lt module option gt lt module option name rolesCtxDN gt cn Users dc company dc com lt module option gt lt module option name roleFilter gt sAMAccountName 0 lt module option gt lt module option name roleAttributeID gt memberOf lt module option gt lt module option name roleAttributeIsDN gt true lt module option gt lt module option name roleNameAttributeID gt cn lt module option gt lt module option name roleRecursion gt 1 lt module option gt lt module option name searchScope gt ONELEVEL_SCOPE lt module option gt lt login module gt lt authentication gt lt application policy gt Actualice los valores en este archivo de configurac
50. llaves disponible para este Por ejemplo el sistema operativo puede autenticar y montar un archivo compartido que mantenga el lamac n privado de llaves como un directorio local para que el servidor JBoss Enterprise BRMS Platform tenga acceso a el Mueva el almac n de confianza a un lugar p blico Es necesario que el almac n de confianza sea accequible para las aplicaciones clientes Esto se puede lograr poniendo el almac n de confianza en una red compartida o como host en un servidor web Configure las propiedades de serializaci n Drools Las propiedades del sistema de serializaci n Drools tienen que establecerse en el servidor Estas son las propiedades que almacenan la informaci n requerida para acceder los almacenes de llaves Ya que JBoss Enterprise BRMS Platform tambi n contiene componentes cliente tanto las propiedades privadas del almac n de llaves como las del almac n de confianza se tienen que configurar en el servidor sobre d nde se pueden establecer las propiedades Las propiedades que es necesario configurar son drools serialization sign indica si la firma est habilitada Debe estar configurado como true drools serialization private keyStoreURL la URL en donde se encuentra el almac n privado de llaves drools serialization private keyStorePwd la contrase a para el almac n de llaves drools serialization private keyAlias el alias utilizado al crear el almac n de Capitulo 6 Seguridad llaves
51. m tiene su propio mecanismo para administrar roles de usuarios Si se inhabilita la autorizaci n basada en roles de manera efectiva todos los usuarios tienen el papel del administrador Esto les da completo acceso a JBoss Enterprise BRMS Platform Importante Red Hat recomienda habilitar la authorizaci n basada en roles Antes de hacerlo asigne por lo menos un usuario para el rol de administrador en la interaz BRMS Permissions Una vez que se habilita esto solo los usuarios con los privilegios administrativos pueden realizar muchas de las tareas administrativas incluyendo el administrar los roles de los usuarios esto se explica en m s detalle en Secci n 6 2 Autorizaci n 6 1 1 Ejemplo de autenticaci n UserRolesLoginModule Este ejemplo ilustra el uso del m dulo de inicio de sesi n org jboss security auth spi UsersRolesLoginModule para acceder a un grupo de cuentas de usuarios almacenados en los archivos props brms users properties y props brms roles properties Procedimiento 6 1 Ejemplo de autenticaci n UserRolesLoginModule 1 Aseg rese de que el sistema de autenticaci n est configurado correctamente Este m dulo de inicio de sesi n usa dos archivos para almacenar el nombre de inicio de sesi n la contrase a y los roles asignados a cada usuario Cree los archivos brms users properties y brms roles properties en el directorio jboss as web server PROFILE conf props y luego especique por lo menos un usuario e
52. ma de paquetes de reglas Lea esta secci n apara prender sobre la firma de paquetes de reglas y la configuraci n del almacenamiento de llaves 41 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS La firma de paquetes de reglas asegura que los paquetes no se pueden da ar o alterar durante la descarga del servidor BRMS en las aplicaciones del cliente La firma de paquetes de reglas no est habilitado por defecto Importante Red Hat le recomienda que habilite la firma de paquetes de reglas en entornors de producci n La firma de paquetes de reglas se implementa usando criptograf a de llaves p blicas Se utiliza el comando JDK keytool para crear una llave privada y un certificado digital p blico correspondiente Los paquetes firmados con una llave privada solo se pueden verificar con el certificado correspondiente La llave privada se almacena en un archivo llamado un almac n de llaves y el servidor lo utiliza para firmar autom ticamente cada paquete El certificado p blico se hace disponible para cada aplicaci n cliente en un almac n de llaves conocido como un almac n de confianza El certificado en el almac n de confianza se utiliza para verificar la autenticidad del los paquetes firmados Los paquetes de reglas que est n da ados o que sean modificados durante la descarga ser n rechazados por el cliente ya que la firma ya no coincidir con el certificado El procedimiento a continuaci n describe el proceso de
53. n brms users properties usando este formato username password el archivo brms roles properties se puede dejar vac o 35 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS 2 Apagar Apague el servidor de aplicaciones antes de realizar estos cambios 3 Configure el m dulo de inicio de sesi n de JBoss Para configurar los m dulos de inicio de sesi n de JBoss abra jboss as web server PROFILE conf login config xml en un editor de texto Es un archivo XML que contiene un elemento lt policy gt con varios elementos hijos lt application policy gt Cada elemento lt application policy gt define un esquema de autenticaci n diferente Agregue el siguiente pedazo XML lt application policy gt como un nuevo hijo del elemento lt policy gt lt BRMS Platform Security Domain gt lt application policy name brms gt lt authentication gt lt login module code org jboss security auth spi UsersRolesLoginModule flag required gt lt module option name usersProperties gt props brms users properties lt module option gt lt module option name rolesProperties gt props brms roles properties lt module option gt lt login module gt lt authentication gt lt application policy gt 4 Configure la plataforma BRMS para utilizar el m dulo de inicio de sesi n Abra el archivo jboss as web server PROFILE deploy JBoss BRMS war WEB INF components xml Contiene un elemento lt components gt con va
54. nfianza hace disponible el certificado digital para las aplicaciones clientes a JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS localhost keytool import alias BRMSKey file BRMSKey crt keystore PublicBRMS keystore Enter keystore password Re enter new password Owner CN John Smith OU Accounts O ACME INC L Captial City ST CC C US Issuer CN John Smith OU Accounts O ACME INC L Captial City ST CC C US Serial number 4ca0021b Valid from Sun Sep 26 22 31 55 EDT 2010 until Sat Dec 25 21 31 55 EST 2010 Certificate fingerprints MD5 31 1D 1B 98 59 CC 0E 3C 3F 57 01 C2 FE F2 6D C9 SHA1 4C 26 52 CA 0A 92 CC 7A 86 04 50 53 80 94 2A 4F 82 6F 53 AD Signature algorithm name SHA1withRSA Version 3 Trust this certificate no yes Certificate was added to keystore 4 Mueva el almac n privado de llaves en un lugar seguro 44 Es necesario mantener el almac n privado de llaves en un lugar seguro en donde solo lo pueda acceder el servidor JBoss Enterprise BRMS Platform Esto puede ser en la misma m quina o en un lugar asegurado de la red que est diponible para esa m quina A Importante JBoss Enterprise BRMS Platform no puede proporcionar cerdenciales de autenticaci n a recursos en la red Si el almac n privado de llaves se almacena en un lugar seguro d ela red entonces los procedimientos de autenticaci n se deben realizar de parte del servidor JBoss Enterprise BRMS para hacer el almac n privado de
55. nte de jboss brms engine zip a un directorio localhost unzip brms engine zip d client Esto crea un directorio que contiene los archivos jar de la biblioteca de clientes 3 Copielo al servidor de aplicaciones Copie el fichero expandido de la aplicaci n web en el directorio de implementaci n de su servidor 12 Cap tulo 2 Instalaci n de una de aplicaciones Aseg rese de que el nombre de archivo del fichero expandido de la aplicaci n web es jboss brms war El ejemplo a continuaci n demuestra esta operaci n realiz ndola en la l nea de comandos en Linux localhost cp rf temp jboss brms war opt brms server jboss as server production deploy La aplicaci n no se implementar hasta que se inicie el servidor de aplicaciones Copie los archivos jar del directorio cliente creado en el paso anterior en el servidor de aplicaciones cuando se necesite Consulte la documentaci n del servidor de aplicaciones para obtener mayores detalles Habilite los usuarios La configuraci n de autenticaci n predeterminada usa el perfil JAAS jmx console Si implementa en un servidor de aplicaciones ya existente es posible que este perfil ya se haya modificado En ese caso consulte la documentaci n del servidor de aplicaciones para obtener instrucciones sobre c mo agregar nuevos usuarios Cualquier usuario definido en el servidor de aplicaciones podr iniciar sesi n en la instalaci n de JBoss Enterprise BRMS Platform Red Hat re
56. onfigurator lt valu e gt lt the root directory for the repo storage the directory must exist gt lt key gt repository root directory lt key gt lt value gt opt brms standalone 5 2 0 BRMSRulesRepository lt value gt lt property gt 27 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Para versiones de BRMS antes de 5 1 el c digo es as lt component name repositoryConfiguration gt lt property name homeDirectory gt opt jboss soa platform BRMSRulesRepository lt property gt lt component gt 5 Mueva el almac n de datos existente opcional JBoss Enterprise BRMS Platform creara un nuevo almac n de datos en ese lugar si todavia no hay uno Para mantener un almac n de datos existente copie los archivos existentes en un nuevo lugar antes de reinicra el servidor de aplicaciones 6 Reinicie el servidor de aplicaciones Reinicie el servidor de aplicaciones Si el almac n de datos existente no se movi al nuevo lugar entonces se crear un nuevo almac n de datos 4 3 2 Configure BRMS para utilizar un RDBMS externo JBoss Enterprise BRMS Platform se puede configurar para que utilice un RDBMS externo como almac n de datos El archivo repository xml contiene informaci n sobre d nde se almacenan los datos en el repositorio Este archivo se debe cambiar para configurar un RDBMS externo Este archivo se puede modificar manualmente o se puede utilizar la herramienta Repository Configuration en la
57. or BRMS del men desplegable b Haga clic en Download para iniciar la descarga 2 Descomprima la descarga del plug in Descomprima el archivo jar del archivo zip descargado unzip jon plugin pack brms 2 4 1 GA zip 3 Inicie sesi n en la interfaz del usuario JBoss ON 50 Capitulo 9 Monitoreamiento 4 Crague el archivo jar plug in Del men seleccione Administration System Configuration Plugins Haga clic en el bot n Add y seleccione el archivo jar extra do del paso anterior y haga clic en upload 9 2 Descubra la instancia BRMS Despu s de instalar el plug in JBoss Operations Network necesita descubrir la instancia BRMS que se est monitoreando JBoss Operations Network descubrir de manera autom tica BRMS Sin embargo si esto no ocurre entonces los recursos se pueden agregar manualmente consulte el JBoss Operations Network Basic Admin Guide para obtener mayores detalles Despues de que se ha descubierto BRMS debe ser importado al inventario Procedimiento 9 3 Importar BRMS 1 De la cola de descubrimiento seleccione el proceso JMX y haga clic en Import 2 Del men Resources seleccione servidores 3 Seleccione el servidor JMX para ver el servicio BRMS lO Los Mbeans deben estar habilitados para que JBoss ON pueda monitorear BRMS Los Mbeans se pueden habilitar pasando el par metro Ddrools mbeans enabled O por medio de la API KnowledgeBaseConfiguration conf KnowledgeBaseFactory newKnowledg
58. os de que tenga requerimientos espec ficos con relaci n a esto 25 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Para configurar la ubicaci n del indice de b squeda modifique el elemento lt SearchIndex gt del archivo repository xml lt SearchIndex class org apache jackrabbit core query lucene SearchIndex gt lt param name path value wsp home index gt lt param name extractorPoolSize value 2 gt lt param name supportHighlighting value true gt lt SearchIndex gt 4 2 la configuraci n de la base de datos para ModeShape La configuraci n del repositorio predeterminado Modeshape usa una fuente de datos JNDI ModeShapeBRMSRepo para almacenamiento de datos lo cual se configura en el archivo PROFILE deploy modeshape brms store ds xm1 Modifique este archivo para cambiar la configuraci n fuente de datos de utilizar Hypersonic a la base de datos de su escogencia Este archivo es un archivo est ndar de configuraci n de fuente de datos JBoss Consulte el cap tulo sobre la configuraci n de la fuente de datos de la documentaci n del servidor de aplicaciones para obtener mayores detalles sobre c mo configurar fuentes de datos JBoss 4 3 Configuraci n del repositorio Lea esta secci n para aprender sobre la configuraci n del repositorio y para configurar un RDBMS externo JBoss Enterprise BRMS Platform usa la especificaci n JCR del ingl s Content Repository API for Java
59. para almacenar y rastrear los activos tales como reglas Apache Jackrabbit es la implementaci n JCR que se incluye 4 3 1 Cambiar la ubicaci n del repositorio JackRabbit Lea esta secci n para aprender a cambiar la ubicaci n en donde Jackrabbit almacenar el repositorio Cuando la aplicaci n JBoss Enterprise BRMS Platform inicia por primera vez crea un repositorio A menos de que haya cambiado la configuraci n predeterminada este repositorio ser generado en el directorio bin del servidor de aplicaciones Especifique una ubicaci n diferente para este modificando el archivo de ocnfiguraci n de JBoss Seam components xml para ese WAR Seleccione una ubicaci n segura de la que se haga una copia de respaldo de manera regular Procedimiento 4 3 Cambie la ubicaci n del repositorio 1 Apagar el servidor de aplicaciones Detener el servidor de aplicaciones antes de realizar estos cambios 2 Ubique el archivo components xml El archivo components xml se encuentra en el directorio WEB INF del fichero web BRMS deploy jboss brms war WEB INF Este es un archivo de configurac n est ndar JBoss Seam el cual permite la personalizaci n de varioas rutas de la aplicaci n 3 Ubique el atributo valor llave repository root directory Abra el archivo components xml en un editor de texto y encuentre el atributo valor llave repository root directory Se encuentra en el componente repositoryConfiguration y por defecto est comentado
60. re vou can define BRMS specific permissions as needed Save changes Cancel Figura 6 1 Administraci n de los permisos de usuario Procedimiento 6 3 Habilitar la autorizaci n con base en roles 1 Asignar privilegios administrativos a un usuario Antes de habilitar la autorizaci n con base en roles es necesario asignar por lo menos un usuario confiable al rol de administrador detalles 2 Apagar Apague el servidor de aplicaciones antes de realizar estos cambios 3 Abra components xml Abra el archivo jboss as web server PROFILE deploy jboss brms war WEB INF components xml en un editor de texto 4 Ubique el elemento lt property name enableRoleBasedAuthorization gt En el archivo predeterminado components xm1 este elemento XML es un hijo de lt components gt lt component name org jboss seam security roleBasedPermissionResolver gt lt property name enableRoleBasedAuthorization gt false lt property gt lt component gt 38 Capitulo 6 Seguridad En las versions 5 1 y anteriores ubique el siguiente XML lt security role based permission resolver enable role based authorization false gt 5 Actualice el valor del atributo como Verdadero Actualice el valor de la propiedad enable role based authorization como true y guarde el archivo lt component name org jboss seam security roleBasedPermissionResolver gt lt property name enableRoleBasedAuthorization gt true lt property g
61. rio 1 Apagar Apagar el servidor de aplicaciones antes de realizar estos cambios Instalar la JAR del controlador JDBC Copie el archivo JAR que contiene el controlador JDBC para el sevidor de la base de datos a utilizar para la configuraci n del servidor en el directorio 1ib el cual puede ser por ejemplo jboss as web PROFILE production lib Abra repository xml en un editor de texto Abra el archivo repository xml en un editor de texto Al utilizar JBoss este archivo se encoentrar en el directorio bin del servidor de aplicaciones a menos de que se especifique una Actualice la configuraci n del PersistenceManager Ubique el elemento lt PersistenceManager gt el cual se encuentra dentro de lt Workspace gt Por ejemplo lt PersistenceManager class org apache jackrabbit core persistence bundle DerbyPersistenceManager gt lt param name url value jdbc derby wsp home db create true gt lt param name schema0bjectPrefix value wsp name _ gt lt PersistenceManager gt Reemplace esto con la configuraci n apropiada para la base de datos que se va a utilizar ejemplos Establezca el par metro schemaObjectPrefix Este valor es indicado por el prefijo en el nombre de cada tabla de la base de datos administrada por el administrador de persistencia esto debe ser nico en cada base de datos La configuraci n predeterminada usa la variable wsp name la cual contiene el nombre del espacio de trab
62. rios elementos hijos incluyendo lt security identity gt Agregue Comente el elemento lt security identity gt para evitar conflictos Agregue el siguiente elemento lt security identity gt lt security identity authenticate method authenticator authenticate jaas config name brms gt La propiedad jaas config name debe ser igual que application policy Si se cambi la propiedad application policy en el paso anterior entonces modifique la propiedad jaas config name para que coincidan 5 Reiniciar Reinicral el servidor de aplicaciones 6 1 2 Ejemplo de autenticaci n LDAP LDAP es una opci n popular para compa ias grandes Los pasos b sicos de configuraci n son los mismos que el ejemplo anterior aunque los detalles de la configuraci n ser n diferentes Procedimiento 6 2 Ejemplo de autenticaci n dos LDAP 36 1 Aseg rese de que el servidor LDAP est configurado correctamente Aeg rese de que la configuraci n de la red y del cortafuegos no est n evitando la comunicaci n enter el servidor de aplicaciones y el servidor LDAP 2 Apagar Capitulo 6 Seguridad Apague el servidor de aplicaciones antes de realizar estos cambios Configure el m dulo de inicio de sesi n de JBoss Para configurar los m dulos de inicio de sesi n de JBoss abra jboss as web server PROFILE conf login config xml en un editor de texto Es un archivo XML que contiene un elemento lt policy gt con varios elementos hijos lt app
63. rocedimiento a continuaci n para instalarlo y configurarlo K NN Consulte la documentaci n de JBoss Enterprise Web Platform 5 para cualquier configuraci n Procedimiento 2 1 Instale el paquete aut nomo 1 Descargue Descargue el archivo zip del paquete aut nomo del portal de soporte al cliente de Red Hat en la versi n La versi n actual es 5 2 0 Todas las instrucciones a continuaci n usan los nombres de paquete para 5 2 0 pero tambi n aplican a las versiones anteriores a menos de que se observe lo opuesto 2 Extr iga El paquete aut nomo contiene un directorio nico que contiene la instalaci n de JBoss Enterprise Web Platform con la aplicaic n web JBoss Enterprise BRMS Platform ya implementada Extraiga el contenido del archivo zip al directorio en donde se instalar b 4 y L localhost unzip brms standalone 5 2 0 zip JBoss Enterprise BRMS Platform se implementa en los perfiles de servidor production y default brms standalone 5 2 0 jboss as web server PROFILE deploy jboss brms war Cap tulo 2 Instalaci n de una K Este manual usa PROFILE en una ruta de directorio como antes para indicar los perfiles production o default Habilite los usuarios La configuraci n predeterminada usa el perfil de aplicaci n JAAS brms Este perfil almacena nombres de usuario y contrase as en el archivo PROFILE conf props brms users properties Los usuarios se agregan a adiendo entradas a este archivo en
64. s de manera que se vuelvan a crear y optimizar para los nuevos datos Y is No use la funcionalidad del repositirio para importar y exportar para realizar copias de seguridad del repositorio en lugar de utilizar las herramientas para realizar copias de seguridad que su venedor de bases de datos le proporciona Tiene varias limitacioens tal como se observ en realizar copias de seguridad y Red Hat no lo soporta en esa capacidad 5 2 Importaci n y exportaci n JBoss Enterprise BRMS Platform proporciona una funcionalidad de importaci n y exportaci n est ndar JCR para uso al migrar de una base de datos a otra Los repositorios exportados se escriben en un archivo XML tal como lo definen los est ndares JCR Esta funcionalidad se puede acceder desde la secci n de administraci n del panel de navigaci n Y WI La funcionalidad de importaci n exportaci n no es para realizar copias de seguridad Siempre utilice el sistema para copias de seguridad que el vendedor de la base de datos le proporcione Debe tener en cosideraci n los siguientes puntos al importar o exportar Al importar se borra todo el contenido existente en la base de datos Las operaciones de importaci n y exportaci n se deben realizar s lamente cuando la base de datos no se est utilizando El rendimiento depende mucho del tama o de la base de datos y de la memoria disponible para el servidor El importar es un proceso muy intenso para la memoria El hi
65. si n resoluci n de problemas Cap tulo 3 Localizaci n tico AAA OER dea es de iaa Cap tulo 4 Configuraci n de la base de datos o oocccccoccccn teens 4 1 Configuraci n de la base de datos para Apache Jackrabbit 4 1 1 Configure la base de datos Workspace 4 1 2 Configurar la base de datos Versions 4 1 3 Busqueda y uso de indices 4 2 la configuraci n de la base de datos para ModeShape 4 3 Configuraci n del repositorio 4 3 1 Cambiar la ubicaci n del repositorio JackRabbit 4 3 2 Configure BRMS para utilizar un RDBMS externo Cap tulo 5 Administraci n de datos ocococcccccoc nen eee ne nee 5 1 Copia de seguridad de datos 5 2 Importaci n y exportaci n 5 3 Migraci n de datos entre versiones de BRMS 5 4 Re construcci n de paquetes binarios Cap tulo 6 Seguridad a Lee be ae ae 6 1 Autenticaci n 6 1 1 Ejemplo de autenticaci n UserRolesLoginModule 6 1 2 Ejemplo de autenticaci n LDAP 6 2 Autorizaci n 6 3 Firma de paquetes de reglas 6 3 1 Configuraci n de propiedades de serializaci n Cap tulo 7 ROgiStroS ora tria Cap tulo 8 Personalizaci n 0 ccc ccc ccc tee eee neee 8 1 Personalizar la interfaz del usuario 8 2 Personalizaci n de selectores para la construcci n de paquetes Table of Contents NOOOuAAAHA co 00 10 10 12 14 18 19 23 23 24 24 25 26 26 26 28 31 31 31 31 33 34 35 36 38 41 45 JBoss Enterprise BRMS
66. stgresql Driver gt lt param name ur1 value jdbc postgresql localhost 5432 brms gt lt param name schema value postgresql gt lt param name user value brms_user gt lt param name password value brms_ password gt lt param name schema0bjectPrefix value wsp name _ gt lt PersistenceManager gt Ejemplo C 5 Configuraci n Microsoft SQL Server 2005 usando MSSqlPersistenceManager lt PersistenceManager class org apache jackrabbit core persistence bundle MSSqlPersistenceManager gt lt param name driver value com microsoft sqlserver jdbc SQLServerDriver gt lt param name url value jdbc sqlserver localhost 3918 DatabaseName brms gt lt param name user value brms_user gt lt param name password value brms_password gt lt param name schema value mssql gt lt param name schema0bjectPrefix value wsp name _ gt lt PersistenceManager gt 57 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Historial de revisiones Revisi n 5 2 0 2 400 2013 10 31 R diger Landmann Rebuild with publican 4 0 0 Revision 5 2 0 2 2012 07 18 Anthony Towns Rebuild for Publican 3 0 Revision 5 2 0 2 Tue Jul 1 2011 L Carlon Actualizado para 5 2 0 Se agreg la secci n sobre monitoreamiento Se agregaron las instrucciones de instalaci n de EWS Revisi n 5 1 0 1 Tue Mar 1 2011 Darrin Mison Se agreg las instrucciones sobre ModeShape Revisi
67. storial de versiones del repositorio no se exporta y el atributo Creation Date de las reglas ser re establecido con la fecha en la que se importaron 5 3 Migraci n de datos entre versiones de BRMS Para migrar el repositorio desde una versi n antigua de JBoss Business Rules Management System a la versi n actual es necesario el exportar el repositorio desde la instancia antigua de JBoss JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS Procedimiento 5 1 Exportar el repositorio 1 Desde el panel de navegaci n del lado izquierdo seleccione Administraci n 2 Clic en Importar Exportar 3 Clic en Exportar JBoss BRMS V Browse Find Repository Config Category Manager Import Export Knowledge Bases x Import Export QA h Package snapshots Sad Choose File No file chosen Import Category Export P Status Administration Archive b Event Log amp user permission lal Import Export Rules Verification 2 Repository Configuration e About El navegador descargar un archivo zip que contiene el repositorio en un archivo XML Dependiendo del tama o del repositorio esta operaci n puede llegar a tomar su tiempo Al importar un repositorio es importante observar que cualquier contenido en el repositorio se borrar y se reemplazar con el contenido en el archivo XML que se importa Procedimiento 5 2 Importar el repositorio 1 Desde el panel de navegaci n del lado izquierdo selecc
68. stra el acceso a estas bases de datos usando administradores de persistencia Se proporciona un administrador gen rico de persistencia para bases de datos que cumplen con los requerimientos de JDBC as como otros varios para implementaciones cambiar la configuraci n de la base de datos Aseg rese de que lo siguiente est disponible antes de proceder Una base de datos vac a para que JBoss Enterprise BRMS Platform la utilice Una cuenta de usuario del servidor de la base de datos para que JBoss Enterprise BRMS Platform la utilice JBoss Enterprise BRMS Platform generar tablas de la base de datos en la base de datos especificada si todav a no existen Una vez que esto se logra Red Hat le recomienda el borrar el permiso del usuario de la base de datos para crear tablas La JAR del controlador JDBC apropiada para el servidor de la base de datos 23 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS 4 1 1 Configure la base de datos Workspace La configuraci n existenta de la base de datos Workspace se encuentra en el archivo Workspaces Default workspace xml El archivo repository xml contiene la configuraci n predeterminada que se utiliza para crear los nuevos espacios de trabajo En lugar de actualizar el espacio de trabajo predeterminado ya existente es m s f cil el borrarlo y actualizar la configuraci n plantilla que se encuentra en repository xml Procedimiento 4 1 Cambiar la base de datos del reposito
69. t lt component gt En las versions 5 1 y anteriores ubique el siguiente XML lt security role based permission resolver enable role based authorization true gt 6 Reiniciar Reinicral el servidor de aplicaciones JBoss Enterprise BRMS Platform no administra la identidad de los usuarios Solo los usuarios que son asignados como usuarios BRMS ser n visibles en los permisos de usuarios de JBoss Enterprise BRMS Platform Procedimiento 6 4 Agregue un nuevo usuario a BRMS 1 Seleccione los detalles de los permisos Seleccione Administration del navigation pane luego escoja User Permissions 2 Agregue el mapeo de usuarios Haga clic en el bot n Create new user mapping Escriba el nombre del usuario en la ventana que aparece y luego haga clic en OK El nombre de usuario que se especifica para el rol debe coincidir con un nombre de usuario en el servicio de autenticaci n o no funcionar 3 Agregar permisos detalles Procedimiento 6 5 Administraci n de los permisos de usuario 39 JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS 1 Seleccionar permisos de usuario Seleccione Administration del navigation pane luego escoja User Permissions 2 Seleccionar el usuario Haga clic Open al lado del nombre de usuario Find User Permission mappings Permission details Be TIP To enable or disable authorization open components xml in WEB INFG Create new user mapping Delete selected user open sel
70. t_bestselling_novel en su directorio actual de trabajo escriba el comando cat my_next_bestselling_novel en el int rprete de comandos de shell y pulse Enter para ejecutar el comando El ejemplo anterior incluye un nombre de archivo un comando de shell y una tecla Todo se presenta en negrita monoespaciado y distinguible gracias al contexto Las combinaciones de teclas se pueden distinguir de las individuales con el signo m s que conecta cada partee de la combinaci n de tecla Por ejemplo Pulse Enter para ejecutar el comando Pulse Ctr1 A1t F2 para pasar a una terminal virtual El primer ejemplo resalta una tecla particular a pulsar El segundo ejemplo resalta una combinaci n de teclas un set de tres teclas pulsadas simult neamente Si se discute el c digo fuente los nombres de las clase los m todos las funciones los nombres de variables y valores de retorno mencionados dentro de un p rrafo ser n presentados en Negrita monoespaciado Por ejemplo Las clases de archivo relacionadas incluyen filename para sistema de archivos file para archivos y dir para directorios Cada clase tiene su propio conjunto asociado de permisos Negrita proporcional Esta denota palabras o frases encontradas en un sistema incluyendo nombres de aplicaci n texto de cuadro de di logo botones etiquetados etiquetas de cajilla de verificaci n y bot n de radio t tulos de men y t tulos del submen Por ejemplo Seleccione Sistema Pre
71. zation specific properties drools serialization sign true drools serialization private keyStoreURL file opt secure PrivateBRMS key store drools serialization private keyStorePwd storepassgoeshere drools serialization private keyAlias BRMSKey drools serialization private keyPwd keypassgoeshere drools serialization public keyStoreURL file opt public PublicBRMS keyst ore drools serialization public keyStorePwd keypassgoeshere lt attribute gt lt mbean gt archivo de propiedades jboss brm war PAra configurar las propiedades en el archivo de propiedades boss brms war agregue el siguiente c digo al archivo jboss brms war WEB INF classes preferences properties 45 46 JBoss drools drools store drools drools drools drools ore drools serialization serialization serialization serialization serialization serialization serialization Enterprise BRMS Platform 5 Manual del administrador BRMS sign true private keyStoreURL file opt secure PrivateBRMS key private keyStorePwd storepassgoeshere private keyAlias BRMSKey private keyPwd keypassgoeshere public keyStoreURL file opt public PublicBRMS keyst public keyStorePwd keypassgoeshere Capitulo 7 Registros Capitulo 7 Registros La aplicaci n web JBoss Enterprise BRMS Platform cuenta con la funcionalidad de registros que 1og4j proporciona La configuraci n inclu da en el WAR WEB INF classes 1log4j xm1

JBoss Enterprise BRMS Platform 5 Manual del administrador BRMS

Contents

Download Pdf Manuals

Related Search

Related Contents