Red Hat Summit Red Hat SummitSupportConsoleDéveloppeursCommencer un essaiContact

Chapitre 4. Configuration de la base de données

Lire ce chapitre pour apprendre comment configurer les bases de données utilisées par le référentiel de JBoss Enterprise BRMS Platform, changer l'adresse du référentiel, et configurer un RDBMS externe.
La plate-forme JBoss Enterprise BRMS peut soit utiliser Apache Jackrabbit (par défaut), ou Modeshape comme référentiel de contenu. Ces deux référentiels utilisent une base de données pour le stockage, mais chacun d'entre eux est configuré différemment. Les sections suivantes contiennent des instructions sur la façon de configurer chaque base de données du référentiel.

Avertissement

Les configurations par défaut d'Apache Jackrabbit et de Modeshape utilisent des bases de données incluses, non prises en charge pour la production, Derby et Hypersonic respectivement. Cette configuration est incluse uniquement à des fins d'évaluation et démonstration et n'est pas prise en charge dans les environnements de production. La configuration d'une base de données supportée est requise pour un déploiement de prise en charge de la production. Consulter http://www.jboss.com/products/platforms/brms/supportedconfigurations/ pour obtenir une liste des systèmes de bases de données prises en charge.

4.1. Configuration de base de données dans Apache Jackrabbit
Copier lien

Le référentiel Apache Jackrabbit stocke deux ensembles d'information, Workspace et Versions. Workspace correspond au système de stockage à desseins multiples, qui contient les règles et autres données. Versions stocke l'historique de tous les changements à Workspace. Workspace et Versions peuvent être stockés dans des bases de données séparées mais Red Hat recommande d'utiliser une simple base de données pour faciliter la gestion.
Le référentiel de JBoss Enterprise BRMS Platform gère l'accès à ces bases de données par les persistence managers. Un gestionnaire de persistance générique est fourni pour les bases de données compatibles-JDBC, ainsi que plusieurs autres pour les implémentations de bases de données spécifiques. Voir http://wiki.apache.org/jackrabbit/PersistenceManagerFAQ pour en savoir davantage sur les gestionnaires de persistance, et voir Annexe C, Exemple de configuration du gestionnaire de persistance pour les exemples.

Avertissement

Utiliser la fonctionnalité d'import export (voir Section 5.2, « Importer et exporter ») pour conserver tout élément stocké dans la base de données existante, avant de modifier la configuration de la base de données.
Veillez à ce que ce qui suit soit disponible ou prêt avant de continuer :
  • Base de données vide à utiliser par la plateforme JBoss Enterprise BRMS.
  • Compte d'utilisateur de serveur de base de données à utiliser par la plate-forme JBoss Enterprise BRMS. La plateforme JBoss Enterprise BRMS va générer des tableaux de bases de données dans une base de données particulières, s'ils ne sont pas déjà présents. Une fois réalisé, Red Hat recommande de retirer la permission de l'utilisateur de la base de données pour créer les tableaux.
  • Le JAR de pilote JDBC approprié pour le serveur de base de données.

4.1.1. Configurer la base de données de Workspace
Copier lien

On trouve la configuration de la base de données de Workspace dans le fichier Workspaces/Default/workspace.xml. Le fichier repository.xml contient les paramètres de configuration par défaut utilisés pour créer les nouveaux packages. Au lieu de mettre à jour le Workspace par défaut déjà existant, il est préférable de le supprimer et de mettre à jour la configuration modèle qui se situe dans repository.xml.

Procédure 4.1. Changer la base de données du référentiel.

  1. Fermeture

    Fermer le serveur de l'application avant d'effectuer ces changements.

  2. Installer le JAR du pilote JDBC

    Copier le fichier JAR qui contient le pilote JDBC dans le répertoire lib du serveur, qui pourrait correspondre, par exemple à jboss-as-web/PROFILE/production/lib/.

  3. Ouvrir repository.xml dans un éditeur de textes.

    Ouvrir le fichier repository.xml dans un éditeur de texte. Quand on utilise JBoss, ce fichier réside dans le répertoire bin du serveur d'applications, à moins qu'une autre adresse n'ait été spécifiée (comme expliqué dans Section 4.3.1, « Changer l'adresse du référentiel de JackRabbit »).

  4. Mise à jour de la configuration de PersitenceManager

    Trouver l'élément <PersistenceManager>, qui se trouve dans <Workspace>.
    Par exemple : 
    <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
    Remplacer cela par la configuration de la base de données à utiliser pour la base de données. Voir Annexe C, Exemple de configuration du gestionnaire de persistance pour les exemples.

  5. Définir le paramètre schemaObjectPrefix

    Cette valeur est indiquée par le préfixe du nom de chaque tableau de base de données géré par le gestionnaire de persistance. (Cela doit être unique dans chaque base de données). La configuration par défaut utilise la variable ${wsp.name} qui contient le nom de l'espace de travail en cours. 
    <param name="schemaObjectPrefix" value="${wsp.name}_"/>
    Copy to Clipboard Toggle word wrap

  6. Effacer l'ancien espace de travail.

    Effacer le répertoire workspaces/Default/.

  7. Redémarrage

    Redémarrer le serveur d'applications.

