# Paramètres du routeur On Demand

La présente rubrique permet d'effectuer la configuration avancée d'un routeur On Demand (ODR). Les paramètres ODR vous permettent d'affiner le comportement de l'ODR. En particulier, vous pouvez configurer les connexions et les demandes établies avec le serveur d'applications, activer la mise en cache, définir les critères de rejet des demandes, définir la gestion des réponses d'erreur et indiquer l'emplacement des journaux de l'ODR.

Une fois créé, le serveur ODR détecte l'environnement et peut acheminer les demandes vers WebSphere Application Server. Vous pouvez ajouter d'autres configurations au serveur ODR en fonction des besoins de votre environnement. La configuration du serveur ODR dans la zone démilitarisée (DMZ) n'est pas prise en charge.

Pour afficher cette page de la console d'administration, cliquez sur Serveurs > Types de serveur > Routeurs On Demand > nom_odr > Propriétés des routeurs On Demand > Paramètres du routeur On Demand.

Pour modifier les paramètres ODR, vous devez posséder les privilèges de l'administrateur ou du configurateur.

Dans l'onglet Configuration, vous pouvez modifier les paramètres de zone configurables associés au serveur ODR.

## Connexion aux serveurs de contenu

Configurez les paramètres de connexion HTTP de base entre le serveur proxy et les serveurs de contenu.

Délai d'expiration de la requête sortante
  Nombre de secondes par défaut pendant lequel l'ODR attend une réponse avant de considérer qu'une demande adressée à un serveur de contenu est arrivée à expiration. Si vous décidez de modifier la valeur, faites preuve de prudence.

Délai d'expiration de la connexion sortante
  Nombre de millisecondes pendant lequel l'ODR attend pour se connecter à un serveur. Si ce délai expire, l'ODR tente de se connecter à un autre serveur. Si aucun autre serveur n'est disponible, la demande expire. Une valeur égale à 0 indique que l'ODR doit utiliser la valeur du délai d'attente du noyau du système d'exploitation.

Pool de connexions au serveur de contenu
  Cette option permettant de regrouper les connexions au serveur est une option d'optimisation. La mise en pool évite de devoir créer et détruire fréquemment les connexions socket au serveur, en permettant au serveur ODR de réserver ces connexions et de les réutiliser. La valeur par défaut pour le nombre maximum de connexions par serveur est 0, ce qui permet d'augmenter au besoin le nombre de connexions.

Nombre maximal de connexions par serveur
  Nombre maximal de connexions regroupées pour un serveur de contenu spécifique. Les propriétés personnalisées de l'ODR qui modifient les connexions du serveur de contenu sont les suivantes :
  - key=http.maxTargetReconnects: Nombre maximal de reconnexions au même serveur de contenu cible pour chaque demande. La valeur par défaut est 5.
  - key=http.maxTargetRetries: Nombre maximal de fois que l'ODR tente de sélectionner un nouveau serveur de contenu cible pour chaque demande. La valeur par défaut est 5.
  - key=http.routing.sendReverseProxyNameInHost: Détermine si le nom du routeur ODR est placé dans l'en-tête hôte pour le contenu qui n'est pas propre aux serveurs de contenu de WebSphere Application Server. Les options sont `true` ou `false` et il n'y a pas de distinction entre les majuscules et les minuscules. La valeur par défaut est false.
  - key=http.compliance.disable: Détermines si la compatibilité HTTP V1.1 est appliquée sur les connexions du serveur de contenu ODR. Les options sont `true` ou `false` et il n'y a pas de distinction entre les majuscules et les minuscules. La valeur par défaut est false.
  - key=http.compliance.via: Valeur de l'en-tête via ajoutée aux demandes et aux réponses pour assurer la compatibilité HTTP. Si la valeur est null, l'en-tête via n'est pas ajouté. Si la valeur est true, une valeur via par défaut est ajoutée. Sinon, la valeur via indiquée est ajoutée. La valeur par défaut est null.

## Mise en cache

Le serveur ODR peut être configuré pour mettre en mémoire cache le contenu des serveurs.

Par défaut, la mise en mémoire cache est activée. Les propriétés suivantes ne sont appliquées que si la mise en cache est activée :

Activer la mise en mémoire cache
  Active la configuration de mise en cache pour le serveur ODR et effectue la mise en cache de contenu statique, comme indiqué dans les spécifications HTTP 1.1.

