Instalar Tomcat 7 (es_ES)

  • Apache Tomcat - http://tomcat.apache.org/
  • Nota: Realiza siempre una instalación limpia de Tomcat
  • Nota: Los usuarios de Windows deben asegurarse de no dejar espacios en la ruta completa de Tomcat lo que causaría errores en las herramientas JSF de Sakai
    BIEN: C:\opt\tomcat\, C:\sakaistuff\installs\tomcat\
    MAL: C:\program files\tomcat\, C:\opt\apache tomcat 7.0.1\
  1. Descargarse tomcat 7 - http://tomcat.apache.org/download-70.cgi
    • Los usuarios de Windows deberían descargar el fichero zip y no usar el instalador exe. Esto hace mucho más sencillo revisar los logs y modificar el Icono

       
      Si vas a ejecutar Sakai 2.9.1 o anterio debes correr Tomcat 7.0.21 o anterior. Si seleccionas una versión más nueva, Webdav y Sitestats (Estadísticas) tendrán errores y no funcionarán. La mejor opción es estar siempre actualizado a la última versión de Sakai y de Tomcat.
      STAT-339 - Sitestats does not load with Tomcat 7.0.35 ( Cerrada)
      SAK-23156 - IncompatibleClassChangeError from WebDAV LOCK operations giving 500 response code ( Cerrada)
  2. Extraer a /opt (crear un enlace simbólico desde el directorio apache-tomcat-7.0.x al directorio tomcat una vez extraido)
    • Los usuarios de Windows deberán renombrar el directorio puesto que no existe la opción de enlace simbólico
  3. Modificar conf/server.xml para soportar los caracteres internacionales
    1. Añadir URIEncoding="UTF-8" el elemento Connector
      • <Connector port="8080" URIEncoding="UTF-8" ...
  4. Configurar la variable de entorno: CATALINA_HOME=/opt/tomcat
  5. Añadir $CATALINA_HOME/bin al PATH
  6. Configurar el fichero SETENV en el directorio tomcat/bin con JAVA_OPTS (ver Java 1.7 Instalación para Sakai 10)
    1. Mac/Linux: Crear un fichero llamado setenv.sh con lo siguiente (se puede poner esto alternativamente en tu fichero .bashrc y se ejecutará automáticamente):


      export JAVA_OPTS="-server -Xmx1028m -XX:MaxPermSize=320m -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Djava.awt.headless=true -Dcom.sun.management.jmxremote -Dsun.lang.ClassLoader.allowArraySyntax=true"
    2. Windows(PC): Crear un fichero llamado setenv.bat con lo siguiente:


      set JAVA_OPTS=-server -Xmx1028m -XX:MaxPermSize=320m  -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Djava.awt.headless=true -Dcom.sun.management.jmxremote -Dsun.lang.ClassLoader.allowArraySyntax=true
  7. [OPCIONAL] Borrar las aplicaciones por defecto del directorio webapps

    rm -rf webapps/*
    
  8. Configurar tomcat 7 para usar los viejos directorios classloaders de tomcat 5.5
    1. Editar conf/catalina.properties
      1. Añadir lo siguiente a la línea que comienza con "common.loader=..."

        ,${catalina.base}/common/classes/,${catalina.base}/common/lib/*.jar
        
      2. Añadir lo siguiente a la línea que comienza con "shared.loader=..."

        ${catalina.base}/shared/classes/,${catalina.base}/shared/lib/*.jar
        
      3. Añadir lo siguiente a la línea que comienza con "server.loader=..."

        ${catalina.base}/server/classes/,${catalina.base}/server/lib/*.jar
        
    2. [OPCIONAL] Crea los directorios

      mkdir -p shared/classes shared/lib common/classes common/lib server/classes server/lib