Groupes de grappes JBoss

Les grappes JBoss sont basées sur un module de communication nommé JGroups. JGroups est installé avec JBoss (il peut également être utilisé sans JBoss). JGroups permet la communication entre les groupes, qui partagent un nom commun, une adresse de multidiffusion et un port de multidiffusion.

Lorsque vous installez un serveur JBoss en grappe, JBoss définit deux groupes JGroups différents pour la gestion de la grappe. L'un se nomme DefaultPartition et est défini dans /deploy/cluster-service.xml. Ce groupe de grappes est utilisé par JBoss pour fournir les principaux services de mise en grappe. JBoss définit également un second groupe de grappes nommé Tomcat-Cluster. Ce groupe de grappes est défini dans /deploy/tc-cluster-service.xml. Ce groupe de grappes fournit la réplication de session pour le serveur Tomcat qui s'exécute à l'intérieur de JBoss.

L'application utilisateur Identity Manager utilise un troisième groupe de grappes. Ce groupe de grappes utilise un nom UUID pour réduire le risque de conflit avec d'autres groupes de grappes que les utilisateurs peuvent ajouter à leurs serveurs. Par défaut, le groupe de grappes se nomme c373e901aba5e8ee9966444553544200. Cette grappe n'est pas configurable à l'aide d'un fichier de service JBoss. À la place, les paramètres de configuration se trouvent dans le répertoire et peuvent être configurés à l'aide des fonctions d'administration de l'application utilisateur. Si vous connaissez bien JGroups et la mise en grappe JBoss, vous pouvez régler la configuration en grappe de l'application utilisateur à l'aide de cette interface. Les modifications apportées à la configuration en grappe ne prennent effet pour un noeud que lorsque ce dernier est redémarré.

Le groupe de grappes de l'application utilisateur n'est utilisé que pour coordonner les caches de l'application utilisateur d'un environnement en grappe. Il est indépendant des deux groupes de grappes de JBoss et n'interagit avec eux en aucune manière. Par défaut, le groupe de grappes de l'application utilisateur et les deux groupes de grappes de JBoss utilisent des noms de groupes, des adresses de multidiffusion et des ports de multidiffusion différents, de sorte qu'il n'est pas nécessaire de procéder à une nouvelle configuration.

Les paramètres du groupe de grappes de l'application utilisateur sont partagés par toute application Identity Manager 3 qui partage la configuration de l'annuaire. L'objectif de l'option des paramètres locaux dans l'interface d'administration de l'application utilisateur est de permettre à un administrateur de supprimer un noeud d'une grappe ou de changer l'appartenance des serveurs à une grappe. Par exemple, vous pouvez désactiver globalement la mise en grappe, puis l'activer localement pour un sous-ensemble de vos serveurs partageant la configuration de l'annuaire.

Mise en batterie d'applications

JBoss permet d'effectuer le déploiement à chaud sur une grappe en copiant un fichier EAR, WAR ou JAR de l'application dans le répertoire de la batterie d'une instance de JBoss en grappe. Le déploiement à chaud sur une machine provoque le déploiement automatique de ce composant sur toutes les instances de la grappe, tandis que la grappe fonctionne.

Cette forme de déploiement d'application n'est pas recommandée avec la version du serveur d'applications JBoss (4.0.2) incluse avec le programme d'installation de l'application utilisateur au moment de la rédaction de ce document. Il existe en effet des problèmes non résolus liés à son utilisation. Toutefois, vous disposez des étapes de base que vous devez respecter (reportez-vous à Déploiement de l'application utilisateur dans une grappe en utilisant la mise en batterie JBoss) pour déployer l'application utilisateur en utilisant la technologie de mise en batterie de JBoss. Des améliorations de cette technologie peuvent apparaître après la publication de ce document.

Base de données MySQL

