Chapitre 2.  Installation

Procédure 2.1. Installer le package autonome

1. Download

   Télécharger le fichier compressé autonome du portail client Red Hat à partir de https://access.redhat.com. Naviguez dans Downloads, puis Plateforme BRMS, puis, sélectionner la version. La version actuelle est 5.2.0. Toutes les instructions ci-dessous utilisent les noms de package de 5.2.0, mais appliquent également des versions antérieures parfois.

2. Extrait

   Le package autonome contient un seul répertoire contenant l'installation de la plate-forme Web de JBoss Enterprise avec l'application web JBoss Enterprise BRMS Platform déjà déployées. Extrayez le contenu du fichier zip dans le répertoire où il sera installé.

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

   Copy to Clipboard Toggle word wrap
   JBoss Enterprise BRMS Platform est déployée à la fois dans les profils de serveur production et par défaut : brms-standalone-5.2.0/jboss-as-web/server/PROFILE/deploy/jboss-brms.war/

   Note

   Ce guide utilise PROFILE dans un chemin d'accès de répertoire, comme ci-dessus, pour indiquer les profils production ou par défaut.

3. Autoriser les utilisateurs

   La configuration par défaut utilise le profil d'applications JAAS brms. Ce profil stocke des noms d'utilisateurs et des mots de passe dans le fichier PROFILE/conf/props/brms-users.properties.
   On ajoute des utilisateurs par des entrées au fichier sous le format nom d'utilisateur=mot de passe. On peut commenter les entrées en ajoutant le caractère de hachage (#) en début de ligne.

   #admin=password
   jsmith=s@r@hSm1th
   tandrews=pp3rrss0nn3ll

   Copy to Clipboard Toggle word wrap
   Consulter Section 6.1, « Authentification » pour obtenir des détails sur la façon de changer le profil JAAS qui supporte un système d'authentification comme LDAP.

4. OPTION : Installer le référentiel de ModeShape

   ModeShape est un JRC (Java Content Repository / Référentiel de contenu Java) qui peut être utilisé à la place de Apache Jackrabbit. Consulter Section 2.2.3, «  Installer et activer ModeShape » pour obtenir davantage d'informations.

   Note

   Modeshape est un aperçu technologique dans BRMS 5.2.

5. OPTION : Activation de Rule Package Signing (signature des règles de package).

   La fonctionnalité Rule Signing Package utilise la cryptographie de clés publiques pour veiller à ce que les packages ne soient pas corrompus ou falsifiés au cours du téléchargement. Red Hat recommande que cette fonctionnalité soit activée dans un environnement de production.
   Consulter Section 6.3, «  Rule Package Signing » pour étudier ce sujet.

6. Configuration de la base de données

   Les configurations par défaut utilisent des bases de données qui ne sont ni adaptées, ni prises en charge pour des environnements de production. Avant de déployer dans un environnement de production, cette configuration doit être changée en un serveur de base de données pris en charge.
   Consulter Chapitre 4, Configuration de la base de données.

7. Démarrer le serveur

   Pour lancer le serveur à partir de la ligne de commande, utiliser la commande run.sh sur un système UNIX ou Linux, ou run.bat sur un système Microsoft Windows. Le paramètre -c doit être utilisé pour indiquer quel profil de serveur utiliser.

   [localhost ]$ ./run.sh -c production

   Copy to Clipboard Toggle word wrap
   Les scripts run.sh et run.bat sont situés dans le répertoire bin.
   Ainsi, le chemin d'accès au répertoire bin du serveur autonome BRMS 5.2.0 est brms-standalone-5.2.0/jboss-as-web/bin/.
   Consulter la documentation de JBoss Enterprise Web Platform 5 pour obtenir des informations sur les paramètres supplémentaires de lancement du serveur, http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Web_Platform/.

8. Test de connexion

   Connectez-vous à l'application web JBoss Enterprise BRMS Platform pour confirmer qu'elle est installée et qu'elle exécute correctement. Voir Section 2.3, «  Première connexion » pour plus de détails.

Procédure 2.2. Installer Deployable Package (package déployable)

1. Download

   Télécharger le fichier zip de Deployable Package à partir du portail à la Clientèle de Red Hat à l'adresse suivant: https://access.redhat.com. Naviguez dans Downloads, puis BRMS Platform, et sélectionner la version. La version courante est 5.2.0. Toutes les instructions ci-dessous utilisent les noms de package de 5.2.0, mais s'appliquent également aux versions précédentes si noté.

2. Extraire le logiciel

   Extraire les fichiers de déploiement BRMS du package zip.

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

   Copy to Clipboard Toggle word wrap
   Cela va créer les fichiers suivants :
   • jboss-brms.engine.zip
   • jboss-brms.manager.zip
   • modeshape.zip

     Note

     modeshape.zip n'est inclus dans le package déployable de BRMS 5.2 qu'en tant qu'aperçu technologique.
   Extraire jboss-brms.war de jboss-brms-manager.zip.

   [localhost ]$ unzip brms-manager.zip

   Copy to Clipboard Toggle word wrap
   Cela va créer un répertoire jboss-brms.war qui contient l'application web JBoss Enterprise BRMS Platform sous forme d'archive explosée.
   Extraire les bibliothèques client de jboss-brms-engine.zip dans un répertoire.

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

   Copy to Clipboard Toggle word wrap
   Cela crée un répertoire qui contient les fichiers jar de bibliothèques client.

