Servidor Tomcat personalizado – iceScrum

Documentación Esta documentación se aplica solo a iceScrum v7.
Para el antiguo iceScrum R6, lea la documentación o migrate.

Servidor de aplicaciones Java

iceScrum es una aplicación web Java, por lo que debe ejecutarse en un servidor de aplicaciones web Java. Proporcionamos un paquete conveniente que ya contiene tanto iceScrum como un servidor Tomcat preconfigurado en la forma de un archivo Java ARchive (JAR): icescrum.jar. Es la forma más fácil de instalar iceScrum, si desea utilizarla, consulte la página sobre cómo instalar iceScrum.

Sin embargo, también puede obtenerlo como Java Web Application ARchive (WAR): icescrum.war, para ejecutarlo en su propio servidor de aplicaciones.

Requiere un contenedor compatible con Servlet 3.0. Recomendamos el uso de Tomcat, un contenedor de Servlet de código abierto ampliamente utilizado. Si es necesario, puede usar otro servidor de aplicaciones (por ejemplo, Jetty), pero esta guía explica el procedimiento de instalación solo para Tomcat.

Usaremos el nombre tomcatDir para representar el directorio donde está instalado Tomcat. El usuario que inicia Tomcat debe tener permisos de escritura en tomcatDir.

Versiones Java y Tomcat

iceScrum v7 admite Java 8 (recomendado) y Java 7

Descargar:

Si ya tiene instalada otra versión de Java, no es un problema: pueden cohabitar distintas versiones. Java 6 is not supported anymore, and Java 9, 10 and higher are not supported.

Aquí están las versiones compatibles de Tomcat, y las operaciones manuales requeridas para usarlas:

Configuración

Primero, necesita configurar el servidor Tomcat. En el archivo tomcatDir/conf/server.xml, configure el conector para usar el protocolo NIO y configure el puerto que se usará para iceScrum (comience con el puerto 8080 si está disponible, podrá cambiarlo más adelante):

<Connector port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol" 
           connectionTimeout="2000" maxThreads="500" URIEncoding="UTF-8"/>

Luego, debe configurar la variable de entorno CATALINA_OPTS (si usa Jetty, defina la variable JAVA_OPTIONS en su lugar).

Un buen lugar para definirlo es un script tomcatDir/bin/setenv.sh (setenv.bat para Windows), lea la documentación de Tomcat para obtener más información. Si usa el administrador de servicios de Tomcat en Windows, las opciones deben ingresarse en la GUI en lugar de en un script y las opciones de memoria se ingresan en campos dedicados separados.

Agregue las siguientes configuraciones a la variable CATALINA_OPTS:

-Dicescrum.log.dir=/path/to/dir/where/i/can/write/
-Duser.timezone=UTC
-Dicescrum_config_location=/path/to/dir/where/i/can/write/config.groovy
-Xmx1024m
-XX:MaxPermSize=256m

Los siguientes indicadores generalmente ya están configurados de manera predeterminada, pero le recomendamos que verifique que se hayan proporcionado a la JVM:

-Djava.awt.headless=true
-server
export CATALINA_OPTS="$CATALINA_OPTS -Duser.timezone=UTC -Xmx1024m -XX:MaxPermSize=256m"
set "CATALINA_OPTS=%CATALINA_OPTS% -Duser.timezone=UTC -Xmx1024M -XX:MaxPermSize=256m"

Instalar el WAR iceScrum

Puede eliminar todo en tomcatDir/webapps/ para comenzar con una instalación limpia de Tomcat.

Descargue icescrum.war aquí: https://www.icescrum.com/download/ (haga clic en «el icono de caja») y muévalo al directorio tomcatDir/webapps/.

By default, the iceScrum URL is http://localhost:8080/icescrum. In such case, the context, which is the part of the URL just after the domain name and the port, is icescrum. It can be changed by changing the name of the .war file, or removed if your rename it to ROOT.war.

Iniciar iceScrum

Una vez que esté configurado, puede iniciar el servidor Tomcat ejecutando el script tomcatDir/bin/startup.sh (startup.bat para Windows). Dependiendo de cómo lo haya instalado, tomcat también se puede iniciar como un servicio de la manera siguiente: service tomcat8 start . Tomcat iniciará iceScrum automáticamente si el WAR se encuentra en el directorio tomcatDir/webapps/.

Luego puede volver a la página cómo instalar iceScrum y seguir la sección «Configure iceScrum» para empezar.

Solución de problemas

Aquí son algunos problemas comunes relacionados con el servidor de aplicaciones personalizado:

  • java.io.FileNotFoundException: /usr/share/java/jsp-api-2.3.jar Los recientes paquetes Debian Tomcat no incluyen todas las bibliotecas Tomcat por algún motivo, instálelos manualmente:
    sudo apt-get install libservlet3.1-java
  • java.lang.NullPointerException at java.util.TimeZone.getAvailableIDs(TimeZone.java:594)
    Esto ocurre al crear un proyecto cuando se utilizan los últimos paquetes de Ubuntu Java 7, ya que no incluyen compatibilidad de zona horaria. Lea lo siguiente para una solución temporal: http://blog.swwomm.com/2016/05/ubuntu-1604-with-java-7-timezone-data.html
  • Relacionado con las exportaciones (PDF etc.):
    Asegúrese de que su JVM esté configurada en modo sin cabeza como se explica en esta guía y que use un servidor de aplicaciones y un JDK compatibles.
  • Relacionado con la URL del servidor (archivos adjuntos, redirección después de iniciar sesión, etc.)::
    Si definió una URL personalizada (dominio, puerto), asegúrese de definir la configuración URL del servidor y el conector Tomcat adecuado.
  • java.lang.NullPointerException en CoyoteAdapter::
    Su versión de Tomcat 7 está probablemente desactualizada.
  • Mensajes de error en el proceso Tomcat al cerrar iceScrum::
    Es un problema conocido que no debería afectar su aplicación. Recomendamos que compruebe que el proceso de Java ha sido realmente terminado.

Si eso no le ayuda, consulte la documentación principal de solución de problemas. documentación principal de solución de problemas.

Custom URL / reverse proxy / https

It is common practice to use a reverse proxy (e.g. Apache or Nginx) in front of a Java Application Server, but it is optional: iceScrum works fine without a reverse proxy!

If you just want to use a custom domain name and port (e.g. http://icescrum.mydomain.com) and even an https connection then a reverse proxy is not needed, everything can be defined on Tomcat.

If you use a reverse proxy, read the corresponding manual.


Pruébalo gratis ahora
Todo lo que necesita para gestionar sus proyectos ágiles