Le programme d'installation de l'application utilisateur installe le gestionnaire de base de données MySQL et crée une base de données utilisable avec l'application utilisateur, ou il utilise une base de données Oracle, Microsoft SQL Server ou MySQL existante. La base de données est responsable de la persistance des données. Tous les noeuds de la grappe JBoss doivent accéder à la même instance de la base de données. L'application utilisateur utilise des appels JDBC standard pour accéder à la base de données et la mettre à jour. L'application utilisateur utilise une source de données JDBC liée à l'arborescence JNDI pour ouvrir une connexion vers la base de données. Si vous créez la grappe JBoss en utilisant le programme d'installation de l'application utilisateur, la source de données est installée automatiquement. Si vous choisissez d'installer la grappe JBoss manuellement, vous devez copier la source de données (fichier IDM-ds.xml) vers le répertoire deploy de tous les noeuds de votre grappe. En outre, si vous utilisez MySQL, vous devez copier le pilote MySQL JDBC (mysql-connector-java-3.1.10-utf8-clob-fix-bin.jar), situé dans le répertoire JBoss /server/IDM/lib directory, vers le répertoire JBoss server/IDM/lib.

Consignation

Pour activer la consignation des grappes, vous devez modifier le fichier de configuration log4j.xml, situé dans le répertoire \conf de la configuration du serveur JBoss (par exemple, \server\IDM\conf), et supprimer les commentaires de la section située en bas et qui ressemble à :

<!--  Clustering logging 
  --> 
- <!-- 
 Uncomment the following to redirect the org.jgroups and
      org.jboss.ha categories to a cluster.log file.
   <appender name="CLUSTER" class="org.jboss.logging.appender.RollingFileAppender">
     <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>
     <param name="File" value="${jboss.server.home.dir}/log cluster.log"/>
     <param name="Append" value="false"/>
     <param name="MaxFileSize" value="500KB"/>
     <param name="MaxBackupIndex" value="1"/>
     <layout class="org.apache.log4j.PatternLayout">
       <param name="ConversionPattern" value="%d %-5p [%c] %m%n"/>
     </layout>
   </appender>
   <category name="org.jgroups">
     <priority value="DEBUG" />
     <appender-ref ref="CLUSTER"/>
   </category>
   <category name="org.jboss.ha">
     <priority value="DEBUG" />
     <appender-ref ref="CLUSTER"/>
   </category>
  --> 

Vous trouverez le fichier cluster.log dans le répertoire log de la configuration du serveur JBoss (par exemple, \server\IDM\log).

Utilisation du programme d'installation de l'application utilisateur sur chaque noeud de la grappe

JBoss est fourni avec trois configurations de serveur différentes prêtes à l'emploi : minimale, par défaut et tout. La mise en grappe n'est activée que dans la configuration tout. Un fichier cluster-service.xml, dans le dossier /deploy, décrit la configuration de la partition de grappe par défaut. Lorsque vous installez l'application utilisateur et indiquez au programme d'installation que vous voulez effectuer l'installation dans une grappe, le programme d'installation effectue une copie de toute la configuration, nomme la copie IDM (par défaut ; le programme d'installation permet de modifier ce nom) et installe l'application utilisateur dans cette configuration.

Déploiement de l'application utilisateur dans une grappe en utilisant la mise en batterie JBoss

N'utilisez pas la mise en batterie JBoss avec JBoss 4.0.2 ou une version précédente, car vous risquez de rencontrer des problèmes (reportez-vous au site http://jira.jboss.com/jira/browse/JBAS-1899). Nous vous recommandons d'installer l'application utilisateur, en utilisant le programme d'installation de l'application utilisateur, sur chaque noeud de la grappe (reportez-vous à Utilisation du programme d'installation de l'application utilisateur sur chaque noeud de la grappe dans ce chapitre). Toutefois, si vous voulez utiliser la mise en batterie pour déployer l'application utilisateur sur une grappe avec JBoss 4.0.3 ou une version ultérieure, procédez de la façon suivante.