IES Gran Capitán
Módulo: Despliegue de Aplicaciones Web
Ciclo Formativo de Grado Superior “Desarrollo de aplicaciones Web”

Práctica 10: Despliegue de aplicaciones
mediante el terminal

Fecha entrega: 02/12/2013
Autor: Pablo Medina Suárez

IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba.
http://www.iesgrancapitan.org http://informatica.iesgrancapitan.org informatica@iesgrancapitan.org
Despliegue de aplicaciones mediante el terminal

2

1 ÍNDICE
1

ÍNDICE

2

2

INTRODUCCIÓN

3

3

DESARROLLO DE LA PRÁCTICA

4

3.1 DESCARGA HUDSON DE SU PÁGINA OFICIAL EN HTTP://HUDSON-CI.ORG/.
4
3.2 COPIA EL .WAR DESCARGADO EN LA CARPETA DE APLICACIONES DE TOMCAT UBICADA EN
$CATALINA_HOME/WEBAPPS Y REINICIE TOMCAT. EJ: /USR/SHARE/APACHE-TOMCAT7.0.0/WEBAPPS/
4
3.3 OBSERVAR LOS FICHEROS DE CONFIGURACIÓN: SERVER.XML, CONTEXT.XML Y WEB.XML (QUE
ESTÁ BAJO WEB-INFO). INDICA PARA QUÉ SE USAN.
4
3.4 VERIFICAR LA SALIDA DEL CONTENEDOR EN EL ARCHIVO [RUTA DE
TOMCAT]/LOGS/CATALINA.OUT CON EL COMANDO TAIL.
5
3.5 VISITA LA DIRECCIÓN HTTP://LOCALHOST:[PUERTO_TOMCAT]/HUDSON Y VERÁ LA PÁGINA DE
INICIO DE HUDSON O UN MENSAJE INDICANDO QUE LA APLICACIÓN ESTÁ ARRANCANDO. SI SALE EN LA
SEGUNDA PANTALLA ESPERAR UNOS SEGUNDOS Y REFRESCAR LA PÁGINA (AUNQUE ESTA DEBERÍA
REFRESCARSE SOLA).
6
4

CONCLUSIÓN

8

5

BIBLIOGRAFIA

9

IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba.
http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org
Despliegue de aplicaciones mediante el terminal

2

3

INTRODUCCIÓN
Objetivo:
Desplegar en Tomcat la aplicación Hudson.

Una aplicación Web Java se compone de una estructura estándar jerárquica de
directorios y archivos. Dicha estructura puede encontrarse desempaquetada o empaquetada
como
una
Web
ARchive
(.war).
El desempaquetado se usa para desarrollo mientras que el empaquetado para distribuir la
aplicación en entornos de producción.
Cada aplicación tiene sus propios ficheros de configuración server.xml, context.xml y
web.xml. Si una aplicación no tiene fichero su propio context.xml, Tomcat lee el general
ubicado en el directorio raíz de Tomcat. Igual ocurre con el web.xml
Verificar la salida del contenido.
Para desplegar una aplicación web existen dos métodos:



Por
consola:
Copiar
la
estructura
desempaquetada
en
el
directorio $CATALINA_HOMEwebapps
Usando el gestor de aplicaciones: Tomcat Manager, que permite desplegar y
eliminar aplicaciones sin necesidad de reiniciar el servidor Tomcat. Hay que
indicar la ruta relativa donde se encuentra la aplicación en el campo URL y la
ruta de archivo de configuración XML si es necesaria.

En esta práctica haremos el despliegue por terminal.

IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba.
http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org
Despliegue de aplicaciones mediante el terminal

4

3 DESARROLLO DE LA PRÁCTICA
3.1

Descarga Hudson de su página oficial en http://hudson-ci.org/.
Entramos en la página oficial y descargamos el fichero haciendo click sobre el siguiente

enlace:

Elegimos un servidor de descarga y esperamos a que se complete la descarga.

3.2

