Manual del administrador BRMS

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 https://access.redhat.com. Navegue a Descargas luego Plataforma BRMS y luego 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. 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á.

   [localhost ]$ unzip brms-standalone-5.2.0.zip

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

   Nota

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

3. 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 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@hSm1th
   tandrews=pp3rrss0nn3ll

   Copy to Clipboard Toggle word wrap
   Consulte Sección 6.1, “Autenticación” para obtener detalles sobre cómo cambiar el perfil JAAS a uno que soporte un sistema de autenticación diferente tal como LDAP.

4. OPCIONAL: Instale el repositorio ModeShape

   ModeShape es un repositorio de contenido Java (JCR del inglés Java Content Repository) que se puede utilizar en lugar de Apache Jackrabbit. Consulte Sección 2.2.3, “ Instalar y habilitar ModeShape” para obtener mayor información.

   Nota

   Modeshape es un avance tecnológico en BRMS 5.2.

5. 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.
   Consulte Sección 6.3, “ Firma de paquetes de reglas” para aprender un poco más sobre este tema.

6. 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.
   Consulte Capítulo 4, Configuración de la base de datos.

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

   Copy to Clipboard Toggle word wrap
   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 sobre los parámetros adicionales para iniciarl el servidor, http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Web_Platform/.

8. Inicio de sesión de prueba

   Inicie sesión en la aplicación web JBoss Enterprise BRMS Platform para confirmar que está instalado y ejecutando correctamente. Consulte Sección 2.3, “ Inicio de sesión por primera vez” para obtener mayores detalles.

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 Hat en https://access.redhat.com. Navegue hasta Descargas luego Plataforma BRMS y luego 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

   Copy to Clipboard Toggle word wrap
   Esto creará los siguientes archivos:
   • jboss-brms.engine.zip
   • jboss-brms.manager.zip
   • modeshape.zip

     Nota

     modeshape.zip solo se incluye con el paquete implementable para BRMS 5.2 como avance de tecnología.
   Extraiga el jboss-brms.war de jboss-brms-manager.zip.

   [localhost ]$ unzip brms-manager.zip

   Copy to Clipboard Toggle word wrap
   Esto creará un directorio jboss-brms.war, el cual contiene la aplicación web JBoss Enterprise BRMS Platform como fichero expandido.
   Extraiga las bibliotecas del cliente de jboss-brms-engine.zip a un directorio.

   [localhost ]$ unzip brms-engine.zip -d client

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

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

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

   Nota

   Cualquier usuario definido en el servidor de aplicaciones podrá iniciar sesión en la instalación de JBoss Enterprise BRMS Platform.
   Red Hat recomienda que se utilice un sistema de autenticación separado para los usuarios de JBoss Enterprise BRMS Platform. Consulte Sección 6.1, “Autenticación” para aprender cómo 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.

   #admin=sekretz
   jsmith=s@r@hSm1th
   tandrews=p3r50n311

   Copy to Clipboard Toggle word wrap

   Nota

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

5. OPCIONAL: Habilite la firma de paquetes de 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.
   Consulte Sección 6.3, “ Firma de paquetes de reglas” para aprender un poco más sobre este tema.

6. 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.
   Consulte Capítulo 4, Configuración de la base de datos.

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

   Copy to Clipboard Toggle word wrap
   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 sobre los parámetros adicionales para iniciarl el servidor, http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Web_Platform/.

8. Inicie sesión

   Inicie sesión en la aplicación web JBoss Enterprise BRMS Platform para confirmar que está instalado y ejecutando correctamente. Consulte Sección 2.3, “ Inicio de sesión por primera vez” para obtener mayores detalles.

Procedimiento 2.3. Configurar ModeShape

1. Descargar y extraer

   Nota

   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 https://access.redhat.com
   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

   Copy to Clipboard Toggle word wrap
   Después de la extracción tendrá la siguiente estructura:

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

   Copy to Clipboard Toggle word wrap

