AMPLIACIN DE BASES DE DATOS

INSTALACIN Y CONFIGURACIN DE TOMCAT

Soporte de Oracle a Aplicaciones

Orlando Alemn Ortiz

4 Ing. Informtica Curso 2005/06

Licencia
Esta obra ha sido publicada bajo licencia "ReconocimientoNoComercial-CompartirIgual 2.5 Spain" de Creative Commons, la cual implica que: Usted es libre de: copiar, distribuir y comunicar pblicamente la obra hacer obras derivadas Bajo las condiciones siguientes:

Reconocimiento. Debe reconocer los crditos de la obra de la manera especificada por el autor o el licenciador.

No comercial. No puede utilizar esta obra para fines comerciales.

Compartir bajo la misma licencia. Si altera o transforma esta obra, o genera una obra derivada, slo puede distribuir la obra generada bajo una licencia idntica a sta.

Y adems: Al reutilizar o distribuir la obra, tiene que dejar bien claro los trminos de la licencia de esta obra. Alguna de estas condiciones puede no aplicarse si se obtiene el permiso del titular de los derechos de autor Los derechos derivados de usos legtimos u otras limitaciones reconocidas por ley no se ven afectados por lo anterior. Para ver una copia de esta licencia, visite http://creativecommons.org/licenses/by-nc-sa/2.5/es/ o envie una carta a Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.

2007. Orlando Alemn Ortiz Las Palmas de Gran Canaria, Espaa. [email protected] http://orlando.pi314.es
2

ndice de contenido
Objetivos................................................................................................................................4 Introduccin............................................................................................................................4 Requisitos del entorno de instalacin....................................................................................4 Software utilizado...................................................................................................................5 Instalacin de Tomcat............................................................................................................5 Comprobacin: Puesta en funcionamiento............................................................................6 Configuracin bsica de Tomcat...........................................................................................6 Comprobacin: Ejecucin de una aplicacin JSP.................................................................8 Instalacin del driver JDBC....................................................................................................8 Anexo I.................................................................................................................................10 Anexo II................................................................................................................................12

Objetivos
Instalacin y configuracin de Apache Tomcat como servidor Web Instalacin del driver Oracle para JDBC

Introduccin
El presente documento pretende abordar de manera sencilla la instalacin de un servidor de aplicaciones bsico que d soporte para acceder a un sistema de gestin de bases de datos. En este contexto, Apache Tomcat aparece como una opcin ms que interesante, ya que soporta JavaServer Pages y el estndar de acceso JDBC. Apache Tomcat, o simplemente Tomcat, es un contenedor de servlets o programas que ofrecen funciones suplementarias a un servidor. Incluye el compilador Jasper, que compila las JSPs convirtindolas en servlets. A menudo se presenta como motor de servlets en combinacin con un servidor Web (generalmente Apache), aunque tambin puede funcionar como servidor Web por s mismo, eso s, con peor rendimiento. Dado que Tomcat fue escrito en Java, funciona en cualquier sistema operativo que disponga de la mquina virtual. Las JavaServer Pages son los elementos bsicos de una tecnologa desarrollada por Sun Microsystems, basada en el procesamiento de scripts Java y que permite a los desarrolladores generar dinmicamente pginas web (HTML, XML u de otro tipo). Para posibilitar el acceso a una base de datos desde una pgina JSP haciendo uso de JDBC se necesita de un driver o controlador, que de no estar estar ya incluido en las libreras de la mquina virtual, pudiera hacer necesaria su adquisicin.

Requisitos del entorno de instalacin

Las caractersticas del entorno donde se va a llevar a cabo la instalacin son:

Mquina: Computador Personal (x86) Sistema Operativo: Microsoft Windows XP Software Instalado: J2SE 1.5 [Imprescindible]

Software de compresin/descompresin: 7zip [slo en el caso de bajar binarios comprimidos]

El hecho de ejecutar Tomcat sobre la mquina virtual de Java posibilita su instalacin en la mayora de plataformas existentes hoy da, pese a que en nuestro caso lo hagamos sobre el sistema operativo de Microsoft.

Requisitos del entorno de instalacin

Software utilizado