4.1.2. Configurer la base de données de Versions
Copier lien

JBoss Enterprise BRMS conserve un historique de tous les changements effectués sur la base de données. Cela est conservé dans un lieu de stockage séparé pour empêcher la dégradation au fur et à mesure que le nombre de versions augmente.
Cette zone de stockage a sa propre configuration de gestion des persistances, qui se trouve dans le fichier repository.xml. À la différence de la configuration de Workspace, la configuration de stockage de version ici ne consiste pas en un simple modèle; il s'agit de la configuration réelle qui est utilisée.

Procédure 4.2. Modifier la base de données de Versions

  1. Fermeture

    Fermer le serveur de l'application avant d'effectuer ces changements.

  2. Installer le JAR du pilote JDBC

    Copier le fichier JAR qui contient le pilote JDBC dans le répertoire lib du serveur, qui pourrait correspondre, par exemple à jboss-as/server/PROFILE/lib/.

  3. Ouvrir repository.xml dans un éditeur de textes.

    Ouvrir le fichier repository.xml dans un éditeur de texte. Quand on utilise JBoss, ce fichier réside dans le répertoire bin du serveur d'applications, à moins qu'une autre adresse n'ait été spécifiée (comme expliqué dans Section 4.3.1, « Changer l'adresse du référentiel de JackRabbit »).

  4. Mise à jour de la configuration de PersitenceManager

    Trouver l'élément <PersistenceManager>, qui se trouve dans <Workspace>.
    Par exemple : 
    <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
    Remplacer cela par la configuration de la base de données à utiliser pour la base de données. Voir Annexe C, Exemple de configuration du gestionnaire de persistance pour les exemples.

  5. Définir le paramètre schemaObjectPrefix

    Cette valeur est indiquée par le préfixe qui se trouve sur le nom de chaque tableau de base de données géré par le Gestionnaire de persistance. (Cela doit être unique pour chaque base de données.) Si la même base de données est utilisée pour les deux Versions et pour le datastore, veillez à ce que le même schemaObjectPrefix ne soit pas utilisé pour les deux. (La configuration par défaut utilise version_.) 
    <param name="schemaObjectPrefix" value="version_"/>
    Copy to Clipboard Toggle word wrap

  6. Redémarrage

    Redémarrer le serveur d'applications.

4.1.3. Recherche et Indexation
Copier lien

Fonctionnalité de recherche et d'indexation de JBoss Enterprise BRMS Platform fournie dans Apache Lucene (http://lucene.apache.org/).
Par défaut, l'index de recherche est conservé dans un système de fichiers local. C'est parce que cela fournit une performance plus rapide. Red Hat ne conseille pas ce paramètre par défaut, à moins que vous ayez un besoin particulier de l'utiliser.
Pour configurer l'adresse de l'index de recherche, modifier l'élément repository.xml file's <SearchIndex> 
<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.  Configuration de la Database de ModeShape
Copier lien

La configuration par défaut du référentiel Modeshape utilise un — ModeShapeBRMSRepo — JNDI pour le stockage de sources de données, qui est configuré dans le fichier PROFILE/deploy/modeshape-brms-store-ds.xml. Modifier ce fichier pour changer la configuration de la source de données, pour pouvoir utiliser la source de données de votre choix, au lieu d' Hypersonic. Ce fichier est un fichier de configuration de source de données de JBoss standard.
Consulter le chapitre de Configurations des sources de données dans la documentation sur le serveur d'applications pour obtenir des détails sur la façon de configurer les sources de données de JBoss.

4.3. Configuration du référentiel
Copier lien

Lire cette section pour savoir comment configurer un référentiel ou un RDBMS externe.
La JBoss Enterprise BRMS Platform utilise la spécification JRC (Content Repository API for Java) pour stocker et pour suivre les actifs comme les règles. Apache est Jackrabbit dans l'implementation qui est incluse.

4.3.1. Changer l'adresse du référentiel de JackRabbit
Copier lien

Lire cette section pour savoir comment changer l'adresse dans laquelle Jackrabbit va stocker son référentiel.
Quand l'application JBoss Enterprise BRMS Platform démarre pour la première fois, elle crée un référentiel. À moins de changer la configuration par défaut, ce référentiel va être généré dans le répertoire bin du serveur d'applications.
Indiquer une adresse différente en modifiant le fichier de configuration components.xml de JBoss Seam pour ce WAR. Sélectionner une adresse sécurisée qui est sauvegardée régulièrement.