2. Ejecute el instalador

   Nota

   Los siguientes pasos son necesarios para 5.1.0 y 5.2.0 y estas instrucciones se referirán a 5.2.0 desde este punto en adelante.
   Para instalar ModeShape en el perfil de servidor requerido, use la línea de comandos para ejecutar ant y cuando se le pida especifique el perfil del servidor en el que se instalará ModeShape.

   [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]
   
   

   Copy to Clipboard Toggle word wrap
   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 los usuarios de acuerdo con esa configuración. Consulte Capítulo 6, Seguridad para obetner mayores detalles.

   1. 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@1l

      Copy to Clipboard Toggle word wrap

   2. 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: username=role1, role2, role3.
      Al usuario admin se le deben asignar los roles de JBossAdmin, HttpInvoker, user y admin.
      Al usuario mailman se le debe asignar los roles de JBossAdmin, readwrite.

      admin=JBossAdmin, HttpInvoker, user, admin
      mailman=JBossAdmin, readwrite

      Copy to Clipboard Toggle word wrap

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

      [localhost]$ java -cp client/jboss-logging-spi.jar:lib/jbosssx.jar org.jboss.resource.security.SecureIdentityLoginModule PASSWORD
      Encoded password: 5f78dc15b9a559cbdf8592078de921bc

      Copy to Clipboard Toggle word wrap
      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.
   Consulte Capítulo 4, Configuración de la base de datos para ver las instrucciones.

5. Borre los archivos JAR no utilizados

   Borre los siguientes archivos JAR del directorio server/PROFILE/deploy/jboss-brms.war/WEB-INF/lib/.
   • jackrabbit-api-2.1.0.jar
   • jackrabbit-core-2.1.0.jar
   • jackrabbit-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:

   <property name="properties">
   <key>org.drools.repository.configurator</key>
   <value>org.drools.repository.jackrabbit.JackrabbitRepositoryConfigurator</value>
   <!--  the root directory for the repo storage the directory must exist. -->
   <!--  <key>repository.root.directory</key><value>/opt/yourpath</value>  -->
   </property>

   Copy to Clipboard Toggle word wrap
   En la configuración predeterminada se ha comentado la configuración ModeShape. Borre el comentario de la configuración tal como se muestra:

   <property name="properties">
   <key>org.drools.repository.configurator</key>
   <value>org.drools.repository.modeshape.ModeShapeRepositoryConfigurator</value>
   <key>org.modeshape.jcr.URL</key><value>jndi:jcr/local?repositoryName=brms</value>
   <key>org.drools.repository.secure.passwords</key><value>false</value>
   <key>org.drools.repository.admin.password</key><value>admin</value>
   <key>org.drools.repository.mailman.password</key><value>mailman</value>
   </property>
   

   Copy to Clipboard Toggle word wrap

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.

   <key>org.drools.repository.secure.passwords</key><value>false</value>
   <key>org.drools.repository.admin.password</key><value>password</value>
   <key>org.drools.repository.mailman.password</key><value>password</value>

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap
   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 sobre los parámetros adicionales para iniciar el servidor, http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Web_Platform/.

9. Inicio de sesión

   Inicie sesión en la aplicación web JBoss Enterprise BRMS Platform para confirmar que está instalado y ejecutando correctamente. Consulte Sección 2.3, “ Inicio de sesión por primera vez” para obtener mayores detalles.

Procedimiento 4.1. Cambiar la base de datos del repositorio

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 para la configuración del servidor en el directorio lib, el cual puede ser, por ejemplo jboss-as-web/PROFILE/production/lib/.

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 de que se especifique una ubicación diferente (tal como se describe en Sección 4.3.1, “Cambiar la ubicación del repositorio JackRabbit”).