Apache Tomcat 4.1 (http://tomcat.apache.org/download-41.cgi) JDBC Driver para Oracle 10g (http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html)

Instalacin de Tomcat
Pongamos por caso que hemos descargado Tomcat en el formato comprimido TAR.GZ. Haciendo uso de una herramienta de descompresin, extraemos el contenido hacia el directorio donde se va a montar el servidor, denominado en Tomcat con la denominacin CATALINA_HOME. En nuestro caso su ruta ser "C:\tomcat". Como consecuencia del proceso, en "C:\tomcat" podremos encontrar la siguiente estructura de directorios:

bin - arranque, cierre, y otros scripts y ejecutables common - clases comunes que pueden utilizar Catalina y las aplicaciones web conf ficheros XML y los correspondientes DTDs para la configuracin de Tomcat logs - logs de Catalina y de las aplicaciones server - clases utilizadas solamente por Catalina shared - clases compartidas por todas las aplicaciones web temp almacenamiento temporal para la mquina Java webapps - directorio que contiene las aplicaciones web work - almacenamiento temporal de ficheros y directorios
(fuente: Wikipedia)

Pero no basta simplemente con situar los archivos, tambin es necesario indicar de forma global su localizacin final. sto se hace mediante la definicin de la variable global CATALINA_HOME, que evidentemente contendr el path del servidor de aplicaciones. Para definir una variable global en Windows disponemos de varias posibilidades. La primera es hacer uso del comando "SET" en el terminal desde el que luego se arrancar el servidor. Vase: C:\> set CATALINA_HOME="C:\tomcat" La desventaja de este mtodo es que su efecto dura lo que dure la sesin en el terminal donde se ejecut la instruccin. Su utilizacin en un archivo de ejecucin por lotes (.bat) podra ser la mejor salida Una segunda forma, y posiblemente la mejor, es definir CATALINA_HOME como una variable global de usuario o de sistema. Para ello, accedemos a "Inicio > Panel de Control > Mi PC > Propiedades > Opciones avanzadas > Variables de entorno" y aadimos una
Instalacin de Tomcat 5

entrada para la nueva definicin. Un detalle a comprobar antes de acabar con primera fase es si la variable JAVA_HOME se encuentra definida y apunta correctamente al directorio raz de la instalacin de la J2SE Development Kit. Para ello, ejecutamos "set" sin parmetros en una consola. Como resultado obtendremos la lista de variables definidas actualmente. En caso de que no se encuentre definida o no posea la ruta completa, procedemos como en la definicin de CATALINA_HOME.

Comprobacin: Puesta en funcionamiento

El mejor mtodo para conocer si el proceso marcha bien es ejecutar el Tomcat. Por defecto est configurado para ofrecer una pgina de prueba muy sencilla. As que, si nos encontramos algn problema durante esta fase, seguro ser de nuestra cosecha. La orden para iniciar la ejecucin es: %CATALINA_HOME%\bin\startup Como consecuencia, el servidor arrancar escuchando peticiones sobre uno o varios puertos. En este caso, observamos que uno de ellos es el 8080. Si tecleamos ahora en un navegador la direccin "http://localhost:8080" obtendremos la pgina de prueba que habamos dicho. Antes de pasar a la siguiente etapa conviene detener la ejecucin del servidor. sto lo conseguiremos ejecutando %CATALINA_HOME%\bin\shutdown

Configuracin bsica de Tomcat

Los aspectos de configuracin ms importantes para nuestros propsitos actuales se encuentran recogidos en dos ficheros situados bajo "%CATALINA_HOME%\conf". "web.xml" recoge los valores por defecto a utilizar por todas las aplicaciones web cargadas en la instancia de Tomcat, como pudiera ser por ejemplo la pgina a cargar por defecto. "server.xml", por contra, contiene la definicin estructural del servidor: Nombre del host, servicios, conectores, etc. En principio, nos conformamos con el contenido actual de "web.xml" y pasamos a explicar algunos detalles de "server.xml".
Componentes Del Fichero "server.xml"
Etiqueta <server> </server> Explicacin Ejemplo (nico y engloba toda la configuracin) <Server port="8005" Define el elemento de configuracin bsico shutdown="SHUTDOWN"> del fichero server.xml Es nico y contiene uno o ms servicios ("Service"). El atributo "port" indica el puerto destinado a la escucha del comando de cierre, indicado por "shutdown" o cierre. (nico) Permiten definir las clases JMX que <Listener className="org.apache.catalina.mbean 6

<Listener/>

Configuracin bsica de Tomcat

Componentes Del Fichero "server.xml"

permitir escuchar Tomcat. <GlobalNaming Resources> </GlobalNaming Resources> <Service> </Service> (nico) Permite definir elementos JNDI para ser utilizados globalmente. Estas etiquetas permiten agrupar uno o ms conectores de forma que compartan un nico contenedor de aplicaciones. Poseen un nico atributo, "name", que fija los identificadores individuales. Si "name" se fija como "Catalina" o "TomcatStandalone", se habilitar a Tomcat como servidor web independiente. (dentro de "Service") Conecta un contenedor de datos con el exterior, definiendo el elemento final a travs del cual se realizarn las peticiones de usuario y se enviarn las respuestas. Entre sus parmetros de configuracin estn el puerto de escucha, "port", la clase encargada de su definicin, "className" y el nmero mximo de conexiones simultneas permitidas, "acceptCount". (dentro de "Service") Punto donde se procesan las peticiones que llegan a los "Connector" que posean en la cabecera el valor de "defaultHost" como destino. (dentro de "Service" o de "Host") Permite establecer el nombre del fichero de logs. Como parmetros tiene la clase encargada de su definicin, "className", el formato nombre del archivo, como la unin de un prefijo, "preffix", y un sufijo, "suffix". s.ServerLifecycleListener" />

[VER ANEXO]
<Service name="TomcatStandalone"></Service>

<Connector />

<Connector className="org.apache.coyote.tomcat4 .CoyoteConnector" port="8080" minProcessors="5" maxProcessors="75" enableLookups="true" acceptCount="100" connectionTimeout="20000" useURIValidationHack="false" disableUploadTimeout="true" /> <Engine name="Standalone" defaultHost="localhost">

<Engine> </Engine>

<Logger/>

<Logger className="org.apache.catalina.logger .FileLogger" prefix="catalina_log." suffix=".txt" timestamp="true"/>

<Host></Host>

Con estas etiquetas podemos definir uno o <Host name="localhost" debug="0" ms elementos Host virtuales para atender appBase="webapps" a las peticiones. unpackWARs="true" autoDeploy="true"> (dentro de "Host") Se utiliza para indicar la ruta ("docBase") a partir de la cual se encuentran las aplicaciones a ser ejecutadas en Tomcat (a partir de "%CATALINA_HOME%\webapps" y el path url ("path") a partir del cual acceder a los servicios.

<Context> </Context>

[VER ANEXO]

En base a estas explicaciones, tomamos por base el mismo fichero que nos proporciona el fabricante y sobre l realizamos las modificaciones necesarias para adaptarlo a nuestras necesidades. En el Anexo I, se muestra el fichero de ejemplo que hemos confeccionado para esta prueba.

Configuracin bsica de Tomcat

Comprobacin: Ejecucin de una aplicacin JSP

Una vez hemos configurado Tomcat a nuestro gusto, pasamos a ejecutar una sencilla aplicacin web en JSP, ya que es este tipo de aplicaciones la finalidad ltima de nuestra tarea. En el Anexo II (pgina ) disponemos del fichero correspondiente. Debemos situarlo bajo "%CATALINA_HOME%\webapps\practica", que es la ruta que hemos establecido en "server.xml" como raz de nuestras aplicaciones.

Ilustracin 1: Ejecucin de aplicacin bsica

Instalacin del driver JDBC

Para acabar, procedemos a instalar el driver Oracle para JDBC. Existen dos posibilidades, instalarlo como librera de la mquina virtual de Java o ponerlo como recurso nico para el contexto que nos ocupa. Para nuestros propsitos basta con la segunda. El primer paso, y nico, es crear el rbol de directorios "WEB-INF/lib" bajo el directorio que fijamos como "docBase" en contexto del servidor y copiar el fichero *.jar correspondiente al driver a esa nueva ubicacin. Para utilizarlo desde una JavaServer Page basta con incluir en nuestro cdigo script un fragmento como el siguiente:

Instalacin del driver JDBC

try { // Cargamos el driver JDBC para Oracle Class.forName("oracle.jdbc.driver.OracleDriver"); } catch(ClassNotFoundException e) { System.out.println("Driver no encontrado."); System.out.println(e.toString()); throw new UnavailableException(this, "Clase no encontrada."); }

Y as podremos tener acceso a nuestra base de datos remota desde nuestro servicio web y disear aplicaciones como la siguiente:

Ilustracin 2: Aplicacin que con la configuracin actual, usa JDBC

Instalacin del driver JDBC

Anexo I
Fichero de configuracin "server.xml" creado para la demo. Su funcionamiento ha sido probado.

SERVER.XML

Anexo I

10

Anexo I

11

Anexo II
Fichero de demo, "index.jsp". Su funcionamiento ha sido probado en apartados anteriores:

Anexo II

12