Pourquoi et quand exécuter cette tâche
Pour utiliser Intelligent Management en vue de router les
demandes HTTP vers une collectivité Liberty, vous devez
activer la fonction dynamicRouting-1.0
sur un ou
plusieurs contrôleurs de cette collectivité.
La fonction
fournit le service
Dynamic Routing, lequel extrait de manière dynamique les
informations de routage du référentiel de collectivité et fournit ces
informations au plug-in
WebSphere. La fonction fournit aussi la commande
dynamicRouting. Utilisez ses actions setup,
genPluginCfg et genKeystore ensemble
pour générer les magasins de clés nécessaires à la communication sécurisée entre
le plug-in et le service Dynamic
Routing, ainsi qu'un fichier de configuration activant Intelligent Management dans le plug-in WebSphere plug-in.
Les règles de routage permettent au plug-in WebSphere
de router les demandes qu'il reçoit vers un ensemble spécifique de serveurs. Elles offrent aussi une capacité de rejet ou de redirection sélective des
demandes. Cette sélection est réalisée par la confrontation des attributs de la demande entrante
aux règles de routage.
- Activez Dynamic Routing sur un contrôleur en ajoutant le code
suivant à la balise
featureManager dans le fichier
server.xml du contrôleur.
<feature>dynamicRouting-1.0</feature>
- Démarrez tous les contrôleurs qui sont activés par la fonction Dynamic Routing.
- Exécutez la commande dynamicRouting
setup sur l'un des contrôleurs afin de
générer le magasin de clés et les fichiers de configuration de
plug-in. Par
exemple :
./dynamicRouting setup --port=9444 --host=controller1.acme.com --user=admin --password=passw0rd --keystorePassword=webAS --pluginInstallRoot=/opt/HTTPServer_Plugins/ --webServerNames=webserver1
Remarque : Assurez-vous que la valeur spécifiée pour l'argument --user correspond à une entrée
existante dans l'annuaire d'utilisateur, à laquelle un rôle administratif est attribué.
Pour plus d'informations, voir Commande de routage dynamique.
- Copiez les fichiers
plugin-key.jks
et plugin-cfg.xml générés
dans un répertoire temporaire sur l'hôte de serveur Web.
- Sur l'hôte du serveur Web, exécutez la commande
gskcmd (incluse dans le
package IHS) pour convertir le
format cms de clés et certificat personnel par défaut. Le format CMS
est le format pris en charge du plug-in
WebSphere. Par
exemple :
gskcmd -keydb -convert -pw webAS -db /tmp/plugin-key.jks -old_format jks -target /tmp/plugin-key.kdb -new_format cms -stash
gskcmd -cert -setdefault -pw <<password>> -db /tmp/plugin-key.kdb -label default
Pour z/OS, voir Conversion du magasin de clés au format CMS sur z/OS.
- Copiez les fichiers plugin-key.kdb,
plugin-key.rdb et
plugin-key.sth qui sont créés par
gskcmd du répertoire temporaire
vers le répertoire --pluginInstallRootargument_value/config/web_server_name/.
- Copiez le fichier plugin-cfg.xml dans le
répertoire
spécifié dans la directive
WebSpherePluginConfig
dans le fichier httpd.conf du serveur web. Le fichier plugin-cfg.xml est généré
avec la section <IntelligentManagement>. Lorsque la fonction Dynamic Routing est activée dans une
collectivité, il y a une section <Connector>
pour chaque contrôleur de collectivité.
Exemple :
<IntelligentManagement>
<Property name="webserverName" value="webServer1"/>
<ConnectorCluster enabled="true" maxRetries="-1" name="default" retryInterval="60">
<Property name="uri" value="/ibm/api/dynamicRouting"/>
<Connector host="controller1.acme.com" port="9444" protocol="https">
<Property name="keyring" value="/opt/HTTPServer_Plugins/config/webserver1/plugin-key.kdb"/>
</Connector>
</ConnectorCluster>
</IntelligentManagement>
- Démarrez le serveur Web et commencez le routage vers l'application
installée dans la collectivité.
- Facultatif : Ajoutez l'élément <dynamicRouting> au fichier
server.xml du contrôleur pour spécifier les propriétés de routage dynamique.
La propriété connectorClusterName spécifie le nom que le routage dynamique
associe à la collectivité. Si la propriété connectorClusterName n'est pas
spécifiée, le nom de la collectivité est utilisé. La propriété retryInterval indique combien de temps attendre avant de tenter
une reconnexion au contrôleur si la tentative précédente a échoué. La propriété
maxRetries indique combien de fois la reconnexion à un contrôleur de collectivité
peut être tentée.
Exemple :
<dynamicRouting maxRetries="4" retryInterval="20" connectorClusterName="collective1"/>
<TraceSpecification name="default" specification=":DEBUG"/>
</dynamicRouting>
Le fichier
plugin-cfg.xml généré contient les propriétés suivantes
dans sa section
<ConnectorCluster> :
<IntelligentManagement>
<TraceSpecification name="default" specification=":DEBUG"/>
<Property name="webserverName" value="webServer1"/>
<ConnectorCluster enabled="true" maxRetries="4" name="collective1" retryInterval="20">
<Property name="uri" value="/ibm/api/dynamicRouting"/>
<Connector host="controller1.acme.com" port="9444" protocol="https">
<Property name="keyring" value="/opt/HTTPServer_Plugins/config/webServer1/plugin-key.kdb"/>
</Connector>
</ConnectorCluster>
</IntelligentManagement>
Optionnel : créez des règles de routage pour spécifier comment certaines demandes doivent être
traitées. Les règles de routage peuvent spécifier les actions suivantes :
- Rejeter des demandes spécifiques.
- Rediriger des demandes spécifiques.
- Autoriser certaines demandes à être routées vers un sous-ensemble des serveurs disponibles.
- Basculer des demandes spécifiques d'un ensemble de serveur à un autre en cas de défaillance du premier.
Reportez-vous aux rubriques
Règles de routage pour le routage dynamique Liberty et Configuration des règles de routage pour le routage dynamique Liberty.