FAQ Hosting

Estructura de Directorios de Tomcat

Los directorios que se listan a continuación se encuentran ubicados en “/usr/local/tomcat-5.5/”

bin  Contiene los scripts de arrancar/parar

conf  Contiene varios ficheros de configuración incluyendo server.xml (el fichero de configuración principal de Tomcat) y web.xml que configura los valores por defecto para las distintas aplicaciones desplegadas en Tomcat.

lib Contiene varios ficheros jar que son utilizados por Tomcat, estos ficheros deben ser añadidos al classpath de Tomcat.

Estos son los principales, puede haber otros que generalmente no se modifican, como:

work  Generado automáticamente por Tomcat, este es el sitio donde Tomcat sitúa los ficheros intermedios (como las páginas JSP compiladas) durante su trabajo. Si borramos este directorio mientras se está ejecutando Tomcat no podremos ejecutar páginas JSP.

classes  Podemos crear este directorio para añadir clases adicionales al classpath. Cualquier clase que añadamos a este directorio encontrará un lugar en el classpath de Tomcat.

Configuracion de Tomcat, server.xml es el archivo principal de configuración para Tomcat, éste es un archivo en XML, el cual de no contener una estructura conforme a XML, se indicará al arranque de Tomcat, la ubicación de este archivo es:

 /usr/local/tomcat-5.5/conf/server.xml

A continuación se detallan algunas de las caracteristicas principales a tener en cuenta, tal como se indico, posee la estructura correspondiente XML.

<Server> es el elemento principal del archivo server.xml y todas las demás secciones deben encontrarse entre estos nodos (dentro de <Server> y </Server>), el atributo port indica el puerto TCP donde se espera la señal de cierre (shutdown) de Tomcat. Tenga en cuenta que los usuarios de planes que poseen Java, poseen acceso total a su server, por lo que ellos pueden modificar éste archivo.

<Listener> A través de los elementos <Listener> se configuran las extensiones JMX ("Java Management Extensions") que serán utilizadas por Tomcat, dichos elementos toman dos atributos : className que indica la Clase diseñada para escuchar sobre eventos JMX y debug para especificar el nivel de "debug" generado al tiempo de ejecución.

<Connector> El elemento Connector representa las conexiones (Puertos TCP) que serán abiertas por Tomcat al arranque, a su vez dentro de cada elemento Connector se definen diversos atributos los cuales dan más detalles acerca de la conexión.

 <Engine> – </Engine>  Los elementos <Engine> representan el mecanismo que atenderá toda solicitud arrivada Tomcat, esto es, toda solicitud recibida por las definiciones Connectors será procesada por <Engine>, los atributos de este elemento son los siguientes:

  defaulthost representa el nombre del servidor Tomcat mientras debug indica el nivel de "debug" generado al tiempo de ejecución
  Logger,  los elementos Logger le indican a Tomcat hacia donde deben ser enviados los registros "Logs"

<Host> – </Host>, los elementos Host permiten definir varios Hosts "Virtuales" para Tomcat, esto es, a través del elemento <Engine> se define un sitio para atender solicitudes, a través de Host es posible definir diversos sitios "Virtuales", un ejemplo puede ser:

      <Host name="dogmedia.com.mx" appBase="/home/vu000324/public_html/webapps"
            unpackWARs="true" autoDeploy="true"
            xmlValidation="false" xmlNamespaceAware="false">
       </Host>

Lo anterior indica que el sitio dogmedia.com.mx contiene sus aplicaciones bajo el directorio /home/vu000324/public_html/webapps, el atributo unpackWARs le indica a Tomcat que debe descomprimir los archivos WAR’s al arranque.

Otro archivo de configuracion es context.xml, que esta tambien en /usr/local/tomcat-5.5/conf el mismo al ser un XML posee tambien la estructura correspondiente pero por default solo tiene definido el elemento “<context>” el cual es utilizado para indicar la ubicación de las aplicaciones ejecutadas en Tomcat, en su configuración "Default" estas aplicaciones se encuentran dentro del directorio webapps bajo el directorio raíz de Tomcat ( /usr/local/tomcat ), según nuestros planes se modifica y un ejemplo seria:

      <Context>
          <WatchedResource>/home/vu000324/public_html/webapps/WEB-INF/web.xml</WatchedResource>
      </Context>

Antes nombramos los Wars, una pequeña definicion seria:

Una aplicación en Tomcat o cualquier Servlet Engine (Web-Container) es un conjunto de "JSP’s y/o "Servlets" agrupados con ciertos parámetros de arranque y seguridad, este conjunto de archivos/aplicación en todo Servlet Engine es conocido como un WAR (Web-Archive).

Luego de modificar los archivos de configuracion de Tomcat, hay que reiniciarlo usando los scripts que hay en el directorio bin.