Copia el .war descargado en la carpeta de aplicaciones de Tomcat
ubicada en $CATALINA_HOME/webapps y reinicie Tomcat. Ej:
/usr/share/apache-tomcat-7.0.0/webapps/

Ya tenemos en el directorio de descargas el fichero, por lo que movemos el fichero al
fichero de aplicaciones del servidor, de la siguiente manera:

Reiniciamos el servidor utilizando los scripts shutdown.sh y startup.sh.

3.3

Observar los ficheros de configuración: server.xml, context.xml y
web.xml (que está bajo web-info). Indica para qué se usan.

Nota: si una aplicación no tiene en su fichero su propio context.xml, Tomcat lee el
general ubicado en el raíz de Tomcat. Igual ocurre con web.xml.
Copiar
el
web.xml
de
la
aplicación
Hudson
a
$CATALINA_HOME/conf/Catalina/localhost y renombrarlo con el nombre de la aplicación
(Hudson.xml).
El directorio WEB-INFO contiene lo siguiente:

Observando el contenido del fichero web.xml vemos que contiene directivas que
describen el despliegue de la aplicación. En él podemos definir parámetros para la aplicación e
indicaciones para el contenedor de aplicaciones.
IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba.
http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org
Despliegue de aplicaciones mediante el terminal

5

No hay ningún fichero context.xml en el directorio, por lo que se utiliza el ubicado en el
directorio raíz de Tomcat. Este fichero se utiliza para definir información que será cargada por
todas las aplicaciones del servidor.
Tampoco hay un fichero server.xml. Este fichero contiene directivas de configuración
del servidor de aplicaciones.
Copiamos el fichero web.xml de Hudson en /localhost/ con el nombre Hudson.xml de
la siguiente manera:

3.4

Verificar la salida del contenedor en el
Tomcat]/logs/catalina.out con el comando tail.

archivo

