Tomcat - Introducción

• Los Workers Tomcat
• Definir Workers
• Configurar Propiedades del Worker
• Propiedades de un Worker ajp12
• Propiedades de un Wroker ajp13
• Propiedades de un Worker lb
• Propiedades de un Worker jni
• Macros en Ficheros de Propiedades
• El ejemplo worker.properties

Los Workers Tomcat

Un worker Tomcat es un ejemplar Tomcat que está esperando para ejecutar servlets por cuenta de algún servidor web. Por ejemplo, podemos tener un servidor web como Apache reenviando peticiones servlets a un proceso Tomcat (el worker que se ejecuta detrás de él.

El escenario descrito arriba es uno muy simple; de hecho uno puede configurar múltiples workers para servir servlets por cuenta de un cierto servidor web. Las razones para dicha configuración pueden ser:

• Queremos que diferentes contextos sean servidos por diferentes workers Tomcat para proporcionar un entorno de desarrollo donde todos los desarrolladores compartan el mismo servidor pero con su propio worker Tomcat.
• Queremos que diferentes host virtuales servidos por diferentes procesos Tomcat proporcionen una clara separación entre los sites pertenecientes a distintas compañías.
• Queremos proporcionar un balance de carga, lo que significa ejecutar múltiples workers Tomcat cada uno en su propia máquina y distribuir las peticiones entre ellos.

Probablemente haya más razones para tener múltiples workers pero creo que esta lista es suficiente...

Los workers están definidos en un fichero de propiedades llamado workers.properties y está página explica como trabajar con él.

 Definir Workers

La definición de workers para el plugin Tomcat del servidor web puede hacerse usando un fichero de propiedades (un fichero de ejemplo llamado workers.properties está disponible en el directorio conf/); el fichero contiene entradas con la siguiente forma:

worker.list=<una lista separada por comas de nombres de workers >

Por ejemplo:

worker.list= ajp12, ajp13

Y

worker.<nombre de worker>.<property>=<valor de propiedad>

Por ejemplo:

worker.local.port=8007

Cuando arranque, el plugin del servidor web ejemplarizará los workers cuyos nombres aparezcan en la propiedad worker.list, estos también son los workers a los que podemos mapear peticiones.

Cada worker nombrado debería tener una pocas entradas para proporcionar información adicional sobre sí mismo; esta información incluye el tipo de worker y otra información relacionada. Actualmente existen estos tipos de workers en (Tomcat 3.2-dev):

Definir workers de un cierto tipo debería hacerse siguiendo este formato de propiedad:

worker.<worker name>.type=<worker type>

Donde worker name es el nombre asignado al worker y worker type es uno de los cuatro tipos definidos en la tabla. Un nombre de worker podría no contener espacios (una buena convención de nombres sería utilizar las reglas de nombrado para las variables Java).

Por ejemplo:

 Configurar Propiedades del Worker

Después de definir los workers podemos especificar propiedades para ellos. Las propiedades se pueden especificar de la siguiente manera:

worker.<worker name>.<property>=<property value>

Cada worker tiene un conjunto de propiedades que podemos configurar según se especifica en las siguientes subsecciones:

 Propiedades de un Worker ajp12

Los workers del tipo ajp12 reenvían peticiones a workers Tomcat fuera-de-proceso usando el protocolo ajpv12 sobre sockets TCP/IP. La siguiente tabla especifica las propiedades que puede aceptar un worker ajp12:

 Propiedades de un Wroker ajp13

Los workers del tipo ajp13 reenvían peticiones a workers Tomcat fuera-de-proceso usando el protocolo ajpv13 sobre sockets TCP/IP. Las principales diferencias entre ajpv12 y ajpv13 son que:

1. ajpv13 es un protocolo más binario e intenta comprimir algunos de los datos solicitados codificando los strings más frecuentemente usados en enteros pequeños.
2. ajpv13 reusa sockets abiertos y los deja abiertos para futuras peticiones.
3. ajpv13 tiene un tratamiento especial para información SSL por eso el contenedor puede implementar métodos relacionados cono SSL como isSecure().

La siguiente tabla especifica las propiedades que puede aceptar un worker ajp13:

 Propiedades de un Worker lb

El worker de balanceo de cargas realmente no se comunica con otros workers Tomcat, en su lugar es el responsable de varios workers "reales". Este control incluye:

• Ejemplarizar los workers en el servidor web.
• Usar el factor de balanceo de carga, realizando un balanceo de carga al redondeo de peso donde el lbfactor más alto significa una máquina más fuerte (es la que manejará más peticiones).
• Seguimiento de las peticiones que pertenecen a la misma sesión y que se ejecutan en el mismo worker Tomcat.
• Identificar los workers Tomcat fallidos, suspender las peticiones a estos workers y hacer que otros workers las manejen.

El resultado general es que los workers manejados por el mismo worker lb tienen balance de cargas (basándose en su lbfactor y la sesión de usuario actual) y tambíen tienen anti-caída por lo que si un proceso Tomcat muere, no "matará" toda la site.

La siguiente tabla especifica las propiedades que puede aceptar un worker lb:

 Propiedades de un Worker jni

El worker jni abre una JVM dentro del proceso del servidor web y ejecuta Tomcat dentro de ella (es decir en-proceso). Después de esto, los mensajes pasados hacia y desde la JVM son pasados usando llamadas a métodos JNI, esto hace al worker jni más rápido que los workers fuera-de-proceso que necesitan comunicarse con los workers Tomcat escribiendo mensajes AJP sobre sockets TCP/IP.

Nota: como la JVM es multi-thread; el worker jni sólo se debería usar dentro de servidores multi-thread como AOLServer, IIS, Netscape y Apache2.0. Deberíamos asegurarnos de que el esquema de threads usado por el servidor web corresponde con el usado para construir el plugin jk del servidor web.

Como el worker jni abre una JVM puede aceptar tantas propiedades como pueda reenviar a la JVM como el classpath, etc. como podemos ver en la siguiente tabla:

worker.localjni.class_path=path-to-some-jarfile
worker.localjni.class_path=path-to-class-directory

worker.localjni.cmd_line=-config
worker.localjni.cmd_line=path-to-tomcats-server.xml-file
worker.localjni.cmd_line=-home
worker.localjni.cmd_line=-path-to-tomcat-home

 Macros en Ficheros de Propiedades

Desde Tomcat3.2 podemos definir macros en los ficheros de propiedades. Estas macros nos permite definir propiedades y posteriormente usarlas cuando construyamos otras propiedades. Por ejemplo, el siguiente fragmento:

workers.tomcat_home=c:\jakarta-tomcat
workers.java_home=c:\jdk1.2.2
ps=\
worker.inprocess.class_path=$(workers.tomcat_home)$(ps)classes
worker.inprocess.class_path=$(workers.java_home)$(ps)lib$(ps)tools.jar

Terminará con los siguientes valores para las propiedades worker.inprocess.class_path:

worker.inprocess.class_path= c:\jakarta-tomcat\classes
worker.inprocess.class_path=c:\jdk1.2.2\lib\tools.jar

 El ejemplo worker.properties

Como escribir worker.properties por nosotros mismos no es una cosa fácil de hacer; junto con los paquetes de Tomcat3.2 (y superiores) viene un fichero worker.properties de ejemplo. Este fichero está pensado para ser tan genérico como sea posible y usa extensivamente las macros de propiedades.

El ejemplo worker.properties contiene el siguiente nivel de definiciones:

1. Un worker ajp12 que usa el host localhost y el puerto 8007.
2. Un worker ajp13 que usa el host localhost y el puerto 8009.
3. Un worker jni.
4. Un worker lb que balancea la carga de los workers ajp12 y ajp13.

Las definicioens de los workers ajp12, ajp13 y lb pueden funcionar sin modificar el fichero. Sin embargo, para hacer que funcione el worker jni deberemos configurar las siguientes configuraciones en el fichero:

• workers.tomcat_home
  - tiene que apuntar a nuestro tomcat_home.
• workers.java_home
  - tiene que apuntar a donde tengamos situado el JDK.
• ps
  - tiene que apuntar al separador de ficheros de nuestro sistema operativo.

Cuando hagamos esto, el worker jni por defecto, debería funcionar.