Propriétés personnalisées du serveur proxy HTTP

Vous pouvez ajouter les propriétés personnalisées suivantes aux paramètres d'un serveur proxy HTTP.

Pour définir des propriétés personnalisées pour un serveur proxy HTTP spécifique, accédez à la page des propriétés personnalisées et indiquez une valeur pour la propriété personnalisée.

  1. Dans la console d'administration, développez Serveurs > Types de serveur > Serveurs proxy WebSphere > nom_serveur_proxy pour ouvrir l'onglet de configuration du serveur.
  2. Développez Paramètres du serveur proxy HTTP, cliquez sur Paramètres du proxy.
  3. Dans le menu Propriétés supplémentaires, sélectionnez Propriétés personnalisées > Nouvelle.
  4. Dans la page Paramètres, indiquez la propriété à configurer dans la zone Nom, et la valeur à lui associer dans la zone Valeur.
  5. Cliquez sur Appliquer ou sur OK.
  6. Cliquez sur Sauvegarder dans la barre des tâches de la console d'administration pour sauvegarder les modifications apportées à la configuration.
  7. Redémarrez le serveur.

cache.ignore.header.Authorization

Indique que le proxy ignorera l'en-tête d'autorisation dans les demandes si vous définissez la propriété personnalisée sur true. Si la réponse peut également être mise en cache, le proxy la mettra en cache.

Information valeur
Type de donnée Boolean
Valeur par défaut false

cache.ignore.header.Cookie

Indique si le proxy doit ignorer l'en-tête cookie dans les demandes si vous définissez la propriété personnalisée sur true. Si la réponse peut également être mise en cache, le proxy la mettra en cache.

Information valeur
Type de donnée Boolean
Valeur par défaut false

cache.ignore.header.Proxy-Authorization

Indique que le proxy ignorera l'en-tête d'autorisation du proxy dans les demandes si vous définissez la propriété personnalisée sur true. Si la réponse peut également être mise en cache, le proxy la mettra en cache.

Information valeur
Type de donnée Boolean
Valeur par défaut false

cache.query.string

Indique si le générateur de clés de cache proxy par défaut utilise à la fois le chemin d'URL et les données de la chaîne de requête pour générer la clé de cache. Pour activer cette fonction, affectez à la propriété personnalisée la valeur "true". Toutefois, si vous utilisez la mise en antémémoire ESI (Edge Side Include) sur le serveur relais, cette propriété personnalisée n'est pas utilisée. Si vous ne définissez par cette propriété personnalisée, le serveur relais génère une clé de cache basée uniquement sur le chemin de l'URL (sans les données de la chaîne de requête).

Pour plus d'informations sur la mise en antémémoire avec ESI, voir la rubrique relative à la configuration de la mise en antémémoire Edge Side Include.

Information valeur
Type de donnée String (chaîne)

http.auto.redirect.correction

Indique si le serveur proxy doit tenter de corriger la valeur dans l'en-tête d'emplacement lorsqu'une réponse 302 est renvoyée par le cluster de serveurs génériques.

Si vous spécifiez none pour cette propriété, le serveur proxy ne tente jamais de corriger la valeur dans l'en-tête d'emplacement lorsqu'une réponse 302 est renvoyée.

Si vous spécifiez gsc pour cette propriété, le serveur proxy tente de corriger la valeur dans l'en-tête d'emplacement uniquement lorsque la réponse 302 est renvoyée par le cluster de serveurs génériques.

Si vous spécifiez managed pour cette propriété, le serveur proxy tente de corriger la valeur dans l'en-tête d'emplacement uniquement lorsque la réponse 302 est renvoyée par un serveur géré.

Si vous spécifiez all pour cette propriété, le serveur proxy tente de corriger la valeur dans l'en-tête d'emplacement dès qu'une réponse 302 est renvoyée.

