escuela tcnica superior de ingeniera informtica

Introduccin a Apache Tomcat 5.5

Departamento de Lenguajes y Sistemas Inform Informticos

Grupo de Ingenier Ingeniera del Software

Febrero 2007

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Qu Qu es Apache Tomcat? Tomcat?

Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

Es un servidor HTTP y un contenedor de servlets. Es la implementaci implementacin de referencia de las especificaciones de servlets (2.4) y de JSP (2.0). Es software libre (licencia Apache 2.0) gestionado por la fundacin Apache. Apache Puede funcionar como servidor HTTP o conectado a otro servidor HTTP como Apache HTTP Server o IIS. IIS Puede ejecutar servicios web mediante Apache Axis. Axis La versin actual es la 5.5.20. La versin 6 est an en fase beta.
1
Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat 2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

Versin original: Amador Durn y Ramn Medel (febrero 2007)

Tiempo: 1h

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Descarga de Tomcat
Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

Descargar la versin que se instala manualmente descomprimiendo un zip (Windows) o un tar.gz (Linux). Descargar tambin la aplicacin de administracin.

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Proceso de instalaci instalacin

Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

(Se asume que se ha instalado previamente un JDK 5) 5 1. Descomprimir el archivo, por ejemplo en:
c:\apache-tomcat-5.5.20 (Windows) /usr/local/apache-tomcat-5.5.20 (Linux)
Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat 2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

2. Crear las siguientes variables de entorno:

CATALINA_HOME = directorio donde se ha instalado Tomcat JAVA_HOME = directorio del JDK

3. Aadir $JAVA_HOME/ $JAVA_HOME/bin al PATH. 4. Ejecutar $CATALINA_HOME/ $CATALINA_HOME/bin/ bin/startup para arrancar Tomcat. 5. Abrir http:// localhost:8080 :8080 en un navegador y comprobar http://localhost que aparecer la pgina de bienvenida de Tomcat. 6. Ejecutar $CATALINA_HOME/ $CATALINA_HOME/bin/ bin/shutdown para parar Tomcat.

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

7. Volver a abrir http:// localhost:8080 :8080 en un navegador y http://localhost comprobar que Tomcat ya no est funcionando.
3

Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat

No descargar la versin que lo instala como un servicio de Windows si se va a usar para desarrollar.

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Proceso de instalaci instalacin

Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Proceso de instalaci instalacin

Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

<user username="admin" password=""

roles="admin,manager" />

9. Descomprimir el archivo de la aplicacin de administracin. 10.Arrancar Tomcat y acceder a las aplicaciones de gestin y de administracin.

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat

8. Para poder acceder a las aplicaciones de gestin y administracin es necesario crear un usuario de Tomcat con los roles adecuados. Para ello, aadir un elemento similar al siguiente al documento $CATALINA_HOME/ $CATALINA_HOME/conf/ conf/tomcattomcat-users.xml: users.xml

Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Estructura de directorios
Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

Ejecutable Ejecutable de de Tomcat, Tomcat, scripts scripts y y precompilador precompilador de de JSP JSP Clases Clases y y JARs JARs accesibles accesibles a a todas todas las las aplicaciones aplicaciones web web y ya a Tomcat Tomcat Archivos Archivos de de configuracin, configuracin, p.e. p.e. server.xml server.xml Archivos Archivos de de registro registro (log) (log) de de Tomcat Tomcat Clases Clases y y aplicaciones aplicaciones accesibles accesibles slo slo a a Tomcat, Tomcat, p.e. p.e. manager manager y y admin admin Clases Clases y y JARs JARs accesibles accesibles a a todas todas las las aplicaciones aplicaciones web web Archivos Archivos temporales temporales Aplicaciones web Aplicaciones web, web, incluyendo incluyendo ROOT ROOT y y algunas algunas de de ejemplo ejemplo Archivos Archivos temporales, temporales, JSP JSP compilados, compilados, etc. etc. Se pueden arrancar varias instancias de Tomcat y que usen configuraciones distintas mediante la variable de entorno CATALINA_BASE
Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat 2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Mltiples instancias de Tomcat

Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

El resto de directorios los usa de CATALINA_HOME. Es lo que hacen entornos de desarrollo como Eclipse o NetBeans: NetBeans arrancan su propia instancia de Tomcat usando su propia configuracin. En el caso de NetBeans, NetBeans incluye un Tomcat interno. No hace falta ni siquiera instalarlo.

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat

Se pueden arrancar varias instancias de Tomcat y que usen configuraciones distintas mediante la variable de entorno CATALINA_BASE. Dentro de CATALINA_BASE deben existir los directorios conf, logs, temp, webapps y work.

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Estructura de una aplicaci aplicacin web

Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

zona p pblica de la aplicaci aplicacin (puede organizarse como se desee)

