Como montar un servidor Tomcat

Buenos días chavalotes.

El tema de hoy no es otro que ver cómo podemos montar y configurar un servidor Tomcat para nuestras necesidades que imagino variarán de un lector a otro. Como se que es difícil establecer un sistema operativo con el que acertar con cualquier lector, voy a explicar cómo hacerlo en dos distintos: linux y windows.

Lo primero que tenemos que hacer es descargar los paquetes de tomcat. Para ello entramos en la página http://tomcat.apache.org/. No molestaros en buscar el paquete que concuerde con vuestro sistema operativo, para todos es el mismo. Esto tiene sus ventajas e inconvenientes.Ventaja: No hay que andar buscando cuál es el de nuestro sistema operativo. Además los desarrolladores tienen un quebradero de cabeza menos. Desventaja: El paquete que descargamos suele ocupar más, ya que sabemos que los binarios de linux no son compatibles con los de windows. No obstante la mayoría de los ficheros del paquete son compartidos por ambos sistemas operativos.

Bueno después de esta disertación sobre qué es lo mejor y lo peor de las distribuciones de apache tomcat vamos a centrarnos en lo que tenemos que hacer. Dentro de la página de apache nos descargamos el núcleo de la aplicación (llamado en ésta core). El nombre del archivo a descargar será algo como apache-tomcat-<versión>.zip. En este post se ha utilizado la versión 6.x de la aplicación. Os recomiendo que utilicéis la misma que yo he utilizado porque con versiones antiguas suelen tener algunas diferencias. Pequeñas, pero al fin y al cabo son diferencias y si estáis leyendo este post es porque no sois expertos en el tema. Por eso cuanto menos problemas mejor.

Ya tenemos el archivo descargado. Ahora procedemos a descomprimirlo en la carpeta donde lo vamos a alojar. Aquí es cuando empiezo a explicarlo en dos sistemas operativos distintos:

Windows

En windows se suelen instalar los programas en la carpeta ‘Archivos de programa’. Pues bien, ¿porqué no?, vamos a dejarlo ahí. Descomprimimos el contenido del zip dentro de esta carpeta. Yo sugiero cambiar el nombre de la carpeta descomprimida por algo más práctico. Normalmente se descomprime como apache-tomcat-<version>. Yo la cambié por tomcat. Así, fácil, práctico. Hecho esto ya tenemos tomcat ‘instalado’ en C:/Archivos de programa/tomcat (¡BIEN! que listos somos). A partir de ahora a esta dirección la llamaremos: $(CATALINA_HOME).

Vamos a configurar ahora el servidor para que funcione. Si abrimos una ventana de MS-DOS y accedemos a $(CATALINA_HOME) veremos que existen distintas carpetas. Las que nos importan a nosotros son:

- Conf: Dentro se encuentran los ficheros de configuración del servidor.

- Webapps: Dentro de esta carpeta se van a incorporar nuestros trabajos, páginas web, etc.

- Lib: Librerías necesarias para que el servidor funcione.

Lo primero que tenemos que hacer es configurar los usuarios (archivo tomcat-users.xml dentro de la carpeta Conf) que vamos a tener dentro del servidor. Obviamente no necesitamos más que un usuario de manejo del servidor. Aquí os dejo cómo debería quedar el XML de usuarios:

<?xml version=’1.0′ encoding=’utf-8′?>
<tomcat-users>
<role rolename=”manager”/>
<role rolename=”admin”/>
<user username=”usuario” password=”contrasena” roles=”manager”/>
</tomcat-users>

Hecho esto ya tenemos el servidor configurado. Lo siento mucho si os habéis hecho ilusiones, pero esto aún no funciona  . Pero por poco tiempo. Nos faltan un par de minucias que vamos a solucionar rápidamente.

Para que esto empiece a funcionar necesitamos configurar las variables de entorno que indican dónde se encuentra instalado tomcat y jre (la máquina virtual de java). Para ello nos vamos al escritorio. En el icono de Mi PC hacemos click derecho y seleccionamos ‘Propiedades’. En la pestaña de ‘Opciones avanzadas’ hacemos click en el botón de ‘Variables de entorno’:

Propiedades de mi pc para las variables de entorno

Al hacer click en este botón accedemos a la ventana de variables de entorno. Existen dos tipos: por usuario y de sistema. Las variables de entorno de usuario sólo ‘funcionan’ cuando el sistema arranca desde el usuario del que la estamos creando. Sin embargo si la hacemos de sistema, la variable de entorno se encuentra activa independiente del usuario utilizado en el sistema. Por lo tanto tendremos que crearnos las variables de entorno de CATALINA_HOME y JRE_HOME. Veamos esto en la imagen:

Ventana de variables de entorno de sistema

Bien, ahora si que estamos preparados para lanzar el Tomcat. No obstante estas variables de entorno no serán activadas hasta que se reinicie el sistema. Así que ya sabes lo que tienes que hacer. Nos vemos en unos minutos  .

