[AIX Solaris HP-UX Linux Windows][z/OS]

Génération de la configuration du plug-in dans un environnement de haute disponibilité

Dans un environnement à haute disponibilité, vous pouvez configurer le serveur Web pour générer la configuration de plug-in. Ainsi, la configuration est générée par un processus dans la cellule, peu importe si les autres processus ne sont pas disponibles.

Avant de commencer

  • Mettez en place l'environnement de haute disponibilité. Pour plus d'informations, consultez la rubrique relative à la configuration d'un environnement à haute disponibilité.
  • L'utilisation du service de génération plugin-cfg à haute disponibilité ne désactive pas automatiquement la génération plugin-cfg ORD (routeur On Demand) si elle est activée. Ces deux services sont indépendants. L'activation des deux services génère une situation de redondance ; lorsque vous activez le service de génération plugin-cfg haute définition, désactivez la génération plugin-cfg ORD qui peut être activée. Pour plus d'informations, consultez la rubrique relative à la configuration d'un routeur ODR en vue de la mise à jour dynamique de la configuration du plug-in de serveur Web.
  • Si vous activez Gestion intelligente pour un serveur Web, n'utilisez pas l'option permettant de générer dynamiquement le fichier plugin-cfg.xml pour ce serveur Web. La génération dynamique du fichier plugin-cfg.xml remplace les paramètres Gestion intelligente dans le fichier plugin-cfg.xml.

Pourquoi et quand exécuter cette tâche

  • Définissez un ensemble de propriétés personnalisées au niveau de la cellule pour chaque fichier plugin-cfg.xml à générer. Les propriétés personnalisées apparaissent sous la forme ODCPluginCfg<propriété>_<IdDéfinition>=valeur, où <propriété> est l'un des éléments suivants :
    • OdrList
    • OutputPath
    • UpdateScript
    • OdrClusterList
    • Disabled
    La variable <IdDéfinition> est le nom de la configuration que vous choisissez. Les propriétés se terminant par la même variable <IdDéfinition> établissent une définition de génération unique au sein du service de génération de configuration de plug-in à haute disponibilité.
Remarque : La valeur ODCPluginCfgUpdateScript_<IdDéfinition> peut être définie avec les mêmes options que les valeurs qui figurent dans la zone de texte du script de modification de la configuration de plug-in. Pour plus d'informations, consultez la rubrique relative à la configuration d'un routeur ODR en vue de la mise à jour dynamique de la configuration du plug-in de serveur Web.
  • Pour générer des définitions HAPluginCfgGeneration à la demande :
    1. Désactivez la génération automatique. Associez la propriété personnalisée de cellule ODCPluginCfgDisabled_<IdDéfinition> à la valeur true.
    2. Pour générer un nouveau plug-in, exécutez la commande suivante :
      <WAS_HOME>/bin/wsadmin.sh -lang jython -f <WAS_HOME>/bin/manageODC.py generateHAPluginCfgs
      <IdDéfinitionGénération> <nomNoeud> <nomServeur>
      Où :
      IdDéfinitionGénération
      est une liste d'ID HAPluginCfgGeneration séparés par une virgule au format ODCPluginCfg_<IdDéfinition.
      nodeName
      est le nom du noeud qui effectue la génération.
      serverName
      est le nom du processus qui effectue la génération. Tout processus étendu d'Intelligent Management peut générer la configuration HAPluginCfgs à la demande, sauf les processus XDAGENT. Par exemple :
      <WAS_HOME>/bin/wsadmin.sh -lang jython -f <WAS_HOME>/bin/manageODC.py generateHAPluginCfgs
      ODCPluginCfg_1,ODCPluginCfg_2 dmgrNodeName dmgr
  • Pour limiter la fréquence à laquelle les définitions HAPluginCfgGeneration sont régénérées, associez la propriété personnalisée de cellule ODCPluginCfgMinGenerationDelay a une valeur qui représente l'intervalle en minutes entre les générations possibles. Exemple :
    ODCPluginCfgMinGenerationDelay = 10
    Les définitions HAPluginCfgGeneration configurées sont régénérées toutes les 10 minutes au plus. Si le générateur reçoit une notification pour la régénération de pluginCfgs, il retarde la génération des configurations pluginCfgs écrites au cours des 10 dernières minutes.
  • Pour limiter la fréquence à laquelle un fichier plugin-cfg.xml généré par un routeur On Demand est régénéré, associez la propriété JVM com.ibm.ws.odr.plugincfg.minGenerationDelay à une valeur qui représente l'intervalle en minutes entre les générations possibles, puis appliquez un cycle au routeur On Demand.
  • Par défaut, la valeur de pondération d'exécution statique configurée est utilisée pour inclure les processus de routeur On Demand arrêtés dans un fichier plugin-cfg.xml généré.
  • Pour inclure les processus de routeur On Demand arrêtés dans un fichier plugin-cfg.xml généré en fonction de la valeur de pondération d'exécution courante (toujours 0), configurez les paramètres suivants :
    • Pour HAPluginCfgGenerator, associez la propriété personnalisée de cellule ODCPluginCfgOdrIncludeStoppedStatic à la valeur false.
    • Pour les fichiers plugin-cfg.xml générés par un routeur On Demand, associez la propriété JVM com.ibm.ws.odr.plugincfg.odrIncludeStoppedStatic à la valeur false, puis appliquez un cycle au routeur On Demand.

