![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
Intelligent Management : contrôle de la génération du fichier plugin-cfg.xml
Vous pouvez remplacer les valeurs des attributs par défaut qui figurent dans le fichier plugin-cfg.xml généré automatiquement par le routeur On Demand (ODR).
Les éléments ci-après sont présentés sous la forme com.ibm.ws.odr.plugincfg.<élément>.<nomAttribut>, où <élément> est le nom du mot clé du fichier de configuration qui indique l'élément contenant un attribut et <nomAttribut> est le nom de l'attribut qui se trouve dans cet élément. Définissez les éléments sous forme de propriétés système de la machine virtuelle Java. Pour définir une propriété système de la machine JVM sur le routeur ODR dans la console d'administration, cliquez sur
.Config
Il s'agit du premier élément du fichier de configuration de plug-in. Il peut inclure un ou plusieurs des éléments et attributs ci-dessous.
- com.ibm.ws.odr.plugincfg.config.ASDisableNagle
- Indique si l'utilisateur souhaite désactiver l'algorithme Nagle pour la connexion entre le plug-in et le serveur.
La valeur par défaut est false.
- com.ibm.ws.odr.plugincfg.config.AcceptAllContent
- Indique si vous pouvez ou non inclure le contenu dans des requêtes POST, PUT, GET et HEAD lorsqu'un en-tête
Content-Length ou Transfer-encoding figure dans l'en-tête de la requête. Vous pouvez spécifier l'une des valeurs suivantes pour cet attribut :
- True si le contenu doit être attendu et lu pour toutes les demandes.
- False si le contenu doit être attendu et lu uniquement pour les demandes POST et PUT.
La valeur par défaut est false.
La valeur par défaut est true.
- com.ibm.ws.odr.plugincfg.config.AppServerPortPreference
- Spécifie le numéro de port qui est utilisé pour la génération de l'URI d'un objet sendRedirect.
La valeur par défaut est HostHeader.
- com.ibm.ws.odr.plugincfg.config.ChunkedResponse
- Indique si le plug-in doit regrouper la réponse au client lorsqu'un en-tête de réponse Transfer-Encoding : Chunked figure dans la réponse.
Vous pouvez spécifier l'une des valeurs suivantes pour cet attribut :
- True si le plug-in doit fractionner la réponse au client lorsqu'un en-tête de réponse Transfer-Encoding : Chunked figure dans la réponse,
- false si la réponse ne doit pas être tronçonnée.
La valeur par défaut est false.
- com.ibm.ws.odr.plugincfg.config.IISDisableNagle
- Indique si l'algorithme Nagle doit être désactivé.
La valeur par défaut est false.
- com.ibm.ws.odr.plugincfg.config.IISPluginPriority
- Indique la priorité en fonction de laquelle le serveur Web charge le plug-in. Vous pouvez indiquer l'une des valeurs suivantes pour cet attribut :
- High
- Medium
- Low
La valeur par défaut est High.
- com.ibm.ws.odr.plugincfg.config.IgnoreDNSFailures
- Indique si le plug-in doit ignorer les erreurs DNS dans une configuration au démarrage. Si l'attribut est associé à la valeur true, le plug-in ignore les erreurs DNS dans une configuration et démarre si au moins un serveur de chaque cluster de serveurs parvient à résoudre le nom d'hôte. Tout serveur pour lequel le nom d'hôte n'est pas résolu est indisponible pour la durée de vie de la configuration. Le nom d'hôte ne peut pas être résolu ultérieurement lors du routage des demandes. Si une erreur DNS survient, un message est enregistré dans le fichier journal du plug-in ; l'initialisation du plug-in continue et le serveur Web peut démarrer.
La valeur par défaut est false.
- com.ibm.ws.odr.plugincfg.config.RefreshInterval
- Fréquence, en secondes, à laquelle le plug-in doit rechercher des mises à jour et des modifications dans le fichier de configuration. Le plug-in recherche dans le fichier toutes les modifications apportées depuis le chargement de la configuration du plug-in.
La valeur par défaut est 60. Dans un environnement de développement dans lequel les modifications sont fréquentes, définissez une fréquence inférieure à 60 secondes. Dans un environnement de production, définissez une valeur supérieure à la valeur par défaut car la configuration n'est pas mise à jour souvent. Si le rechargement du plug-in n'aboutit pas, un message est enregistré dans le fichier journal du plug-in et la configuration précédente est utilisée jusqu'à ce que le rechargement du fichier de configuration du plug-in aboutisse. Consultez le fichier journal du plug-in pour plus d'informations en cas d'erreur.
- com.ibm.ws.odr.plugincfg.config.ResponseChunkSize
- Le fichier de plug-in lit le corps de la réponse en paquets de 64K jusqu'à ce que toutes les données de la réponse soient lues, ce qui réduit les performances dans le cas de requêtes dont le corps de la réponse contient une quantité élevée de données.
Servez-vous de cet attribut pour spécifier la taille de paquet maximale à utiliser lors de la lecture du corps de la réponse. Par exemple, Config ResponseChunkSize="N">, où N est égal à la taille de tronçon en kilo-octets.
Si la longueur du contenu du corps de la réponse est inconnue, une taille de mémoire tampon de N kilo-octets est allouée et le corps est lu en paquets de N kilo-octets, jusqu'à ce que l'intégralité du corps ait été lu. Si la longueur du contenu est connue, une taille de mémoire tampon de la longueur du contenu ou de N est utilisée pour la lecture du corps de la réponse.
La taille de paquet par défaut est de 64K.
- com.ibm.ws.odr.plugincfg.config.VHostMatchingCompat
- Indique que le numéro de port doit être utilisé pour la correspondance d'hôte virtuel. Vous pouvez spécifier les valeurs suivantes :
- True pour une correspondance physique en utilisant le numéro de port pour lequel la requête est reçue,
- False pour une correspondance logique en utilisant le numéro de port figurant dans l'en-tête de l'hôte.
La valeur par défaut est False.
- com.ibm.ws.odr.plugincfg.odrIncludeStopped
- Indique qu'il faut autoriser l'inclusion des routeurs ODR arrêtés. Vous pouvez spécifier les valeurs suivantes :
- True pour inclure les routeurs ODR arrêtés.
- False pour ne pas inclure les routeurs ODR arrêtés.
La valeur par défaut est False.
- com.ibm.ws.odr.plugincfg.config.TrustedProxyEnable
- Indique les systèmes proxy dignes de confiance. Vous pouvez spécifier les valeurs suivantes :
- True pour inclure les systèmes proxy dignes de confiance.
- False pour ne pas inclure les systèmes proxy dignes de confiance.
La valeur par défaut est False. Les systèmes proxy dignes de confiance sont collectés parmi les systèmes proxy de sécurité dignes de confiance de la page de la console d'administration
.
Journal
Le journal décrit l'emplacement et le niveau des messages de journal consignés par le plug-in. Si aucun journal n'est spécifié dans le fichier de configuration, les messages de journal peuvent être enregistrés dans le journal des erreurs.
- com.ibm.ws.odr.plugincfg.log.Name
- Chemin d'accès complet au fichier journal dans lequel le plug-in enregistre les messages d'erreur.
La valeur par défaut est profileRoot/logs/http_plugin.log.
- com.ibm.ws.odr.plugincfg.log.LogLevel
- Niveau de détail des messages de journal que le plug-in enregistre dans le journal. Vous pouvez spécifier l'une des valeurs suivantes pour cet attribut :
- Trace. Toutes les étapes du processus de demande sont consignées en détail.
- Stats. Le serveur sélectionné pour chaque demande, ainsi que d'autres informations d'équilibrage de charge liées à la gestion des demandes, sont consignés.
- Warn. Tous les messages d'avertissement et d'erreur résultant d'un traitement incorrect des demandes sont consignés.
- Error. Seuls les messages d'erreur résultant d'un traitement incorrect des demandes sont consignés.
- Debug. Toutes les étapes essentielles du traitement des requêtes sont consignées.
- Detail. Toutes les informations sur les demandes et les réponses sont consignées.
La valeur par défaut est Error.ATTENTION :Si vous sélectionnez le niveau trace, un nombre élevé de messages est consigné, ce qui peut entraîner une saturation rapide du système de fichiers. N'utilisez jamais le paramètre trace dans un environnement fonctionnant normalement afin de ne pas détériorer les performances.
ServerCluster
Cet élément est un groupe de serveurs généralement configuré pour le traitement d'un même type de requête.
Dans le cas le plus simple, le cluster contient une définition de serveur uniquement. Lorsque vous définissez plusieurs serveurs, le plug-in procède à l'équilibrage de la charge sur le serveurs définis à l'aide d'un algorithme de permutation circulaire ou aléatoire. La valeur par défaut est la permutation circulaire.
- com.ibm.ws.odr.plugincfg.cluster.CloneSeparatorChange
- Certaines unités mobiles ne peuvent pas traiter le caractère deux-points (:) utilisé pour séparer les ID clone en conjonction avec l'affinité de session. Cet attribut indique au plug-in que le caractère de séparation des clones est le signe plus (+). Vous devez changer les configurations de serveur de sorte que le serveur sépare aussi les ID clone à l'aide du signe plus.
La valeur par défaut est false.
- com.ibm.ws.odr.plugincfg.cluster.LoadBalance
- Le point de départ de l'implémentation de la permutation circulaire est aléatoire. Le premier serveur est sélectionné aléatoirement et la valeur de permutation circulaire est utilisée pour sélectionner les serveurs à partir de ce point, vers l'avant. Dans un environnement comportant plusieurs serveurs Web reposant sur des processus, cette implémentation permet d'assurer que tous les processus n'envoient pas leur première requête au même serveur.
Le type d'équilibrage de charge par défaut est Permutation circulaire.
- com.ibm.ws.odr.plugincfg.cluster.PostSizeLimit
- Nombre maximal d'octets de contenu de requête autorisé pour que le plug-in tente d'envoyer la requête à un serveur. Si la taille d'une requête reçue est supérieure à cette valeur, le plug-in y met fin.
La valeur par défaut est de -1 octets, ce qui signifie qu'il n'existe pas de limite de taille pour les articles.
- com.ibm.ws.odr.plugincfg.cluster.RemoveSpecialHeaders
- Le plug-in ajoute des en-têtes spéciaux à la requête avant son réacheminement vers le serveur. Ces en-têtes stockent des informations sur la requête qui seront utilisées par l'application. Par défaut, le plug-in retire ces en-têtes des requêtes entrantes avant d'ajouter les en-têtes requis.
La valeur par défaut est true. Si vous associez l'attribut à la valeur false, vous exposez votre système en ne supprimant pas les en-têtes des requêtes entrantes.
- com.ibm.ws.odr.plugincfg.cluster.RetryInterval
- Entier spécifiant le temps écoulé entre le moment où un serveur est considéré comme arrêté et la nouvelle tentative que le plug-in effectue pour établir une connexion.
La valeur par défaut est 60 secondes.
Server
Cet élément est une instance de serveur configurée pour le traitement des requêtes qui lui parviennent selon les stratégies de routage figurant dans la configuration de plug-in. L'élément server correspond à un serveur d'applications exécuté sur le poste de travail local ou sur un poste de travail éloigné.
- com.ibm.ws.odr.plugincfg.server.ServerIOTimeout
- Active le plug-in de définition d'une valeur de délai d'attente, en secondes, pour envoyer des demandes au serveur et pour lire les réponses du serveur. Lorsque vous sélectionnez une valeur pour cet attribut, tenez compte des points suivants :
- Un serveur peut prendre plusieurs minutes pour traiter une demande. La définition de la valeur de l'attribut ServerIOTimeout de manière trop basse peut causer l'envoi par le plug-in d'une réponse d'erreur de serveur erronée au client.
- Si une valeur n'est pas définie, le plug-in utilise la valeur par défaut pour écrire des demandes sur le serveur et pour lire les réponses du serveur jusqu'à ce que la connexion TCP expire. La valeur par défaut est 900.
- Remarque : Pour les versions de produit plus anciennes, la valeur par défaut est 0. Si le plug-in utilise la valeur de délai d'attente par défaut 0, une erreur peut survenir.
Pour plus d'informations sur la configuration de l'attribut ServerIOTimeout, voir la note technique sur la configuration des plug-ins de serveur Web.
- com.ibm.ws.odr.plugincfg.server.ConnectTimeout
- Permet au plug-in d'établir des connexions non bloquantes au serveur d'applications, ce qui est utile lorsque le plug-in ne parvient pas à contacter la destination afin de déterminer si le port est disponible ou non.
Si aucune valeur n'est spécifiée, le plug-in établit une connexion bloquante ; dans ce cas, le plug-in attend jusqu'à ce qu'un système d'exploitation dépasse le délai d'attente et signale que le serveur est indisponible. Une valeur supérieure à 0 correspond au nombre de secondes pendant lequel le plug-in attend l'établissement d'une connexion. Si la connexion n'est pas établie après cette période, le plug-in signale que le serveur est indisponible et passe à l'un des autres serveurs définis dans le cluster.
La valeur par défaut est 0.
- com.ibm.ws.odr.plugincfg.server.ExtendedHandShake
- Utilisé lorsqu'un pare-feu de proxy existe entre le plug-in et le serveur d'applications. Dans ce cas, le plug-in ne peut pas basculer sur un autre serveur.
Le plug-in signale qu'un serveur est arrêté à la fin de la méthode connect(). Toutefois, lorsqu'un pare-feu de proxy existe entre le plug-in et le serveur d'applications, la méthode connect() aboutit, même si le serveur d'applications d'arrière-plan est arrêté. En conséquence, le plug-in ne parvient pas à basculer sur d'autres serveurs d'applications.
Cet attribut garantit le démarrage du plug-in avant l'envoi de la requête.
La valeur par défaut est false.
- com.ibm.ws.odr.plugincfg.server.MaxConnections
- Spécifie le nombre maximal de connexions à un serveur qui sont en attente et qui passent par un processus de serveur Web à un moment ou à un autre.
La valeur par défaut est -1.
- com.ibm.ws.odr.plugincfg.cluster.WaitForContinue
- Indique si le support HTTP 1.1 100 Continue doit être utilisé avant l'envoi du contenu de la requête au serveur d'applications. La valeur par défaut est false. Le plug-in n'attend pas que le serveur d'applications envoie la réponse 100 Continue avant d'envoyer le contenu de la requête.
Cette propriété est ignorée pour les requêtes POST afin d'éviter toute erreur si le serveur d'applications ferme une connexion en raison du dépassement du délai d'attente.
Activez cette fonction lors de la configuration du plug-in en vue de son utilisation avec certains types de pare-feu de proxy.
Propriété
- com.ibm.ws.odr.plugincfg.property.ESIEnable
- Utilisé pour activer ou désactiver le processeur ESI (Edge Side Include). Si le processeur ESI est désactivé, les autres éléments ESI du fichier sont ignorés.
La valeur par défaut est true.
- com.ibm.ws.odr.plugincfg.property.ESIMaxCacheSize
- Entier spécifiant, en kilooctets, la taille maximale du cache. La taille maximale par défaut de la mémoire cache est de 1024K octets (1 mégaoctet). Si la mémoire cache est pleine, la première entrée supprimée est celle qui est la plus proche de l'expiration.
- com.ibm.ws.odr.plugincfg.property.ESIInvalidationMonitor
- Indique si le processeur ESI reçoit ou non des invalidations du serveur d'applications.
La valeur par défaut est false.
- com.ibm.ws.odr.plugincfg.property.https.keyring
- Cet élément permet de spécifier les paramètres d'initialisation lorsque le protocole de transport est HTTPS.
Cet attribut est un nom pris en charge reconnu par le transport. La valeur par défaut pour l'élément de fichier de clés est racine_profil/etc/plugin-key.kdb.
- com.ibm.ws.odr.plugincfg.property.https.stashfile
- La valeur par défaut pour le fichier de dissimulation est racine_profil/node/etc/plugin-key.sth
- com.ibm.ws.odr.plugincfg.property.PluginInstallRoot
- Indique le chemin d'installation du plug-in. La valeur par défaut est "". Indiquez le chemin complet de la racine d'installation du plug-in. Sinon, la propriété n'est pas affichée dans le fichier plugin-cfg.xml.
Remarques sur la génération du fichier plugin-cfg.xml
- Désactivez la génération automatique. Associez la propriété personnalisée de cellule ODCPluginCfgDisabled_<IdDéfGén> à la valeur true.
- Pour générer un nouveau plug-in, exécutez la commande suivante :
Où :<WAS_HOME>/bin/wsadmin.sh -lang jython -f <WAS_HOME>/bin/manageODC.py generateHAPluginCfgs <IdDéfinitionGénération> <nomNoeud> <nomServeur>
- IdDéfinitionGénération
- est une liste d'ID HAPluginCfgGeneration séparés par une virgule au format ODCPluginCfg_<IdDéfGén.
- nomNoeud
- est le nom du noeud qui effectue la génération.
- nomServeur
- 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. Exemple :
<WAS_HOME>/bin/wsadmin.sh -lang jython -f <WAS_HOME>/bin/manageODC.py generateHAPluginCfgs ODCPluginCfg_1,ODCPluginCfg_2 dmgrNodeName dmgr
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 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.