Una vez tenemos esto ya solo nos quedan las instrucciones de arrancar y parar el sistema. Esto lo cuento más adelante. Después de la configuración del sistema en linux. Sigue leyendo…

Linux

En linux se suelen instalar los programas en la carpeta /usr/local. Pues bien, ¿porqué no?, vamos a dejarlo ahí. Descomprimimos el contenido del zip dentro de esta carpeta. Yo sugiero cambiar el nombre de la carpeta descomprimida por algo más práctico. Normalmente se descomprime comoapache-tomcat-<version>. Yo la cambié por tomcat. Así, fácil, práctico. Hecho esto ya tenemos tomcat ‘instalado’ en /usr/local/tomcat (¡BIEN! que listos somos). A partir de ahora a esta dirección la llamaremos: $(CATALINA_HOME).

Vamos a configurar ahora el servidor para que funcione. Si abrimos un terminal y accedemos a $(CATALINA_HOME) veremos que existen distintas carpetas. Las que nos importan a nosotros son:

- Conf: Dentro se encuentran los ficheros de configuración del servidor.

- Webapps: Dentro de esta carpeta se van a incorporar nuestros trabajos, páginas web, etc.

- Lib: Librerías necesarias para que el servidor funcione.

Lo primero que tenemos que hacer es configurar los usuarios (archivo tomcat-users.xml dentro de la carpeta Conf) que vamos a tener dentro del servidor. Obviamente no necesitamos más que un usuario de manejo del servidor. Aquí os dejo cómo debería quedar el XML de usuarios:

<?xml version=’1.0′ encoding=’utf-8′?>
<tomcat-users>
<role rolename=”manager”/>
<role rolename=”admin”/>
<user username=”usuario” password=”contrasena” roles=”manager”/>
</tomcat-users>

Hecho esto ya tenemos el servidor configurado. Lo siento mucho si os habéis hecho ilusiones, pero esto aún no funciona  . Pero por poco tiempo. Nos faltan un par de minucias que vamos a solucionar rápidamente.

Para que esto empiece a funcionar necesitamos configurar las variables de entorno que indican dónde se encuentra instalado tomcat y jre (la máquina virtual de java). Para ello nos vamos de nuevo al terminal. Desde el terminal nos vamos a la carpeta de usuario (suele ser /home/<usuario>). Desde esta carpeta editamos el archivo .bashrc. Dentro de este archivo, al final, deberemos de añadir las sentencias que le indican al sistema dónde se encuentra la carpeta de tomcat y la carpeta del jre. Básicamente debemos añadir las siguientes entradas:

export JRE_HOME=/usr/local/java/jre
export CATALINA_HOME=/usr/local/tomcat

Bien, ya tenemos configuradas las variables de entorno necesarias. Aún no están activas. Para activarlas podemos ejecutar la sentencia: $> source .bashrc. No obstante no siempre funciona. Depende de la distribución de linux que estemos utilizando. Lo más seguro es reiniciar. Si reiniciamos seguro que se activan  . Así que ya sabes lo que tienes que hacer. Nos vemos en unos minutos  .

Una vez tenemos esto ya solo nos quedan las instrucciones de arrancar y parar el sistema.

Poniendo en marcha el sistema

La puesta en marcha del sistema es bien sencilla. No obstante varía dependiendo del sistema operativo.

Windows

Para arrancar el sistema en windows va a ser necesario que abramos una ventana de MS-DOS y accedamos al directorio $CATALINA_HOME. Entramos al directorio bin. Desde éste ejecutamos la sentencia:

catalina.bat start

Bingo! se nos abre una nueva ventana de MS-DOS llamada Tomcat y en la que empezamos a ver cómo se van activando los servicios de éste.

Linux

Para arrancar el sistema en linux va a ser necesario que abramos un terminal y accedamos al directorio de $CATALINA_HOME. Desde aquí entramos al directorio bin. Hecho esto ejecutamos la siguiente sentencia en el terminal:

sh catalina.sh start

Bingo! en el terminal comienzan a aparecer los directorios de las variables de entorno indicándonos que todo es correcto.

NOTA: Una vez que hemos terminado de utilizar el servidor, podemos pararlo ejecutando la misma sentencia pero cambiando la palabra ‘start’ por ‘stop’.

Prueba del sistema

Una vez tenemos arrancado podemos probar su correcto funcionamiento accediendo a un navegador web. Si, lo que estás utilizando para leer este post. Desde éste accedemos a la dirección http://localhost:8080. Se nos ha de abrir la ventana de bienvenida de tomcat. Si esto es así, ya hemos terminado. Lo tenemos correcto. Si el navegador nos indica que no encuentra la página, mal asunto amigo. En algo te has equivocado y te toca repasar todos los pasos dados en este post.

Ventana principal de Tomcat

¿Qué hacer con tomcat?

Obviamente el que ha montado un servidor así es porque tiene claro para qué lo va a utilizar. No obstante no tengo ningún problema en decir que en la carpeta $CATALINA_HOME/webapps se han de incorporar las páginas web, .war, etc que queremos que el servidor nos aloje.

Salu2 a todos, BLAKEscIence.