6.2. Mise en cluster d'un ensemble générique

1. 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épertoires Zookeeper ($ZOOKEEPER_HOME) et Helix ($HELIX_HOME) sont créés.
2. Veuillez maintenant configurer ZooKeeper :
   1. Dans le répertoire ZooKeeper, allez dans le répertoire conf et effectuez ce qui suit :

      cp zoo_sample.cfg zoo.cfg

   2. 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.
   3. 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
3. Installez ZooKeeper afin de l'utiliser lors de la création du cluster avec Helix :
   1. 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.
4. 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 :
   1. 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

   2. 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

5. 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

6. 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.
7. 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 &

Procédure 6.1. Arrêt de Helix et ZooKeeper

1. Arrêtez les processus du serveur JBoss EAP
2. Arrêtez le processus Helix créé par run-helix-controller.sh, par exemple kill -15 <pid of HelixControllerMain>.
3. Arrêtez le serveur ZooKeeper à l'aide de la commande zkServer.sh stop

1. 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 passe bpms. 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.
2. 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.
3. 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 fichier quartz-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, utilisez org.quartz.impl.jdbcjobstore.oracle.OracleDelegate).