![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
Script manageODR.py
Puede utilizar el script manageODR.py para crear un clúster de direccionadores on demand (ODR) y gestionar las reglas de direccionamiento y el registro personalizado.
Location
El script manageODR.py se encuentra en el directorio raíz_servidor_aplic/bin. Antes de ejecutar este script, asegúrese de que ha configurado la variable de entorno WAS_HOME de modo que apunte al directorio de la instalación de WebSphere.
Operaciones
- convertToCluster <nodo:odr> <clúster>: Convertir un ODR existente en el nodo nodo con el nombre odr en un clúster de ODR denominado <clúster>.
- createDynamicCluster <clúster> <grupoNodos>: Crear un clúster dinámico de ODR denominado <clúster> en nodos del grupo de nodos <grupoNodos>.
- addToCluster <nodo:odr> <clúster>: Crear un nuevo ODR en el nodo nodo con el nombre odr y añadirlo al clúster de ODR clúster.
- insertMultiClusterRoutingRule <clúster_o_servidor_odr> <familia_protocolos> <número_regla> <condición> <acción_varios_clústeres> <especificación_varios_clústeres>: Insertar una regla de direccionamiento ODR con una acción para equilibrar la carga o migrar tras error entre los clústeres en la misma célula o en células diferentes.
- insertRedirectRoutingRule <clúster_o_servidor_odr> <número_regla> <condición> <URL_redirección>: Inserte una regla de direccionamiento ODR con una acción para devolver una redirección al cliente. Esto sólo está soportado para la familia de protocolos HTTP.
- insertRejectRoutingRule <clúster_o_servidor_odr> <familia_protocolos> <número_regla> <condición> <código_error>: Inserte una regla de direccionamiento ODR con una acción para devolver un código de error específico al cliente.
- removeRoutingRule <clúster_o_servidor_odr> <familia_protocolos> <número_regla> : Eliminar la regla de direccionamiento de ODR especificada por la familia de protocolos (por ejemplo, la familia de protocolos HTTP) y el número de regla.
- listRoutingRules <clúster_o_servidor_odr> <familia_protocolos>: Listar las reglas de direccionamiento de ODR para la familia de protocolos especificada (por ejemplo, la familia de protocolos HTTP).
- insertLocalContentRoutingRule <clúster_o_servidor_odr> <número_regla> <condición> <vía_acceso_local>: Insertar una regla de direccionamiento ODR con una acción para servir contenido HTML estático desde el sistema de archivos local del ODR.
- insertCustomLogRule <clúster_o_servidor_odr> <número_regla> <condición> <formato_archivo_registro>: Insertar una regla de registro personalizado en la lista en la posición <número_regla>.
- RemoveCustomLogRule <clúster_o_servidor_odr> <número_regla>: Eliminar el número de regla de registro personalizado <número_regla.
- listCustomLogRules <clúster_o_servidor_odr>:
Listar las reglas de registro personalizado asociadas a un ODR o a un clúster de
ODR. Los argumentos son:
- <nodo:odr> es el nombre del nodo y ODR (por ejemplo, miNodo:miOdr).
- <clúster> es el nombre de un clúster de direccionadores On Demand (ODR).
- <clúster_o_servidor_odr> es <nodo:odr> o <clúster>.
- <familia_protocolos> es "HTTP" o "SIP".
- <número_regla> es el número de la regla, desde 1 al número total de reglas.
- <condición> es la condición (por ej. expresión booleana) que debe evaluarse como true para desencadenar la acción asociada.
- <acción_varios_clústeres> es "Failover", "WLOR" (Weighted Least Outstanding Requests) o "WRR" (Weighted Round Robin).
- <especificación_varios_clústeres> es una especificación de
varios clústeres en uno de los formatos siguientes:
- clúster = <nombre_célula>/<nombre_clúster>: para especificar un clúster específico.
- servidor = <nombre_célula>/<nombre_nodo>/<nombre_servidor>: para especificar un servidor específico.
- módulo= <nombre_célula>/<nombre_aplicación>/<nombre_edición>/<nombre_módulo>: para especificar todos los servidores en los que se despliega este módulo.
- <URL_redirección> es el URL donde redirigir la solicitud.
- <código_error> es el código de retorno de error que debe devolverse para una regla de direccionamiento de rechazo.
- <formato_archivo_registro> es una especificación que indica el nombre de archivo y formato de la entrada de registro.
- <vía_acceso_local> es el directorio desde donde debe servirse el contenido estático local.
El ejemplo siguiente muestra cómo crear un ODR HTTP llamado odr en el node 1:
wsadmin.sh -f createodr.jacl node1 odr odr
El ejemplo siguiente muestra cómo convertir un ODR llamado odr en el nodo node1 a un clúster de ODR llamado ODRCluster:
wsadmin.sh -f manageODR.py -lang jython convertToCluster node1:odr ODRClusterEl ejemplo siguiente muestra cómo añadir una regla de registro personalizado para colocar todas las solicitudes cuyo tiempo de servicio es superior a 2 segundos en el registro personalizado slow.log e incluir el servidor de aplicaciones al que se envió la solicitud y el tiempo de servicio:
wsadmin.sh -f manageODR.py -lang jython insertCustomLogRule myNode02:odr1 1 "service.time > 2000" "slow.log %t %r %Z %T"El ejemplo siguiente muestra cómo añadir una regla de registro personalizado para colocar todas las 503 respuestas en 503.log. La regla se añade en la posición 2. Si hay alguna regla existente en la posición 2, la nueva regla se inserta antes de la regla existente.
wsadmin.sh -f manageODR.py -lang jython insertCustomLogRule myNode02:odr1 2 "response.code = 503" "503.log %t %r %s"EL ejemplo siguiente muestra cómo añadir una regla de registro personalizado en la posición 1 para registrar los errores que se pueden producir al escribir una respuesta en un cliente en response.write.error.log:
wsadmin.sh -f manageODR.py -lang jython insertCustomLogRule node1:odr 1 "response.write.error" "response.write.error.log %t %r %s"