WebSphere Virtual Enterprise, Version 6.1.1
             Sistemas operativos: AIX, HP-UX, Linux, Solaris, Windows,


Control de la generación del archivo plugin-cfg.xml

Puede alterar temporalmente los valores de atributo predeterminados del archivo plugin-cfg.xml que genera automáticamente el direccionador On Demand (ODR).

Los siguientes elementos tienen el formato com.ibm.ws.odr.plugincfg.<elemento>.<nombreatributo>, donde <elemento> es el nombre de la palabra clave del archivo de configuración que denota el elemento que contiene un atributo, y <nombreatributo> es el nombre del atributo que se encuentra dentro de dicho elemento. Configure los elementos como propiedades del sistema JVM. Para establecer una propiedad del sistema JVM en el ODR con la consola administrativa, pulse Servidores > Direccionadores On Demand > direccionador_on_demand > Java y gestión de procesos > Definición de proceso > Máquina virtual Java > Propiedades personalizadas > Nuevo.

Config

Este elemento inicia el archivo de configuración de plug-in. Puede incluir uno o varios de los siguientes elementos y atributos.

com.ibm.ws.odr.plugincfg.config.ASDisableNagle
Especifica si el usuario desea inhabilitar el algoritmo de Nagle para la conexión entre el plug-in y el servidor.

El valor predeterminado es false.

com.ibm.ws.odr.plugincfg.config.AcceptAllContent
Especifica si desea incluir o no contenido en las solicitudes POST, PUT, GET y HEAD cuando existe una cabecera de longitud de contenido o codificación de transferencia en la cabecera de la solicitud. Puede especificar uno de los siguientes valores para este atributo:
  • True si se espera contenido y se va a leer para todas las solicitudes
  • False si sólo se espera contenido y se va a leer para las solicitudes POST y PUT.

El valor predeterminado es false.

com.ibm.ws.odr.plugincfg.config.AppServerPortPreference
Especifica qué número de puerto se utiliza para crear URI para sendRedirect.

El valor predeterminado es HostHeader.

com.ibm.ws.odr.plugincfg.config.ChunkedResponse
Especifica si el plug-in agrupa la respuesta en el cliente cuando existe en la respuesta una cabecera de codificación de transferencia : respuesta fragmentada.

Puede especificar uno de los siguientes valores para este atributo:

  • True si el plug-in fragmenta la respuesta en el cliente cuando existe en la respuesta una cabecera de codificación de transferencia : respuesta fragmentada.
  • False si la respuesta no se fragmenta.

El valor predeterminado es false.

com.ibm.ws.odr.plugincfg.config.IISDisableNagle
Especifica si desea inhabilitar el algoritmo de Nagle.

El valor predeterminado es false.

com.ibm.ws.odr.plugincfg.config.IISPluginPriority
Especifica la prioridad con la que el servidor web carga el plug-in. Puede especificar uno de los siguientes valores para este atributo:
  • Alta
  • Media
  • Baja

El valor predeterminado es Alta.

com.ibm.ws.odr.plugincfg.config.IgnoreDNSFailures
Especifica si el plug-in ignora las anomalías de DNS en una configuración cuando se inicia. Cuando se establece en true, el plug-in ignora las anomalías de DNS en una configuración y se inicia satisfactoriamente si al menos un servidor en cada ServerCluster resuelve el nombre de host. Los servidores para los que no se resuelve el nombre de host se marcan como no disponible durante el ciclo de vida de la configuración. El nombre de host no se resuelve posteriormente durante el direccionamiento de las solicitudes. Si se produce una anomalía de DNS, se escribe un mensaje de anotaciones cronológicas en el archivo de anotaciones de plug-in y el plug-in continúa inicializándose en lugar del servidor web que no se inicia.

El valor predeterminado es false.