Eviter les incidents Eviter les incidents: La règle de réécriture de jonction remplace la valeur spécifiée pour cette propriété personnalisée. gotcha
Information valeur
Type de donnée String (chaîne)
Valeurs admises none, gsc, managed, ou all
Valeur par défaut gsc

http.cache.nocache.headers

Indique les en-têtes set-cookie que vous ne souhaitez pas mettre en cache lorsque le serveur proxy reçoit une réponse. Par défaut, le serveur proxy stocke les en-têtes set-cookie dans le cache du proxy. Si les informations d'en-tête Cache-Control ne sont pas correctement définies, le serveur proxy peut stocker certains cookies privés de l'utilisateur, relatifs aux sessions. Vous pouvez utiliser cette propriété personnalisée pour indiquer les en-têtes set-cookie que vous ne souhaitez pas stocker dans le cache du proxy.

Information valeur
Type de donnée Chaîne de noms d'en-tête HTTP séparés par des virgules

Par exemple, vous pouvez fournir les valeurs suivantes : Set-Cookie,Set-Cookie2. Par conséquent, le serveur proxy ne stocke pas les en-têtes HTTP Set-Cookie et Set-Cookie2 dans le cache du proxy.

http.clientInfoFromTrustedIntermediary

Indique si le proxy doit extraire l'adresse IP d'un en-tête WebSphere Application Server privé contenu dans une demande. Lorsque le plug-in est déployé devant le proxy, le serveur proxy extrait l'adresse IP client des canaux au lieu des en-têtes privés transmis depuis le plug-in. Si cette propriété prend la valeur true, le serveur proxy extrait les informations client à partir des en-têtes HTTP privés envoyés depuis le plug-in sécurisé et non à partir des canaux.

Information valeur
Type de donnée String (chaîne)
Valeur par défaut false

http.connectionPoolUseForPOST

Spécifie si le serveur proxy utilise le regroupement des connexions pour les demandes POST. Par défaut, les demandes POST ne sont ni regroupées ni persistantes. Il en découle que si trop de demandes POST sont envoyées via le serveur proxy, une saturation des ports risque de se produire, se traduisant par des exceptions de liaison. Si cette propriété a la valeur true, le regroupement des connexions est utilisé pour les demandes POST.

Information valeur
Type de donnée Booléen
Valeur par défaut false

http.connectRetryLimit

Indique le nombre de tentatives d'établissement de connexion entre WebSphere Proxy Server et le serveur d'arrière-plan avant l'arrêt du serveur.

Si vous n'ajoutez pas cette propriété personnalisée aux paramètre WebSphere Proxy Server, à chaque fois que WebSphere Proxy Server ne peut établir de connexion à un serveur d'arrière-plan, ce serveur est marqué comme étant arrêté, et plus aucune requête n'est acheminée vers ce serveur tant que la durée spécifiée pour la propriété personnalisée retryAfterValue n'est pas écoulée, même si une autre tentative de connexion avait pu aboutir. Par exemple, la première tentative de connexion peut avoir échoué suite à la réutilisation trop rapide d'un port éphémère, et la connexion précédente est toujours à l'état TIME_WAIT.

Information valeur
Type de donnée Entierr
Valeur par défaut 0

http.disable.retry.on.503.uriprefix

Indique les préfixes URI pour lesquels vous ne souhaitez pas que le serveur proxy fasse automatiquement une nouvelle tentative avec les autres serveurs lorsque le serveur proxy reçoit une réponse 503 du serveur d'arrière-plan auquel il a envoyé la demande initiale.

En général, lorsque le serveur proxy reçoit une réponse 503 d'un serveur d'arrière-plan, il marque le serveur d'arrière-plan comme étant désactivé et tente d'envoyer la demande à un autre serveur. Si, pour des préfixes URI spécifiques, vous ne souhaitez pas que le serveur proxy marque le serveur d'arrière-plan comme désactivé et tente automatiquement d'autres serveurs, vous pouvez indiquer ces préfixes comme valeur de cette propriété personnalisée. Pour tout préfixe URI spécifié pour cette propriété, si le serveur proxy reçoit une réponse 503 à cette demande par le serveur d'arrière-plan, le serveur proxy renvoie une réponse 503 directement au client au lieu de relancer la demande. Par ailleurs, le serveur proxy ne marque pas le serveur d'arrière-plan comme étant désactivé.

