Red Hat Summit Red Hat SummitApoyoConsolaDesarrolladoresIniciar una pruebaContacto

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

Aviso

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 http://www.jboss.com/products/platforms/brms/supportedconfigurations/ para ver una lista de los sistemas soportados de la base de datos.

4.1. Configuración de la base de datos para Apache Jackrabbit
Copiar enlace

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 administra 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 especificas para bases de datos. Consulte http://wiki.apache.org/jackrabbit/PersistenceManagerFAQ para encontrar mayor información sobre los administradores de persistencia y en Apéndice C, Ejemplo de configuraciones del administrador de persistencia encontrará ejemplos.

Aviso

Use la funcionalidad de importación y exportación (consulte Sección 5.2, “Importación y exportación”) para retener cualquier activo almacenado en la base de datos existente antes de 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.

4.1.1. Configure la base de datos Workspace
Copiar enlace

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

4.1.2. Configurar la base de datos Versions
Copiar enlace

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

4.1.3. Búsqueda y uso de índices
Copiar enlace

La funcionalidad de búsqueda y de uso de índices dentro de JBoss Enterprise BRMS Platform la brinda Apache Lucene (http://lucene.apache.org/).
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 menos de que tenga requerimientos específicos con relación a esto.
Para configurar la ubicación del índice de búsqueda, modifique el elemento <SearchIndex> del archivo repository.xml: 
<SearchIndex class="org.apache.jackrabbit.core.query.lucene.SearchIndex">
	<param name="path" value="${wsp.home}/index"/>
	<param name="extractorPoolSize" value="2"/>
	<param name="supportHighlighting" value="true"/>
</SearchIndex>
Copy to Clipboard Toggle word wrap

4.2. la configuración de la base de datos para ModeShape
Copiar enlace

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.xml. 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
Copiar enlace

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) 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
Copiar enlace

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

4.3.2. Configure BRMS para utilizar un RDBMS externo
Copiar enlace

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 interfaz de usuario BRMS.
Para modificar manualmente el archivo repository.xml, ubique el archivo y ábralo con un editor de texto. el archivo está anotado con comentarios que describen las opciones.
A menos de que se especificara un directorio de inicio diferente (tal como se describe en Sección 4.3.1, “Cambiar la ubicación del repositorio JackRabbit”), el archivo repository.xml se encontrará en el diretcorio bin del servidor de aplicaciones.
Consulte Apéndice C, Ejemplo de configuraciones del administrador de persistencia para ver configuraciones de ejemplo.

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.
    La herramienta de configuración del repositorio
    View larger image
    La herramienta de configuración del repositorio

    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.
    Tipo RDBMS
    View larger image
    Tipo RDBMS

    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
    Información RDBMS
    View larger image
    Información RDBMS

    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.
Volver arriba
Red Hat logoGithubredditYoutubeTwitter

Aprender

Pruebe, compre y venda

Comunidades

Acerca de la documentación de Red Hat

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

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

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

Acerca de Red Hat

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

Theme

© 2025 Red Hat