6.2. Instalando Cocoon
6.2.1. Instalaci�n R�pida De Cocoon
De Cocoon se pueden obtener dos distribuciones. La que trataremos en esta parte es la distribuci�n en binario que puede ser descargada de este enlace. Con esta distribuci�n lo �nico que usted debe hacer es descargarla y descomprimirla en cualquier directorio. En el directorio que usted eligi� deber� haber quedado el fichero cocoon.war. Este fichero es el de la aplicaci�n Cocoon.
Para que Tomcat y Cocoon se puedan comunicar, usted debe copiar el cocoon.war en el directorio CATALINA_HOME/webapps e iniciar Tomcat.
Cuando usted inicia Tomcat puede darse cuenta que el fichero es descomprimido autom�ticamente en el directorio CATALINA_HOME/webapps/cocoon/, el cual llamaremos de ahora en adelante COCOON_HOME. Para probar si cocoon est� funcionando puede abrir la direcci�n http://localhost:8080/cocoon/ en el browser, en la cual debe mostr�rsele una p�gina de bienvenida de este estilo.
6.2.2. Instalaci�n a partir de los fuentes
En ocasiones es recomendable tener una copia local del c�digo de Cocoon y compilar la aplicaci�n de forma local. Para �sto, lo que usted debe hacer es descargar el c�digo fuente de Cocoon. Esto lo puede realizar a trav�s del servidor de CVS (Current Versioning System) de Apache.
Primero det todo, usted debe tener instalado CVS. Si usted no lo ha instalado a�n en su m�quina, puede consultar el sitio web de CVS para m�s informaci�n.
En el momento que tenga instalado el CVS, ingrese al servidor de CVS de Apache de la siguiente forma:
Cuando se le pregunte por una contrase�a escriba anoncvs. Luego escriba lo siguiente:
Una vez hecho esto se inicia la descarga de todo el c�digo necesario para la compilaci�n de Cocoon.
Cuando tenga los fuentes de Cocoon descargados, debe compilarlos para crear el fichero cocoon.war. Para empezar a ejecutar el proceso de compilaci�n utilice la siguiente instrucci�n:
�sto crear� un directorio con el c�digo compilado, las bibliotecas y el fichero cocoon.war. Una vez termine el proceso copie el cocoon.war en el directorio CATALINA_HOME/webapps y reinicie Tomcat. De esta forma Cocoon estar� ejecut�ndose en http://localhost:8080/cocoon/.
 | Si usted est� interesado en hacer pruebas con Cocoon es �til crear una aplicaci�n aparte para este fin. �sto lo puede hacer creando un directorio nuevo bajo CATALINA_HOME/webapps. Supongamos que a dicho directorio se le pone como nombre pruebasCocoon. Lo que usted debe hacer es copiar el fichero COCOON_HOME/cocoon.xconf y la carpeta COCOON_HOME/WEB-INF en CATALINA_HOME/webapps/pruebasCocoon/. �sto ya es suficiente para empezar a hacer sus pruebas y sus desarrollos ya que en WEB-INF est�n todas las clases necesarias para hacer que Cocoon pueda funcionar correctamente. Cree tambi�n su propio sitemap en CATALINA_HOME/webapps/pruebasCocoon(con lo cual no corre el riesgo de alterar los ejemplos y la documentaci�n que ya existan) y cargue su aplicaci�n en http://localhost:8080/pruebasCocoon/ |