com.ibm.ws.odr.plugincfg.config.RefreshInterval
El intervalo de tiempo, en segundos, con el que el plug-in debe comprobar si hay cambios o actualizaciones en el archivo de configuración. El plug-in comprueba si se han producido modificaciones en el archivo desde que se cargó la configuración del plug-in.

El valor predeterminado es 60. En un entorno de desarrollo en el que los cambios son frecuentes, establezca el intervalo de tiempo en un valor inferior a 60 segundos. En un entorno de producción, establezca un valor superior al valor predeterminado, ya que las actualizaciones no se producen con tanta frecuencia en la configuración. Si la recarga del plug-in no es satisfactoria, el archivo de anotaciones del plug-in contendrá un mensaje y se utilizará la configuración anterior hasta que el archivo de configuración del plug-in se recargue satisfactoriamente. Consulte el archivo de anotaciones del plug-in para obtener más información si se produce un error.

com.ibm.ws.odr.plugincfg.config.ResponseChunkSize
El archivo de plug-in lee el cuerpo de la respuesta en fragmentos de 64k hasta que se leen todos los datos de la respuesta, lo que supone un problema de rendimiento para las solicitudes cuyo cuerpo de respuesta contenga grandes cantidades de datos.

Utilice este atributo para especificar el tamaño de fragmento máximo que desea utilizar cuando se lee el cuerpo de la respuesta. Por ejemplo, Config ResponseChunkSize="N">, donde N es igual al tamaño del fragmento en kilobytes.

Si la longitud del contenido del cuerpo de respuesta es desconocida, se asigna un tamaño de almacenamiento intermedio de N kilobytes y el cuerpo se lee en fragmentos de N kilobytes de tamaño hasta que se lee todo el cuerpo. Si la longitud del contenido es conocida, se utiliza un tamaño de almacenamiento intermedio igual a la longitud del contenido o N para leer el cuerpo de la respuesta.

El tamaño de los fragmentos predeterminados es 64k.

com.ibm.ws.odr.plugincfg.config.VHostMatchingCompat
Especifica que se debe utilizar el número de puerto para la coincidencia de hosts virtuales. Pueden especificarse los siguientes valores:
  • True para la coincidencia física utilizando el número de puerto para el que se ha recibido la solicitud.
  • False para la coincidencia lógica utilizando el número de puerto contenido en la cabecera de host.

El valor predeterminado es false.

com.ibm.ws.odr.plugincfg.config.odrIncludeStopped
Especifica que se permita la inclusión de ODR detenidos. Pueden especificarse los siguientes valores:
  • True para incluir ODR detenidos.
  • False para no incluir ODR detenidos.

El valor predeterminado es false.

com.ibm.ws.odr.plugincfg.config.TrustedProxyEnabled
Especifica los proxies de confianza. Pueden especificarse los siguientes valores:
  • True para incluir proxies de confianza.
  • False para no incluir proxies de confianza.

El valor predeterminado es false.

Anotaciones cronológicas

Las anotaciones cronológicas describen la ubicación y el nivel de los mensajes de anotaciones que escribe el plug-in. Si no se especifica una anotación cronológica en el archivo de configuración, los mensajes de anotaciones se escribirán en las anotaciones de error.

com.ibm.ws.odr.plugincfg.log.Name
La vía de acceso plenamente cualificada del archivo de anotaciones cronológicas en el que el plug-in escribe mensajes de error.

El valor predeterminado es raízPerfil/logs/http_plugin.log.

com.ibm.ws.odr.plugincfg.log.LogLevel
El nivel de detalle de los mensajes de anotaciones que el plug-in escribe en las anotaciones cronológicas. Puede especificar uno de los siguientes valores para este atributo:
  • Trace. Todos los pasos del proceso de solicitud se anotan detalladamente.
  • Stats. Se anota el servidor seleccionado para cada solicitud y otra información de equilibrado de carga relacionada con el manejo de solicitudes.
  • Warn. Se anotan todos los mensajes de aviso y error debidos al proceso areglal de solicitudes.
  • Error. Se anotan sólo los mensajes error debidos al proceso areglal de solicitudes.
  • Debug. Se anotan todos los pasos críticos realizados en el proceso de las solicitudes.
  • Detail. Se anota toda la información sobre las solicitudes y las respuestas.