3. Copier dans le serveur d'applications.

   Copier l'archive d'applications web explosées dans le répertoire de déploiement de votre serveur d'applications. Veillez à ce que le nom de fichier de l'archive d'applications web explosée soit jboss-brms.war. L'exemple ci-dessous démontre que cette opération est effectuée au niveau ligne de commande sur Linux.

   [localhost ]$ cp -rf ~/temp/jboss-brms.war /opt/brms-server/jboss-as/server/production/deploy/

   Copy to Clipboard Toggle word wrap
   L'application ne sera pas déployée tant que le serveur d'applications n'est pas lancé.
   Copier les fichiers jar du répertoire clients créé dans l'étape précédente dans le serveur d'applications selon les besoins. Veuillez consulter la documentation sur le serveur d'applications pour obtenir davantage d'informations.

4. Autoriser les utilisateurs

   La configuration d'authentification par défaut utilise le profil JAAS jmx-console. En cas de déploiement dans un serveur d'applications existant, il est possible que ce profil ait déjà été modifié. Dans ce cas, consulter la documentation sur les serveurs d'applications pour obtenir des instructions sur la façon d'ajouter de nouveaux utilisateurs.

   Note

   Tout utilisateur défini dans le serveur d'applications sera en mesure de se connecter à l'installation de JBoss Enterprise BRMS Platform.
   Red Hat recommande qu'un système d'autentification séparé soit utilisé pour les utilisateurs de JBoss Enterprise BRMS Platform. Voir Section 6.1, « Authentification » pour savoir comment modifier le profil JAAS.
   La configuration par défaut du profil de la jmx-console pour les produits JBoss Platform utilise le module de connexion UsersRolesLoginModule pour stocker les noms d'utilisateurs et les mots de passe dans le fichier PROFILE/conf/props/jmx-console-users.properties.
   On peut ajouter des utilisateurs en ajoutant des entrées à ce fichier sous le format suivant nom d'utilisateur=mot de passe. On peut commenter les entrées en ajoutant le caractère de hachage (#) en début de ligne.

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

   Copy to Clipboard Toggle word wrap

   Note

   Ce guide utilise PROFILE dans un chemin d'accès de répertoire, comme ci-dessus, pour indiquer les profils production ou par défaut.

5. OPTION : Activation de Rule Package Signing (signature des règles de package).

   La fonctionnalité Rule Signing Package utilise la cryptographie de clés publiques pour veiller à ce que les packages ne soient pas corrompus ou falsifiés au cours du téléchargement. Red Hat recommande que cette fonctionnalité soit activée dans un environnement de production.
   Consulter Section 6.3, «  Rule Package Signing » pour étudier ce sujet.

6. Configuration de la base de données

   Les configurations par défaut utilisent des bases de données qui ne sont ni adaptées, ni prises en charge pour des environnements de production. Avant de déployer dans un environnement de production, cette configuration doit être changée pour un serveur de base de données pris en charge.
   Consulter Chapitre 4, Configuration de la base de données.

7. Démarrer le serveur

   Pour lancer le serveur à partir de la ligne de commande, utiliser la commande run.sh sur un sytème UNIX, ou bien exécuter run.bat sur un système Microsoft Windows. Le paramètre -c doit être utilisé pour spécifier quel profil de serveur utiliser.

   [localhost ]$ ./run.sh -c production

   Copy to Clipboard Toggle word wrap
   Les scripts run.sh et run.bat sont situés dans le répertoire bin.
   Ainsi, le chemin d'accès au répertoire bin du serveur autonome BRMS 5.2.0 est brms-standalone-5.2.0/jboss-as-web/bin/.
   Consulter la documentation de JBoss Enterprise Web Platform 5 pour obtenir des informations sur les paramètres supplémentaires de lancement du serveur, http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Web_Platform/.

8. Connexion

   Connectez-vous à l'application web JBoss Enterprise BRMS Platform pour confirmer qu'elle est installée et qu'elle exécute correctement. Voir Section 2.3, «  Première connexion » pour plus de détails.

Procédure 2.3. Configuration de ModeShape

1. Téléchargement et Extraction

   Note

   Cette étape est utile uniquement pour 5.1.0. Le package autonome 5.2.0 est fourni avec ModeShape.
   Télécharger le package ModeShape package (modeshape.zip) du portail Red Hat Support Portal à partir de https://access.redhat.com
   Extraire le répertoire modeshape du fichier ZIP du package, et le mettre dans le répertoire d'installation BRMS. Pour la version autonome de JBoss Enterprise BRMS Platform, il s'agit de brms-standalone-5.1.0.

   [localhost ]$ unzip modeshape.zip

   Copy to Clipboard Toggle word wrap
   Après l'extraction, le répertoire aura la structure suivante :

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

   Copy to Clipboard Toggle word wrap

