Introducimos los parámetros para cada Plug-in de Servidor Web en ficheros de configuración Especiales. Cada Servidor Web tiene un nombre diferente para su fichero de configuración y diferentes reglas para su formateo. Puedes visitar las siguientes secciones para encontrar más detalles sobre cada Plug-in:
| Parámetro |
Valor por
Defecto |
Descripción |
WebLogicHost
(Requerido cuando pasamos [proxy]
a un sólo servidor WebLogic). |
ninguno |
El host WebLogic Server (o nombre de host virtual según se dfine en un Servidor Web ejecutándose en WebLogic Server) al que se deben reenviar las solicitudes HTTP.
Si estamos usando un cluster WebLogic, usamos el parámetro WebLogicCluster en lugar de WebLogicHost.
|
WebLogicPort
(Requerido cuando pasamos [proxy]
a un sólo servidor WebLogic). |
ninguno |
Puerto en el que el host WebLogic Server está escuchando solicitudes de conexiones WebLogic. (Si estamos usando SSL entre el plug-in y el servidor WebLogic, seleccionamos este parámetro al puerto de escucha SSL (ver Configurar el puerto de Escucha) y seleccionamos el parámetro SecureProxy a ON ).
Si estamos usando un cluster WebLogic, usamos el parámetro WebLogicCluster en lugar de WebLogicPort.
|
WebLogicCluster
(Requerido cuando pasamos [proxy]
a un cluster WebLogic). |
ninguno |
Lista de Servidores WebLogic que pueden usarse en un cluster para balance de carga. El cluster es una lista delimitada por comas de entradas host:port. Por ejemplo: WebLogicCluster myweblogic.com:7001, yourweblogic.com:7001,theirweblogic.com:7001.
Si estamos usando SSL entre el plug-in y el servidor WebLogic, seleccionamos este parámetro al puerto de escucha SSL (ver Configurar el puerto de Escucha) y seleccionamos el parámetro SecureProxy a ON.
Usamos WebLogicCluster en lugar de los parámetros WebLogicHost y WebLogicPort. WebLogic Server primero búsca el parámetro WebLogicCluster. Si no lo encuentra, busca y usa WebLogicHost y WebLogicPort.
El plug-in da una simple vuelta entre todos los miembros disponibles del cluster. La lista de cluster especificada en esta propiedad es un punto de entrada para la lista de cluster dinámica que mantienen el servidor y el plug-in. WebLogic Server y el plug-in funcionan juntos para actualizar automáticamente la lista de clusters con los miembros del cluster nuevos, fallados y recuperados.
Podemos desactivar el uso de la lista dinámica de cluster selecionando el parámetro DynamicServerList a OFF (sólo Microsoft Internet Information Server).
El plug-in dirige las solicitudes HTTP que contienen un cookie, una seción URL codificada, o una sesión almacenada en los datos POST al servidor del cluster que creo originalmente la cookie.
|
| PathTrim |
null |
String recortada por el plug-in desde el principio de la URL original, antes de que la solicitud sea re-enviada al Servidor WebLlogic. Por ejemplo, si la URL http://myWeb.server.com/weblogic/foo se pasa al plug-in para dividirla y PathTrim ha sido seleccionado para dividir a partir de /weblogic antes de manejar la URL hacia WebLogic Server, la URL re-enviada al Servidor WebLogic es:
http://myweblogic.server.com:7001/foo
|
| PathPrepend |
null |
String que el plug-in añade al principio de la URL original, después de que la haya recortado PathTrim, y antes de re-enviarla al Servidor WebLogic. |
| ConnectTimeoutSecs |
10 |
Tiempo máximo en segundos que el plug-in debería intentar conectar con el servidor WebLogic. Debemos hacer es valor mayor que ConnectRetrySecs. Si ConnectTimeoutSecs expira sin una conexión exitosa, incluso después de los intentos apropiados (ver ConnectRetrySecs), se enviará al cliente una respueta "HTTP 503/Service Unavailable".
Podemos personalizar la respuesta de error usando el parámetro ErrorPage.
|
| ConnectRetrySecs |
2 |
Intervalo, en segundos que el plug-in debería esperar entre intentos de conexión con el Servidor WebLogic (o todos los servidores en el cluster). Debemos hacer este número menor que ConnectTimeoutSecs. El número de veces que el plug-in intenta conectar antes de devolver al cliente una respuesta "HTTP 503/Service Unavailable" se calcula dividiendo ConnectTimeoutSecs entre ConnectRetrySecs.
Para no especificar entradas, seleccionamos ConnectRetrySecs igual a ConnectTimeoutSecs. Sin embargo, el plug-in intenta conectarse al menos dos veces.
Podemos personalizar la respuesta de error usando el parámetro ErrorPage.
|
| Debug |
OFF |
Seleccionamos el tipo de log realizado para operaciones de depurado. No es recomendable activar estas opciones de depuración en sistemas de producción.
La información de depuración se escribe en el fichero /tmp/wlproxy.log en sistemas UNIX y en c:\tmp\wlproxy.log sobre sistemas Windows NT/2000.
Podemos seleccionar cualquiera de las siguientes opciones de log (las opciones HFC,HTW,HFW, y HTC podrían seleccionarse en combinaiones introduciéndolas separadas por comas, por ejemplo “HFC,HTW”):
- ON
El plug-in guarda solo mensajes informativos y de error.
- OFF
No se guarda información de depuración.
- HFC
El plug-in guarda cabeceras del cliente, y mensajes informativos y de error.
- HTW
El plug-in guarda cabeceras enviadas al servidor WebLogic, mensajes informativos y mensajes de error.
- HFW
El plug-in guarda cabeceras enviadas desde el servidor WebLogic, mensajes informativos y mensajes de error.
- HTC
El plug-in guarda cabeceras enviadas al cliente, mensajes informativos y mensajes de error.
- ALL
El plug-in guarda cabeceras enviadas al y desde el cliente, cabeceras enviadas al y desde el servidor WebLogic, mensajes informativos y mensajes de error.
|
| DebugConfigInfo |
OFF |
Activa el parámetro especial de consulta “__WebLogicBridgeConfig”. Usado para obtener detalles sobre los parámetros de configuración desde el plug-in.
Por ejemplo, si activamos “__WebLogicBridgeConfig” seleccionando DebugConfigInfo y luego envíamos una solicitud que incluye el string de consulta ?__WebLogicBridgeConfig, el plug-in obtiene la información de configuración es estadísticas en tiempo de ejecución y devuelve la información al navegador. El plug-in no conecta con el Servidor WebLogic en este caso.
Este parámetro es estrictamente para depuración y el formato de los mensajes de salidas puede cambiar con las versiones. Por razones de seguridad, mantenemos este parámetro desactivado en sistemas de producción.
|
StatPath
(No disponible en el Plug-in de
Microsoft Internet Information Server) |
false |
Si se selecciona a true, el plug-in chequea la existencia y los permisos de path traducido (“Proxy-Path-Translated”) de la solicitud antes de enviarla al Servidor WebLogic.
Si el fichero no existe, se devuelve al cliente una respuesta "HTTP 404 File Not Found". Si el fichero existe pero no es leíble por todo el mundo, se le devuelve al cliente una respuesta "HTTP 403/Forbidden". En cualquier caso, el mecanismo por defecto para que el Servidor Web maneje estas respuestas rellena el cuerpo de la respuesta. Esta opción es útil si tanto la aplicación Web del Servidor WebLogic como el servidor Web tiene el mismo documento raíz.
Podemos peronalizar la respuesta de error usando el parámetro ErrorPage.
|
| ErrorPage |
ninguno |
Podemos crear nuestra propia página de error que se muestra cuando nuestro servidor Web no peude re-enviar solicitudes al Servidor WebLogic. Podemos seleccionar este parámetro de dos formas:
|
| HungServerRecoverSecs |
300 |
Define la cantidad de tiempo que el plug-in espera una respuesta a una petición desde el Servidor WebLogic. El plug-in espera durante HungServerRecoverSecs a que el servidor responda y luego declara el servidor como muerto, y pasa al próximo servidor. El valor debería seleccionarse a un valor muy grande. Si el valor es menor que el tiempo que tardan en procesarse los servlets, podríamos ver resultados inesperados.
Valor mínino: 10
|
| Idempotent |
ON |
Cuando se selecciona a ON si el servidor no responde en HungServerRecoverSecs, el plug-in pasa al siguiente servidor.
Si se selecciona a OFF el plug-no pasa a otro servidor. Si estámos usando el Netscape Enterprise Server Plug-In, o Apache HTTP Server
podemos seleccionar este parámetro de forma diferente para diferentes URLs o tipos MIME.
|
| CookieName |
JSESSIONID |
Si cambiamos el nombre del cookie de sesión del Servidor WebLogic en la Aplicación Web del Servidor WebLogic, necesitamos cambiar el parámetro CookieName en el plug-in al mismo valor.
El nombre del cookie de sesión WebLogic se selecciona en el descriptor de despliegue específico de WebLogic, en el elemento <session-descriptor>.
|
| DefaultFileName |
ninguno |
El plug-in realiza los siguientes pasos:
- Recorta el path especificado con el parámetro PathTrim.
- Si la URI es “/” el plug-in le añade el valor de DefaultFileName.
- Añade el valor especificado con PathPrepend.
Este procedimiento evita redirecciones desde el Servidor WebLogic.
Seleccionamos DefaultFileName a la página de bienvenida por defecto de la Aplicación Web en el Servidor WebLogic al que se pasan las peticiones. Por ejemplo, si DefaultFileName se selecciona a welcome.html, y PathTrim se selecciona a /weblogic, una solicitud como: “http://somehost/weblogic” se convierte en “http://somehost/welcome.html”.
Para que este parámetro funcione, se debe especificar el mismo fichero de bienvenida en todas las Aplicaciones Web a las que se les redirigen solicitudes.
Nota: para el plug-in de Apache usando Stronghold o Raven: No debemos definir el parámetro DefaultFileName en un bloque IFmodule. En su lugar, debemos definirlo en un bloque Location.
|
| MaxPostSize |
-1 |
Máximo tamaño permitido de los datos POST, en bytes. Si la longitud del contenido excede de MaxPostSize, el plug-in devuelve un mensaje se error. Si se selecciona a -1, no se chequea el tamaño de los datos POST.
Esto es útil para evitar ataques de denegación-de-servicio que intentan sobrecargar el servidor con datos POST.
|
MatchExpression
(sólo Apache HTTP Server) |
ninguno |
Cuando se pasa por tipo MIME, seleccionamos el patrón de nombre de fichero dentro de un bloque IfModule usando el parámetro MatchExpression.
Ejemplo de cuando pasamos por tipo MIME:
<IfModule mod_weblogic.c>
MatchExpression *.jsp
WebLogicHost=myHost|paramName=value
</IfModule>
Ejemplo de cuando se pasa por path:
<IfModule mod_weblogic.c>
MatchExpression /weblogic
WebLogicHost=myHost|paramName=value
</IfModule>
|
| FileCaching |
ON |
Cuando se selecciona a ON, y el tamaño de los datos POST de una petición es mayor de 2048 bytes, los datos POST son almacenados en disco en un fichero temporal y reenviados al Servidor WebLogic en trozos de 8192 bytes. Sin embargo, seleccionar FileCaching a ON, puede causar un problema con la barra de progreso mostrada por el navegador que indica el progeso de la descarga. El navegador muestra que la descarga se ha completado incluso aunque el fichero se esté transfiriendo todavía.
Cuando se selecciona a OFF y el tamaño de los datos POST es mayor de 2048 bytes, los datos POST son almacenados en memoria y enviados al Servidor WebLogic en trozos de 8192 bytes. Seleccionarla a OFF puede causar problemas si el servidor se apaga durante el procesamiento de la petición porque el plug-in no podrá corregir el fallo.
|
WlForwardPath
(sólo Microsoft Internet
Information Server) |
null |
Si WlForwardPath se selecciona a "/" todas las peticiones serán pasadas. Para reenviar cualquier petición que empiece con un string particular, seleccionamos WlForwardPath a ese string. Por ejemplo, seleccionado WlForwardPath a /weblogic renviará todas las peticiones que empiecen con /weblogic al Servidor WebLogic.
Este parámetro es necesario si estámos pasando por path. Podemos seleccionar múltiples strings separándolas con comas. Por ejemplo: WlForwardPath=/weblogic,/bea.
|
MaxSkips
(solo Microsoft Internet
Information Server) |
10 |
Válido sólo si DynamicServerList se selecciona a OFF.
Si falla un Servidor WebLogic listado en el parámetro WebLogicCluster o en la lista dinámica de clusters devuelta por un Servidor WebLogic, ese servidor se marca como "bad" y el plug-in tentan conectar con el siguiente servidor de la lista:
MaxSkips selecciona el número de intentos después de que el plug-in reintente un servidor marcado como “bad”.
|
DynamicServerList
(solo Microsoft Internet
Information Server) |
ON |
Cuando se selecciona a OFF, el plug-in ignora la lista dinámica de clusters usada para el balance de carga y sólo usa la lista estática especificada con el parámetro WebLogicCluster. Normalmente este parámetro debería permanecer a ON.
Hay algunas implicaciones al seleccionar este parámetro a OFF:
- Si fallan uno o más servidores de la lista estática, el plug-in puede gastar mucho tiempo intentando conectar con un servidor muerto, resultando en un decremento del rendimiento,
- Si añadimos un nuevo servidor al cluster, el plug-in no podrá pasarle peticiones a menos que redefinamos este parámetros. WebLogic Server añade automáticamente los nuevos servidores a la lista dinámica de servidores cuando se convierten en parte del cluster.
|
Tutoriales
Introducción