Guide d'installation
Pour les administrateurs Red Hat JBoss
Red Hat Content Services
Klara Kufova
kkufova@redhat.com
Marek Czernek
mczernek@redhat.com
Tomas Radej
tradej@redhat.com
Vidya Iyengar
viyengar@redhat.com
Résumé
Chapitre 1. Introduction
1.1. Red Hat JBoss BPM Suite
1.2. Plateformes prises en charge
- Red Hat JBoss Enterprise Application Platform 6.4
- Red Hat JBoss Web Server 2.1 (Tomcat 7) on JDK 1.7
- IBM WebSphere Application Server 8.5.5.0
- Oracle WebLogic Server 12.1.3 (12c)
1.3. Cas d'utilisation : solutions basées sur les processus dans le secteur des prêts
Figure 1.1. Flux de processus d'application de prêt de haut niveau
Figure 1.2. Automatisation du processus de demande de prêts
Partie I. Installation de Red Hat JBoss BPM Suite
Chapitre 2. Options d'installation
- Programme d'installation jar exécutable pour installation sur Red Hat JBoss Enterprise Application Platform (EAP) 6.4.
- Installation de fichier zip disponible en deux versions :
jboss-bpmsuite-6.3-deployable-eap6.x.zip
: version adaptée à un déploiement sur Red Hat JBoss Enterprise Application Platform (EAP 6.4).jboss-bpmsuite-6.3-deployable-generic.zip
: la version déployable avec bibliothèques supplémentaires adaptée au déploiement sur Red Hat JBoss Web Server (EWS), Apache Tomcat 6 et Apache Tomcat 7.
Note
"-Dfile.encoding=UTF-8"
.
Important
2.1. Installation de Red Hat JBoss BPM Suite Installer
Avertissement
yum
ou RPM Package Manager
. Dans un tel cas, télécharger le fichier Red Hat JBoss BPM Suite 6.3.0 Deployable for EAP 6 et suivez les étapes décrites dans Section 2.1.3, « Télécharger un ZIP déployable pour Red Hat JBoss EAP ».
Note
2.1.1. Installation de Red Hat JBoss BPM Suite à l'aide du programme d'installation
Note
non-root user
.
Conditions préalables
jar
soit présent dans $PATH
avant d'exécuter le programme d'installation. Sur Red Hat Enterprise Linux, ce binaire se trouve dans le paquet java-$JAVA_VERSION-openjdk-devel
.
- Naviguez vers le dossier à partir duquel vous avez téléchargé le fichier d'installation et exécutez la commande suivante :
java -jar jboss-bpmsuite-6.3.0.GA-installer.jar
Note
Pendant l'exécution du programme d'installation sur Windows, il peut vous être demandé de fournir les informations d'authentification d'administrateur lors de l'installation. Pour éviter cela, ajoutez l'optionizpack.mode=privileged
à la commande d'installation :java -Dizpack.mode=privileged -jar jboss-bpmsuite-6.3.0.GA-installer.jar
Le programme d'installation graphique sera exécuté et affichera un écran d'accueil et une page d'accord de licence. - Veuillez accepter la licence pour continuer.
- Sur l'écran suivant, fournissez l'emplacement parent d'un JBoss EAP existant où Red Hat JBoss BPM Suite doit être installé. La capture d'écran ci-dessous montre un exemple de chemin d'accès de répertoire :
Figure 2.1. Red Hat JBoss BPM Suite pour chemin d'accès de répertoire JBoss EAP
- Aux deux écrans suivants, créez deux utilisateurs : le premier pour la console de gestion de EAP (ManagementRealm) et le second pour gérer Red Hat JBoss BPM Suite (ApplicationRealm).La création du premier utilisateur pour la console de gestion de JBoss EAP est facultative : vous pouvez donc ne pas l'effectuer si celle-ci n'est pas requise.Veuillez noter ces noms d'utilisateurs et mots de passe : ils vous serviront pour accéder respectivement au serveur JBoss EAP (si vous décidez de le créer) et à l'application Red Hat JBoss BPM Suite.Si une configuration avancée n'a pas été effectuée, le mot de passe utilisateur de Red Hat JBoss BPM Suite sera utilisé comme mot de passe par défaut pour les keystores JMS SSL client et serveur et les keystores d'archivage sécurisé des mots de passe.
Note
Le nom d'utilisateur que vous créerez doit être différent des autres rôles prédéfinis (veuillez consulter Section 4.1, « Définir les rôles »).Vos mots de passe doivent contenir au moins 8 caractères dont un caractère numérique et un caractère non alphanumérique (à l'exception du signe &).Note
Le rôle d'application attribué au second utilisateur créé est le rôleadmin
. Vous pouvez attribuer des rôles supplémentaires à cet utilisateur au cours de cette étape. - Configurez ensuite l'environnement de sécurité de votre nouvelle installation Red Hat JBoss BPM Suite. Choisissez d'activer ou non le gestionnaire Java Security Manager au cours de cette étape en cochant la case correspondante. Le gestionnaire Java Security Manager offre une meilleure sécurisation de votre système mais ses performances peuvent en être altérées. Veuillez faire un choix en vous basant sur votre environnement.
- Choisissez d'effectuer ou non une configuration IPv6 pure sur le serveur sur lequel l'installation est effectuée, ce qui vous permettra d'effectuer plus tard des configurations de runtime spécifiques à IPv6.
Configurer l'environnement de runtime
Cette étape offre la possibilité d'utiliser une configuration par défaut ou de spécifier une configuration avancée.Configuration par défaut
Choisissez la configuration par défaut pour l'environnement de runtime dans l'étape suivante puis cliquez sur suivant pour revoir les informations d'installation. Si les informations fournies sont correctes, cliquez sur suivant pour démarrer l'installation ou cliquez sur précédent pour retourner à l'écran précédent et effectuer des modifications.Configuration avancée
Sélectionnez pour activer les options de configuration avancée. Sélectionnez Effeectuer configuration avancée et choisissez les options de configuration avancée que vous souhaitez activer pour votre environnement en utilisant les cases à cocher.Figure 2.2. Options de configuration avancée
Configurer l'archivage sécurisé
L'archivage sécurisé des mots de passe est utilisé pour masquer les mots de passe dans les différents descripteurs de serveur en utilisant une clé secrète java générée lors du processus d'installation ou manuellement à l'aide du keytool. Cela évite que les mots de passe soit stockés en texte brut dans les descripteurs.iteration count
etsalt
sont tous deux des paramètres du processus de cryptage.Dans le cas de Red Hat JBoss BPM Suite, un archivage sécurisé est toujours installé, même si l'utilisateur ne décide pas d'en installer un avec ses propres paramètres. Dans ce cas-là, les valeurs par défaut seront utilisées.Pour plus d'informations à propos de l'archivage sécurisé des mots de passe, veuillez consulter le Guide de Sécurité de Red Hat JBoss EAP.Figure 2.3. Configurer l'archivage sécurisé
Sécurité SSL
Cet écran vous permet d'ajouter les éléments<ssl>
et<truststore>
au ManagementRealm security-realm à l'aide du keystore fourni.Le résultat final est une connexion cryptée sécurisée entre le client et le serveur pour le ManagementRealm.- L'élément
<ssl>
pousse le serveur à présenter le certificat du keystore comme étant son identité, ce qui permet à l'utilisateur d'appliquer son certificat officiel. - L'élément
<truststore>
active l'authentification « Client-Cert », ce qui signifie que si un client distant tente de se connecter à une ressource gérée par le ManagementRealm, le client peut présenter un certificat et, si une entrée dans le truststore correspond, sera authentifié sans avoir besoin de fournir un nom d'utilisateur/mot de passe.
Figure 2.4. Configuration de Sécurité SSL
Sécurité LDAP
Cette étape du programme d'installation permet à l'utilisateur de définir un serveur LDAP, qui en retour définit les utilisateurs qui devraient être autorisés à s'authentifier avec ManagementRealm. Cette étape remplace la configuration par défaut.L'écran LDAP Connection permet aux utilisateurs de définir comment se connecter au serveur LDAP.- Le Nom Distinctif (DN ou Distinguished Name) : l'utilisateur pouvant se connecter au serveur LDAP. Le nom distinctif définit généralement un utilisateur spécial à cet effet.
Figure 2.5. Configuration de connexion LDAP
Sécurité LDAP (console de gestion)
L'écran Configuration LDAP de console de gestion vous permet d'installer un domaine de sécurité et permet d'ajouter l'élément<security-realm>
aux descripteurs et utilise la connexion définie précédemment.Figure 2.6. Configuration LDAP de console de gestion
- Nom distinctif de base : définit généralement une « recherche de base » ou « contexte root » pour commencer à rechercher des utilisateurs.
- Type de filtre : indique à JBoss EAP comment trouver l'attribut LDAP qui définit un utilisateur : il peut s'agir d'un simple attribut ou d'un filtre LDAP complexe.
- Attribut de nom d'utilisateur : l'attribut LDAP détenant les valeurs de nom d'utilisateur. Un nom d'utilisateur saisi dans ce domaine est utilisé pour les requêtes de recherches comme valeur de l'attribut « uid ». Si un utilisateur choisit « recherche syntaxe LDAP » comme type de filtre, cette requête doit être spécifiée dans ce champ.
- Recherche récursive de répertoire : si activée, JBoss EAP traversera l'arborescence LDAP de manière récursive, en commençant par Base DN. Sinon, la recherche sera limitée à Base DN.
Sécurité LDAP (Business Central)
La plupart des champs suivants sont semblables à la Base DN. Les contextes sont utilisés pour rechercher des rôles, ce qui permet d'effectuer une autorisation en plus d'une authentification. Sinon, les champscontext
sont analogues à la Base DN précédente et les champsattribute
sont analogues à l'attribut Nom d'utilisateur. Les filtres permettent un contrôle précis des valeurs d'un attribut donné qui seront acceptées.Dans Red Hat JBoss BPM Suite, les fichiersjbpm.usergroup.callback.properties
etjbpm.user.info.properties
utilisés par les composantsLDAPUserGroupInfo
etLDAPUserInfo
de Task Service sont également remplis avec des valeurs saisies sur la page de configuration Business Central LDAP.Les valeurs de saisie de la page de configuration Business Central LDAP sont utilisées pour configurer un nouveau domaine de sécurité, qui utilise le module de connexionLdapExtended
. Ce domaine de sécurité est configuré par défaut pour l'application web Business Central. Pour plus d'informations sur les domaines de sécurité et les modules de connexion, veuillez consulter le Guide de sécurité Red Hat JBoss EAP.Figure 2.7. Configuration Business Central LDAP
Domaine de sécurité et JSSE
L'écran de domaine de sécurité vous permet de configurer tous les éléments du sous-système de sécurité<security-domain>
pour gérer les informations de sécurité, y compris la configuration JSSE. Pour plus d'informations sur la configuration des domaines de sécurité, veuillez consulter le Guide de sécurité Red Hat JBoss EAP.Figure 2.8. Domaine de sécurité
Figure 2.9. Configuration JSSE
Configurer les keystores JMS SSL
Cet écran permet le cryptage de messages JMS envoyés à Business Central. Les keystores client sont distribués aux systèmes nécessitant une communication avec le serveur afin de faciliter les communications cryptées. Les utilisateurs peuvent utiliser leur keystore pré-existants ou en générer de nouveaux.Figure 2.10. Configurer les keystores JMS SSL
Configurer la mise en cluster
Sélectionner cette option installe Red Hat JBoss BPM Suite, qui est prêt à effectuer des opérations clusterisées. Pour obtenir davantage d'informations, veuillez consulter Section 6.1, « Mise en cluster avec JBoss EAP ».
- Le programme d'installation effectuera les étapes d'installation de Red Hat JBoss BPM Suite ainsi que les étapes de configuration post-installation lorsque vous cliquez sur Suivant. Le programme d'installation peut également lancer le serveur de Red Hat JBoss BPM Suite dans le mode de votre choix (en mode autonome ou de domaine, davantage d'informations se trouvent dans Section 5.1, « Démarrage du serveur »), puis il s'y connectera pour valider l'installation. Cliquez sur Suivant pour arriver au dernier écran, sur lequel vous pourrez générer le script d'installation et le fichier des propriétés. Pour quitter le programme d'installation, veuillez cliquer sur Terminer.
2.1.2. Installation de Red Hat JBoss BPM Suite à l'aide du programme d'installation en mode CLI
Conditions préalables
jar
soit présent dans $PATH
avant d'exécuter le programme d'installation. Sur Red Hat Enterprise Linux, ce binaire se trouve dans le paquet java-$JAVA_VERSION-openjdk-devel
.
- Naviguez vers le dossier à partir duquel vous avez téléchargé le fichier d'installation et exécutez la commande suivante :
java -jar jboss-bpmsuite-6.3.0.GA-installer.jar -console
- Le processus interactif de ligne de commande démarrera et affichera le contrat de licence de l'utilisateur final. Au bas de ce contrat, il vous sera demandé de sélectionner une option :
tapez 1 pour continuer, 2 pour quitter, 3 pour afficher à nouveau.
- Saisissez 1 pour démarrer l'installation et tapez le répertoire parent d'une installation EAP existante.
L'emplacement ci-dessous doit indiquer le JBOSS_HOME d'une installation EAP existante. [/home/user/BPMSuite-6.3.0/jboss-eap-6.4]
Le programme d'installation vérifiera l'emplacement de l'installation EAP JBoss à l'emplacement prévu. Tapez 1 pour confirmer et continuer. - Facultatif : créez un utilisateur pour la console de gestion de JBoss EAP (Management Realm) :
Créer un utilisateur administratif Cet utilisateur devra être ajouté au domaine de gestion du conteneur hôte à but administratif. Il pourra être utilisé pour accéder à la console de gestion, à l'interface en ligne de commande CLI ou à d'autres applications sécuriées dans ce domaine.
Saisir 0 si vous souhaitez éviter de créer un nouvel utilisateur administratif, sinon tapez 1 pour en créer un. Si vous décidez d'en créer un, suivez ces étapes :- Veuillez saisir un nom d'utilisateur :
Nom d'utilisateur admin : [admin]
- Créer et confirmer un mot de passe pour l'utilisateur de la console de gestion EAP :
Le mot de passe doit comprendre au moins 8 caractères, un numéro et un symbole non alphanumérique (à l'exception du caractère &). Mot de passe admin : [] Confirmer le mot de passe admin : [******************************]
Après la création de l'utilisateur, passez à l'étape suivante.
- Créez un utilisateur administrateur Red Hat JBoss BPM Suite.
Créez un utilisateur admin pour la Business Process Management Suite Créez un utilisateur admin pour la BPM Suite. L'utlisateur sera ajouté au ApplicationRealm, et pourra être utilisé pour accéder à la Business Central Console. L'utilisateur recevra les rôles d'application 'admin'. Le nom d'utilisateur de la BPM Suite ne peut pas correspondre aux mots suivants : 'admin', 'analyst', 'user', 'manager' ou 'developer'. Nom d'utilisateur BPM Suite : [bpmsAdmin]
- Choisissez un nom d'utilisateur, puis créez et confirmez un mot de passe.
Le mot de passe doit comprendre au moins 8 caractères, un numéro et un symbole non alphanumérique (à l'exception du caractère &). Mot de passe BPM Suite : [] Confirmer le mot de passe BPM : [******************************]
- Une fois le mot de passe saisi et confirmé, une étape supplémentaire vous permettra de définir d'autres rôles pour cet utilisateur (en plus du rôle
admin
). Saisissez ces rôles dans une liste séparée par des virgules ou appuyez sur la touche Entrée pour ignorer cette étape.(Option) Vous pouvez ajouter cet utilisateur à des rôles supplémentaires de gestion des tâches. Ces rôles auront des noms personnalisés et seront utilisés à nouveau quand vous créerez vos processus de tâches humaines. Ajouter vos rôles aux noms personnalisés dans une liste séparée par des virgules ci-dessous. Rôles utilisateur supplémentaires : []
- Configurez le Java Security Manager en tapant 1 pour le sélectionner ou 0 pour annuler la sélection.
Configurez le Java Security Manager Un Java Security Manager propose une sécurité niveau JVM qui va au delà de ce qu'offre le conteneur d'applications. Il fait appliquer les règles d'accès de runtime JVM sur la base de plusieurs stratégies de sécurité. Ce programme d'installation mettra deux stratégies de sécurité dans le répertoire d'installation sous la forme de fichiers aux noms suivants 'security.policy' et 'kie.policy' quel que soit votre choix. Ces stratégies seront activées au moment du runtime si l'option ci-dessous est sélectionné. Veuillez noter que le Security Manager impose une surcharge de performance significative une fois activé. Il est conseillé d’appliquer les stratégies incluses en production uniquement si les besoins des utilisateurs exige des mesures supplémentaires par rapport à ce qui est déjà fourni par le mécanisme d'autorisation et d'authentification du conteneur d’applications. Voir la documentation d'administration de JBoss Business Process Management Suite pour obtenir plus d'informations. [ ] Activer Java Security Manager Saisir 1 pour sélectionner, 0 pour désélectionner :
- Après avoir sélectionné le gestionnaire de sécurité Java, choisissez une option à partir de l'invite ci-dessous :
tapez 1 pour continuer, 2 pour quitter, 3 pour afficher à nouveau.
- Précisez si vous utilisez IPv6.
Configuration IPv6 Si cet ordinateur utilise une configuration IPv6 pure, veuillez sélectionner la case ci-dessous. Une installation IPv6 pure requiert une configuration supplémentaire au moment du runtime pour garantir des liaisons entre les interfaces de gestion et http correctes. [ ] Activer configuration IPv6 pure Saisir 1 pour sélectionner, 0 pour désélectionner :
Après avoir sélectionné ou annulé la sélection de la configuration IPv6, sélectionnez l'une des options suivantes :tapez 1 pour continuer, 2 pour quitter, 3 pour afficher à nouveau.
- Configurer l'environnement runtime en choisissant la configuration par défaut ou les options avancées.
Configurer l'environnement de runtime Red Hat JBoss Business Process Management Suite peut être personnalisée davantage à ce moment là. 0 [x] Configuration par défaut 1 [ ] Configuration avancée
Si vous sélectionnez 1, « Configuration avancée », effectuez les configurations suivantes :[ ] Install password vault Saisir 1 pour sélectionner, 0 pour désélectionner :
[ ] Activer SSL Security Saisir 1 pour sélectionner, 0 pour désélectionner :
[ ] Sécuriser EAP Management Console avec LDAP Saisir 1 pour sélectionner, 0 pour désélectionner :
[ ] Sécuriser Business Central avec LDAP Saisir 1 pour sélectionner, 0 pour désélectionner :
[ ] Ajouter un security-domain Saisir 1 pour sélectionner, 0 pour désélectionner :
[ ] Générer JMS Client Keystores Saisir 1 pour sélectionner, 0 pour désélectionner :
[ ] Installer configuration clusterisée Saisir 1 pour sélectionner, 0 pour désélectionner :
- Puis sélectionnez une option à partir de l'invite ci-dessous :
tapez 1 pour continuer, 2 pour quitter, 3 pour afficher à nouveau.
- Le fichier .jar débutera sa décompression et configuration.
- Suite à l'installation, la ligne de commande vous demandera si vous souhaitez générer un script d'installation automatique et un fichier de propriétés.
L'installation a réussi. Application installée dans /home/user/BPMSuite-6.3.0/jboss-eap-6.4 Souhaitez-vous générer un script d'installation automatique et un fichier de propriétés ? (y/n) [n]:
- Si vous tapez [ y ], indiquez un chemin d'accès pour le script d'installation automatique :
Sélectionner le chemin d'installation automatique du script : [/home/user/BPMSuite-6.3.0/jboss-eap-6.4/<auto script filename>]
Ce script généré permettra à l'utilisateur d'exécuter le programme d'installation de la manière suivante pour les installations futures :java -jar jboss-bpmsuite-6.3.0.GA-installer.jar <auto script filename>
Note
Cette méthode d'exécution du programme d'installation aura pour résultat une installation identique à l'installation à partir de laquelle le script automatique a été généré. Veuillez noter que les valeurs sensibles, telles que les mots de passe, devront être fournies à partir d'un fichier externe ou lors de l'installation automatique. L'argument facultatif ci-dessous permet à l'utilisateur de fournir ces valeurs automatiquement :-variablefile <variable filename>
Les valeurs sensibles peuvent également être fournies à l'aide de l'argument suivant :-variables key1=value1,key2=value2
- La ligne de commande affichera le message suivant suite à la création d'un script automatique et/ou l'installation de la console :
XML written successfully. [ Console installation done ] [BPMS_Installer]$
- Démarrez JBoss EAP comme décrit dans Section 5.1, « Démarrage du serveur ».
- Naviguer vers http://localhost:8080/business-central dans un navigateur web.
- Connectez-vous avec le nom d'utilisateur et mot de passe attribués à l'utilisateur de Red Hat JBoss BRM Suite à l'étape Créer et confirmer un mot de passe pour l'utilisateur Red Hat JBoss BRM Suite.
2.1.3. Télécharger un ZIP déployable pour Red Hat JBoss EAP
- Connectez-vous au Portail Client Red Hat.
- Cliquer sur DOWNLOADS en haut de la page.
- À partir de la page Téléchargements de produits qui s'ouvre, cliquez sur Red Hat JBoss BPM Suite.
- À partir du menu déroulant Version, sélectionnez la version 6.3.0.
- Sélectionnez Red Hat JBoss BRM 6.3.0 Deployable for EAP 6, puis cliquez sur Télécharger.
- Veuillez extraire l'archive. Le répertoire en résultant est nommé
$EAP_HOME
. - Avec la ligne de commande, veuillez vous déplacer sur le répertoire
$EAP_HOME
, puis lancez le serveur autonome :Dans un environnement Unix, exécutez :./standalone.sh
Dans un environnement Windows, exécutez :./standalone.bat
Configurer les modes de domaine
Important
- Téléchargez et extrayez le fichier ZIP Red Hat JBoss BPM Suite 6.3.0 Deployable for EAP 6 à partir du Portail Client Red Hat et copiez les répertoires suivants dans votre installation locale d'EAP 6.4 :
bin
domain
Omettez le répertoirestandalone
. - Avec la ligne de commande, veuillez vous déplacer sur le répertoire
$EAP_HOME/bin
, puis lancez le domaine :Dans un environnement Unix, exécutez :./domain.sh
Dans un environnement Windows, exécutez :./domain.bat
- Veuillez déployer les archives via des scripts CLI (
$EAP_HOME/bin/jboss-cli.sh
ou$EAP_HOME/bin/jboss-cli.bat
), ou via l'interface utilisateur web de gestion (http://localhost:9990/) :Note
Les applications webbusiness-central.war
etdashbuilder.war
fournies dans les binaires déployables EAP sont des répertoires, mais pour un déploiement dans le domaine, vous devrez utiliser des archives WAR. Pour les créer, veuillez compresser le contenu des répertoires business-central.war et dashbuilder.war.- Pour déployer l'archive via les scripts CLI, veuillez vous déplacer sur
$EAP_HOME/bin directory
et déployer le fichier WAR, en suivant les invites à l'écran :Dans un environnement Unix, exécutez :./jboss-cli.sh
Dans un environnement Windows, exécutez :./jboss-cli.bat
- Pour déployer l'archive via l'interface utilisateur web de gestion (http://localhost:9990/) :
- connectez-vous avec votre compte de gestion EAP
- sélectionnez Domaine -> Gérer Déploiements -> Référentiel de contenu -> Ajouter
- sélectionnez l'archive web à partir du système de fichier et téléversez l'archive web
- sélectionnez le déploiement puis cliquez sur le bouton Attribuer
- Sélectionnez le groupe de serveurs
Note
Installation de plusieurs instances de Red Hat JBoss BRM Suite Server
org.uberfire.nio.git.dir
org.uberfire.metadata.index.dir
org.uberfire.nio.git.ssh.cert.dir
org.uberfire.nio.git.daemon.host
- peut être laissé sur défaut pour être relié au localhost.org.uberfire.nio.git.daemon.port
org.uberfire.nio.git.ssh.host
- peut être laissé sur défaut pour être relié au localhost.org.uberfire.nio.git.ssh.port
Note
org.uberfire.nio.git.daemon.port
et org.uberfire.nio.git.ssh.port
nécessitent tous deux des valeurs de port différentes de manière à éviter les conflits de port.
$EAP_HOME/domain/configuration/host.xml
tel qu'illustré dans les deux nœuds ci-dessous :
<system-properties> <property name="org.uberfire.nio.git.dir" value="/valid/path/.." boot-time="false"/> <property name="org.uberfire.metadata.index.dir" value="/valid/path/.." boot-time="false"/> <property name="org.uberfire.nio.git.ssh.cert.dir" value="/valid/path/.." boot-time="false"/> <property name="org.uberfire.nio.git.daemon.host" value="10.10.10.10" boot-time="false"/> <property name="org.uberfire.nio.git.daemon.port" value="9417" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.host" value="10.10.10.10" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.port" value="8002" boot-time="false"/> </system-properties>
<system-properties> <property name="org.uberfire.nio.git.dir" value="/valid/path/.." boot-time="false"/> <property name="org.uberfire.metadata.index.dir" value="/valid/path/.." boot-time="false"/> <property name="org.uberfire.nio.git.ssh.cert.dir" value="/valid/path/.." boot-time="false"/> <property name="org.uberfire.nio.git.daemon.host" value="10.10.10.10" boot-time="false"/> <property name="org.uberfire.nio.git.daemon.port" value="9418" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.host" value="10.10.10.10" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.port" value="8003" boot-time="false"/> </system-properties>
.index
ou .niogit
. Ces fichiers, qui doivent être utilisés par un nœud respectif, seront ensuite groupés dans un domaine particulier.
2.2. L'installation d'un groupement déployable standard
jboss-bpmsuite-VERSION-deployable-generic.zip
: ce fichier contient les applications webbusiness-central.war
,dashbuilder.war
etkie-server.war
.jboss-bpmsuite-VERSION-engine.zip
: les bibliothèques d'exécution d'engine prises en charge pour l'intégration de engine dans votre application et autres bibliothèques nécessaires pour un déploiement générique.
2.2.1. Téléchargement du paquet déployable standard
- Connectez-vous au Portail Client Red Hat.
- Cliquer sur DOWNLOADS en haut de la page.
- À partir de la liste de produits, sélectionnez Red Hat JBoss BPM Suite.
- À partir du menu déroulant Version, sélectionnez la version 6.3.0 (si cela n'est pas déjà fait).
- Dans la section Téléchargements de logiciels qui s'affiche, allez sur la ligne Red Hat JBoss BPM Suite 6.3.0 Deployable for All Supported Containers puis cliquez sur Télécharger.
- Placez-vous sur la ligne des fichiers Red Hat JBoss BPM Suite 6.3.0 Core Engine, puis cliquez sur Télécharger pour télécharger les fichiers Red Hat JBoss BPM Suite Engine.
2.2.2. Installation d'un paquet déployable standard
- Configurez le pilote de la base de données et le gestionnaire de transactions (Bitronix) (voir Section 2.2.2.1, « Installer le gestionnaire de transactions dans Red Hat JBoss Web Server 2.1 (Tomcat 7) »).
- Installez l'application Business Central : créer des utilisateurs et des rôles, et créer des persistances (voir Section 2.2.2.2, « Installation de Business Central dans Red Hat JBoss Web Server 2.0 (Tomcat 7) »).
- Installer l'application Dashbuilder : créer des utilisateurs et des rôles, et créer des persistances (voir Section 2.2.2.3, « Installation de Dashbuilder dans Red Hat JBoss Web Server 2.0 (Tomcat 7) »).
2.2.2.1. Installer le gestionnaire de transactions dans Red Hat JBoss Web Server 2.1 (Tomcat 7)
- Extraire le paquet zip déployable que vous avez téléchargé à partir du Portail Client Red Hat vers un emplacement temporaire. Ce paquet zip contient les trois archives d'application web suivantes :
business-central.war
,dashbuilder.war
etkie-server.war
dans un format éclaté. Renommez ces dossiers pour supprimer l'extension.war
. - Copiez ces dossiers directement dans le dossier
$TOMCAT_DIR/webapps
.Vous devriez obtenir trois dossiers dans un format éclaté :$TOMCAT_DIR/webapps/business-central
,$TOMCAT_DIR/webapps/dashbuilder
et$TOMCAT_DIR/webapps/kie-server
.Note
$TOMCAT_DIR correspond au répertoire d'accueil où se situe le serveur web. Remplacez-le par le chemin actuel qui mène au répertoire d'accueil de votre serveur web, ainsi :/home/john/jboss-ews-2.1/tomcat7/
- Extraire le contenu de l'archive des fichiers Red Hat JBoss BPM Suite Engine vers un emplacement temporaire à partir duquel vous pourrez copier les bibliothèques dont vous avez besoin. Ce dossier contient maintenant toutes les bibliothèques Red Hat JBoss BPM Suite principales dans le dossier extrait et le dossier
lib
. - Installer le gestionnaire de transactions.
Avertissement
Veuillez noter que la section suivante décrit l'installation d'un gestionnaire de transaction, Bitronix, qui n'est pas officiellement pris en charge par Red Hat.Copiez les bibliothèques jar du gestionnaire de transactions suivantes à partir du dossierlib
vers le répertoire$TOMCAT_DIR/lib/
:- btm-VERSION.jar
- btm-tomcat55-lifecycle-VERSION.jar
- jta-VERSION.jar
- slf4j-api-VERSION.jar
- slf4j-jdk14-VERSION.jar
De plus, téléchargez la bibliothèque suivante et copiez-la dans le dossier$TOMCAT_DIR/lib/
également : - Installez le pilote sur votre base de donnéesCopiez le fichier jar et le pilote de base de donnée qui convient dans
$TOMCAT_DIR/lib/
.Note
Si vous utilisez la base de données H2 intégrée, le pilote sera disponible dansbusiness-central/WEB-INF/lib/
. - Créer les fichiers de configuration du gestionnaire de transactions dans
$TOMCAT_DIR/conf/
:- btm-config.properties
bitronix.tm.serverId=tomcat-btm-node0 bitronix.tm.journal.disk.logPart1Filename=${btm.root}/work/btm1.tlog bitronix.tm.journal.disk.logPart2Filename=${btm.root}/work/btm2.tlog bitronix.tm.resource.configuration=${btm.root}/conf/resources.properties
- resources.properties (le resource.ds1.uniqueName définit le nom de la source de données utilisée dans la définition de ressource tomcat par la suite - et notez cette valeur).Veillez à bien changer les valeurs dans les définitions suivantes pour qu'elles correspondent bien à votre environnement.
Exemple 2.1. Définition de source de données H2
resource.ds1.className=bitronix.tm.resource.jdbc.lrc.LrcXADataSource resource.ds1.uniqueName=jdbc/jbpm resource.ds1.minPoolSize=10 resource.ds1.maxPoolSize=20 resource.ds1.driverProperties.driverClassName=org.h2.Driver resource.ds1.driverProperties.url=jdbc:h2:file:~/jbpm resource.ds1.driverProperties.user=sa resource.ds1.driverProperties.password= resource.ds1.allowLocalTransactions=true
Exemple 2.2. Définition de source de données MySQL 5.5
resource.ds1.className=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource resource.ds1.uniqueName=jdbc/jbpm resource.ds1.minPoolSize=0 resource.ds1.maxPoolSize=10 resource.ds1.driverProperties.URL=jdbc:mysql://localhost:3306/sampledb resource.ds1.driverProperties.user=dbuser resource.ds1.driverProperties.password=dbpassword resource.ds1.allowLocalTransactions=true
Exemple 2.3. Définition de source de données DB2 de Type 4
resource.ds1.className=com.ibm.db2.jcc.DB2Driver resource.ds1.uniqueName=jdbc/jbpm resource.ds1.minPoolSize=0 resource.ds1.maxPoolSize=10 resource.ds1.driverProperties.URL=jdbc:db2://localhost:50000/sampledb resource.ds1.driverProperties.user=dbuser resource.ds1.driverProperties.password=dbpassword resource.ds1.allowLocalTransactions=true
Exemple 2.4. Définition de source de données Oracle
resource.ds1.className=oracle.jdbc.xa.client.OracleXADataSource resource.ds1.uniqueName=jdbc/jbpm resource.ds1.minPoolSize=0 resource.ds1.maxPoolSize=10 resource.ds1.driverProperties.URL=jdbc:oracle:thin:@//localhost:1521/bpms resource.ds1.driverProperties.user=dbuser resource.ds1.driverProperties.password=dbpassword resource.ds1.allowLocalTransactions=true
Exemple 2.5. Définition de source de données Microsoft SQL Server
resource.ds1.className=com.microsoft.sqlserver.jdbc.SQLServerDriver resource.ds1.uniqueName=jdbc/jbpm resource.ds1.minPoolSize=0 resource.ds1.maxPoolSize=10 resource.ds1.driverProperties.URL=jdbc:sqlserver://localhost:1433;databaseName=bpms; resource.ds1.driverProperties.user=dbuser resource.ds1.driverProperties.password=dbpassword resource.ds1.allowLocalTransactions=true
- Installez le listener du gestionnaire de transaction dans
$TOMCAT_DIR /conf/server.xml
pour démarrer et arrêter le Bitronix sur arrêt et démarrage du conteneur :Ajouter l'élément suivant comme dernier élément <Listener> dans l'élément <Server> :<Listener className="bitronix.tm.integration.tomcat55.BTMLifecycleListener" />
- Définissez la propriété système btm.root et l'emplacement où le fichier de config bitronix se trouve :Dans
$TOMCAT_DIR/bin/
, créez un fichiersetenv.sh
accessible en lecture avec le contenu suivant :CATALINA_OPTS="-Xmx512M -XX:MaxPermSize=512m -Djava.security.auth.login.config=$CATALINA_HOME/webapps/business-central/WEB-INF/classes/login.config -Dbtm.root=$CATALINA_HOME -Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties -Djbpm.tsr.jndi.lookup=java:comp/env/TransactionSynchronizationRegistry"
La propriétéjava.security.auth.login.config
doit être définie pour que le clone ssh du référentiel git fonctionne.Important
Dans les systèmes Microsoft Windows, remplacez la valeur$CATALINA_HOME
du contenu du fichier par le nom de la variable d'environnement équivalente ou utilisez le chemin complet et ajoutez les valeurs dans le fichiersetenv.bat
comme dans l'exemple suivant :set "CATALINA_OPTS=-Xmx512m -XX:MaxPermSize=512m -Djava.security.auth.login.config=C:\apache-tomcat\webapps\business-central\WEB-INF\classes\login.config -Dbtm.root=C:\apache-tomcat -Dbitronix.tm.configuration=C:\apache-tomcat\conf\btm-config.properties -Djbpm.tsr.jndi.lookup=java:comp/env/TransactionSynchronizationRegistry"
2.2.2.2. Installation de Business Central dans Red Hat JBoss Web Server 2.0 (Tomcat 7)
- Installez une
Valve
pour que l'application web de Web Central puisse télécharger les utilisateurs créés dans Tomcat :- Définissez les utilisateurs et les rôles dans
$TOMCAT_DIR/conf/tomcat-users.xml
. Notez que Business Central nécessite que les utilisateurs aient les rôlesadmin
et/ouanalyst
(pour obtenir plus d'informations sur les définitions de rôle ou d'utilisateur, veuillez consulter la documentation Tomcat 7).La liste de programme ci-dessous est un exemple qui montre comment ces deux rôles peuvent être ajoutés et comment affecter ces rôles à un utilisateur nommébpmsadmin
.Note
Assurez-vous que les utilisateurs et les rôles ne portent pas le même nom. Par exemple, ne donnez pas le nomadmin
à un utilisateur.<role rolename="admin"/> <role rolename="analyst" /> <user username="bpmsadmin" password="P@ssw0rd" roles="admin,analyst"/>
- Déplacez (ne copiez pas)
kie-tomcat-integration-VERSION.jar
de$TOMCAT_DIR/webapps/business-central/WEB-INF/lib/
dans$TOMCAT_DIR/lib/
. - Copiez
jboss-jaxb-api-VERSION.jar
de$TOMCAT_DIR/webapps/business-central/WEB-INF/lib/
dans$TOMCAT_DIR/lib/
. - Dans
$TOMCAT_DIR/conf/server.xml
, ajoutez la déclaration de Valve Tomcat dans l'élément <hôte> qui convient :<Valve className="org.kie.integration.tomcat.JACCValve" />
- Si vous utilisez une source de données autre que la valeur par défaut fournie par la base de données sous-jacente de H2, vous aurez besoin d'installer une persistance. Si vous utilisez la base de données de H2 par défaut, vous pouvez alors ignorer le reste des étapes de cette procédure.Dans cette procédure, vous configurez une source de données avec le nom JNDI
jdbc/myDatasource
défini dans uniqueName=jdbc/jbpm du fichier bitronixresources.properties
précédent (pour l'option MySQL).- Dans
business-central/META-INF/context.xml
, remplacez le nom JNDI de la source de données de l'élément <Resource>. L'attribut uniqueName se rapporte à la propriété resource.ds1.uniqueName définie dansresources.properties
:<Resource name="jdbc/myDatasource" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>
- Dans
business-central/WEB-INF/web.xml
, remplacez le nom JNDI de la source de données de l'élément >res-ref-name< par le nom de votre source de données :<resource-ref> <description>Console DS</description> <res-ref-name>jdbc/myDatasource</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref>
- Modifiez
business-central/WEB-INF/classes/META-INF/persistence.xml
.Dans ce fichier, modifiez le nom du dialecte hibernate utilisé dans votre base de données, si vous utilisez une autre base de données que H2. Le code ci-dessous montre les informations de la base de données d'origine depersistence.xml
:<property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/>
Cette information peut être mise à jour de la manière suivante (comme démontré dans la base de données MySQL ci-dessous) :<property name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect"/>
Note
Le dialecte de DB2 estorg.hibernate.dialect.DB2Dialect
, de DB2 dans AS/400 estorg.hibernate.dialect.DB2400Dialect
, d'Oracle estorg.hibernate.dialect.Oracle10gDialect
et de Microsoft SQL Server estorg.hibernate.dialect.SQLServerDialect
. - Modifiez le fichier
business-central/WEB-INF/classes/META-INF/persistence.xml
de façon à ce que le moteur de processus Red Hat JBoss BPM Suite puisse utiliser la nouvelle base de données.Le code ci-dessous démontre les informations de la source de données d'origine pourpersistence.xml
:<jta-data-source>java:comp/env/jdbc/jbpm</jta-data-source>
Modifiez cette valeur pour qu'elle corresponde à la valeur de la source de données définie plus tôt :<jta-data-source>java:comp/env/jdbc/myDatasource</jta-data-source>
- Vous pouvez démarrer dès maintenant le JBoss Web Server pour vous connecter à Business Central.
- Exécutez
startup.sh
dans le répertoire $TOMCAT_HOME/bin
../startup.sh
- Naviguer vers http://localhost:8080/business-central dans un navigateur web.
- Connectez-vous avec le nom d'utilisateur et le mot de passe définis précédemment dans le fichier
tomcat-users.xml
.
2.2.2.3. Installation de Dashbuilder dans Red Hat JBoss Web Server 2.0 (Tomcat 7)
Note
- Définissez les utilisateurs et les rôles dans
$TOMCAT_DIR/conf/tomcat-users.xml
. Notez que Dashbuilder exige que les utilisateurs aient les rôlesadmin
et/ouanalyst
. Si vous avez déjà défini ces utilisateurs plus tôt dans Business-Central, vous n'avez pas besoin de les définir à nouveau. - Activez un seul sign-on entre Dashbuilder et Business Central en annulant le commentaire des lignes suivantes dans le fichier
$TOMCAT_DIR/conf/server.xml
:<Valve className="org.apache.catalina.authenticator.SingleSignOn" />
- Comme dans l'installation Business Central, si vous utilisez une base de données autre que la base de données par défaut et la base de données H2 intégrée, vous devrez installer une persistance.Dans cette procédure, vous configurez une source de données avec le nom JNDI
jdbc/dashbuilderDS
défini dans uniqueName=jdbc/jbpm dans le fichier bitronixresources.properties
:- Dans
dashbuilder/META-INF/context.xml
, remplacer le nom JNDI de la source de données de l'élément <Resource>. L'attribut uniqueName se rapporte à la propriété resource.ds1.uniqueName définie dansresources.properties
:<Resource name="jdbc/dashbuilderDS" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>
Note
Suivant votre base de données, vous souhaiterez peut-être définir d'autres propriétés. Par exemple, dans un environnement Oracle, cette entrée peut ressembler au listing suivant.<Resource name="jdbc/jbpm" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource" username="username" password="password" driverClassName="oracle.jdbc.xa.client.OracleXADataSource" url="jdbc:oracle:thin:YOUR-URL:1521:YOUR-DB" maxActive="8" />
- Dans
dashbuilder/WEB-INF/web.xml
, ajoutez le nom JNDI de la source de données de l'élément >res-ref-name< par le nom de votre source de données :<resource-ref> <description>Dashboard Builder Datasource</description> <res-ref-name>jdbc/dashbuilderDS</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref>
- Dans
dashbuilder/META-INF/context.xml
, définissez la fabrique de transactions :<Transaction factory="bitronix.tm.BitronixUserTransactionObjectFactory"/>
- Mettez à jour le nom JNDI de la base de données dans
dashbuilder/WEB-INF/etc/hibernate.cfg.xml
de l'élément <session-factory> :<property name="connection.datasource">java:/comp/env/jdbc/dashbuilderDS</property>
- Redémarrez le serveur web pour appliquer les changements. Une fois redémarré, vous pourrez vous rendre dans Dashbuilder à partir de Business Central ou directement via :
http://localhost:8080/dashbuilder
.
Chapitre 3. Configurations spéciales
3.1. Installation de la Persistance pour Business Central
java:jboss/datasources/ExampleDS
. Pour Business Central, cet exemple de source de données est situé dans le fichier business-central.war/WEB-INF/classes/META-INF/persistence.xml
.
business-central.war/WEB-INF/classes/META-INF/persistence.xml
:
- Installez le pilote JDBC (Java Database Connectivity) à l'aide d'une approche modulaire pour une configuration facilitée (veuillez consulter EAP 6 documentation).
- Créez une nouvelle source de données suivant l'exemple dans la documentation EAP 6, section Exemple de Source de données PostgreSQL. Voici la configuration de source de données spécifique à la base de données H2 utilisée par défaut :
<subsystem xmlns="urn:jboss:domain:datasources:1.1"> <datasources> <datasource jndi-name="java:jboss/datasources/ExampleDS" pool-name="ExampleDS" enabled="true" use-java-context="true"> <connection-url>jdbc:h2:mem:test;DB_CLOSE_DELAY=-1</connection-url> <driver>h2</driver> <security> <user-name>sa</user-name> <password>sa</password> </security> </datasource> <drivers> <driver name="h2" module="com.h2database.h2"> <xa-datasource-class>org.h2.jdbcx.JdbcDataSource</xa-datasource-class> </driver> </drivers> </datasources>
- Utilisez le nom JNDI de la source de données pour mettre à jour l'entrée suivante à l'intérieur du fichier
persistence.xml
, qui est par défaut défini sur cette entrée.<jta-data-source>java:jboss/datasources/ExampleDS</jta-data-source>
Important
Lors de la configuration de votre source de données, assurez-vous d'activer JTA (en ajoutantjta="true"
à la balisedatasource
). - Remplacez le texte suivant par le nom de dialecte hibernate spécifique à la base de données.
<property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect" />
Par exemple, pour un Oracle Database Express Edition 11g :<property name="hibernate.dialect" value="org.hibernate.dialect.Oracle10gDialect" />
Note
WARN
) sont produits dans les journaux, sans activité Business Central correspondante effectuée. Cela est normal. Pour désactiver ces messages, définissez le niveau de la catégorie org.hibernate.loader du journal sur ERROR
dans le fichier standalone.xml
.
<logger category="org.hibernate.loader"> <level name="ERROR"/> </logger>
3.2. Installation de la Persistance pour Dashbuilder
java:jboss/datasources/ExampleDS
. Si vous souhaitez faire fonctionner l'application avec une base de données différente de H2
, par exemple Oracle
, MySQL
, Postgres
ou MS SQL Server
, suivez ces étapes.
Note
[mysqld] character-set-server=utf8 collation-server=utf8_general_ci
Important
0
(sensible à la casse) en 1
(non sensible à la casse). Les requêtes Red Hat JBoss BPM Suite KPI sont écrites en minuscule, mais les noms de tableau sont écrits en casse mixte. En modifiant la propriété lower_case_table_names, vous éviterez que des exceptions se produisent ultérieurement.
- Installez le pilote de base de données et créez une nouvelle source de données suivant l'exemple dans la documentation EAP 6, section Exemple de Source de données PostgreSQL. Installez le pilote JDBC de manière modulaire pour faciliter la configuration.
- Créer une base de données vide.
- Modifiez le fichier
dashbuilder.war/WEB-INF/jboss-web.xml
dont l'entrée par défaut est :<jboss-web> <context-root>/dashbuilder</context-root> <resource-ref> <res-ref-name>jdbc/dashbuilder</res-ref-name> <res-type>javax.sql.DataSource</res-type> <jndi-name>java:jboss/datasources/ExampleDS</jndi-name> </resource-ref>
- Modifiez également les fichiers
WEB-INF/jboss-deployment-structure.xml
à des applicationsbusiness-central.war
etdashbuilder.war
, et ajoutez une dépendance sous la section des dépendances sur le module de pilote JBDC créé précédemment lors de la création de source de données. Le snippet suivant montre un exemple de configuration oùjdbcDriverModuleName
représente le nom du module pilote JBoss EAP 6 JDBC.<dependencies> ... <module name="jdbcDriverModuleName" /> ... </dependencies>
3.3. Installation spéciale de la base de données IBM DB2
Exemple 3.1. Ajuster la taille de la page
CREATE DATABASE dashb PAGESIZE 16384
Chapitre 4. Rôles et utilisateurs
4.1. Définir les rôles
- admin : les utilisateurs ayant un rôle admin sont les administrateurs de l'application. Les administrateurs peuvent gérer les utilisateurs, les référentiels (les créer et les cloner) et avoir un accès total pour effectuer des changements dans l'application. Les admins ont accès à toutes les régions du système.
- developer : un développeur a accès à presque toutes les fonctionnalités et peut gérer des règles, des modèles, des flux de processus, des formulaires et tableaux de bord. Ils peuvent gérer le référentiel des ressources, ils peuvent créer, construire et déployer des projets et ils peuvent même utiliser Red Hat JBoss Developer Studio pour afficher les processus. Seules certaines fonctions administratives comme la création et le clonage d'un nouveau référentiel sont masquées au rôle de développeur.
- analyst : un rôle d'analyste a accès à toutes les fonctions de haut niveau pour modeler et exécuter des projets. Cependant, l'accès Création → Administration n'est pas disponible aux utilisateurs ayant un role d'analyste. Certaines fonctions de bas niveau qui ciblent les développeurs, comme l'affichage Déploiement → Référentiel Artefact sont cachées à ce role. Cependant, le bouton Créer & Déployer est accessible au role d'analyste quand celui-ci utilise l'éditeur de projet.
- utilisateur : l'utilisateur travaille sur les listes de tâches d'entreprise qui sont utilisées pour l'exploitation d'un certain processus. Un utilisateur avec ce rôle peut accéder au tableau de bord et gérer les processus.
- manager : un manager est une personne qui voit un système et s'intéresse aux statistiques sur les processus d'entreprise et la performance, les indicateurs clés de l'entreprise et autres rapports du système. Un utilisateur avec ce rôle a accès à la BAM uniquement.
Note
4.2. Création d'utilisateurs
- Exécutez ./add-user.sh sur un système Unix ou add-user.bat sur un système Windows à partir du répertoire bin.
- Saisissez b pour sélectionner un Utilisateur d'application à l'invite type d'utilisateur, et appuyez sur Entrée.
- Acceptez le domaine (realm) par défaut (ApplicationRealm) en appuyant sur Entrée.
- À l'invite du nom utilisateur, saisissez un nom utilisateur et le confirmer. Par exemple :
helloworlduser
.Note
Assurez-vous que les utilisateurs et les groupes ne portent pas le même nom. Par exemple, si un groupe porte le nomadmin
ne donnez pas le nomadmin
à un utilisateur. - Créez le mot de passe utilisateur à l'invite du mot de passe et saisissez à 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. ~! @ # $ % ^ * () - _ + =). - Saisissez une liste de rôles séparée par des virgules dont l'utilisateur aura besoin sur invite des rôles (veuillez consulter Section 4.1, « Définir les rôles »).Les utilisateurs de Business Central doivent au moins posséder le rôle
analyst
, et les utilisateurs Dashbuilder le rôleadmin
. Les rôles doivent être saisis sous la forme d'une liste séparée par des virgules. - Confirmer que vous souhaitez ajouter l'utilisateur.
- Saisir oui à la prochaine invite (pour activer la mise en cluster dans le future si possible)
Chapitre 5. Test de l'installation
5.1. Démarrage du serveur
Note
5.1.1. Mode autonome
Note
standalone.sh
qui fait partie de Red Hat JBoss BPM Suite est optimisé dans un souci de performance. Pour exécuter votre serveur en mode de performance, suivez ces instructions :
- Avec la ligne de commande, déplacez-vous sur le répertoire
$EAP_HOME/bin/
. - Dans un environnement Unix, veuillez exécuter :
./standalone.sh
Dans un environnement Windows, veuillez exécuter :./standalone.bat
standalone-secure.sh
, optimisé pour la sécurité. Ce script applique une politique de sécurité par défaut qui protège contre une vulnérabilité de sécurité connue.
Note
standalone-secure.sh
.
Avertissement
- Avec la ligne de commande, déplacez-vous sur le répertoire
$EAP_HOME/bin/
. - Dans un environnement Unix, veuillez exécuter :
./standalone-secure.sh
Dans un environnement Windows, veuillez exécuter :./standalone-secure.bat
Note
standalone-secure.sh
séparé.
5.1.2. Mode Domaine
Note
- Avec la ligne de commande, déplacez-vous sur le répertoire
$EAP_HOME/bin/
. - Dans un environnement Unix, veuillez exécuter :
./domain.sh
Dans un environnement Windows, veuillez exécuter :./domain.bat
5.2. Java Security Manager et Gestion de performance
- Dans des environnements de charge élevée où la performance est critique, il est recommandé de seulement déployer des applications qui ont été développées sur d'autres systèmes et adéquatement évaluées. Il est également recommandé de ne pas créer des utilisateurs avec le rôle d'analyste sur de tels systèmes. Si ces précautions sont respectées, il est plus sûr de laisser JSM désactivé sur ces systèmes afin d'éviter toute dégradation de performance.
- Dans les environnements de test et de développement sans charges élevées ou dans des environnements où la règle et le processus de création sont exposés à des réseaux externes, il est recommandé d'avoir JSM activé afin d'obtenir une meilleure sécurité d'évaluation correctement isolée (sandboxed) de MVEL.
5.3. Connectez-vous à Business Central
- Naviguer dans http://localhost:8080/business-central via navigateur web. Si l'interface utilisateur est configurée pour exécuter à partir d'un nom de domaine, substituer
localhost
par le nom de domaine. Par exemple http://www.example.com:8080/business-central. - Connectez-vous à l'aide des informations d'identification qui ont été créées lors de l'installation. Par exemple : Utilisateur =
helloworlduser
et mot de passe =Helloworld@123
.
Chapitre 6. Mise en cluster
- Le référentiel GIT : le référentiel VFS (virtual-file-system) détenant les ressources d'entreprise afin que tous les nœuds du cluster utilisent le même référentiel
- Serveur d'exécution et applications Web : le serveur runtime présent dans le conteneur (tel que Red Hat JBoss EAP) ainsi que les applications web Red Hat JBoss BRMS et Red Hat JBoss BPM Suite pour que les nœuds se partagent les mêmes données de runtime.Pour savoir comment mettre l'application en cluster, veuillez consulter la documentation relative à la mise en cluster du conteneur.
- Base de données d'arrière-plan : base de données avec les données de statut, telles que, entre autre, les instances de processus, sessions KIE et journal d'historique pour les basculements.
Figure 6.1. Schéma du système Red Hat JBoss BPM Suite avec composants de système individuel
Mécanisme de mise en cluster du référentiel GIT
- Apache Zookeeper regroupe toutes les parties.
- Apache Helix est le composant de gestion de cluster qui enregistre tous les détails du cluster (le cluster, les nœuds, les ressources).
- uberfire framework, qui fournit le pilier des applications web
Figure 6.2. Schéma de mise en cluster avec Helix et Zookeeper
- Installation du cluster avec Zookeeper et Helix
- Installation de la base de données d'arrière-plan avec une configuration et des tableaux Quartz
- Configuration de la mise en cluster sur votre conteneur (cette documentation ne fournit que des instructions relatives à la mise en cluster pour Red Hat JBoss EAP 6)
Mise en cluster des référentiels Maven
rsync
.
6.1. Mise en cluster avec JBoss EAP
6.1.1. Mise en cluster à l'aide du programme d'installation JAR
Note
business-central.war
, dashbuilder.war
, et kie-server.war
sont déployés. Pour personnaliser l'installation afin qu'elle correspondent à votre scénario, ou pour utiliser la mise en cluster avec le fichier ZIP déployable, veuillez consulter Section 6.1.2, « Configuration personnalisée (ZIP déployable) ». Vous pouvez également obtenir davantage d'informations dans la documentation JBoss EAP.
Note
Sélectionner le fournisseur JDBC
Sur cet écran, veuillez sélectionner le fournisseur JDBC dans la liste. Vous devrez fournir le ou les JAR correspondants de l'une des manières suivantes :- Sélectionnez un ou plusieurs fichiers sur le système de fichiers
- Veuillez fournir un ou plusieurs URL. Le programme d'installation télécharge les fichiers automatiquement.
Le programme d'installation copie ensuite le ou les JAR sur l'emplacement approprié sous le répertoire$EAP_HOME/modules
, où un fichiermodule.xml
correspondant est également créé automatiquement.Figure 6.3. Installation du pilote JDBC
Configurer la connexion Quartz
Sur l'écran suivant, veuillez fournir les données à la base de données pour Quartz. Le programme d'installation crée automatiquement le fichier de définition Quartz ($EAP_HOME/domain/configuration/quartz-definition.properties
) et deux sources de données Quartz dans le fichier de configuration du domaine$EAP_HOME/domain/domain.xml
. Vous pouvez modifier les fichiers après avoir terminé l'installation.Note
Pendant l'installation, les scripts DDL Quartz seront exécutés sur la base de données sélectionnée dans cette étape. Ces scripts rendent des changements nécessaires pour permettre à Quartz d'opérer (d'ajouter des tables, etc...), et se trouvent dans$EAP_HOME/jboss-brms-bpmsuite-6.3-supplementary-tools/ddl-scripts
comme référence (il n'est pas nécessaire de les modifier de quelque manière que ce soit).Figure 6.4. Installation de la base de données Quartz
- Cliquez sur Suivant pour lancer l'installation.
Important
Lors de l'utilisation du programme d'installation JAR, les archiveswar
sont automatiquement créées à partir des applications résidant dans$EAP_HOME/standalone/deployments/
. Cela signifie que de l'espace supplémentaire est nécessaire car les applications existent à la fois dans un état compressé et non-compressé dans le stockage pendant l'installation.Trois instances de ZooKeeper sont automatiquement créées dans$EAP_HOME/jboss-brms-bpmsuite-6.3-supplementary-tools/
(noms des répertoireszookeeper-one
,zookeeper-two
, etzookeeper-three
).Dans le répertoire$EAP_HOME/jboss-brms-bpmsuite-6.3-supplementary-tools/helix-core
, vous pourrez trouver la configuration Helix par défaut et les scripts pour lancer le cluster—startCluster.sh
pour UNIX etstartCluster.bat
pour Windows.Une fois l'installation terminée, veuillez NE PAS sélectionner d'exécuter le serveur immédiatement. Vous devrez d'abord lancer le cluster en déplaçant dans le répertoire$EAP_HOME/jboss-brms-bpmsuite-6.3-supplementary-tools/helix-core
le script de lancement mentionné ci-dessus et en l'exécutant :Sur les systèmes Unix :./startCluster.sh
Sur Windows :./startCluster.bat
Ce script lance le cluster Helix et les instances ZooKeeper. Uniquement après cela, lancez le serveur EAP en mode domaine en vous déplaçant sur le répertoire$EAP_HOME/bin
et en exécutant :Sur les systèmes Unix :./domain.sh
Sur Windows :./domain.bat
6.1.2. Configuration personnalisée (ZIP déployable)
- Configurer ZooKeeper et Helix selon Section 6.2.1, « Installer un Cluster ».
- Configurer Quartz selon Section 6.2.2, « Installation de Quartz ».
- Installez votre pilote JDBC comme module principal : copiez le jar du pilote sur
$EAP_HOME/modules/system/layers/base/
et créez un fichiermodule.xml
dans le répertoire. - Veuillez modifier le fichier
module.xml
d'après le module XSD correspondant.Exemple 6.1. Contenu de fichier
module.xml
pour la source de données PostgreSQL<module xmlns="urn:jboss:module:1.0" name="org.postgresql"> <resources> <resource-root path="postgresql-jdbc.jar"/> </resources> <dependencies> <module name="javax.api"/> <module name="javax.transaction.api"/> </dependencies> </module>
- Configurez la source de données pour le serveur : ouvrez le fichier
host.xml
oustandalone.xml
pour modification, selon le PROFIL utilisé situé dans$EAP_HOME/PROFILE/
, localisez le profilfull
et effectuez ce qui suit :- Ajoutez la définition de la source de données principale utilisée par Red Hat JBoss BPM Suite.
Exemple 6.2. La source de données PostgreSQL définie comme la source de données Red Hat JBoss BPM Suite principale
<datasource jndi-name="java:jboss/datasources/psbpmsDS" pool-name="postgresDS" enabled="true" use-java-context="true"> <connection-url>jdbc:postgresql://localhost:5432/jbpm</connection-url> <driver>postgres</driver> <security> <user-name>bpms</user-name> <password>bpms</password> </security> </datasource>
- Ajoutez la définition de la source de données pour le service Quartz.
Exemple 6.3. La source de données PostgreSQL définie comme la source de données Quartz principale
<datasource jta="false" jndi-name="java:jboss/datasources/quartzNotManagedDS" pool-name="quartzNotManagedDS" enabled="true" use-java-context="true"> <connection-url>jdbc:postgresql://localhost:5432/jbpm</connection-url> <driver>postgres</driver> <security> <user-name>bpms</user-name> <password>bpms</password> </security> </datasource>
- Définissez le pilote de la source de données.
Exemple 6.4. La définition du pilote PostgreSQL
<driver name="postgres" module="org.postgresql"> <xa-datasource-class>org.postgresql.xa.PGXADataSource</xa-datasource-class> </driver>
- Configurer des nœuds de serveurs individuels dans l'élément
main-server-group
du fichier$EAP_HOME/domain/configuration/host.xml
dont les propriétés sont définies dans Tableau 6.1, « Propriétés de nœud Cluster » :Veuillez noter que lors de la configuration d'un cluster JBoss EAP avec Zookeeper, il est possible que le nombre de nœuds JBoss EAP soit différent de celui des nœuds de Zookeeper (Zookeeper doit avoir un nombre impaire de nœuds). Il est conseillé que Zookeeper et JBoss EAP aient le même nombre de nœuds.Tableau 6.1. Propriétés de nœud Cluster
Nom de propriété Valeur Description jboss.node.name
nodeOne
Nom de nœuds unique dans le clusterorg.quartz.properties
/bpms/quartz-definition.properties
chemin d'accès absolu vers le fichier de configuration Quartzorg.uberfire.cluster.id
bpms-cluster
Nom de cluster de Helixorg.uberfire.cluster.local.id
nodeOne_12345
ID unique du nœud de cluster HelixVeuillez noter que:
est remplacé par_
.org.uberfire.cluster.vfs.lock
vfs-repo
nom de la ressource défini sur le cluster Helixorg.uberfire.cluster.zk
server1:2181
Emplacement Zookeeperorg.uberfire.metadata.index.dir
/home/jbpm/node[N]/index
emplacement où l'index de recherche doit être créé (pris en charge par Apache Lucene)org.uberfire.nio.git.daemon.host
nodeOne
le nom de la machine d'hôte démon dans un cluster physique. org.uberfire.nio.git.daemon.port
9418
port utilisé par le référentiel VFS pour accepter les connexions clientLe port doit être unique pour chaque membre de cluster.org.uberfire.nio.git.dir
/home/jbpm/node[N]/repo
Emplacement du référentiel GIT (VFS) sur le nœud [N]org.uberfire.nio.git.ssh.host
nodeOne
le nom de la machine d'hôte SSH dans un cluster physique. org.uberfire.nio.git.ssh.port
8003
le numéro de port unique pour l'accès SSH au référentiel GIT pour un cluster exécuté sur des machines physiques. org.uberfire.nio.git.ssh.hostport and org.uberfire.nio.git.daemon.hostport
8003 and 9418
Dans un environnement virtualisé, le port externe à utiliser Exemple 6.5. Configuration du Cluster nodeOne
<system-properties> <property name="org.uberfire.nio.git.dir" value="/tmp/bpms/nodeone" boot-time="false"/> <property name="jboss.node.name" value="nodeOne" boot-time="false"/> <property name="org.uberfire.cluster.id" value="bpms-cluster" boot-time="false"/> <property name="org.uberfire.cluster.zk" value="server1:2181,server2:2181,server3:2181" boot-time="false"/> <property name="org.uberfire.cluster.local.id" value="nodeOne_12345" boot-time="false"/> <property name="org.uberfire.cluster.vfs.lock" value="vfs-repo" boot-time="false"/> <property name="org.uberfire.nio.git.daemon.host" value="nodeOne" /> <property name="org.uberfire.nio.git.daemon.port" value="9418" boot-time="false"/> <property name="org.uberfire.nio.git.daemon.hostport" value="9418" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.port" value="8003" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.hostport" value="8003" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.host" value="nodeOne" /> <property name="org.uberfire.metadata.index.dir" value="/tmp/jbpm/nodeone" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.cert.dir" value="/tmp/jbpm/nodeone" boot-time="false"/> <property name="org.quartz.properties" value="/tmp/jbpm/quartz/quartz-db-postgres.properties" boot-time="false"/> </system-properties>
Exemple 6.6. Configuration du Cluster nodeTwo
<system-properties> <property name="org.uberfire.nio.git.dir" value="/tmp/bpms/nodetwo" boot-time="false"/> <property name="jboss.node.name" value="nodeTwo" boot-time="false"/> <property name="org.uberfire.cluster.id" value="bpms-cluster" boot-time="false"/> <property name="org.uberfire.cluster.zk" value="server1:2181,server2:2181,server3:2181" boot-time="false"/> <property name="org.uberfire.cluster.local.id" value="nodeTwo_12346" boot-time="false"/> <property name="org.uberfire.cluster.vfs.lock" value="vfs-repo" boot-time="false"/> <property name="org.uberfire.nio.git.daemon.host" value="nodeTwo" /> <property name="org.uberfire.nio.git.daemon.port" value="9418" boot-time="false"/> <property name="org.uberfire.nio.git.daemon.hostport" value="9418" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.port" value="8003" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.hostport" value="8003" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.host" value="nodeTwo" /> <property name="org.uberfire.metadata.index.dir" value="/tmp/jbpm/nodetwo" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.cert.dir" value="/tmp/jbpm/nodetwo" boot-time="false"/> <property name="org.quartz.properties" value="/tmp/jbpm/quartz/quartz-db-postgres.properties" boot-time="false"/> </system-properties>
Exemple 6.7. Configuration du Cluster nodeThree
<system-properties> <property name="org.uberfire.nio.git.dir" value="/tmp/bpms/nodethree" boot-time="false"/> <property name="jboss.node.name" value="nodeThree" boot-time="false"/> <property name="org.uberfire.cluster.id" value="bpms-cluster" boot-time="false"/> <property name="org.uberfire.cluster.zk" value="server1:2181,server2:2181,server3:2181" boot-time="false"/> <property name="org.uberfire.cluster.local.id" value="nodeThree_12347" boot-time="false"/> <property name="org.uberfire.cluster.vfs.lock" value="vfs-repo" boot-time="false"/> <property name="org.uberfire.nio.git.daemon.host" value="nodeThree" /> <property name="org.uberfire.nio.git.daemon.port" value="9418" boot-time="false"/> <property name="org.uberfire.nio.git.daemon.hostport" value="9418" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.port" value="8003" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.hostport" value="8003" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.host" value="nodeThree" /> <property name="org.uberfire.metadata.index.dir" value="/tmp/jbpm/nodethree" boot-time="false"/> <property name="org.uberfire.nio.git.ssh.cert.dir" value="/tmp/jbpm/nodethree" boot-time="false"/> <property name="org.quartz.properties" value="/tmp/jbpm/quartz/quartz-db-postgres.properties" boot-time="false"/> </system-properties>
- Ajoutez les utilisateurs de gestion comme indiqué dans le Guide d'Administration et de Configuration pour Red Hat JBoss EAP et les utilisateurs d'application comme indiqué dans le Guide d'Administration et de Configuration Red Hat JBoss BPM Suite.
- Déplacez-vous sur le répertoire
$EAP_HOME/bin
et exécutez le serveur d'applications en mode domaine :Sur les systèmes Unix :./domain.sh
Sur Windows :./domain.bat
- Vérifiez que les nœuds sont disponibles.
- Remplacez la persistance prédéfinie de l'application par la base de données requise (PostgreSQL) : appliquez les modifications suivantes dans
persistence.xml
:- nom jta-data-source de la source défini sur le serveur d'application (
java:jboss/datasources/psbpmsDS
) - dialecte hibernate doit correspondre au dialecte de la source de données (
org.hibernate.dialect.PostgreSQLDialect
)
- Connectez-vous en tant qu'utilisateur de gestion à la console Administration du serveur de votre domaine et ajoutez les nouveaux déploiements à l'aide de l'affichage Runtime de la console. Une fois le déploiement ajouté au domaine, attribuez-le au groupe de serveur approprié (
main-server-group
).
Note
déployé
. Toute requête ciblant cette unité de déploiement envoyé à un membre de cluster échoue avec DeploymentNotFoundException
.
6.2. Mise en cluster d'un ensemble générique
6.2.1. Installer un Cluster
- Téléchargez
jboss-bpmsuite-brms-VERSION-supplementary-tools.zip
, qui contient Apache Zookeeper, Apache Helix et les scripts Quartz DDL. Après le téléchargement, décompressez l'archive : les répertoiresZookeeper
($ZOOKEEPER_HOME
) etHelix
($HELIX_HOME
) sont créés. - Veuillez maintenant configurer ZooKeeper :
- Dans le répertoire ZooKeeper, allez dans le répertoire
conf
et effectuez ce qui suit :cp zoo_sample.cfg zoo.cfg
- Ouvrez
zoo.cfg
pour effectuer des modifications et ajustez les paramètres dont :# the directory where the snapshot is stored. dataDir=$ZOOKEEPER_HOME/data/ # the port at which the clients connects clientPort=2181 server.1=server1:2888:3888 server.2=server2:2888:3888 server.3=server3:2888:3888
Assurez-vous de l'existence et de l'accessibilité de l'emplacement dataDir. - Attribuez un ID de nœud à chaque membre qui exécutera ZooKeeper. Par exemple, utilisez 1, 2 et 3 pour le nœud 1, 2 et 3 respectivement. ZooKeeper doit avoir un nombre impair d'instances, au moins trois, pour pouvoir récupérer d'un échec.L'ID de nœud est spécifié dans un champ appelé
myid
sous le répertoire de données de ZooKeeper sur chaque nœud. Par exemple, sur le nœud 1, exécutez :$ echo "1" > /zookeeper/data/myid
- Installez ZooKeeper afin de l'utiliser lors de la création du cluster avec Helix :
- Allez sur le répertoire
$ZOOKEEPER_HOME/bin/
et démarrez ZooKeeper :./zkServer.sh start
Vous pouvez vérifier le journal de ZooKeeper dans le fichier$ZOOKEEPER_HOME/bin/zookeeper.out
. Vérifiez ce journal pour vous assurer que « l'ensemble » (cluster) a bien été créé. Un des nœuds doit être élu comme nœud principal, suivi par les deux autres.
- Une fois l'ensemble ZooKeeper démarré, l'étape suivante consiste à configurer et démarrer Helix. Helix ne doit être configuré qu'une fois, à partir d'un nœud unique. La configuration est ensuite stockée par l'ensemble ZooKeeper et partagée si besoin.Installez le cluster avec le serveur ZooKeeper comme maître de la configuration :
- Créez le cluster en fournissant l'hôte ZooKeeper et importez en tant que liste séparée par des virgules :
$HELIX_HOME/bin/helix-admin.sh --zkSvr ZOOKEEPER_HOST:ZOOKEEPER_PORT --addCluster CLUSTER_NAME
- Ajoutez vos nœuds au cluster :
$HELIX_HOME/bin/helix-admin.sh --zkSvr ZOOKEEPER_HOST:ZOOKEEPER_PORT --addNode CLUSTER_NAME NODE_NAMEUNIQUE_ID
Exemple 6.8. Ajouter trois nœuds de cluster
./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addNode bpms-cluster nodeOne:12345 ./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addNode bpms-cluster nodeTwo:12346 ./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addNode bpms-cluster nodeThree:12347
- Ajouter des ressources au cluster
Exemple 6.9. Ajouter vfs-repo comme ressource
./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addResource bpms-cluster vfs-repo 1 LeaderStandby AUTO_REBALANCE
- Rééquilibrez le cluster avec les trois nœuds.
Exemple 6.10. Rééquilibrer le bpms-cluster
./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --rebalance bpms-cluster vfs-repo 3
Dans la commande ci-dessus,3
fait référence à trois nœuds Zookeeper. - Démarrez le contrôleur Helix dans tous les nœuds du cluster.
Exemple 6.11. Démarrez le contrôleur Helix
./run-helix-controller.sh --zkSvr server1:2181,server2:2181,server3:2181 --cluster bpms-cluster 2>&1 > /tmp/controller.log &
Note
Arrêt de Helix et ZooKeeper
Procédure 6.1. Arrêt de Helix et ZooKeeper
- Arrêtez les processus du serveur JBoss EAP
- Arrêtez le processus Helix créé par
run-helix-controller.sh
, par exemplekill -15 <pid of HelixControllerMain>
. - Arrêtez le serveur ZooKeeper à l'aide de la commande
zkServer.sh stop
6.2.2. Installation de Quartz
Note
- Installez la base de données. Assurez-vous d'utiliser l'une des sources de données non JTA prises en charge. Veuillez noter que Quartz nécessite une source de données non JTA et que vous ne pouvez donc pas utiliser la source de données Business Central. Dans le code en exemple, PostgreSQL est utilisé avec l'utilisateur
bpms
et le mot de passebpms
. Cette base de données devra être connectée à votre serveur d'application, assurez-vous donc de noter les informations et détails d'authentification de la base de données. - Créez des tableaux Quartz sur votre base de données pour permettre une synchronisation d'événements de minuteur. Pour cela, veuillez utiliser le script DDL pour votre base de données, disponible dans l'archive zip supplémentaire disponible sur
$QUARTZ_HOME/docs/dbTables
. - Créez le fichier de configuration Quartz
quartz-definition.properties
dans le répertoire$JBOSS_HOME/PROFILE/configuration/
et définissez les propriétés Quartz.Exemple 6.12. Fichier de configuration Quartz pour une base de données PostgreSQL
#============================================================================ # Configure Main Scheduler Properties #============================================================================ org.quartz.scheduler.instanceName = jBPMClusteredScheduler org.quartz.scheduler.instanceId = AUTO #============================================================================ # Configure ThreadPool #============================================================================ org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool org.quartz.threadPool.threadCount = 5 org.quartz.threadPool.threadPriority = 5 #============================================================================ # Configure JobStore #============================================================================ org.quartz.jobStore.misfireThreshold = 60000 org.quartz.jobStore.class=org.quartz.impl.jdbcjobstore.JobStoreCMT org.quartz.jobStore.driverDelegateClass=org.quartz.impl.jdbcjobstore.PostgreSQLDelegate org.quartz.jobStore.useProperties=false org.quartz.jobStore.dataSource=managedDS org.quartz.jobStore.nonManagedTXDataSource=notManagedDS org.quartz.jobStore.tablePrefix=QRTZ_ org.quartz.jobStore.isClustered=true org.quartz.jobStore.clusterCheckinInterval = 20000 #============================================================================ # Configure Datasources #============================================================================ org.quartz.dataSource.managedDS.jndiURL=jboss/datasources/psbpmsDS org.quartz.dataSource.notManagedDS.jndiURL=jboss/datasources/quartzNotManagedDS
Veuillez noter les sources de données configurées qui recevront les deux programmes Quartz à la fin du fichier.Important
L'intervalle recommandé pour la détection de cluster est de 20 secondes. Il est défini dans la propriété org.quartz.jobStore.clusterCheckinInterval du fichierquartz-definition.properties
. Selon votre configuration, prenez en compte l'impact sur la performance et modifiez les paramètres en conséquence.Veuillez également noter la propriété org.quartz.jobStore.driverDelegateClass qui définit le dialecte DB à utiliser lors de la communication avec la base de données configurée (dans cet exemple,org.quartz.impl.jdbcjobstore.PostgreSQLDelegate
. Si vous utilisez Oracle, utilisezorg.quartz.impl.jdbcjobstore.oracle.OracleDelegate
).
Chapitre 7. Référentiels Maven
7.1. Maven
http://
s'il est situé sur un serveur HTTP, ou file://
s'il est situé sur un serveur de fichiers. Le référentiel par défaut est le Maven 2 Central Repository distant public.
settings.xml
. Vous pouvez soit configurer les paramètres généraux de Maven dans le fichier M2_HOME/conf/settings.xml
, ou les paramètres de niveau utilisateur dans le fichier USER_HOME/.m2/settings.xml
.
Note
7.2. Les référentiels Maven fournis
settings.xml
de Maven lors de l'installation, Maven sera déjà configuré pour utiliser les référentiels en ligne.
Important
7.3. Configurer Maven pour utiliser les référentiels de système de fichier
Dans les situations où une utilisation de référentiels en ligne est impossible, vous devrez télécharger et configurer les référentiels requis localement.
Procédure 7.1.
- Télécharger les archives ZIP suivantes contenant les référentiels requis :
- Décompressez les fichiers ZIP téléchargés vers un emplacement arbitraire dans un système de fichiers local.
- Ajoutez les entrées des référentiels décompressés vers le fichier
settings.xml
de Maven. L'exemple de code suivant contient un profil avec les référentiels , une configuration d'authentication pour accéder aux référentiels et une entrée d'activation pour le profil :<?xml version="1.0" encoding="UTF-8" standalone="no"?> <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/xsd/settings-1.0.0.xsd"> <localRepository/> <profiles> <!-- Profile with local repositories required by Red Hat JBoss BRMS/Red Hat JBoss BPM Suite --> <profile> <id>brms-bpms-local-profile</id> <repositories> <repository> <id>jboss-brms-bpmsuite-repository</id> <name>BRMS/BPMS 6.3.0 GA Repository</name> <url>file://<!-- path to the repository -->/jboss-brms-bpmsuite-6.3.0.GA-redhat-5-maven-repository/maven-repository</url> <layout>default</layout> <releases> <enabled>true</enabled> <updatePolicy>never</updatePolicy> </releases> <snapshots> <enabled>false</enabled> <updatePolicy>never</updatePolicy> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>jboss-brms-bpmsuite-repository</id> <name>BRMS/BPMS 6.3.0 GA Repository</name> <url>file://<!-- path to the repository -->/jboss-brms-bpmsuite-6.3.0.GA-redhat-5-maven-repository/maven-repository</url> <layout>default</layout> <releases> <enabled>true</enabled> <updatePolicy>never</updatePolicy> </releases> <snapshots> <enabled>false</enabled> <updatePolicy>never</updatePolicy> </snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles> <!-- Configuring pre-emptive authentication for the repository server --> <server> <id>brms-bpms-m2-repo</id> <username>admin</username> <password>admin</password> <configuration> <wagonProvider>httpclient</wagonProvider> <httpConfiguration> <all> <usePreemptive>true</usePreemptive> </all> </httpConfiguration> </configuration> </server> <!-- Alternative to enabling pre-emptive authentication - configuring the Authorization HTTP header with Base64-encoded credentials <server> <id>brms-bpms-m2-repo</id> <configuration> <httpHeaders> <property> <name>Authorization</name> <value>Basic YWRtaW46YWRtaW4=</value> </property> </httpHeaders> </configuration> </server> --> <activeProfiles> <!-- Activation of the Red Hat JBoss BRMS/Red Hat JBoss BPM Suite profile --> <activeProfile>brms-bpms-local-profile</activeProfile> </activeProfiles> </settings>
Les référentiels Maven sont téléchargés, décompressés dans un système de fichiers local, enregistrés dans le fichier settings.xml
de Maven et prêt à être utilisés lors des générations Maven.
- Q : Pourquoi obtiens-je des messages d'erreur lors de la génération ou du déploiement de mes applications ?
- Q : Pourquoi JBoss Developer Studio utilise-t-il mon ancienne configuration Maven ?
Lorsque vous générez ou déployez un projet, celui-ci échoue avec un ou les deux messages d'erreur suivants :
[ERROR] Failed to execute goal on project PROJECT_NAME
Could not find artifact ARTIFACT_NAME
Il se peut que votre référentiel Maven local mis en cache contienne des artefacts obsolètes.
Pour résoudre ce problème, supprimez le référentiel local mis en cache : le répertoire ~/.m2/repository/
sur Linux ou le répertoire %SystemDrive%\Users\USERNAME\.m2\repository\
sur Windows, puis exécutez mvn clean install -U
. Cela obligera Maven à télécharger les versions correctes des artefacts nécessaires lors de l'exécution de la génération suivante.
Vous avez mis votre configuration Maven à jour, mais cette configuration n'est pas visible dans JBoss Developer Studio.
Si votre JBoss Developer Studio est en marche lorsque vous modifiez votre fichier settings.xml
Maven, cette configuration ne sera pas visible dans JBoss Developer Studio.
Figure 7.1. Mise à jour des paramètres de configuration de l'utilisateur Maven
7.4. Configurer Maven pour utiliser les référentiels en ligne
Procédure 7.2. Configurer Maven pour utiliser les référentiels en ligne
- Ajoutez des entrées aux référentiels en ligne et la configuration de l'authentification pour y accéder au fichier
settings.xml
Maven tel que dans l'exemple de code ci-dessous :<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> <profiles> <!-- Profile with online repositories required by BRMS/BPMS --> <profile> <id>brms-bpms-online-profile</id> <repositories> <repository> <id>jboss-ga-repository</id> <url>http://maven.repository.redhat.com/techpreview/all</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>jboss-ga-plugin-repository</id> <url>http://maven.repository.redhat.com/techpreview/all</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles> <!-- Configuring pre-emptive authentication for the repository server --> <server> <id>brms-bpms-m2-repo</id> <username>admin</username> <password>admin</password> <configuration> <wagonProvider>httpclient</wagonProvider> <httpConfiguration> <all> <usePreemptive>true</usePreemptive> </all> </httpConfiguration> </configuration> </server> <!-- Alternative to enabling pre-emptive authentication - configuring the Authorization HTTP header with Base64-encoded credentials <server> <id>brms-bpms-m2-repo</id> <configuration> <httpHeaders> <property> <name>Authorization</name> <value>Basic YWRtaW46YWRtaW4=</value> </property> </httpHeaders> </configuration> </server> --> <activeProfiles> <!-- Activation of the BRMS/BPMS profile --> <activeProfile>brms-bpms-online-profile</activeProfile> </activeProfiles> </settings>
- Si vous avez modifié le fichier
settings.xml
alors que JBoss Developer Studio était en cours d'exécution, vous devrez réactualiser les paramètres Maven dans l'IDE. À partir du menu, sélectionnez Window → Préférences. Dans la fenêtre Préférences, agrandissez Maven et sélectionnez Paramètres utilisateur. Cliquez sur le bouton Paramètres de mise à jour pour réactualiser les paramètres de l'utilisateur Maven dans JBoss Developer Studio.Figure 7.2. Mise à jour des paramètres de configuration de l'utilisateur Maven
Maven a été configuré pour utiliser les référentiels en ligne fournis pour votre produit Red Hat JBoss.
Important
- Missing artifact ARTIFACT_NAME
- [ERROR] Failed to execute goal on project PROJECT_NAME; Could not resolve dependencies for PROJECT_NAME
~/.m2/repository/
sur Linux ou le répertoire %SystemDrive%\Users\USERNAME\.m2\repository\
sur Windows. Cela obligera Maven à télécharger les versions correctes des artefacts nécessaires lors de la génération suivante.
7.5. Gestion des dépendances
pom.xml
du projet. Ces fichiers BOM garantissent que les bonnes versions des dépendances transitives des référentiels Maven fournis sont inclus dans le projet.
- Red Hat JBoss BPM Suite en utilisant le référentiel Maven en ligne. Pour obtenir des instructions, consulter Section 7.4, « Configurer Maven pour utiliser les référentiels en ligne ».
- Red Hat JBoss BPM Suite en utilisant le référentiel Maven basé sur un système de fichiers local. Pour obtenir des instructions, consulter Section 7.3, « Configurer Maven pour utiliser les référentiels de système de fichier ».
org.jboss.bom.brms:jboss-brms-bpmsuite-bom:VERSION
: l'indicateur BOM de base sans support Java EE6.org.jboss.bom.brms:jboss-javaee-6.0-with-brms-bpmsuite:VERSION
: offre un support pour Java EE6.
Chapitre 8. Red Hat JBoss Developer Studio
8.1. Red Hat JBoss Developer Studio
Avertissement
UTF-8
. Vous pouvez pour cela modifier le fichier $JBDS_HOME/studio/jbdevstudio.ini
et ajouter la propriété suivante : "-Dfile.encoding=UTF-8"
8.2. Installation des plug-ins d'un JBoss Developer Studio
Procédure 8.1. Installer le plugin Drools et jBPM JBoss Developer Studio
- Démarrer JBoss Developer Studio.
- Sélectionnez Help → Installer Nouveau Logiciel.
- Cliquez sur Ajouter pour saisir le menu Ajouter référentiel.
- Donnez au site du logiciel un nom à côté du champ Nom et ajoutez l'url suivant dans le champ Emplacement : https://devstudio.jboss.com/updates/8.0/integration-stack/
- Cliquez sur OK.
- Sélectionnez la fonctionnalité Développement de processus métiers et de règles parmi les options disponibles puis cliquez sur Suivant et sur Suivant à nouveau.
- Lisez les termes de la licence et acceptez-la en sélectionnant le bouton radio qui convient, puis cliquez sur Terminer
- Après l'installation des plug-ins, démarrez JBoss Developer Studio à nouveau.
8.3. Définissez le runtime de Drools
Procédure 8.2. Configurer le Runtime de Red Hat JBoss BRMS
- Extrayez les fichiers jar de runtime situés dans l'arcihve
jboss-brms-VERSION-engine.zip
que vous pouvez télécharger à partir du Portail Client Red Hat. - À partir du menu JBoss Developer Studio, sélectionnez Window et cliquez sur Préférences.
- Sélectionnez Drools → Installed Drools Runtimes.
- Cliquez sur Add... (Ajouter) ; choisissez un nom pour le nouveau runtime puis cliquez sur Browse (Parcourir) pour naviguer vers le répertoire dans lequel vous avez extrait les fichiers de runtime à l'étape 1. Cliquez sur OK pour enregistrer le runtime sélectionné dans JBDS.
- Indiquez que le runtime que vous avez créé est le runtime Drools par défaut en cliquant sur la case adjacente.
- Cliquez 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.
8.4. Configuration du serveur JBoss BPM Suite
Procédure 8.3. Configurer le serveur
- Ouvrez l'affichage jBPM en sélectionnant Window → Ouvrir Perspective → Autre et sélectionnez jBPM, puis cliquez sur OK.
- Ajoutez l'affichage du serveur en sélectionnant Window → Afficher Vue → Autre... et en sélectionnant Serveur → Serveurs.
- Ouvrez le Menu de serveur en effectuant un clic droit sur le panneau de serveurs et en sélectionnant Nouveau → Serveur.
- Définissez le serveur en sélectionnant JBoss Enterprise Middleware → JBoss Enterprise Application Platform 6.4+ et en cliquant sur Suivant.
- Configurez le répertoire d'accueil en cliquant sur le bouton Parcourir. Recherchez et sélectionnez le répertoire d'installation de JBoss EAP 6.4 avec Red Hat JBoss BPM Suite installé.
- Donnez un nom au serveur dans le champ Nom, assurez-vous que le fichier de configuration est défini et cliquez sur Terminer.
8.5. Importation de projets à partir d'un référentiel Git dans JBoss Developer Studio
Procédure 8.4. Clonage d'un référentiel GIT distant
- Démarrez le serveur Red Hat JBoss BRMS / Red Hat BPM Suite en sélectionnant le serveur à partir de l'onglet Serveur et en cliquant sur le bouton Start.
- Démarrez 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 et 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
- Dans JBoss Developer Studio, sélectionnez Fichier → Importer... et naviguez dans le fichier Git. Ouvrez le dossier Git et sélectionnez Projets Git puis cliquez sur Suivant.
- Sélectionnez la source du référentiel en tant que Clone URI et cliquez sur Suivant.
- Saisissez les détails du référentiel Git dans la prochaine fenêtre et cliquez sur Suivant.
Figure 8.1. Informations sur le référentiel Git
- Sélectionnez la branche que vous souhaitez importer dans la fenêtre suivante et cliquez sur Suivant.
- Pour définir le stockage local pour ce projet, saisissez (ou sélectionnez) un répertoire non-vide, apportez des modifications de configuration et cliquez sur Suivant.
- Importez le projet en tant que projet général dans la fenêtre suivante et cliquez sur Suivant. Nommez le projet et cliquez sur Terminer.
Procédure 8.5. Importer un référentiel local Git
- Démarrez le serveur Red Hat JBoss BRMS / Red Hat BPM Suite en sélectionnant le serveur à partir de l'onglet Serveur et en cliquant sur le bouton Start.
- Dans JBoss Developer Studio, sélectionnez Fichier → Importer... et naviguez dans le fichier Git. Ouvrez le dossier Git et sélectionnez Projets Git puis cliquez sur Suivant.
- Sélectionnez la source du référentiel en tant que Référentiel local existant et cliquez sur Suivant.
Figure 8.2. Informations sur le référentiel Git
- Sélectionnez le référentiel qui doit être configuré à partir de la liste de référentiels disponibles et cliquez sur Suivant.
- Dans la boîte de dialogue, sélectionnez le bouton Importer comme projet général à partir de Wizard pour groupe d'importation de projet et cliquez sur Suivant. Nommez le projet et cliquez sur Terminer.
Figure 8.3. Wizard pour Importation de Projet
Chapitre 9. Correctifs et Mise à niveau de Red Hat JBoss BPM Suite
9.1. Correctifs et Mises à niveau
- Mises à jour asynchrones : correctifs ponctuels publiés en dehors d'un cycle de mise à jour normal du produit existant. Ces mises à jour peuvent inclure des correctifs de sécurité, ainsi que d'autres correctifs ponctuels fournis par GSS (Red Hat Global Support Services) pour résoudre ces problèmes particuliers.
- Mises à jour planifiées : les correctifs cumulatifs d'un produit existant, qui incluent toutes les mises à jour développées auparavant pour cette version du produit.
- Clients Red Hat JBoss BRMS -
jboss-brms-<version>-patch.zip
- Clients Red Hat JBoss BPM Suite -
jboss-bpmsuite-<version>-patch.zip
- Mises à jour des référentiels Red Hat Maven (identiques pour les clients Red Hat JBoss BRMS et JBoss BPM Suite) -
jboss-brms-bpmsuite-<version>-incremental-maven-repository.zip
9.2. Appliquer des correctifs dans Red Hat JBoss BPM Suite 6.3
.sh
et .bat
simples, permettant une application de mises à jour facilitée et automatique sur une installation Red Hat JBoss BPM Suite 6.1 (ou version ultérieure).
Important
<path-to-distribution-root>
et <type-of-distribution>
. Par exemple, la commande suivante applique les mises à jour au lot JBoss EAP suivant :
Note
$ ./apply-updates.sh ~/EAP_HOME/jboss-eap-6.4 eap6.x
- eap6.x
- eap6.x-bc
- eap6.x-kie-server
- eap6.x-dashbuilder
- generic
- generic-bc
- generic-kie-server
- generic-dashuilder
- was8
- was8-bc
- was8-kie-server
- was8-dashbuilder
- wls12c
- wls12c-bc
- wls12c-kie-server
- wls12c-dashbuilder
- brms-engine
- planner-engine
- supplementary-tools
Note
Fonctionnalité de sauvegarde
backup/<current-timestamp>
. Le répertoire de sauvegarde de niveau supérieur est créé au même niveau de fichier système que le apply-updates
.
Fonctionnalité liste noire
blacklist.txt
présent dans la distribution de correction. Saisissez le chemin d'accès relatif aux fichiers ne devant pas être mis à jour. Chaque fichier doit être précisé sur une ligne individuelle.
# lines with a '#' are comment lines, like this one # blank lines are ignored # we have made changes to the web.xml that must be preserved WEB-INF/web.xml # this file has custom modifications styles/base.css
blacklist.txt
et dont le contenu du correctif est mis à jour ne seront pas pris en compte par l'outil de mise à jour. À la place, l'outil copie le nouveau fichier mis à jour au même emplacement et y ajoute le suffixe new
. Par exemple, après l'exécution de l'outil de correction, ces deux fichiers existeront dans le dossier styles
, continuant avec le fichier blacklist.txt
dans l'exemple ci-dessus.
$ ls styles base.css base.css.new
blacklist.txt
. L'outil de mise à jour de correction ne supprimera pas ces fichiers, et créera à la place un fichier marqueur vide avec le suffix removed
. Vous pourrez ensuite décider de conserver ou supprimer ces fichiers manuellement.
base.css
a été supprimé et qu'il était listé dans le fichier blacklist.txt
, le contenu du répertoire des styles sera, suite à l'exécution de l'outil de correction, semblable à ce qui suit :
$ ls styles base.css base.css.removed
9.3. Corriger d'autres plateformes et applications
$ ./apply-updates.[sh|bat] <some-path>/jboss-eap-6.4/standalone/deployments/business-central.war eap6.x-bc
$ ./apply-updates.[sh|bat] <some-path-to-tomcat-home>/webapps/kie-server.war generic-kie-server
$ ./apply-updates.[sh|bat] <path-to-unzipped-wls12c-bundle> wls12c
$ ./apply-updates.[sh|bat] <path-to-unzipped-planner-bundle> planner-engine
9.4. Mise à niveau des dernières versions mineures
- Red Hat JBoss BPM Suite 6.2.2 à Red Hat JBoss BPM Suite 6.3.0
- Red Hat JBoss BPM Suite 6.1.5 à Red Hat JBoss BPM Suite 6.3.0
- Utiliser jboss-bpmsuite-6.2.2-to-6.3.0-patch.zip pour la mise à niveau de Red Hat JBoss BPM Suite 6.2.2 à Red Hat JBoss BPM Suite 6.3.0
- Utiliser jboss-bpmsuite-6.1.5-to-6.3.0-patch.zip pour la mise à niveau de Red Hat JBoss BPM Suite 6.1.5 à Red Hat JBoss BPM Suite 6.3.0
- apply-updates.bat
- apply-updates.sh
$ ./apply-updates.sh <distribution path> <distribution name>
$ ./apply-updates.sh ~/EAP_HOME/jboss-eap-6.4 eap6.x
- eap6.x
- eap6.x-bc
- eap6.x-dashbuilder
- eap6.x-kie-server
- generic
- generic-bc
- generic-dashbuilder
- generic-kie-server
- was8
- was8-bc
- was8-dashbuilder
- was8-kie-server
- wls12c
- wls12c-bc
- wls12c-dashbuilder
- wls12c-kie-server
- bpmsuite-engine
- planner-engine
- supplementary-tools
Note
persistence.xml
, l’approche recommandée est d’ajouter vos modifications personnalisées pour les nouveaux fichiers créés par l’outil de mise à niveau. Une fois que vous aurez mis à jour les fichiers .new avec toutes les modifications requises, renommez-les avec leur nom d’origine (sans le suffixe .new). Cela garantit que les applications sélectionnent les fichiers de configuration mis à jour contenant vos modifications personnalisées.
Annexe A. Historique des versions
Historique des versions | |||
---|---|---|---|
Version 6.3.0-5.1 | Fri May 27 2016 | Red Hat Localization Services | |
| |||
Version 6.3.0-5 | Thu May 5 2016 | Tomas Radej | |
| |||
Version 6.3.0-4 | Thu May 5 2016 | Tomas Radej | |
| |||
Version 6.3.0-3 | Thu Apr 28 2016 | Tomas Radej | |
| |||
Version 6.3.0-2 | Thu Apr 28 2016 | Tomas Radej | |
| |||
Version 6.3.0-1 | Thu Apr 28 2016 | Tomas Radej | |
|