zona privada de la aplicaci aplicacin (META-INF es opcional)

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Estructura de una aplicaci aplicacin web

Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

Directorio raz
Contiene la parte pblica de la aplicacin: documentos HTML, JSP, CSS, cdigo JavaScript, imgenes, etc.
Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat 2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

Lo habitual es organizarlo en varios subdirectorios: para imgenes, para estilos, etc.

WEB-INF
Contiene la parte privada de la aplicacin: el descriptor de despliegue de la aplicaci web.xml), aplicacin (web.xml las clases compiladas (classes), las bibliotecas de clases (lib) y las etiquetas para usar en los documentos JSP (tld).

META-INF
Es opcional y suele contener slo el archivo MANIFEST.MF, que indica las bibliotecas de las que depende la aplicacin. Se suele generar automticamente.

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Despliegue de una aplicaci aplicacin web

Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

Archivos WAR
La forma ms sencilla de desplegar (instalar) una aplicacin web en Tomcat es copiar el archivo WAR de la aplicacin en $CATALINA_HOME/webapps: Tomcat lo descomprimir e instalar la aplicacin automticamente. Un archivo WAR no es ms que el directorio de la aplicacin comprimido en un archivo en formato ZIP. Tanto Eclipse como NetBeans permiten generar archivos WAR de forma automtica.

2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

Despliegue manual
Se puede crear el directorio a mano, copiar los archivos y desplegar la aplicacin con la aplicacin de gestion (manager) que viene con Tomcat. Ese proceso se puede automatizar con la herramienta Ant. Ant

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

10

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Descriptor de despliegue de una aplicaci aplicacin web

Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

Archivo web.xml
El archivo $CATALINA_HOME/ $CATALINA_HOME/conf/ conf/web.xml establece opciones por defecto para todas las aplicaciones, p.e. el procesamiento de pginas JSP. Cada aplicacin tiene su propio web.xml, web.xml normalmente generado por el entorno de desarrollo, en el directorio WEB-INF. Algunos elementos interesantes de web.xml son:
<icon> icon>: icono de la aplicacin <displaydisplay-name> name>: nombre de la aplicacin <description> description>: descripcin de la aplicacin <servlet> servlet>: declaracin de un servlet <servletservlet-mapping> mapping>: mapeo de un servlet a una URL <sessionsession-config> config>: configura parmetros de la sesin <welcomewelcome-filefile-list> list>: define los documentos por defecto

2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

Lo habitual es que los entornos de desarrollo generen el archivo web.xml y que, si es necesario, se edite visualmente.

11

Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat

Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Edici Edicin del archivo web.xml (Eclipse 3.2)

Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

12

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Edici Edicin del archivo web.xml (NetBeans 5.5)

Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

13

Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat

Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Aplicaci ) Aplicacin de administraci administracin (server.xml (server.xml)

Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

14

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Bibliograf Bibliografa recomendada

Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

Tomcat: Tomcat: The Definitive Guide. Guide J. Britain y I. F. Darwin. O'Reilly, 2003. Consultar tambin artculos en www.onjava.com. www.onjava.com Documentaci Documentacin de Tomcat. Tomcat http://tomcat.apache.org Fundacin Apache, 2007.

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

15

Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat

Proffesional Apache Tomcat 5. V. Chopra et al. Wrox, 2004. En especial los captulos 3 y 6.

Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat

[ngel US V7] Diseo: Amador Durn Toro (2003-2006)

Introducci Introduccin a Apache Tomcat 5.5

Instalar Tomcat
Escuela Tcnica Superior de Ingeniera Informtica Departamento de Lenguajes y Sistemas Informticos

2. Instalaci Instalacin de Tomcat 3. Estructura de directorios de Tomcat 4. Aplicaciones web en Tomcat 5. Administraci Administracin de Tomcat 6. Para saber m ms 7. Ejercicios

Investigue sobre el contenido de los archivos de configuracin server.xml y web.xml. web.xml

Instalar otros contenedores de servlets

Existen alternativas libres a Tomcat como Jetty, Jetty Resin o Jigsaw. Jigsaw Investigue sobre sus caractersticas comparndolas con Tomcat.

Usar Ant para compilar y desplegar una aplicaci aplicacin

Compilar y desplegar manualmente una aplicacin es una tarea tediosa. Ant es una herramienta que permite automatizar la construccin y despliegue de aplicaciones web. Investigue sobre ella.

TOMCAT
Sevilla, febrero de 2007 Grupo de Ingeniera del Software

16

Versin original: Amador Durn y Ramn Medel (febrero 2007)

1. Introducci Introduccin a Tomcat

Descargue e instale la ltima versin de Tomcat y compruebe que funciona. Si puede, hgalo en ms de un sistema operativo. Cree pginas HTML en la aplicacin por defecto (ROOT) y cree su propia aplicacin web.