[8.5.5.4 ou ultérieure]

Configuration de la fonction Dynamic Routing pour les collectivités Liberty

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.
  1. 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.
  2. 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.
  3. Utilisez l'assistant d'installation pour installer les plug-in de serveur Web et le correctif temporaire nécessaire.
  4. Lorsque vous y êtes invité par l'assistant, indiquez le répertoire d'installation et poursuivez l'installation.

Multimédia 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

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

  2. Démarrez tous les contrôleurs sur lesquels la fonction Dynamic Routing est activée.
  3. 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é.
  4. 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.
  5. 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
  6. 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>/
  7. 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>
  8. 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.

Icône indiquant le type de rubrique Rubrique Tâche

Dispositions pour les centres de documentation | Commentaires


Icône d'horodatage Dernière mise à jour: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_wve_enabledynrout
Nom du fichier : twlp_wve_enabledynrout.html