Procédure

  1. Dans la console d'administration, cliquez sur Administration du système > Cellule > Propriétés personnalisées > Nouveau.
  2. Définissez les propriétés personnalisées suivantes :
    ODCPluginCfgOdrList_<IdDéfinition>=cell1:noeud1:odr1,cell2:noeud2:*,[cell1:noeud3:odr3],[cell1:noeud4:odr4]
    Cette propriété indique les routeurs ODR à inclure dans le fichier plugin-cfg.xml. Utilisez l'astérisque (*) comme caractère générique pour chaque segment de chemin.odr1 et odr2 sont définis comme serveurs principaux. odr3 et odr4 sont définis comme serveurs de sauvegarde.
    ODCPluginCfgOutputPath_<IdDéfinition>=/chemin/nom_fichier.txt
    Cette propriété indique l'emplacement où le fichier plugin-cfg.xml est placé après sa génération. Comme vous pouvez générer la configuration du plug-in sur n'importe quel noeud de la cellule, vous devez vérifier que le répertoire de sortie existe sur chaque noeud.
    ODCPluginCfgUpdateScript_<IdDéfinition>=/chemin/script <paramètre1> <paramètre2>
    Cette propriété définit le chemin d'accès absolu à votre script et les arguments à transmettre au script défini. Ce dernier sera appelé à chaque fois qu'un fichier plugin-cfg.xml est généré.
    ODCPluginCfgOdrClusterList_<IdDéfinition>=cell1:cluster1,cell1:cluster2,cell1:*,[cell1:cluster3],[cell1:cluster4]
    Cette propriété indique un cluster de routeurs ODR à inclure dans le fichier plugin-cfg.xml. Utilisez l'astérisque (*) comme caractère générique pour chaque segment de chemin. cluster1 et cluster2 sont définis comme serveurs principaux. cluster3 et cluster4 sont définis comme serveurs de sauvegarde.
    ODCPluginCfgDisabled_<IdDéfinition>
    Cette propriété désactive la génération d'une configuration sans désactiver toutes les propriétés de la configuration. La valeur par défaut est false.
    ODCPluginCfgOdrSessionIdCookie_<IdDéfinition>
    Définit le nom du cookie utilisé pour maintenir l'affinité entre IBM® HTTP Server et les routeurs ODR lorsque vous utilisez l'affinité de cellule des routeurs ODR.
    ODCPluginCfgIHSConfigProperties_<IdDéfinition>
    Cette propriété est utilisée à la place de la configuration des propriétés JVM (comme c'est le cas lors de la génération plugin-cfg.xml non-HA) pour définir les propriétés de configuration du serveur HTTP IBM. La valeur de cette propriété est une liste de paires ATTRIBUTE_NAME=value séparées par une virgule, où ATTRIBUTE_NAME est le nom d'un attribut représenté dans plugin-cfg.xml.

    Par exemple, si le nom de configuration est utilisé, la propriété de cellule ODCPluginCfgIHSConfigProperties_1 ayant la valeur TrustedProxyEnable=true,LogLevel=INFO,CloneSeparatorChange=true,ServerIOTimeout=60 est créée pour définir les attributs TrustedProxyEnable, LogeLevel, CloneSeparatorChange, et ServerIOTimeout contenus dans le fichier plugin-cfg.xml généré.

    ODCPluginCfgTrustedProxyList_<IdDéfinition>=proxysécurisé1,proxysécurisé2
    Cette propriété permet d'indiquer les systèmes proxy sécurisés à inclure dans le fichier plugin-cfg.xml.
    Voir Contrôle de la génération du fichier plugin-cfg.xml pour la liste des noms et des valeurs de propriétés valides.
Définissez les propriétés personnalisées de cellule suivantes afin de générer la configuration de plug-in pour un ensemble de routeurs ODR qui ne se trouvent pas dans un cluster de routeurs ODR. Notez que toutes les propriétés se terminent par la chaîne _1n qui les relie entre elles pour former une seule configuration.
Tableau 1. Propriétés personnalisées permettant de générer une configuration de plug-in pour des routeurs situés hors d'un cluster
Nom de la propriété Valeur de la propriété Description

ODCPluginCfgOdrList_1

myCell:*:*

Génère une configuration de plug-in qui achemine les données vers tous les routeurs ODR de la cellule myCell.

ODCPluginCfgOutputPath_1

/tmp/plugin-cfg1.xml

Copie la configuration de plug-in générée dans le fichier /tmp/plugin-cfg1.xml.

ODCPluginCfgUpdateScript_1

/root/bin/pluginCfgUpdate1

Chemin du script qui sera appelé à chaque fois que le fichier /tmp/plugin-cfg1.xml est mis à jour.

Définissez les propriétés personnalisées suivants pour générer la configuration de plug-in d'un cluster d'ODR nommé myCell/myOdrCluster. Notez que toutes les propriétés se terminent _2, ce qui les lie dans une même configuration.
Tableau 2. Propriétés personnalisées permettant de générer la configuration de plug-in de myCell/myOdrCluster
Nom de la propriété Valeur de la propriété Description

ODCPluginCfgOdrClusterList_2

myCell:myOdrCluster

Génère une configuration de plug-in qui achemine les données vers tous les routeurs ODR du cluster MyOdrCluster dans la cellule myCell.

ODCPluginCfgOutputPath_2

/tmp/plugin-cfg2.xml

Copie la configuration de plug-in générée dans le fichier /tmp/plugin-cfg2.xml.

ODCPluginCfgUpdateScript_2

/root/bin/pluginCfgUpdate2

Chemin du script exécuté à chaque mise à jour du fichier /tmp/plugin-cfg2.xml.

ODCPluginCfgOdrIncludeStopped_2

true ou false

Inclut ou exclut les routeurs ODR arrêtés.

Que faire ensuite

Comme la génération du fichier plugin-cfg.xml peut être exécutée dans n'importe quel noeud de la cellule, vous pouvez déterminer l'emplacement exact d'exécution du service de génération :

Dans la console d'administration, cliquez sur Opérations d'exécution > Stabilité du composant > Composants centraux. Vérifiez que HAPluginCfgGenerator est affiché dans le tableau.


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



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twve_haplugincfg
Nom du fichier : twve_haplugincfg.html