Information valeur
Type de donnée chaîne composée de préfixes URI séparés par des virgules
Valeur par défaut Aucune valeur par défaut

http.disableresponsebufferingurls

Indique dans quelles conditions un serveur relais met en mémoire tampon une réponse pour une application de signal de présence.

La valeur de cette propriété est une liste d'URL séparées par des virgules, par exemple /application_a/.*html;/application_b/.*html. Par exemple, si le serveur relais reçoit une requête du type /application_a/heartbeat.html qui correspond à l'un des modèles d'URI contenus dans la propriété personnalisée, il ne met pas en mémoire tampon le corps de la réponse destinée à cette requête. Dans cet exemple, si le serveur relais renvoie un octet, il l'envoie au côté client sans passer par la mémoire tampon.

Si cette propriété n'est pas définie, quand le serveur relais reçoit une réponse, il place en mémoire tampon le corps de réponse jusqu'à ce que la limite de corps de réponse partiel soit atteinte.

Important : Le processus de mise en mémoire tampon peut améliorer les performances du serveur relais mais peut aussi entraîner des expirations des connexions côté client pour certaines applications à signal de présence.

http.isDisable10ResponseCaching

Indique si le proxy doit annuler le tronquage et mettre en mémoire tampon la réponse pour un client HTTP 1.0.

Si la propriété http.isDisable10ResponseCaching a la valeur true, le serveur proxy ne génère pas l'en-tête de longueur du contenu et n'inclut pas les données tronquées dans la réponse côté client. Au lieu de cela, le serveur proxy ferme la connexion au niveau de la marque de fin du corps de réponse.

Information valeur
Type de donnée Booléen
Valeur par défaut false

http.log.history

Permet d'augmenter le nombre de fichiers historiques pour les fichiers journaux du serveur proxy.

Les fichiers journaux du serveur proxy sont les fichiers proxy.log, local.log et cache.log. Sans cette propriété personnalisée, vous disposez d'un seul fichier historique pour ces fichiers journaux de serveur proxy.

Information valeur
Type de donnée Boolean
Valeur par défaut 1

http.log.history.backup.list

Vous permet de rechercher des fichiers historiques dans le répertoire de journaux du serveur proxy et, si des fichiers sont trouvés, de les ajouter aux nouveaux fichiers journaux.

Si vous définissez la propriété personnalisée http.log.history.backup.list sur 1, le serveur proxy recherche dans le répertoire de journaux du serveur proxy les versions historiques des fichiers cache.log, local.log et proxy.log. Si des versions historiques sont trouvées, elles sont ajoutées à la fin de tous les nouveaux fichiers journaux.

Pour que cette propriété personnalisée soit appliquée, vous devez activer la journalisation pour le serveur proxy HTTP.

Information valeur
Type de donnée Boolean
Valeur par défaut 0

http.maxCachedPayload

Indique la taille maximum d'une réponse tronquée pour laquelle le serveur proxy générera un en-tête de longueur du contenu.

Lorsque le serveur proxy reçoit une réponse tronquée pour un client HTTP 1.0, il suppose que le client HTTP 1.0 ne peut pas traiter le message tronqué et tente d'annuler le tronquage du message et de calculer la longueur du contenu pour le corps de réponse. Si la taille de la réponse tronquée est inférieure ou égale à la limite de taille spécifiée pour cette propriété, le serveur proxy génère un en-tête de longueur du contenu pour la réponse. Si la réponse tronquée dépasse la limite de taille spécifiée pour cette propriété, le proxy renvoie un message d'erreur 500.

Information valeur
Type de donnée integer
Valeur par défaut 100000 octets

