La fonction Dynamic Routing permet le routage
des
demandes HTTP vers les membres des collectivités Liberty sans qu'il
soit nécessaire de regénérer le fichier de configuration de plug-in
WebSphere lorsque
l'environnement change. Lorsque des serveurs, des membres de cluster,
des applications ou des hôtes virtuels sont ajoutés, retirés,
démarrés, arrêtés ou modifiés, les nouvelles informations sont
livrées de façon dynamique
au plug-in WebSphere. Les
demandes sont routées à partir d'informations à jour. 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 également trois nouvelles actions de commande de
collectivité. Ces actions
sont utilisées conjointement pour générer un magasin de clés
qui est nécessaire une
communication sécurisée entre le plug-in et le service Dynamic
Routing,
ainsi qu'un fichier de configuration de plug-in qui active
Intelligent Management
dans le plug-in
WebSphere.
Avant de commencer
Important : Le correctif temporaire pour
Intelligent Management
dans le plug-in du serveur Web pour
WebSphere Application
Server APAR numéro PI27023 est nécessaire pour l'utilisation de la
fonction Dynamic Routing. Vous devez installer un serveur Web qui est
pris en charge par le plug-in du serveur Web pour
WebSphere Application
Server, par exemple IBM HTTP Server, installer la version 8.5.5 ou
suivante des plug-in de serveur Web pour
WebSphere Application
Server, puis installer le correctif temporaire avant d'activer la
fonction Dynamic Routing.
- Téléchargez et installer la dernière version
d'IBM
Installation Manager. Pour plus d'informations sur IBM
Installation Manager, voir
Installing Installation Manager and preparing to install the
product.
- Utilisez Installation Manager pour accéder aux référentiels de
produit en ligne et
installer le plug-in du serveur Web pour
WebSphere Application
Server et le correctif temporaire
nécessaire pour la fonction Dynamic Routing. Pour afficher les
préférences d'interface graphique d'Installation Manager,
sélectionnez Fichier >
Préférences . Utilisez Installation Manager pour installer le produit à partir du
référentiel Web disponible à l'adresse
http://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLGILAN.v85
Remarque : Vous avez besoin d'un ID IBM pour accéder au référentiel. Ce
référentiel est uniquement destiné aux plateformes réparties.
- Utilisez l'assistant d'installation pour
installer les plug-in de serveur Web et le correctif
temporaire
nécessaire.
- Lorsque vous y êtes invité par l'assistant, indiquez le
répertoire d'installation et poursuivez l'installation.
Lecture : La vidéo
Enabling
IHS for Liberty Dynamic Routing video explique comment
installer IHS, comment installer le plug-in de serveur Web pour
WebSphere Application Server, et comment appliquer le correctif
temporaire pour le routage dynamique.
[Transcription]
Pourquoi et quand exécuter cette tâche
Pour utiliser Intelligent Management pour le routage des
demandes HTTP vers une collectivité Liberty, l'utilisateur doit
activer la fonction Dynamic Routing
sur un ou
plusieurs contrôleurs d'une collectivité.
Procédure
- 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 sur lesquels la fonction Dynamic
Routing est activée.
- 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
Pour plus d'informations sur les commandes Dynamic Routing, voir
Commande de routage dynamique.
Remarque : Assurez-vous
qu'un nom d'utilisateur (valeur de l'argument
--user) est présent
dans un registre d'utilisateurs et que le rôle d'administration lui
est affecté.
- 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
- Copiez les fichiers the plugin-key.kdb,
plugin-key.rdb et
plugin-key.sth qui sont créés par
gskcmd du répertoire temporaire
vers le répertoire <value of the
--pluginInstallRootargument>/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 d'IBM HTTP Server (IHS). 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 :
<IntelligentMangement>
<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é.
Il est possible aussi d'ajouter la balise
<dynamicRouting> dans le fichier
server.xml du contrôleur afin de
spécifier des propriétés
<ConnectorCluster>
comme
maxRetries et
retryInterval. Exemple :
<dynamicRouting maxRetries="4" retryInterval="20" connectorClusterName="collective1"/>
<TraceSpecification name="default" specification=":DEBUG"/>
</dynamicRouting>
Le fichier
plugin-cfg.xml généré ressemble
à ceci :
<IntelligentMangement>
<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>
Résultats
Avec la fonction
Dynamic
Routing activée,
Intelligent Management peut désormais router de manière
dynamique les demandes HTTP
vers les collectivités Liberty.