El valor predeterminado es Error.
PRECAUCIÓN:
Muchos mensajes se anotan a nivel de rastreo, lo que puede hacer que el sistema de archivos se llene rápidamente. No utilice nunca un valor de rastreo en un entorno con un funcionamiento reglal, ya que puede afectar negativamente al rendimiento.

ServerCluster

Este elemento es un grupo de servidores que se configuran generalmente para dar servicio al mismo tipo de solicitudes.

En el caso más simple, el clúster contiene sólo una definición de servidor. Si define más de un servidor, el plug-in realiza un equilibrado de carga en los servidores definidos utilizando un algoritmo por turno circular o un algoritmo aleatorio. El valor predeterminado es el turno circular.

com.ibm.ws.odr.plugincfg.cluster.CloneSeparatorChange
Algunos dispositivos generalizados no pueden manejar el signo de dos puntos (:) que se utiliza para separar los ID de clones junto con la afinidad de sesiones. Este atributo indica al al plug-in que espere a que aparezca el signo más (+) como el separador de clones. Debe modificar las configuraciones de servidor para que un servidor pueda separar también los ID de clones con el signo más.

El valor predeterminado es false.

com.ibm.ws.odr.plugincfg.cluster.LoadBalance
La implementación de turno circular tiene un punto de partida aleatorio. El primer servidor se selecciona aleatoriamente y se utiliza el valor de turno circular para seleccionar servidores desde ese punto en adelante. Esta implementación garantiza que en varios servidores web basados en procesos, todos los procesos no empiecen enviando la primera solicitud al mismo servidor.

El tipo de equilibrado de carga predeterminado es Turno circular.

com.ibm.ws.odr.plugincfg.cluster.PostSizeLimit
El número máximo de bytes de contenido de solicitud permitido para el plug-in cuando intenta enviar la solicitud a un servidor. Si se recibe una solicitud con un tamaño mayor que este, el plug-in finaliza la solicitud.

El valor predeterminado es de -1 bytes, que indica que no hay límite para el tamaño de envío.

com.ibm.ws.odr.plugincfg.cluster.RemoveSpecialHeaders
El plug-in añade cabeceras especiales a la solicitud antes de enviarla al servidor. Estas cabeceras almacenan información sobre la solicitud que puede utilizar la aplicación. De forma predeterminada, el plug-in elimina estas cabeceras de las solicitudes entrantes antes de añadir las cabeceras necesarias.

El valor predeterminado es true. Si establece el atributo en false, introduce un posible peligro de seguridad al no eliminar las cabeceras de las solicitudes entrantes.

com.ibm.ws.odr.plugincfg.cluster.RetryInterval
Un entero que especifica la cantidad de tiempo que transcurre desde el momento en el que se escoge un servidor al momento en el que el plug-in intentará establecer de nuevo una conexión.

El valor predeterminado es 60 segundos.

Server

Este elemento es una instancia de servidor que se configura para manejar las solicitudes direccionadas a él, según las reglas de direccionamiento de la configuración del plug-in. El elemento de servidor se corresponde con un servidor de aplicaciones que se ejecuta en la estación de trabajo local o una estación de trabajo remota.

com.ibm.ws.odr.plugincfg.server.ConnectTimeout
Permite al plug-in establecer conexiones sin bloqueo con el servidor de aplicaciones, que son útiles cuando el plug-in no puede contactar con el destino para determinar si el puerto está o no disponible.

Si no se especifica ningún valor, el plug-in efectúa una conexión de bloqueo en la que el plug-in espera hasta que un sistema operativo excede el tiempo de espera y permite al plug-in marcar el servidor como no disponible, unavailable. Un valor mayor que 0 especifica el número de segundos que el plug-in espera una conexión satisfactoria. Si no se establece una conexión después de dicho intervalo de tiempo, el plug-in marca el servidor como unavailable y continúa con otro de los servidores definidos en el clúster.