Nom d'instance de cache
  Instance de cache d'objets dynamique configurée dans la section Ressources > Instances de cache > Instances de cache d'objet et utilisée pour mettre en mémoire cache toutes les réponses de contenu statique et dynamique. Cet instance de cache d'objets doit être configurée pour prendre en charge les nouvelles API NIO.

Mettre en cache le contenu SSL
  Détermine si les connexions SSL du client ODR arrêtées par le serveur ODR doivent mettre leur réponse en cache.

Mise en cache systématique
  Permet de mettre en cache des réponses HTTP qui ne le seraient pas normalement. Les règles de mise en cache définies par HTTP 1.1 peuvent ne pas être respectées pour optimiser la mise en cache.

Mettre en cache le contenu dynamique
  Détermine si le contenu dynamique généré par les systèmes WebSphere Application Server version 6.02 ou suivantes est mis en cache. La mise en cache du contenu dynamique généré par les serveurs de contenu dotés d'une version de WebSphere Application Server antérieure à la version 6.0.2 n'est pas prise en charge.

URI de mise à jour de cache
  Lors de la mise en cache du contenu dynamique, URI relatif à l'application du serveur de contenu installée qui est utilisé pour invalider les entrées mises en cache.

## Stratégie de compression

Permet la compression du corps du message de réponse HTTP avant son envoi au client.

gzip uniquement
  Compresse la réponse à l'aide du mécanisme de compression gzip. La réponse est compressée uniquement si cela est acceptable pour le client, en fonction de l'en-tête de requête d'acceptation du codage.

deflate uniquement
  Compresse la réponse à l'aide du mécanisme de compression deflate. La réponse est compressée uniquement si cela est acceptable pour le client, en fonction de l'en-tête de requête d'acceptation du codage.

auto
  L'utilisation du mécanisme de compression gzip ou deflate, ou aucune compression est déterminé par les préférences du client.

## Exclusions

Le serveur ODR examine chaque demande entrante. Vous pouvez définir certaines méthodes d'exclusion et si la méthode HTTP demandée correspond à l'une des méthodes configurées pour l'exclusion, le serveur ODR rejette les demandes en signalant l'erreur METHOD DISALLOWED.

Désactivation des méthodes HTTP
  Par défaut, les méthodes CONNECT, PUT et DELETE sont désactivées.

## Journalisation

Les demandes HTTP sont consignées dans l'un des trois journaux : proxy, cache ou local. La configuration du journal local n'est pas possible dans la console d'administration mais elle est disponible dans ${RACINE_JOURNAL_SERVEUR}local.log. Indiquez l'emplacement du journal en associant la propriété personnalisée http.log.localFileName à l'emplacement du fichier. Le contenu de chaque journal est mis en forme à l'aide du format de journal du National Center for Supercomputing Applications.

Activation de la journalisation de l'accès
  Sélectionnez pour activer la journalisation.

Taille maximale du journal des accès
  Taille maximale du fichier journal en Mo. 25 Mo est la valeur par défaut.

Journal des accès au proxy
  Consigne les réponses provenant des serveurs distants.

Journal des accès à la mémoire cache
  Consigne les réponses provenant de la mémoire cache locale.

Journal des accès en local
  Contient le nom du journal local. `NULL` indique que la valeur par défaut `${SERVER_LOG_ROOT}/local.log` est utilisée. Consigne toutes les réponses locales qui ne proviennent pas de la mémoire cache, par exemple les redirections et les erreurs internes. Ce contenu ne provient pas du cache ODR.

## Sécurité

Cette section permet de définir les options de sécurité.

Proxys de sécurité sécurisés
  Certaines topologies comportent une autre couche de routage activée sur l'ODR. Par exemple, certains serveurs Web lisent les demandes entrantes pour déterminer le serveur ODR vers lequel elles doivent être acheminées. Cette configuration permet aux systèmes intermédiaires autres que le serveur ODR de prendre en charge la demande en ordonnant au serveur ODR de leur faire confiance. Entrez une adresse Internet ou un nom d'hôte complet dans cette zone.

## Règle de configuration du plug-in de proxy

