Instalación para Principiantes
Habilidades Necesarias
Asumimos que:
- tienes un conocimiento básico sobre aplicaciones web y servidores de aplicaciones en general,
- sabes como desplegar una aplicación web en un contenedor de servlets
- y sabes como descomprimir un paquete comprimido
Pre-Requisitos Técnicos
Para poder instalar cocoon necesitarás:
- una Máquina Virtual Java 1.2 (o posterior).
- un contenedor servelt instalado y funcionando correctamente
Instalación de la Distribución Binaria de Cocoon
Obtener la Distribución de Cocoon
Pudes obtener la distribución desde alguna de estas localizaciones:
Abajo tienes enlaces directos para a las versiones binarias de la distribución de Apache Cocoon-2.04.
Debes tener en cuenta que la 2.0.4 es la última versión de Cocoon que se distribuirá de forma binaria, a partir de la versión 2.1 tendrás que bajarte la versión fuente y construirla tu mismo en tu ordenador.
Nota:
¿Por qué sólo versiones de código fuente y no binarias?
Debido a las incompatibilidades entre las diferentes versiones del JDK 1.3 y 1.4 (diferencias en las librerías de JDBC, etc.), Apache tenía que poner a nuestra disposición una versión binaria de Cocoon para cada uno de esos JDK y cada usuario debía bajarse la versión adecuada para su JDK. Pero ¿Qué pasaba si el usuario decidía actualizar su versión del JDK a una superior? Pues que la versión de Cocoon que se había bajado no funcionaría con su nueva versión del JDK.
Descargando el código fuente, el usuario puede compilar su versión de Cocoon con la versión del JDK que tenga en su máquina.
|
Desde http://mirrors.xtria.com/apache/cocoon/SOURCES/ podrás bajarte las fuentes de las últimas versiones de Cocoon. Con las fuentes viene incluido un script para construir la versión de Cocoon utilizando el JDK que tengas instalado en tu ordenador.
Desempaquetar Cocoon
Desempaqueta el archivo descargado en cualquier lugar de tu elección. Obtendremos un árbol de directorios que empieza con cocoon-2.0.4. Dentro de este árbol de directorios encontrarás el archivo de la aplicación web cocoon.war en el nivel más alto. Junto a esto encontrarás un conjunto completo de documentación en formato HTML bajo el subdirectorio "docs".
Desplegar la versión Binaria de Cocoon
Copia el fichero cocoon.war en la carpeta de aplicaciones web de tu servidor de aplicaciones. Sobre Tomcat, está carpeta será el directorio webapps dentro del directorio principal de Tomcat.
Si tu contentedor de servlet está activo y lo hemos configurado para un despliegue automático, Cocoon empezará a estar operativo en pocos segundos.
Si tu contenedor servlet no soporta el auto-despliegue, debemos desplegarlo manualmente.
Desplegarlo en un Servidor de Aplicaciones
Desplegar Cocoon en un servidor de aplicaciones es una tarea bastante sencilla. Lo único a tener en cuenta es que en el fondo, Cocoon es sólo un servlet. Teniendo esto en mente, desplegarlo en nuestro servidor de aplicaciones es lo mismo que desplegar cualquier otro servlet. Para JBoss 3.0+ o Tomcat es tan sencillo como dejar el fichero war en el directorio de despliegue apropiado.
Despliegue Manual
Después de que el contenedor esté listo para la operación, puedes arrancar tu navegador y dirigirte a la dirección:
http://direccionDeTuContenedor:puerto/cocoon
Para una configuración por defecto de Tomcat, esto sería:
http://localhost:8080/cocoon
Deberías ver el mensaje de bienvenida de Cocoon.
¡Felicidades! Ya has realizado el primer paso para publicar en XML
Posibles Problemas
Dependiendo de la combinación de versiones del JDK y del contendor de Servlets (Tomcat u otros...) que tengas instalada en tu máquina se complicará un poco el proceso de instalación/despliegue de Cocoon.
Configuración del JDK 1.4
Cocoon requiere unas versiones de las librerías Xerces y Xalan más recientes que las que trae incluidas la versión 1.4 del JDK. Para evitar problemas con estas librerías, sigue estos pasos:
- Crea el directorio %JAVA_HOME%\jre\lib\endorsed. (Los usuarios de Tomcat pueden utilizar también el directorio %TOMCAT_HOME\common\endorsed).
- Copia los ficheros xercesXXX.jar, xalan-XXX.jar, y xml-apis.jar desde el directorio .\lib\endorsed\ de Cocoon al directorio creado en el paso anterior.
Tutoriales
cocoon-2.0.4-bin.tar.gz
