Guide de démarrage

1. Aller dans le portail Red Hat Customer Portal et connectez-vous.
2. Sélectionner Downloads → Red Hat JBoss Middleware → Download Software.
3. À partir du menu déroulant Product, sélectionner BRMS Platform.
4. À partir du menu Version, sélectionner la version 6.0.2.
5. Sélectionner Red Hat JBoss BRMS 6.0.2 Deployable for EAP 6.1.1 puis cliquer sur Download.

1. Déplacez l'archive zip téléchargée dans le répertoire d'accueil de Red Hat JBoss Enterprise Application Platform (EAP_HOME; le répertoire jboss-eap-6.1 ).
2. Décompressez l'archive zip téléchargée : assurez-vous qu'elle soit mise dans le répertoire EAP_HOME (jboss-eap-6.1).

   Avertissement

   Cette étape doit être exécutée par le même compte d'utilisateur utilisé pour installer EAP. Ce compte ne doit pas être un compte superutilisateur.
3. Il est nécessaire de remplacer les fichiers qui existent déjà dans le répertoire EAP_HOME avec leur version d'archive zip téléchargée. Lorsque vous êtes invité à le faire, acceptez de remplacer les fichiers d'origine.

1. Télécharger l'archive zip et préparez-vous à faire fusionner les fichiers ensemble dans le répertoire d'accueil de Red Hat JBoss Enterprise Application Platform (EAP_HOME; le répertoire jboss-eap-6.1).
2. Décompressez l'archive zip téléchargée ; mais ne remplacez pas tous les fichiers. Faîtes fusionner manuellement les fichiers suivants dans le répertoire EAP_HOME (jboss-eap-6.1).
   • jboss-eap-6.1/domain/configuration/*
   • jboss-eap-6.1/standalone/configuration/*
   • jboss-eap-6.1/modules/layers.conf
   • jboss-eap-6.1/bin/product.conf

   Avertissement

   Assurez-vous que cette étape ait été exécutée par le même compte d'utilisateur utilisé pour installer EAP. Ce compte ne doit pas être un compte superutilisateur.
3. Veillez à ce que la cible EAP n'inclue pas de déploiement ayant un nom qui risque d'entrer en conflit. Copier le dossier jboss-eap-6.1/standalone/deployments dans le répertoire EAP_HOME à partir de la distribution BRMS.
4. Assurez-vous bien qu'aucune couche de module EAP se prénome BRMS et copier le dossier jboss-eap-6.1/modules/system/layers/brms dans le dossier EAP 6.1.1.

1. Exécuter ./add-user.sh sur un système Unix ou add-user.bat sur un système Windows à partir du répertoire bin.
2. Saisir b pour sélectionner un utilisateur d'application à l'invite type d'utilisateur, et appuyer sur Enter.
3. Accepter le domaine (realm) par défaut (ApplicationRealm): en appuyant sur Enter.
4. À l'invite du nom utilisateur, saisir un nom utilisateur et le confirmer. Par exemple : helloworlduser.
5. Créer le mot de passe utilisateur à l'invite du mot de passe et saisir à nouveau le mot de passe. Par exemple : Helloworld@123.

   Note

   Le mot de passe doit comporter au moins 8 caractères et contenir des caractères alphabétiques majuscules et minuscules (par exemple A-Z, a-z), au moins un caractère numérique (par exemple 0-9) et au moins un caractère spécial (p. ex. ~! @ # $ % ^ * () - _ + =).
6. Saisir une liste de rôles séparée par des virgules dont l'utilisateur aura besoin sur invite des rôles (se reporter à Section 3.3, « Définir les rôles »).
   Les utilisateurs de Business Central doivent posséder le rôle analyst ou le rôleadmin.
7. Confirmer que vous souhaitez ajouter l'utilisateur.
8. Saisir oui à la prochaine invite (pour activer le clustering dans le future si possible)

Procédure 3.1. Installer un package déployable standard

1. Pour télécharger le fichier zip du package déployable standard de Red Hat Customer Support Portal, allez dans https://access.redhat.com et connectez-vous.
2. Sélectionner Downloads → Red Hat JBoss Middleware → Download Software.
3. À partir du menu déroulant Product, sélectionner BRMS Platform.
4. À partir du menu déroulant Version, sélectionner la version du produit.
5. Sélectionner le package Red Hat JBoss BRMS 6.0.2 Deployable for all supported containers puis cliquer sur Download.
6. Extraire l'archive téléchargée pour créer les archives zip suivantes :
   • jboss-brms-engine.zip
   • jboss-brms-manager.zip
7. Extraire business-central.war de l'archive jboss-brms-manager.zip et la copier dans tomcat7/webapps/.
8. Supprimer l'extension .war du business-central.war de façon à ce que le répertoire soit dorénavant nommé business-central.
9. Définir les utilisateurs et les rôles dans tomcat7/conf/tomcat-users.xml comme indiqué ci-dessous :

     <role rolename="admin"/>
     <role rolename="analyst"/>
     <user username="user" password="password" roles="admin,analyst"/>

   Copy to Clipboard Toggle word wrap
10. Modifier le fichier web.xml du répertoire tomcat7/webapps/business-central/WEB-INF en décommentant les entrées marquées TOMCAT-JEE-SECURITY. Par exemple :

    <!-- TOMCAT-JEE-SECURITY -->
        <!--
        <init-param>
          <param-name>org.uberfire.auth.scheme</param-name>
          <param-value>org.uberfire.security.server.auth.JACCAuthenticationScheme</param-value>
        </init-param>
        -->
    

    Copy to Clipboard Toggle word wrap
    Doit être décommenté ainsi :

    <!-- TOMCAT-JEE-SECURITY -->
    
        <init-param>
          <param-name>org.uberfire.auth.scheme</param-name>
          <param-value>org.uberfire.security.server.auth.JACCAuthenticationScheme</param-value>
        </init-param>
    

    Copy to Clipboard Toggle word wrap
11. Copier le fichier kie-tomcat-integration-VERSION.jar à partir de business-central/WEB-INF/lib de la distribution BRMS dans tomcat7/lib.
12. Copier le fichier slf4j-api-VERSION.jar et le fichier slf4j-ext-VERSION.jar de business-central/WEB-INF/lib de la distribution BRMS dans tomcat7/lib.
13. Télécharger le fichier ci-dessous et le mettre dans le répertoire tomcat7/lib.
    • javax.security.jacc-api.jar
14. Ajouter la déclaration de Valve Tomcat dans tomcat7/conf/server.xml (dans l' <hôte> qui convient):

    <Valve className="org.kie.integration.tomcat.JACCValve"/>

    Copy to Clipboard Toggle word wrap
15. Renommer org.uberfire.security.auth.AuthenticationSource dans org.uberfire.security.auth.AuthenticationSource-ORIGIN et org.uberfire.security.auth.AuthenticationSource-TOMCAT-JEE-SECURITY dans org.uberfire.security.auth.AuthenticationSource à l'intérieur de business-central/WEB-INF/classes/META-INF/services
16. Démarrer le serveur JBoss Web Server en exécutant startup.sh dans le répertoire tomcat7/bin.

    ./startup.sh

    Copy to Clipboard Toggle word wrap
17. Naviguez vers http://localhost:8080/business-central dans un navigateur web.
18. Connectez-vous avec le nom d'utilisateur et le mot de passe donnés dans le fichier tomcat-users.xml où vous avez défini les rôles d'utilisateur.

1. Sur ligne de commande, déplacez-vous dans le répertoire $SERVER_HOME/bin/.
2. Dans un environnement Unix, exécuter :

   ./standalone.sh

   Copy to Clipboard Toggle word wrap
   Dans un environnement Windows, exécuter :

   ./standalone.bat

   Copy to Clipboard Toggle word wrap

1. Sur ligne de commande, déplacez-vous dans le répertoire $SERVER_HOME/bin/.
2. Dans un environnement Unix, exécuter :

   ./standalone-secure.sh

   Copy to Clipboard Toggle word wrap
   Dans un environnement Windows, exécuter :

   ./standalone-secure.bat

   Copy to Clipboard Toggle word wrap

1. Ouvrir Business Central dans votre navigateur web (en cas d'exécution locale http://localhost:8080/business-central) et connectez-vous en tant qu'utilisateur avec le rôle admin (helloworlduser).
2. Créer une unité organisationnelle dans le référentiel Artifact :
   1. Aller dans Authoring → Administration.
   2. Dans le menu Perspective, cliquer sur Organizational Units → Manage Organizational Units.
   3. Dans la vue Organizational Unit Manager, cliquer sur Add.
      Dans la boîte de Add New Organizational Unit affichée, définir les propriétés d'unité et cliquer sur le bouton OK:
      • Nom : helloworld
      • Propriétaire : helloworlduser
3. Créer un nouveau référentiel dans l'unité organisationnelle helloworld :
   1. Aller dans Authoring → Administration.
   2. Dans le menu perspective, cliquer sur Repositories → New repository.
   3. Dans la boîte de dialogue Create Repository affichée, définir les propriétés du référentiel :
      • Nom du référentiel : helloworldrepo
      • Unité organisationnelle : helloworld
4. Aller dans Authoring → Project Authoring.
5. Dans Project Explorer qui se trouve dans la boîte d'unité organisationnelle, sélectionner helloworld, et dans la zone déroulante du référentiel, sélectionner helloworldrepo.
   

   View larger image

   

   Figure 5.1. Sélectionner le référentiel helloworldrepo qui se trouve dans l'unité organisationnelle helloworld de Project Explorer

6. Créer un projet dans le référentiel helloworld :
   1. Dans le menu perspective, cliquer sur New Item → Project.
   2. Dans la boîte de dialogue Create new affichée, définir les propriétés du projet :
      • Nom du projet (nom du projet): HelloWorld
      • Chemin : default://master@helloworldrepo/
   3. Dans la boîte de dialogue New Project Wizard, définir les propriétés maven du projet. Appuyer sur la touche Enter après chaque entrée.
      • ID Group : org.brms
      • ID Artifact : HelloWorld
      • ID Version : 1.0
   4. Cliquer sur Terminé.

1. Dans Project Explorer, sélectionner l'unité organisationnelle helloworld, le référentiel helloworldrepo, le projet HelloWorld, et le package default.

   Note

   Assurez-vous de bien sélectionner le package default. Si vous sélectionnez le mauvais package, le déploiement échouera.
2. Créer le fichier DRL :
   1. Dans le menu perspective, cliquer sur New Item → DRL file.
   2. Dans la boîte de dialogue Create New, définir le nom de la ressource en tant que helloworldrule et vérifier que le chemin de destination soit bien default://master@helloworldrepo/HelloWorld/src/main/resources.
   3. Cliquez sur Valider.
3. Dans l'éditeur DRL qui affiche le fichier helloworldrule.drl, définir la règle :

   rule "helloworldrule"
   ruleflow-group "helloworldgroup"
   when 
   then
   	System.out.println("Hello World!");
   end
   

   Copy to Clipboard Toggle word wrap
   Cette règle ne définit aucune condition (Si), c'est à dire qu'elle sera toujours sur true par défaut quand on l'appelle à exécution, et la phrase Hello World! s'affichera.
4. Cliquer sur le bouton Save.
5. Une invite Save this item apparaît. Saisir Check-in comment et cliquer sur Save.

   Note

   Le commentaire d'enregistrement correspond à une description courte du genre de changement que vous venez d'effecteur et doit être saisi à chaque fois qu'une ressource est sauvegardée.

1. Dans le menu principal de Business Central, aller dans Authoring → Project Authoring.
2. Dans Project Explorer, chercher le projet Hello World.
3. Ouvrir le project dans l'éditeur du project  : dans le menu perpective, cliquer sur Tools → Project Editor.
4. Vérifier que les bonnes informations de project soient affichées dans Project Screen et cliquer sur le bouton Build & Deploy qui se trouve dans le coin en haut et à gauche de la vue Project View.
   

   View larger image

   

   Figure 5.2. Éditeur de projet avec des propriétés de projet helloWorld

Procédure 6.1. Configurer le Runtime de BRMS

1. À partir du menu JBoss Developer Studio, sélectionner Window et cliquer sur Preferences.
2. Sélectionner Drools → Installed Drools Runtimes.
3. Cliquer sur Add...; fournir un nom de nouveau runtime, puis cliquer sur Browse pour naviguer vers le répertoire où le runtime se situe. Cliquer sur OK pour enregistrer le runtime sélectionné dans JBDS.
4. Indiquer que le runtime que vous avez créé est le runtime Drools par défaut en cliquant sur la case adjacente.
5. Cliquer sur OK. Si vous avez des projets existants, une boîte de dialogue vous indiquera de démarrer à nouveau JBoss Developer Studio pour mettre le Runtime à jour.

Procédure 6.2. Configurer le Serveur

1. Ouvrir la vue Drools en sélectionnant Window → Open Perspective → Other et sélectionner Drools puis cliquer OK.
2. Ajouter la vue de serveur en sélectionnant Window → Show View → Other... et en sélectionnant Server → Servers.
3. Ouvrir le Menu de serveur en cliquant à droite le panneau de serveurs et en sélectionnant New → Server.
4. Définir le serveur en sélectionnant JBoss Enterprise Middleware → JBoss Enterprise Application Platform 6.1+ et en cliquant sur Next.
5. Configurer le répertoire d'accueil en cliquant sur le lien , puis sur le bouton Browse. Recherchez et sélectionnez le répertoire d'installation de JBoss EAP 6.1.1 avec JBoss BRMS installé.
6. Donnez un nom au serveur dans le champ Name, assurez-vous que le fichier de configuration est défini à et cliquer sur Finish.

Procédure 6.3. Importer un référentiel local Git

1. Démarrer le serveur Red Hat JBoss BRMS (s'il n'est pas déjà en cours d'exécution) en sélectionnant le serveur à partir de l'onglet Serveur et en cliquant sur le bouton Start.
2. Sélectionner File → Import... et naviguez dans le fichier Git. Ouvrir le dossier Git et sélectionner Projects from Git puis cliquer Next.
3. Sélectionner la source du référentiel en tant que Existing local repository et cliquer sur Next.
   

   View larger image

   

   Figure 6.1. Informations sur le référentiel Git

4. Sélectionner le référentiel qui doit être configuré à partir de la liste de référentiels disponibles.
5. Importer le projet en tant que projet général dans la prochaine fenêtre et cliquer sur Next. Nommez ce projet et cliquer sur Finish.

Procédure 6.4. Cloner un référentiel GIT distant

1. Démarrer le serveur Red Hat JBoss BRMS (s'il n'est pas déjà en cours d'exécution) en sélectionnant le serveur à partir de l'onglet Serveur et en cliquant sur le bouton Start.
2. Démarrer en même temps le serveur Secure Shell, s'il n'est pas déjà en cours d'exécution, en utilisant la commande suivante. La commande est spécifique à Linux ou Mac. Sur ces plates-formes, si sshd a déjà démarré, cette commande échouera et vous pourrez ignorer cette étape.

   /sbin/service sshd start

   Copy to Clipboard Toggle word wrap
3. Sélectionner File → Import... et naviguez dans le fichier Git. Ouvrir le dossier Git et sélectionner Projects from Git puis cliquer Next.
4. Sélectionner la source du référentiel en tant que Clone URI et cliquer sur Next.
5. Saisir les détails du référentiel Git dans la prochaine fenêtre et cliquer sur Next.

   

   View larger image

   

   Figure 6.2. Informations sur le référentiel Git

6. Sélectionner la branche que vous souhaitez importer dans la prochaine fenêtre et cliquer sur Next.
7. On vous donnera alors l'option de définir le stockage local pour ce projet. Saisir (ou sélectionnez) un répertoire non-vide, apporter des modifications de configuration et cliquer sur Next.
8. Importer le projet en tant que projet général dans la prochaine fenêtre et cliquer sur Next. Nommez ce projet et cliquer sur Finish.

Procédure 6.5. Créer un nouveau projet Red Hat JBoss Developer Studio

1. À partir du menu principal, sélectionner File → New → Project.
   Sélectionner Drools → Drools Project et cliquer sur Next.
2. Saisir un nom pour le projet dans la case Project name: et cliquer sur Next.

   Note

   JBoss Developer Studio donne l'option d'ajouter un exemple de fichier HelloWorld au projet. Accepter cette valeur par défaut en cliquant sur Next afin de tester l'échantillon de projet par les étapes suivantes :
3. Sélectionner le temps d'exécution (ou utiliser la valeur par défaut).
4. Sélectionner un code compatible avec Drools 6.0.x. Saisir GroupID, un ArtifactID, et une Version, et cliquer sur Finish.
5. Pour tester le projet, cliquer à droite sur le fichier Java qui contient la méthode principale, et sélectionner Run → run as → Java Application.
   La sortie s'affichera dans l'onglet de console.

1. Naviguez dans Red Hat Customer Portal et connectez-vous par vos informations d'identification utilisateur.
2. Sélectionner Downloads → Red Hat JBoss Middleware → Download Software.
3. À partir du menu Products, sélectionner BPM Suite.
4. Dans le menu déroulant Version, sélectionner la version de prod 6.0.2.
5. Sélectionner Red Hat JBoss BRMS 6.0.2 Business Resource Planner puis cliquer sur Download.

1. Sur ligne de commande, déplacez-vous dans le répertoire examples/.
2. En environnement Unix, exécuter la commande suivante :

   ./runExamples.sh

   Copy to Clipboard Toggle word wrap
   En environnement Windows, exécuter la commande suivante :

   ./runExamples.bat

   Copy to Clipboard Toggle word wrap
3. Sélectionner un exemple de l'application Examples GUI qui s'ouvre et l'exécuter dans votre IDE favori.