2. Exécuter l'installateur

   Note

   Vous aurez besoin des étapes suivantes pour 5.1.0 et 5.2.0, et ces instructions feront référence à 5.2.0 à partir de ce point.
   Pour installer ModeShape dans le profil de serveur qui convient, utiliser la ligne de commande pour exécuter ant, et quand vous y serez invité, indiquer le profil du serveur où ModeShape sera installé.

   [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
   Le script installe tous les services de ModeShape dans le profil de serveur spécifié.

3. Utilisateurs et rôles pour l'installation

   Ajouter les comptes d'utilisateur admin et mailman, et leur assigner les rôles indiqués ci-dessous. La configuration par défaut utilise des fichiers de texte pour stocker les noms d'utilisateur, les mots de passe et les rôles assignés. Les instructions données assument qu'à ce point, la configuration d'autorisation n'a pas été changée. Si elle a été changée, alors il faut ajouter les utilisateurs suivant cette configuration. Consulter Chapitre 6, Sécurité pour obtenir davantage d'informations.

   1. Ajouter les utilisateurs admin et mailman

      Ouvrir le fichier PROFILE/conf/props/brms-users.properties dans l'éditeur de texte et ajouter les utilisateurs admin et mailman à ce fichier comme nouvelle ligne avec la syntaxe : username=password.

      admin=s3kr3t5
      mailman=53cur3m@1l

      Copy to Clipboard Toggle word wrap

   2. Assigner les rôles

      Assigner les rôles indiqués ci-dessous aux deux utilisateurs en ouvrant le fichier PROFILE/conf/props/brms-roles.properties dans un éditeur de texte, et en ajoutant une nouvelle ligne pour chaque utilisateur avec la syntaxe : username=role1, role2, role3.
      L'utilisateur admin doit posséder les rôles de JBossAdmin, HttpInvoker, user, et d' admin.
      L'utilisateur de mailman doit posséder les rôles de JBossAdmin, readwrite.

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

      Copy to Clipboard Toggle word wrap

   3. OPTION : Encoder les mots de passe

      En option, les mots de passe peuvent être stockés en forme encodée et non pas en texte ordinaire. Pour cela, exécuter la commande suivante dans le répertoire du serveur d'application (jboss-as or jboss-as-web) pour créer la forme encodée du mot de passe, et en remplaçant PASSWORD par le mot de passe qui convient.

      [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
      Puis, remplacer les mots de passe stockés dans PROFILE/conf/props/brms-users.properties par les versions encodées.

4. OPTION : Configuration de la base de données

   La configuration par défaut de Modeshape utilise une base de données qui ne convient, ni n'est supportée dans les environnements de production. Avant de déployer dans un environnement de production, cette configuration doit être changée en serveur de bases de données supportées.
   Consulter Chapitre 4, Configuration de la base de données pour obtenir davantage d'instructions.

5. Retirer les fichiers JAR Non utilisés

   Supprimer les fichiers JAR suivants du répertoire 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. Activer ModeShape dans le WAR

   Modifier le fichier jboss-brms.war/WEB-INF/components.xml pour retirer la configuration d'Apache Jackrabbit et ajouter la configuration de ModeShape.
   Pour retirer la configuration d'Apache Jackrabbit, il faut supprimer ou dé-commenter la section suivante :

   <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
   La configuration de ModeShape est dé-commentée dans la configuration par défaut. Dé-commenter la configuration comme suit :

   <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. Définir les mots de passe

   ModeShape a besoin de deux comptes d'utilisateur, admin et mailman. Les mots de passe ce ces comptes doivent être spécifiés dans la configuration ModeShape de l'étape précédente.

   <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. Démarrage du serveur

   Pour lancer le serveur à partir de la ligne de commande, utiliser la commande run.sh d'un système UNIX ou Linux, ou bien run.bat sur un système Microsoft Windows. Le paramètre -c doit être utilisé pour indiquer quel profil de serveur utiliser.

   [localhost ]$ ./run.sh -c production

   Copy to Clipboard Toggle word wrap
   Les scripts run.sh et run.bat se situent dans le répertoire bin.
   Par exemple, le chemin complet vers le répertoire bin du serveur autonome BRMS 5.2.0 est brms-standalone-5.2.0/jboss-as-web/bin/.
   Consulter la documentation JBoss Enterprise Web Platform 5 pour obtenir des informations sur les paramètres supplémentaires nécessaires pour lancer le serveur, http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Web_Platform/.

9. Connexion

   Connectez-vous à l'application web JBoss Enterprise BRMS Platform pour confirmer que l'installation et l'exécution soient au point. Consulter Section 2.3, «  Première connexion » pour obtenir davantage d'informations.