Configuration du routage dynamique pour une seule collectivité Liberty

Vous pouvez configurer la fonction Dynamic Routing pour router les demandes HTTP vers les membres de 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.

Avant de commencer

Effectuez les étapes d'installation du produit décrites dans Configuration de la fonction de routage dynamique pour les collectivités Liberty.

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.

[17.0.0.1 and later]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.

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 qui sont activés par la fonction Dynamic Routing.
  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
    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.

  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

    Pour z/OS, voir Conversion du magasin de clés au format CMS sur z/OS.

  6. 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/.
  7. 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>
  8. Démarrez le serveur Web et commencez le routage vers l'application installée dans la collectivité.
  9. 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>
  10. [17.0.0.1 and later]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.

Résultats

Avec la fonction dynamicRouting-1.0 activée, Intelligent Management peut désormais router dynamiquement les demandes HTTP vers les collectivités Liberty.


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

Nom du fichier : twlp_wve_enabledynrout_single.html