Générez la configuration de plug-in
  Utilisez ce paramètre pour générer un fichier de configuration de plug-in du serveur ODR utilisable sur un serveur Web déployé devant le serveur ODR. Le plug-in détermine l'URI que le serveur ODR prend en charge au nom du serveur d'applications. Il peut déterminer le point d'extrémité ou les limites du serveur ODR pour pouvoir acheminer correctement les demandes reçues du serveur ODR. Cette fonctionnalité est utile pour ceux qui préfèrent déployer un serveur Web reconnu de la zone démilitarisée (DMZ) capable d'exploiter les fonctions du serveur ODR. Notez que la configuration du serveur ODR dans la zone démilitarisée (DMZ) n'est pas prise en charge.

  Vous pouvez définir un niveau de génération du plug-in. Dans la portée de la cellule, le routeur ODR génère une configuration de plug-in incluant tous les URI gérés par l'ensemble des routeurs ODR de la cellule. Dans la portée du noeud, le fichier de configuration du plug-in contient tous les URI gérés par l'ensemble des routeurs ODR définis sur le même noeud que l'ODR générant le plug-in. En outre, l'ensemble du trafic acheminé par le fichier de configuration du plug-in est transmis uniquement via les routeurs ODR appartenant au même noeud que cet ODR. Dans la portée du serveur, le fichier de configuration du plug-in contient tous les URI gérés uniquement par le routeur ODR générant le plug-in et l'ensemble du trafic acheminé par le fichier de configuration du plug-in est transmis seulement via cet ODR.

Script de modification de la configuration du plug-in.
  Indique le chemin à un script qui est exécuté une fois que la configuration du plug-in de WebSphere Application Server est générée.

## Règle de page d'erreur personnalisée

Cette zone permet d'utiliser des pages d'erreur personnalisées lorsque des erreurs se produisent pendant le traitement de la demande.

Par défaut, aucune page d'erreurs n'est générée. Les propriétés suivantes permettent d'utiliser des pages d'erreurs personnalisées lorsque des erreurs se produisent lors du traitement d'une demande :

URI de l'application de génération de la page d'erreurs
  URI de l'application de génération de la page d'erreurs : si aucun URI valide vers une application installée n'est indiqué, la règle de page d'erreurs personnalisée ne gère aucune demande.

Gérer les erreurs distantes
  Lorsque cette option est désélectionnée, les codes d'état des erreurs des réponses HTTP sont traités uniquement lorsque le routeur On Demand génère un message d'erreur. Lorsqu'elle est sélectionnée, les codes d'état des erreurs des réponses HTTP sont traités lorsque le routeur On Demand génère un message d'erreur, ainsi que lorsqu'un serveur d'applications génère un message d'erreur. La procédure recommandée consiste à configurer une application de page d'erreurs sur le même système physique que le routeur On Demand.

En-têtes à transmettre à l'application de page d'erreurs
  Indique des valeurs d'en-tête supplémentaires provenant de la demande client à transmettre à l'application de page d'erreurs sous forme de paramètres de requête. Les paramètres de demande responseCode et URI sont toujours envoyés à l'application de page d'erreurs, en plus des paramètres configurés. Le paramètre responseCode est le code d'état HTTP généré en interne ou renvoyé par le serveur de contenu. Le paramètre URI est l'URI de la demande pour le client.
  Exemple : L'URI de la page d'erreurs est `/ErrorPageApp/ErrorPage`, les en-têtes à transmettre contiennent `Host` et un client envoie la demande suivante :

      GET  /house/rooms/kitchen.jpg HTTP/1.1
      Host:  homeserver.companyx.com
      La demande génère une réponse HTTP 404 (locale ou distante) et l'URI de la demande vers l'application serait :
      /ErrorPageApp/ErrorPage?responseCode=404&uri=/house/rooms/kitchen.jpg&Host= homeserver.companyx.com

Codes d'état HTTP devant être reconnus en tant qu'erreurs
  Codes d'état pour lesquels les règles de page d'erreurs fournissent une réponse. Si aucun code d'état n'est indiqué, le contenu original des réponses associé à ce code d'état est renvoyé. Si aucun code d'état HTTP n'est spécifié, les codes par défaut `04` et `5XX` sont utilisés. Au lieu d'indiquer des codes d'état séparément, la méthode suivante est recommandée pour représenter une plage de codes d'état :
  - `5XX : 500-599`
  - `4XX : 400-499`
  - `3XX : 300-399`
  - `2XX : 200-299`

Informations connexes :
Collection du routeur On Demand
Paramètres du routeur On Demand
Paramètres des règles du cache statique du routeur On Demand
Collection d'instances de cache d'objet du routeur On Demand
Collection des chaînes de transport du routeur On Demand
Configuration du routeur On Demand
Règles du cache statique du routeur On Demand
Création d'un routeur On Demand
Collection de clusters de routeurs On Demand

Nom de fichier : odr_settings.html