[ruta

Este es el resultado mostrado en el fichero de log de Tomcat:

IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba.
http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org

de
Despliegue de aplicaciones mediante el terminal

3.5

6

Visita la dirección http://localhost:[puerto_Tomcat]/hudson y verá la
página de inicio de Hudson o un mensaje indicando que la aplicación
está arrancando. Si sale en la segunda pantalla esperar unos
segundos y refrescar la página (aunque esta debería refrescarse
sola).
Entramos en la dirección correspondiente y observamos lo siguiente:

Esta es la pantalla de inicio para configurar la aplicación antes de instalarla, si pulsamos
el botón Finish y nos aparecerá lo siguiente:

Y este es el resultado de la aplicación al finalizar su despliegue:

IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba.
http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org
Despliegue de aplicaciones mediante el terminal

Ya hemos finalizado el despliegue de una aplicación por terminal.

IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba.
http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org

7
Despliegue de aplicaciones mediante el terminal

8

4 CONCLUSIÓN
En el desarrollo de esta práctica he aprendido a descargar y desplegar una aplicación en
nuestro servidor Tomcat utilizando el terminal del sistema, sin recurrir a la interfaz gráfica de
Tomcat, además de comprender la estructura y funcionamiento básico de estas aplicaciones, y
conocer los directorios utilizados para el despliegue de aplicaciones.

IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba.
http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org
Despliegue de aplicaciones mediante el terminal

9

5 BIBLIOGRAFIA


Tomcat Web Application Deployment
Consultado en: http://tomcat.apache.org/tomcat-7.0-doc/deployer-howto.html



Administración de servicios de Internet.
Consultado en:
http://books.google.es/books?id=PnYgzkE7XdYC&printsec=frontcover&dq=libro+de+
texto+servidores+aplicaciones++web&source=bl&ots=P7lQfODCH3&sig=knnGQY_i
FzJ5jGmKgACyUUVAnzM&hl=es&sa=X&ei=S79UUPOtEIi7hAeq_oHYBg&ved=0
CEUQ6AEwAw#v=onepage&q&f=false

IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba.
http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org

Apache Tomcat 8: despliegue de una aplicación mediante terminal

  • 1.
    IES Gran Capitán Módulo:Despliegue de Aplicaciones Web Ciclo Formativo de Grado Superior “Desarrollo de aplicaciones Web” Práctica 10: Despliegue de aplicaciones mediante el terminal Fecha entrega: 02/12/2013 Autor: Pablo Medina Suárez IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba. http://www.iesgrancapitan.org http://informatica.iesgrancapitan.org informatica@iesgrancapitan.org
  • 2.
    Despliegue de aplicacionesmediante el terminal 2 1 ÍNDICE 1 ÍNDICE 2 2 INTRODUCCIÓN 3 3 DESARROLLO DE LA PRÁCTICA 4 3.1 DESCARGA HUDSON DE SU PÁGINA OFICIAL EN HTTP://HUDSON-CI.ORG/. 4 3.2 COPIA EL .WAR DESCARGADO EN LA CARPETA DE APLICACIONES DE TOMCAT UBICADA EN $CATALINA_HOME/WEBAPPS Y REINICIE TOMCAT. EJ: /USR/SHARE/APACHE-TOMCAT7.0.0/WEBAPPS/ 4 3.3 OBSERVAR LOS FICHEROS DE CONFIGURACIÓN: SERVER.XML, CONTEXT.XML Y WEB.XML (QUE ESTÁ BAJO WEB-INFO). INDICA PARA QUÉ SE USAN. 4 3.4 VERIFICAR LA SALIDA DEL CONTENEDOR EN EL ARCHIVO [RUTA DE TOMCAT]/LOGS/CATALINA.OUT CON EL COMANDO TAIL. 5 3.5 VISITA LA DIRECCIÓN HTTP://LOCALHOST:[PUERTO_TOMCAT]/HUDSON Y VERÁ LA PÁGINA DE INICIO DE HUDSON O UN MENSAJE INDICANDO QUE LA APLICACIÓN ESTÁ ARRANCANDO. SI SALE EN LA SEGUNDA PANTALLA ESPERAR UNOS SEGUNDOS Y REFRESCAR LA PÁGINA (AUNQUE ESTA DEBERÍA REFRESCARSE SOLA). 6 4 CONCLUSIÓN 8 5 BIBLIOGRAFIA 9 IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba. http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org
  • 3.
    Despliegue de aplicacionesmediante el terminal 2 3 INTRODUCCIÓN Objetivo: Desplegar en Tomcat la aplicación Hudson. Una aplicación Web Java se compone de una estructura estándar jerárquica de directorios y archivos. Dicha estructura puede encontrarse desempaquetada o empaquetada como una Web ARchive (.war). El desempaquetado se usa para desarrollo mientras que el empaquetado para distribuir la aplicación en entornos de producción. Cada aplicación tiene sus propios ficheros de configuración server.xml, context.xml y web.xml. Si una aplicación no tiene fichero su propio context.xml, Tomcat lee el general ubicado en el directorio raíz de Tomcat. Igual ocurre con el web.xml Verificar la salida del contenido. Para desplegar una aplicación web existen dos métodos:   Por consola: Copiar la estructura desempaquetada en el directorio $CATALINA_HOMEwebapps Usando el gestor de aplicaciones: Tomcat Manager, que permite desplegar y eliminar aplicaciones sin necesidad de reiniciar el servidor Tomcat. Hay que indicar la ruta relativa donde se encuentra la aplicación en el campo URL y la ruta de archivo de configuración XML si es necesaria. En esta práctica haremos el despliegue por terminal. IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba. http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org
  • 4.
    Despliegue de aplicacionesmediante el terminal 4 3 DESARROLLO DE LA PRÁCTICA 3.1 Descarga Hudson de su página oficial en http://hudson-ci.org/. Entramos en la página oficial y descargamos el fichero haciendo click sobre el siguiente enlace: Elegimos un servidor de descarga y esperamos a que se complete la descarga. 3.2 Copia el .war descargado en la carpeta de aplicaciones de Tomcat ubicada en $CATALINA_HOME/webapps y reinicie Tomcat. Ej: /usr/share/apache-tomcat-7.0.0/webapps/ Ya tenemos en el directorio de descargas el fichero, por lo que movemos el fichero al fichero de aplicaciones del servidor, de la siguiente manera: Reiniciamos el servidor utilizando los scripts shutdown.sh y startup.sh. 3.3 Observar los ficheros de configuración: server.xml, context.xml y web.xml (que está bajo web-info). Indica para qué se usan. Nota: si una aplicación no tiene en su fichero su propio context.xml, Tomcat lee el general ubicado en el raíz de Tomcat. Igual ocurre con web.xml. Copiar el web.xml de la aplicación Hudson a $CATALINA_HOME/conf/Catalina/localhost y renombrarlo con el nombre de la aplicación (Hudson.xml). El directorio WEB-INFO contiene lo siguiente: Observando el contenido del fichero web.xml vemos que contiene directivas que describen el despliegue de la aplicación. En él podemos definir parámetros para la aplicación e indicaciones para el contenedor de aplicaciones. IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba. http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org
  • 5.
    Despliegue de aplicacionesmediante el terminal 5 No hay ningún fichero context.xml en el directorio, por lo que se utiliza el ubicado en el directorio raíz de Tomcat. Este fichero se utiliza para definir información que será cargada por todas las aplicaciones del servidor. Tampoco hay un fichero server.xml. Este fichero contiene directivas de configuración del servidor de aplicaciones. Copiamos el fichero web.xml de Hudson en /localhost/ con el nombre Hudson.xml de la siguiente manera: 3.4 Verificar la salida del contenedor en el Tomcat]/logs/catalina.out con el comando tail. archivo [ruta Este es el resultado mostrado en el fichero de log de Tomcat: IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba. http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org de
  • 6.
    Despliegue de aplicacionesmediante el terminal 3.5 6 Visita la dirección http://localhost:[puerto_Tomcat]/hudson y verá la página de inicio de Hudson o un mensaje indicando que la aplicación está arrancando. Si sale en la segunda pantalla esperar unos segundos y refrescar la página (aunque esta debería refrescarse sola). Entramos en la dirección correspondiente y observamos lo siguiente: Esta es la pantalla de inicio para configurar la aplicación antes de instalarla, si pulsamos el botón Finish y nos aparecerá lo siguiente: Y este es el resultado de la aplicación al finalizar su despliegue: IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba. http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org
  • 7.
    Despliegue de aplicacionesmediante el terminal Ya hemos finalizado el despliegue de una aplicación por terminal. IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba. http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org 7
  • 8.
    Despliegue de aplicacionesmediante el terminal 8 4 CONCLUSIÓN En el desarrollo de esta práctica he aprendido a descargar y desplegar una aplicación en nuestro servidor Tomcat utilizando el terminal del sistema, sin recurrir a la interfaz gráfica de Tomcat, además de comprender la estructura y funcionamiento básico de estas aplicaciones, y conocer los directorios utilizados para el despliegue de aplicaciones. IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba. http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org
  • 9.
    Despliegue de aplicacionesmediante el terminal 9 5 BIBLIOGRAFIA  Tomcat Web Application Deployment Consultado en: http://tomcat.apache.org/tomcat-7.0-doc/deployer-howto.html  Administración de servicios de Internet. Consultado en: http://books.google.es/books?id=PnYgzkE7XdYC&printsec=frontcover&dq=libro+de+ texto+servidores+aplicaciones++web&source=bl&ots=P7lQfODCH3&sig=knnGQY_i FzJ5jGmKgACyUUVAnzM&hl=es&sa=X&ei=S79UUPOtEIi7hAeq_oHYBg&ved=0 CEUQ6AEwAw#v=onepage&q&f=false IES Gran Capitán. C/. Arcos de la Frontera, S/N. 14014 – Córdoba. http://www.iesgrancapitan.org http://www.iesgrancapitan.org/blog04/ informatica@iesgrancapitan.org