Consejos de Instalación Cocoon 2 para Principiantes

• Ocultar /cocoon de la URL
• Configurar Tomcat
• ¿Qué hemos conseguido?

Ocultar /cocoon de la URL

Podríamos querer eliminar el /cocoon que aparece en las URLs de nuestra aplicación Cocoon. Es decir, en lugar de teclear la URL:

 
http://mycompany:8080/cocoon/myapp 

queremos la URL:

http:/mycompany:8080/myapp

para hacer que cocoon envíe una página HTML al navegador.

 Configurar Tomcat

En pocas palabras, necesitamos configurar un contexto por defecto, donde suceda que Cocoon sea la aplicación web por defecto que se dispare. Vamos allá:

• Vamos al directorio principal de Tomcat ($tomcat_home).
• Entramos en la subcarpeta conf y editamos el fichero server.xml.
• Buscamos el siguiente fragmento de código:

  
  <!-- Tomcat Root Context -->
    <!--
       <Context path="" docBase="ROOT" debug="0"/>
    -->
  
  

  Nota: En algunas versiones de Tomcat el Root Context no está deshabilitado como se ve arriba. Si tu versión de Tomcat lo tiene habilitado debes desactivarlo ahora mismo, poniendole en medio de un comentario XML, como se ve arriba.

• Crea un nuevo elemento <Context> con el siguiente contenido justo debajo del elemento de la definición anterior y graba las modificaciones:

  
  <Context path="" 
           docBase="/path/to/cocoon/webapp"
           debug="0"/>
  
  

Algunas consideracioens sobre los atributos de Context:

• Definiendo un <Context> con el path="" hemos creado un Contexto por defecto. Ahora Tomcat dirigirá todas sus peticiones hacia Cocoon, que puede no estar asociado explícitamente con otra aplicación web.
• Seleccionando docBase con un path absoluto hemos dirigido a Tomcat para que monte la aplicación web desde ese path. También podríamos haber utilizado un path relativo, que se resolvería en relación a $cocoon_root/webapps pero cuidado...

 ¿Qué hemos conseguido?

La siguiente URL, por ejemplo:

http:/mycompany:8080/myapp

ahora apunta al mismo lugar que la URL utilizada formalmente:

http://mycompany:8080/cocoon/myapp