El valor predeterminado es 0.

com.ibm.ws.odr.plugincfg.server.ExtendedHandShake
Se utiliza cuando hay un cortafuegos entre el plug-in y el servidor de aplicaciones. En tal caso, el plug-in no se migra tras error, según lo esperado.

El plug-in marca un servidor como detenido cuando finaliza connect(). No obstante, cuando hay un cortafuegos entre el plug-in y el servidor de aplicaciones, el método connect() es satisfactorio, aunque el servidor de aplicaciones de fondo esté detenido. Esto hace que el plug-in no se migre tras error correctamente en otros servidores de aplicaciones.

El plug-in contiene este atributo para garantizar que se ha iniciado antes de enviar la solicitud.

El valor predeterminado es false.

com.ibm.ws.odr.plugincfg.server.MaxConnections
Especifica el número máximo de conexiones pendientes con un servidor que fluyen a través de un proceso de servidor web en cualquier momento.

El valor predeterminado se establece en -1.

com.ibm.ws.odr.plugincfg.cluster.WaitForContinue
Especifica si se debe utilizar el soporte de HTTP 1.1 100 Continue antes de enviar el contenido de la solicitud al servidor de aplicaciones. El valor predeterminado es false. El plug-in no espera la respuesta de 100 Continue del servidor de aplicaciones antes de enviar el contenido de la solicitud.

Esta propiedad se ignora para las solicitudes POST para impedir que se produzcan anomalías si el servidor de aplicaciones cierra una conexión porque se ha excedido un tiempo de espera.

Habilite esta función cuando configure el plug-in para que trabaje con determinados tipos de cortafuegos de proxy.

com.ibm.ws.odr.plugincfg.TrustedProxyEnabled

Permite que el plug-in dé soporte a servidores proxy de confianza. Los valores son true o false.

Propiedad

com.ibm.ws.odr.plugincfg.property.ESIEnable
Se utiliza para habilitar o inhabilitar el procesador ESI (Edge Side Include). Si el procesador ESI está inhabilitado, se ignorarán los otros elementos ESI del archivo.

El valor predeterminado es true.

com.ibm.ws.odr.plugincfg.property.ESIMaxCacheSize
Un entero que especifica, en unidades de 1K byte, el tamaño máximo de la memoria caché. El tamaño máximo predeterminado de la memoria caché es 1024K bytes (1 megabyte). Si la memoria caché está llena, la primera entrada que se va a desalojar de memoria caché es la que caduque antes.
com.ibm.ws.odr.plugincfg.property.ESIInvalidationMonitor
Indica si el procesador ESI recibe o no invalidaciones del servidor de aplicaciones.

El valor predeterminado es false.

com.ibm.ws.odr.plugincfg.property.https.keyring
Utilice este elemento para especificar los parámetros de inicialización cuando el protocolo del transporte se establece en HTTPS.

Este atributo es un nombre soportado que reconoce el transporte. El valor predeterminado del elemento de conjunto de claves es raízPerfil/etc/plugin-key.kdb.

com.ibm.ws.odr.plugincfg.property.https.stashfile
El valor predeterminado del archivo stash es raízPerfil/node/etc/plugin-key.sth



Conceptos relacionados
Visión general de la prioridad del flujo de solicitudes
Tareas relacionadas
Creación y configuración de ODR
Direccionamiento de solicitudes directamente de un servidor web a un servidor de aplicaciones de fondo
Configuración del direccionador On Demand para actualizar dinámicamente la configuración de plug-in del servidor Web
Tema de referencia    

Condiciones de uso | Comentarios

Última actualización: 22-sep-2009 09H39' EDT
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r1m1/index.jsp?topic=/com.ibm.websphere.ops.doc/info/odoe_task/rodr_plugin_props.html