4. Actualice la configuración del PersistenceManager

   Ubique el elemento <PersistenceManager>, el cual se encuentra dentro de <Workspace>.
   Por ejemplo:

   <PersistenceManager class=
     "org.apache.jackrabbit.core.persistence.bundle.DerbyPersistenceManager">
       <param name="url" value="jdbc:derby:${wsp.home}/db;create=true"/>
   	<param name="schemaObjectPrefix" value="${wsp.name}_"/>
   </PersistenceManager>

   Copy to Clipboard Toggle word wrap
   Reemplace esto con la configuración apropiada para la base de datos que se va a utilizar. Consulte Apéndice C, Ejemplo de configuraciones del administrador de persistencia para ver 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). La configuración predeterminada usa la variable ${wsp.name}, la cual contiene el nombre del espacio de trabajo actual.

   <param name="schemaObjectPrefix" value="${wsp.name}_"/>

   Copy to Clipboard Toggle word wrap

6. Borrar el espacio de trabajo viejo

   Borre el directorio workspaces/Default/.

7. Reiniciar

   Reiniciar el servidor de aplicaciones.

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 lib, el cual puede ser, por ejemplo jboss-as/server/PROFILE/lib/.

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 de que se especifique una ubicación diferente (tal como se describe en Sección 4.3.1, “Cambiar la ubicación del repositorio JackRabbit”).

4. Actualice la configuración del PersistenceManager

   Ubique el elemento <PersistenceManager>, el cual se encuentra dentro de <Workspace>.
   Por ejemplo:

   <PersistenceManager class=
     "org.apache.jackrabbit.core.persistence.bundle.DerbyPersistenceManager">
     <param name="url" value="jdbc:derby:${rep.home}/version/db;create=true"/>
     <param name="schemaObjectPrefix" value="version_"/>
   </PersistenceManager>

   Copy to Clipboard Toggle word wrap
   Reemplace esto con la configuración apropiada para la base de datos que se va a utilizar. Consulte Apéndice C, Ejemplo de configuraciones del administrador de persistencia para ver 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_).

   <param name="schemaObjectPrefix" value="version_"/>

   Copy to Clipboard Toggle word wrap

6. Reiniciar

   Reiniciar el servidor de aplicaciones.

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

   <property name="properties">
      <key>org.drools.repository.configurator</key>
      <value>org.drools.repository.jackrabbit.JackrabbitRepositoryConfigurator</value>
      <!--  the root directory for the repo storage the directory must exist. -->
      <!--  <key>repository.root.directory</key><value>/opt/yourpath</value>  -->
   </property>

   Copy to Clipboard Toggle word wrap

   Nota

   Para versiones de BRMS antes de 5.1 siga los siguientes pasos:

   • Ubique la propiedad homeDirectory
   • 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".

   <component name="repositoryConfiguration"> 
   <!-- 
   *** This is for configuring the "home" directory for the repository
    storage. the directory must exist. ***
   <property name="homeDirectory">
       /home/michael/RulesRepository_001
   </property>
   -->  
   </component> 
   

   Copy to Clipboard Toggle word wrap

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

   <property name="properties">
      <key>org.drools.repository.configurator</key>
      <value>org.drools.repository.jackrabbit.JackrabbitRepositoryConfigurator</value>
      <!--  the root directory for the repo storage the directory must exist. -->
      <key>repository.root.directory</key>
      <value>/opt/brms-standalone-5.2.0/BRMSRulesRepository</value>
   </property>
   

   Copy to Clipboard Toggle word wrap

   Nota

   Para versiones de BRMS antes de 5.1 el código es así:

   <component name="repositoryConfiguration"> 
       <property name="homeDirectory">/opt/jboss-soa-platform/BRMSRulesRepository</property>
   </component>
   

   Copy to Clipboard Toggle word wrap

5. Mueva el almacén de datos existente (opcional)

   JBoss Enterprise BRMS Platform creará un nuevo almacén de datos en ese lugar si todavía 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.

Procedimiento 4.4. Configure un RDBMS externo con la herramienta de configuración del repositorio

