Install Icescrum

Icescrum com’s with two installer options:
1. icescrum.jar: Include iceScrum and a preconfigured Tomcat server.
2. icescrum.war: Include iceScrum web app only.

In this guide we will learn how to install and configer icescrum.war with Tomcat and PostgreSQL on Ubuntu/Debian Server.


Requirement

iceScrum R6#14.3 require:
- Java 7. (Java 8 not supported)
- Tomcat 7. (Tomcat 8 not supported)

Tomcat 7

Install

To install Tomcat 7:

1
$ sudo apt-get install tomcat7 tomcat7-docs tomcat7-admin tomcat7-examples

Confige

  1. Add CATALINA_OPTS by craeting the setenv.sh file

    1
    
    $ sudo nano /usr/share/tomcat7/bin/setenv.sh
    
    Then Copy/Paste those options to the file
    1
    2
    3
    4
    
    CATALINA_OPTS="-XX:MaxPermSize=512m -Xmx1024m"
    CATALINA_OPTS="$CATALINA_OPTS -Dicescrum_config_location=/etc/tomcat7/icescrum.groovy"
    CATALINA_OPTS="$CATALINA_OPTS -Duser.timezone=UTC"
    #CATALINA_OPTS="$CATALINA_OPTS -Dicescrum.log.dir=/var/lib/tomcat7/icescrum/"
    

  2. Config server.xml file
    Open server.xml file

    1
    
    $ sudo nano /etc/tomcat7/server.xml
    
    Search for
    1
    
    <Connector port="8080"  />
    
    comment it out and use instead
    1
    2
    3
    4
    5
    
    <Connector port="8080"
      protocol="org.apache.coyote.http11.Http11NioProtocol"
      connectionTimeout="2000"
      maxThreads="500"
      URIEncoding="UTF-8"/>
    

PostgreSQL

Install

To install PostgreSQL

1
$ sudo apt-get install postgresql postgresql-contrib

// TODO

Icescrum

Download

Download icescrum.war file to /var/lib/tomcat7/webapps/ directory from https://www.icescrum.com/pricing/#standalone

1
2
$ cd /var/lib/tomcat7/webapps/
$ sudo wget http://direct/url/to/icescrum.war

Confige

Create icescrum.groovy file at /etc/tomcat7/

1
$ sudo nano /etc/tomcat7/icescrum.groovy

Then Copy/Paste this configration (modifiy to fit your config)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
//Server URL - IMPORTANT
grails.serverURL = "http://127.0.0.1:8080/icescrum"

//Logging (for debug purposes)
icescrum.debug.enable = true

//Working directory
//icescrum.baseDir = "/var/lib/tomcat7/icescrum/"

//PostgreSQL
dataSource.driverClassName = "org.postgresql.Driver"
dataSource.dialect="net.sf.hibernate.dialect.PostgreSQLDialect"
//dataSource.dialect="org.hibernate.dialect.PostgreSQLDialect"
dataSource.url = "jdbc:postgresql://localhost:5432/icescrum"
dataSource.username = "postgres"
dataSource.password = "postgres"

//MySQL
//dataSource.dialect = "org.hibernate.dialect.MySQL5InnoDBDialect"
//dataSource.driverClassName = "com.mysql.jdbc.Driver"
//dataSource.url = "jdbc:mysql://localhost:3306/icescrum?useUnicode=true&characterEncoding=utf8"
//dataSource.username = "root"
//dataSource.password = "password"

//Mail server (These exemple values aren't set by default)
//grails.mail.host = "smtp.gmail.com"
//grails.mail.port = 465
//grails.mail.username = "identifiant@gmail.com"
//grails.mail.password = "password"

//Project
icescrum.project.import.enable = true
icescrum.project.export.enable = true
icescrum.project.creation.enable = true
icescrum.project.private.enable = true

//Users
icescrum.gravatar.secure = false
icescrum.gravatar.enable = true
icescrum.registration.enable = true
icescrum.login.retrieve.enable = true

//Alerts
icescrum.auto_follow_productowner = true
icescrum.auto_follow_stakeholder = true
icescrum.auto_follow_scrummaster = true
icescrum.alerts.errors.to = "quentin@dufour.tk"
icescrum.alerts.subject_prefix = "[icescrum]"
icescrum.alerts.enable = true
icescrum.alerts.default.from = "mrsuperboum@gmail.com"

//Attachments
icescrum.attachments.enable = true

Running

  1. Start or Restart tomcat server
    1
    2
    
    $ sudo service tomcat7 stop
    $ sudo service tomcat7 start
    
  2. Open Tomcat manager web app your.server.ip.address:8080/manager
    Under Applications make sure /icescrum is running, if not click Start to run it.
  3. Open icescrum home page your.server.ip.address:8080/icescrum
    It will redirect you to setup wizard.
  4. Follow the setup wizard and check your configuration
  5. After finish the setup wizard restart tomcat
  6. Done.

Comments