How to set up IceScrum on Ubuntu 12.04

Autor: Adrian Najczuk    Data publikacji:

ubuntuSerwer Tomcat 7 and MySQL 5.5


Install Tomcat 7

First you should install Tomcat 7 server and Tomcat Admin Module. To do so just type into console the following:

sudo apt-get install tomcat7 tomcat7-admin

Prepare icescrum

Next we will download icescrum package:

# open any download location

cd ~/Download/icescrum/

# download package


# unzip war package



Get MySQL connector

Finally you should download and unpack MySQL Java Connector

            tar -xzf mysql-connector-java-{version}.tar.gz or unzip mysql-connector-java-{version}.zip

  • From unpacked folder copy mysql-connector-java-{version}-bin.jar to Tomcat library:

           sudo cp mysql-connector-java-{version}-bin.jar /usr/share/tomcat7/lib

Thanks to this your icescrum app will be able to work with MySQL database.


Icescrum deployment

Server configuration

In Tomcat server configuration file (/var/lib/tomcat7/conf/server.xml) replace the following lines:

<Connector port="8080"



redirectPort="8443" />


<Connector port=”8080″

protocol=”org.apache.coyote.http11.Http11NioProtocol” connectionTimeout=”2000″



User configuration

In tomcat user configuration (/var/lib/tomcat7/conf/tomcat-users.xml ) file type:

<role rolename="manager-gui"/>

<user username="admin" password="pass" roles="manager-gui"/>

This will allow you to log into Tomcat application management panel to deploy downloaded icescrum.war file.


Deploying application

In your browser go to http://localhost:8080/manager/html and using credentials from previous step log into manager panel. Then deploy icescrum.war in section ‘WAR file to deploy’

If you’ll get error saying there is not enough memory go to usr/share/tomcat7-admin/manager/WEB-INF/web.xml and modify the following section:






with greater values like 104857600  (100 mb).

Such deployed application isn’t ready to work. We should configure it.

NOTE: You may also deploy app by putting war package in /var/lib/tomcat7/webapps/ and restarting server /etc/init.d/tomcat7 restart

Environment configuration


On MySQL create new user and database:

CREATE DATABASE IF NOT EXISTS icescrum; GRANT ALL PRIVILEGES ON icescrum.* TO %27icescrum%27@%27localhost%27%20IDENTIFIED" data-mce-href="mailto:%27icescrum%27@%27localhost%27%20IDENTIFIED">'icescrum'@'localhost' IDENTIFIED BY "pass";


Work folder

Create new folder /home/icescrum, which will be used to store attachments and give owner permissions to that folder to user tomcat7 (created automatically while installing Tomcat)

Also create /etc/icescrum folder to keep configuration file there

chown tomcat7:tomcat7 -R /home/icescrum/

usermod -d /home/icescrum tomcat7



Next you should grant all permissions to iscescrum app on Tomcat Server in filr /etc/tomcat7/policy.d/50local.policy adding the following lines at the end:

grant codeBase "file:${catalina.base}/webapps/icescrum/-" {



Application requires more memory than it is avalible by default JVM settings, thats why we should export new settings at server startup. To do so we will modify script starting server. At the begining of /usr/share/tomcat7/bin/ insert:

JAVA_OPTS="-Djava.awt.headless=true -XX:MaxPermSize=1024m -Xmx1024m -Dicescrum_config_location=/etc/icescrum/"

Line with -Dicescrum_config_location defines where server should look for the icescrum configuration. We will talk about this file later.


App configuration

Default icescrum configuration file id located in webapps/icescrum/WEB-INF/classes/ It’s convenient to put this file somewhere else:

cp /var/lib/tomcat7/webapps/icescrum/WEB-INF/classes/ /etc/icescrum/

We replace the following properties in the newly created file:

#Data Source








#Use pool connection

dataSource.pooled=true = 50 = 25 = 1 = 1 = 1800000 = 1800000 = 3 = 10000 = true = true = false = "SELECT 1"


#serverURL Absolute link required with context name like : http://localhost:8080/icescrum


If you’re using older MySQL version you may replace




and to enable debugging type

icescrum.debug.enable = true


Start working

Now you can restart Tomcat server:

/etc/init.d/tomcat7 restart

and start working with application under http://localhost:8080/icescrum/ . If you have any problem try to check gedit /var/log/tomcat7/catalina.out log file (be sure that you’ve enabled debuging). To log in register or use default admin account:

login: admin

password: adminadmin!