1. Inicie sesión en la interfaz del usuario

   Abra un navegador web e introduzca la URL http://localhost:8080/jboss-brms/ reemplazando 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.
   

   View larger image

   

   Figura 4.1. La herramienta de configuración del repositorio

3. Seleccione el tipo RDBMS

   Del menú desplegable Select RDBMS type: seleccione el tipo RDBMS.
   

   View larger image

   

   Figura 4.2. Tipo RDBMS

4. Introduzca los detalles RDBMS

   Seleccione 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 está utilizando introduzca la información requerida RDBMS:
   • Controlador
   • URL
   • Usuario
   • Contraseña
   

   View larger image

   

   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.xml existente con el nuevo repository.xml. A menos de que se especifiqeu un directorio inicial diferente (tal como se describe en Sección 4.3.1, “Cambiar la ubicación del repositorio JackRabbit”), el archivo repository.xml se encoentrará en el directorio bin del servidor de aplicaciones.

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 en brms-users.properties usando este formato: username=password (el archivo brms-roles.properties se puede dejar vacío).

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 <policy> con varios elementos hijos <application-policy>. Cada elemento <application-policy> define un esquema de autenticación diferente. Agregue el siguiente pedazo XML <application-policy> como un nuevo hijo del elemento <policy>:

   <!--BRMS Platform Security Domain-->
   <application-policy name="brms">
      <authentication>
          <login-module
              code="org.jboss.security.auth.spi.UsersRolesLoginModule"
              flag="required">
               <module-option name="usersProperties">
                   props/brms-users.properties
               </module-option>
               <module-option name="rolesProperties">
                   props/brms-roles.properties
               </module-option>
           </login-module>
       </authentication>
   </application-policy>
   

   Copy to Clipboard Toggle word wrap

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 <components> con varios elementos hijos incluyendo <security:identity> .
   Agregue Comente el elemento <security:identity> para evitar conflictos. Agregue el siguiente elemento <security:identity>:

   <security:identity authenticate-
   method="#{authenticator.authenticate}" jaas-config-name="brms"/>
   

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

Procedimiento 6.2. Ejemplo de autenticación dos: LDAP

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

   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 <policy> con varios elementos hijos <application-policy>. Cada elemento <application-policy> define un esquema de autenticación diferente. Agregue el siguiente pedazo XML <application-policy> como un nuevo hijo del elemento <policy>:

   <application-policy name="brms">
    <authentication>
     <login-module code="org.jboss.security.auth.spi.LdapExtLoginModule" 
         flag="required" >
       <module-option name="java.naming.provider.url">
           ldap://ldap.company.com:389
       </module-option>
       <module-option name="bindDN">DEPARTMENT\someadmin</module-option>
       <module-option name="bindCredential">password</module-option>
       <module-option name="baseCtxDN">cn=Users,dc=company,dc=com
       </module-option>
       <module-option name="baseFilter">(sAMAccountName={0})</module-option>
       <module-option name="rolesCtxDN">cn=Users,dc=company,dc=com
       </module-option>
       <module-option name="roleFilter">(sAMAccountName={0})</module-option>
       <module-option name="roleAttributeID">memberOf</module-option>
       <module-option name="roleAttributeIsDN">true</module-option>
       <module-option name="roleNameAttributeID">cn</module-option>
       <module-option name="roleRecursion">-1</module-option>
       <module-option name="searchScope">ONELEVEL_SCOPE</module-option>
     </login-module>
    </authentication>
   </application-policy>

   Copy to Clipboard Toggle word wrap
   Actualice los valores en este archivo de configuración con los valores apropiados para su servidor LDAP.

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 <components> con varios elementos hijos incluyendo <security:identity>.
   Agregue Comente el elemento <security:identity> para evitar conflictos. Agregue el siguiente elemento <security:identity>:

   <security:identity authenticate-method="#{authenticator.authenticate}" jaas-config-name="brms"/>

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