Procédure 4.3. Changer la location du référentiel

  1. Fermer le serveur d'applications

    Stopper le serveur d'applications avant d'effectuer ces changements.

  2. Trouver le fichier components.xml

    Le fichier components.xml se situe dans le répertoire WEB-INF/, (deploy/jboss-brms.war/WEB-INF/.) Il s'agit d'un fichier de configuration standard qui permet la personnalisation de différentes parties de l'application.

  3. Trouver l'attribut Key-Value de repository.root.directory

    Ouvrir le fichier components.xml dans un éditeur de texte et trouver l'attribut Key-Value de repository.root.directory. Il est contenu dans le composant repositoryConfiguration et est "dé-commenté" par défaut. 
    <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

    Note

    Pour les versions de BRMS antérieures à 5.1, suivre les étapes suivantes :
    • Trouver la propriété homeDirectory
    • Ouvrir le fichier components.xml dans un éditeur de textes et trouver la propriété homeDirectory. Elle se trouve dans le composant repositoryConfiguration et elle est "dé-commentée" par défaut. 
    <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. Mettre à jour l'attribut Key-Value de repository.root.directory

    Retirer les balises de commentaires qui se trouvent autour de l'attribut de Key-Value repository.root.directory et modifier la valeur du chemin d'accès au répertoire où va se trouver le datastore. (Ce répertoire doit déjà exister). 
    <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

    Note

    Pour les versions de BRMS antérieures à 5.1, le code est le suivant : 
    <component name="repositoryConfiguration"> 
    <property name="homeDirectory">/opt/jboss-soa-platform/BRMSRulesRepository</property>
</component>
    Copy to Clipboard Toggle word wrap

  5. Déplacer le datastore existant (en option)

    La JBoss Enterprise BRMS Platform va créer un nouveau datastore à cette adresse s'il n'y en a pas déjà un. Pour conserver un datastore déjà existant, copier les fichiers existants à une autre adresse avant de redémarrer le serveur d'applications.

  6. Redémarrage du serveur d'applications

    Redémarrer le serveur d'applications. Si un datastore existant n'a pas été déplacé vers la nouvelle adresse, un nouveau datastore sera créé.

4.3.2.  Configurer BRMS pour qu'il utilise un RDBMS externe.
Copier lien

La JBoss Enterprise BRMS Platform peut être configurée pour utiliser un RDBMS externe comme datastore. Le fichier repository.xml contient des informations sur l'endroit où les données du référentiel se trouvent. Ce fichier doit être modifié pour installer un RDBMS externe. Ce fichier peut être modifié manuellement ou par l'outil Repository Configuration qui se trouve dans l'interface d'utilsateur de BRMS.
Pour éditer manuellement le fichier repository.xml, localiser le fichier et ouvrez-le dans un éditeur de texte. Le fichier est annoté par des commentaires qui décrivent les options.
À moins qu'un répertoire d'accueil différent ne soit spécifié (comme décrit dans Section 4.3.1, « Changer l'adresse du référentiel de JackRabbit »), le fichier repository.xml se situera dans le répertoire bin du répertoire du serveur d'applications.
Voir Annexe C, Exemple de configuration du gestionnaire de persistance pour les configurations d'exemples.

Procédure 4.4. Configurer un RDBMS externe par l'outil de configuration du référentiel.

  1. Connectez-vous à l'interface utilisateur

    Ouvrir un navigateur Web et saisir l'URL http://localhost:8080/jboss-brms/ en remplaçant localhost par le nom d'hôte du serveur pour accéder au dialogue de login.

  2. Sélectionner l'outil de configuration du référentiel

    À partir du panneau de navigation, sélectionner Administration, puis Configuration Référentiel.
    Outil de configuration du référentiel
    View larger image
    Outil de configuration du référentiel

    Figure 4.1. Outil de configuration du référentiel

  3. Sélectionner le Type RDBMS

    À partir du menu déroulant Select RDBMS type:, choisir le type RDBMS.
    Type RDBMS
    View larger image
    Type RDBMS

    Figure 4.2. Type RDBMS

  4. Saisir les informations sur le RDBMS

    Sélectionner la case USE JNDI si JNDI est configuré.
    Sélectionner Continue et saisir le nom JNDI configuré dans la source de données déployée.
    Si JNDI n'est pas utilisé, saisir les informations RDBMS requises :
    • Pilote
    • URL
    • Utilisateur
    • Mot de passe
    Information RDBMS
    View larger image
    Information RDBMS

    Figure 4.3. Information RDBMS

  5. Générer le fichier de configuration du référentiel

    Sélectionner Generate repository config pour générer le fichier repository.xml.
    Vous pouvez, soit couper/coller le texte généré dans un fichier et le sauvegarder dans repository.xml, ou bien, vous pouvez sélectionner Save Configuration pour télécharger le texte sous forme de fichier. Remplacer le repository.xml existant par le nouveau repository.xml. À moins qu'un répertoire d'accueil différent ne soit spécifié, (comme décrit dans Section 4.3.1, « Changer l'adresse du référentiel de JackRabbit »), le fichier repository.xml se trouvera dans le répertoire bin du serveur d'applications.
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2026 Red HatRetour au début