Documentación Esta documentación se aplica solo a iceScrum v7.
Para el antiguo iceScrum R6, lea la documentación o migrate.
Configurar iceScrum
Si desea cambiar la configuración en una interfaz de usuario agradable y tener sus cambios tomados en cuenta de inmediato, echar un vistazo a la App dedicada .
Si no puede usar esta aplicación, tendrá que actualizar el archivo config.groovy manualmente. Este archivo se crea para usted al final del asistente que se muestra al primer inicio. Su ubicación predeterminada es en el hogar del usuario que inicia iceScrum bajo un nuevo directorio .icescrum.
Todos los cambios de configuración manuales necesitan un reinicio de la aplicación para aplicar si el servidor se está ejecutando.
El archivo config.groovy sigue el formato Groovy, que se describe a continuación.
Apps
Si puede, usa la App dedicada en lugar de actualizar manualmente el archivo config.groovy .
Esta documentación sólo incluye la configuración básica de iceScrum. Las aplicaciones también pueden tener su propio panel en la ventana Configuración, en cuyo caso la documentación de la aplicación explica cómo configurarla. Consulte la documentación de las Apps para obtener más información.
Formato de configuración
la configuración de iceScrum debe seguir el formato Groovy:
// Inline comment
/*
Block comment
*/
key = value // For booleans and numbers values
key = "string value" // For strings values
Todas las rutas de tu config.groovy deben usar ‘/’ (barra diagonal).
Configuraciones de la aplicación
Estas son las configuraciones de aplicación disponibles con su valor predeterminado, dado en el formato Groovy (.groovy):
icescrum.project.import.enable = true icescrum.project.export.enable = true icescrum.project.creation.enable = true icescrum.project.private.enable = true icescrum.project.private.default = false
icescrum.gravatar.enable = false icescrum.registration.enable = true icescrum.invitation.enable = false icescrum.login.retrieve.enable = true icescrum.sessionTimeoutSeconds = 1800
icescrum.alerts.enable = true icescrum.alerts.errors.to = "dev@icescrum.org" icescrum.alerts.subject_prefix = "[icescrum]" icescrum.alerts.default.from = "webmaster@icescrum.org"
Configuraciónes técnicas
icescrum.serverURL = "http://localhost:8080/icescrum"
icescrum.debug.enable = false icescrum.securitydebug.enable = false
icescrum.baseDir = "<yourHome>/icescrum"
/* Use a custom directory where Tomcat has write rights
(not webapps!!). Path must use '/' (forward slash) */
icescrum.cors.enable = true /* CORS is enabled by default
However, it's enabled only for projects
where web services are enabled */
icescrum.cors.allow.origin.regex = "*" /* Use double backslash for escaping
e.g. (http://|.+.)mydomain.com */
icescrum.check.enable = true icescrum.reportUsage.enable = true icescrum.feedback.enable = true
grails.mail.host = "smtp.gmail.com" grails.mail.port = 465 grails.mail.username = username@gmail.com grails.mail.password = "mypassword"
Es necesario definir una configuración de correo electrónico adicional si utiliza autenticación TLS, SSL o anónima. Por lo general, sólo uno de ellos es necesario. Para combinarlos, defina la propiedad sólo una vez y añada las entradas entre paréntesis, separadas por una coma.
grails.mail.props = ["mail.smtp.socketFactory.class":"javax.net.ssl.SSLSocketFactory"]
grails.mail.props = ["mail.smtp.starttls.enable":"true"]
grails.mail.props = ["mail.smtp.auth":"false"]
Solución de problemas
Si tiene algún problema al configurar iceScrum, lo primero que debe comprobar es que se utilice el archivo de configuración. El que se utiliza es mencionado en la salida estándar de tomcat al iniciar iceScrum.
Si se utiliza pero no funciona, puede que no esté bien formateado, así que vuelva a comprobar el formato de configuración.
A continuación, puede intentar cambiar una configuración trivial (como desactivar el registro) y ver si funciona. Si funciona, prueba que su configuración es tenida en cuenta y que su configuración específica puede estar equivocada.
También puede probar valores triviales para su configuración (por ejemplo, Gmail para correos electrónicos) para ver si el problema proviene de sus valores.
Por último, si intenta conectarse a un servicio externo, pruebe los ajustes en otro cliente (por ejemplo, en la línea de comandos) para comprobar si son correctos.
Base de datos
iceScrum viene con una base de datos H2 integrada para que pueda probarlo sin necesidad de instalar o configurar un DBMS. La configuración predeterminada de H2 NO es adecuada para entornos de producción en términos de fiabilidad y rendimiento . Utilice un DBMS externo compatible con iceScrum: MySQL, PostgreSQL, MS SQL Server u Oracle.
Esta configuración debe configurarse en el archivo de configuración (consulte la sección anterior). Cualquier cambio requerirá que reinicie el servidor si se está ejecutando.
Cree y vacíe la base de datos de iceScrum con un charset / collation sensible: elija UTF-8 para su nueva base de datos .
Así es cómo crear la base de datos vacía en MYSQL :
CREATE DATABASE `icescrum` CHARACTER SET utf8 COLLATE utf8mb4_unicode_ci;
Con PostgresQL, ten cuidado, tiene que usar el esquema «público» de lo contrario iceScrum no se reiniciará.
Por último, proporcione la URL de conexión de JDBC, que está precargada de acuerdo con el DBMS elegido y que incluye el nombre de la base de datos que ha creado. iceScrum se encargará de crear la estructura de la base de datos.
H2
H2 es el base de datos predeterminado en iceScrum. Está agrupado para que sea posible probar iceScrum sin necesidad de instalar un DBMS. El base de datos se almacena como un archivo de script en su sistema de archivos.
La estructura y los datos de la base de datos se almacenan como sentencias SQL en un archivo denominado prodDb.h2.db ubicado en el directorio desde el que se inició iceScrum. Para hacer una copia de seguridad de su base de datos, sólo tiene que conservar una copia de los archivos prodDb .
El nombre de usuario predeterminado es sa y la contraseña está vacía.
MySQL
dataSource.dialect = "org.hibernate.dialect.MySQL5InnoDBDialect" dataSource.driverClassName = "com.mysql.jdbc.Driver" dataSource.url = "jdbc:mysql://localhost:3306/icescrum?useUnicode=true&amp;characterEncoding=utf8" dataSource.username = "root" dataSource.password = "myDbPass"
Otros DBMS
dataSource.dialect = "org.hibernate.dialect.Oracle10gDialect"
// use this dialect even for greater versions
dataSource.driverClassName = "oracle.jdbc.driver.OracleDriver"
dataSource.url = "jdbc:oracle:thin:@localhost:1521:XE"
dataSource.username = "sa"
dataSource.password = "myDbPass"
Con PostgreSQL, ten cuidado, tiene que usar el esquema «público» de lo contrario iceScrum no se reiniciará.
dataSource.driverClassName = "org.postgresql.Driver" dataSource.url = "jdbc:postgresql://localhost:5432/icescrum" dataSource.username = "postgres" dataSource.password = "myDbPass"
dataSource.dialect = "org.hibernate.dialect.SQLServer2012Dialect" // For 2012 and above dataSource.driverClassName = "com.microsoft.sqlserver.jdbc.SQLServerDriver" dataSource.url = "jdbc:sqlserver://localhost:1433;databaseName=icescrum" dataSource.username = "sa" dataSource.password = "myDbPass"
