16.3.3. Configuration mod_cluster sur httpd

Résumé

mod_cluster est un équilibreur de charges basé httpd. Il utilise un réseau de communication pour envoyer des requêtes de httpd vers un groupe de noeuds de serveur d'application. Les dérivatifs suivants peuvent être définis pour configurer mod cluster sur httpd.

Note

Il n'est nul besoin d'utiliser les directives ProxyPass car mod_cluster configure automatiquement les URL qui doivent être envoyés à JBossWEB.

Tableau 16.2. Dérivatifs mod_cluster

Dérivatif Description Valeurs
CreateBalancers Définit comment les équilibreurs de charge sont créés dans les hôtes virtuels httpd. Cela active les directives comme : ProxyPass /balancer://mycluster1/.
0: Créer tous les hôtes virtuels httpd
1: Ne pas créer d'équilibreurs (vous aurez besoin d'un ProxyPass ou d'un ProxyMatch au moins pour définir les noms des équilibreurs)
2: Ne créer que le serveur principal
Par défaut: 2

Note

Si vous utilisez la valeur 1, n'oubliez pas de configurer l'équilibreur dans la directive ProxyPass, car la valeur par défaut correspond à une session sticky vide. De plus nofailover=Off et les valeurs reçues via message MCMP CONFIG sont ignorées.
UseAlias Vérifier que l'alias corresponde bien au nom du serveur.
0: Ignorer les alias
1: Vérifier les alias
Par défaut: 0
LbstatusRecalTime Intervalle d'équilibrage de charge (en secondes) de la logique pour recalculer le statut d'un noeud.
Par défaut: 5 secondes
WaitForRemove Durée en secondes avant qu'un noeud supprimé soit oublié par httpd.
Par défaut: 10 secondes
ProxyPassMatch/ProxyPass
ProxyPassMatch et ProxyPass sont des directives mod_proxy qui, quand on utilise ! (à la place de l'url de back-end), évitent un proxy inverse sur le chemin d'accès. Utilisé pour autoriser httpd à fournir des informations statiques comme des images. Ainsi,
ProxyPassMatch ^(/.*\.gif)$ !
L'exemple ci-dessus permet à httpd de servir les fichiers .gif directement.
mod_manager

Le contexte d'une directive mod_manager est l'hôte virtuel dans tous les cas, sauf contre indication. Le contexte server config implique que la directive doit se trouver en dehors d'une configuration de l'hôte virtuel. Si tel n'est pas le cas, un message erreur apparaîtra et httpd ne démarrera pas.

Tableau 16.3. Dérivatifs mod_manager

Dérivatif Description Valeurs
EnableMCPMReceive Autorise l'hôte virtuel à recevoir MCPM des noeuds. Inclure EnableMCPMReceive dans la configuration httpd pour permettre au mod_cluster de fonctionner. Le sauvegarder dans l'hôte virtuel de configuration advertise.
MemManagerFile
Le nom de base pour les noms que mod_manager utilise pour stocker la configuration, générer des clés pour mémoire partagée ou fichiers verrouillés. Ce doit être un nom de chemin d'accès absolu; les répertoires seront créés si nécessaire. Il est recommandé que ces fichiers soient placés sur un lecteur local et non pas en NFS share.
Context: config serveur
$server_root/logs/
Maxcontext Le nombre maximum de contextes pris en charge par mod_cluster
Context: config serveur
Par défaut: 100
Maxnode Le nombre maximum de noeuds supportés par le mod_cluster.
Context: config serveur
Par défaut: 20
Maxhost Le nom maximum d'hôtes (alias) supportés par mod_cluster. Inclut également le nombre maximum d'équilibreurs de charge.
Context: config serveur
10
Maxsessionid
Le nombre d'ID de session actifs stockés afin de procurer le nombre de sessions actives du gestionnaire mod_cluster-manager. Une session est inactive quand mod_cluster ne reçoit aucune information de la session pendant 5 minutes.
Context: config serveur
Ce champ est à but de démonstration et débogage uniquement.
0: la logique n'est pas activée.
MaxMCMPMaxMessSize Taille maximum des messages MCMP en provenance d'autres directives max Calculé sur la base d'autres directives max. Min: 1024
ManagerBalancerName Le nom que l'équilibreur des charges utilise quand JBoss AS/JBossWeb/Tomcat ne fournit pas de nom d'équilibreur.
mycluster
PersistSlots Indique à mod_slotmem de persister les noeuds, les alias et les contextes dans des fichiers.
Context: config serveur
Off
CheckNonce Contrôle de la vérification de la valeur unique avec le gestionnaire mod_cluster=manager.
on/off
Par défaut: on - Nonce checked
AllowDisplay Contrôle des affichages supplémentaires sur la page principale du mod_cluster-manager.
on/off
Par défaut: off - only version is displayed
AllowCmd Autorise les commandes qui utilisent l'URL mod_cluster-manager.
on/off
Par défaut: on - Commands allowed
ReduceDisplay Réduit le montant d'informations affichées sur la page principale de mod_cluster-manager, afin qu'un plus grand nombre de noeuds puissent être affichés sur la page.
on/off
Default: off - full information is displayed
SetHandler mod_cluster-manager
Affiche des informations sur le nœud que mod_cluster voit dans le cluster. L'information comprend des informations génériques et compte aussi le nombre de sessions actives.
						
							<Location /mod_cluster-manager>
							SetHandler mod_cluster-manager
							Order deny,allow
							Allow from 127.0.0.1
							</Location>
						

on/off
Default: off

Note

Quand on accède à l'emplacement défini dans httpd.conf :
Transferred: Correspond aux données POST envoyées du serveur de back-end.
Connected: Correspond au nombre de requêtes traitées au moment où la page de statuts du mod_cluster a été demandée.
Num_sessions: Correspond au nombre de sessions que le rapport mod_cluster a reporté comme étant inactives (sur lesquelles il y a eu une requête au cours des 5 dernières minutes). Ce champ n'est pas présent quand Maxsessionid est égal à zéro. Ce champ est à but de démonstration et de débogage uniquement.