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.
 cocoon-2.0.4-bin.tar.gz |
17MB | �ltima distribuci�n binaria para JDK 1.2/1.3 bajo UNIX/Linux |
| cocoon-2.0.4-bin.zip |
19MB | �ltima distribuci�n binaria para JDK 1.2/1.3 bajo Windows |
| cocoon-2.0.4-vm14-bin.tar.gz |
17MB | �ltima distribuci�n binaria para JDK 1.4 bajo UNIX/Linux |
| cocoon-2.0.4-vm14-bin.zip |
19MB | �ltima distribuci�n binaria para JDK 1.4 bajo Windows |
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
- Crea una carpeta llamada cocoon dentro del directorio webapps de tu contenedor de servlets.
- Copia el fichero cocoon.war en la carpeta creada en el paso anterior.
- Descomprime el fichero war:
jar -xf cocoon.war
Despu�s de descomprimir ver�s una estructura de carpetas webapps que contiene la aplicaci�n web cocoon.
- Reinicia el contenedor (si es necesario).
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.