http.odcUpdateTimeout

Indique la durée, en secondes, pendant laquelle le serveur proxy HTTP patiente pendant le démarrage du serveur avant d'envoyer des informations. Le serveur proxy patiente pendant le nombre de secondes indiqué avant de lier ses ports.

Cette propriété personnalisée permet de configurer un délai pour le démarrage (avant la liaison des ports HTTP/HTTPS) et d'autoriser la diffusion des informations acheminées après une certaine durée. Si vous attribuez la valeur 300, le serveur proxy patiente pendant 300 secondes avant d'autoriser la diffusion des informations vers le serveur proxy. Si les informations sont diffusées vers le serveur proxy avant le délai de 300 secondes, le démarrage du serveur reprend.

Information valeur
Type de donnée String (chaîne)
Valeur par défaut 150

http.pmiTimerInterval

Indique l'intervalle de temps estimé, en millisecondes, après lequel les statistiques PMI sont enregistrées dans le serveur relais.

Eviter les incidents Eviter les incidents: Si vous indiquez une valeur inférieure à la valeur par défaut (100 milli-secondes), les performances du serveur relais peuvent baisser car ce dernier doit alors vérifier l'heure courante plus souvent.gotcha
Information valeur
Type de donnée Entierr
Valeur par défaut 100

http.routing.sendReverseProxyNameInHost

Détermine si l'en-tête de l'hôte est réécrit pour le contenu qui ne se trouve pas sur un serveur de contenu WebSphere Application Server.

Les options de cette propriété sont true ou false et aucune distinction n'est faite entre les majuscules et les minuscules. Si la valeur de cette propriété est false, l'en-tête de l'hôte est réécrit en tant qu'hôte du serveur cible. Si la valeur de cette propriété est true, l'en-tête de l'hôte n'est pas récrite.

Information valeur
Type de donnée Boolean
Valeur par défaut false

http.virtual.port.map

Indique les données de mappage de port de serveur que le serveur d'arrière-plan utilise pour renvoyer les réponses aux ports de site Web externe appropriés.

Quand les données de mappage des ports sont configurées sur un équilibreur de charge installé devant le serveur relais, ce dernier risque d'envoyer des données de port de site Web externe incorrectes au serveur d'arrière-plan car le numéro de port du site Web externe est probablement différent du port d'écoute du plug-in de serveur Web ou de celui du serveur relais. Vous pouvez utiliser cette propriété personnalisée pour corriger les données de port avant que le serveur relais ne les communique au serveur d'arrière-plan.

Par exemple, si le serveur relais ou le plug-in de serveur Web sont en écoute sur les ports 20080 et 20443 mais que le site Web externe utilise les ports 80 et 443, vous pouvez définir cette propriété personnalisée pour que le serveur relais communique des données de port correctes au serveur d'arrière-plan. Le serveur d'arrière-plan pourra alors envoyer les réponses vers les ports de site Web externe appropriés.
Nom  http.virtual.port.map   
Valeur :   20080:80;20443:443
Information valeur
Type de donnée Valeur de chaîne contenant des paires de mappage de ports séparées par deux points (:).
Valeur par défaut none

HTTPProxyAdvisorMethodName

Indique le nom de la méthode HTTP utilisée (habituellement HEAD ou GET). Il s'agit également du nom de méthode conseiller défini sur l'équilibreur de charge frontal. Cette propriété personnalisée permet au serveur relais de reconnaître les requêtes entrantes et de déterminer si elles proviennent de l'équilibreur de charge ou non.

Information valeur
Type de donnée Valeur de chaîne (nom de méthode HTTP, par exemple GET ou READ)
Valeur par défaut none

HTTPProxyAdvisorStartupDelay

Indique le délai de lancement du conseiller HTTP en secondes. La valeur par défaut est de 0 seconde.

Quand le serveur relais réceptionne une requête, il la compare avec les propriétés personnalisées (LBIPAddr, HTTPProxyAdvisorURI, HTTPProxyAdvisorURI, HTTPProxyAdvisorStartupDelay) si celles-ci sont définies.
Remarque : Il n'est pas nécessaire de définir toutes ces propriétés personnalisées.
Si toutes les propriétés personnalisées correspondent, la requête est considérée comme étant la requête de conseiller provenant de l'équilibreur de charge frontal.

Si l'heure de début du proxy actif est inférieure à la valeur définie dans la propriété personnalisée HTTPProxyAdvisorStartupDelay, un code d'erreur HTTP 503 est renvoyé directement du serveur relais pour informer l'équilibreur de charge que le serveur relais ou le serveur d'arrière-plan ne sont pas prêts à traiter les requêtes HTTP.

Si l'heure de début du proxy actif est supérieure à la valeur définie dans la propriété personnalisée HTTPProxyAdvisorStartupDelay, le proxy transmet la requête de conseiller au serveur d'arrière-plan et renvoie la réponse à l'équilibreur de charge frontal. Ce dernier détermine si le serveur d'arrière-plan et le serveur relais sont prêts à traiter les requêtes sur la base du code d'état renvoyé.

Si le proxy s'arrête, le serveur relais renvoie un code d'erreur 503 aux requêtes de conseiller. Ce code d'erreur informe l'équilibreur de charge que le serveur d'arrière-plan et le proxy ne peuvent plus traiter de requêtes et qu'il doit arrêter d'envoyer les requêtes à ce serveur relais.

Information valeur
Type de donnée Entier (délai en secondes)
Valeur par défaut 0

HTTPProxyAdvisorURI

Indique une chaîne d'URI qualifiées complètes. Il s'agit également de l'URI de conseiller défini sur l'équilibreur de charge frontal. Une application doit être configurée sur le serveur d'arrière-plan pour répondre à l'URI de cette requête. Cette propriété personnalisée permet au serveur relais de reconnaître les requêtes entrantes et de déterminer si elles proviennent de l'équilibreur de charge ou non.

Information valeur
Type de donnée Valeur de chaîne contenant des URI qualifiées complètes.
Valeur par défaut none

HTTPProxyAdvisorUserAgent

Indique le nom de l'agent d'utilisateur de l'équilibreur de charge frontal. Cette propriété personnalisée permet au serveur relais de reconnaître les requêtes entrantes et de déterminer si elles proviennent de l'équilibreur de charge ou non.

Information valeur
Type de donnée Valeur de chaîne contenant des en-têtes d'agent d'utilisateur HTTP.
Valeur par défaut none

HTTPSustainedHighVolumeLogging

Cette propriété personnalisée peut être définie dans le panneau Serveurs proxy WebSphere > Nom du serveur proxy > Paramètres du serveur proxy HTTP > Paramètres du proxy > Propriétés personnalisées.

LBIPAddr

Indique une liste d'adresses IP séparées par des points-virgules. Cette propriété personnalisée permet au serveur relais de reconnaître les requêtes entrantes et de déterminer si elles proviennent de l'équilibreur de charge ou non.

Information valeur
Type de donnée Valeur de chaîne contenant des adresses IP séparées des points-virgules.
Valeur par défaut none

localOutboundTCPAddress

Indique l'interface hôte dédiée au trafic HTTP. Cette propriété détermine l'interface utilisée pour les connexions HTTP sortantes vers le conteneur HTTP.

Information valeur
Type de donnée String (chaîne)
Valeur par défaut *

normalize.redirect.URL

Lorsqu'il est défini sur true, l'URI spécifié dans une règle de routage de redirection du serveur Proxy est normalisé, la barre oblique de fin ('/') est supprimée. Pour la valeur false, l'URI n'est pas modifié. La valeur par défaut est true.


Icône indiquant le type de rubrique Rubrique de référence



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=rjpx_siphttpcustprops
Nom du fichier : rjpx_siphttpcustprops.html