Icescrum

=Introduction=

What is it?
The iceScrum team say about the tool: "iceScrum is the free platform for your agile developments". Please read the features at the iceScrum project site.

Motivation
At the moment I test some project managment tools. Redmine is one of these. Icescrum looks nice therefore I also want test it.

Preconditions
Icescrum is a tomcat based application. The installation of tomcat itself is not part of this instruction. Installation of a database is not necessary since version R3#8. This IceScrum version is delivered with a HSQLDB (a relational database engine written in Java). Nevertheless I will describe the configuration to use a MySQL DB. Using the bundle is also not the focus of this description.

=Installation=

Download and deploy
First download the war-file-zip, unzip and copy to the directory "/var/lib/tomcat-6/webapps". Alternatively you can also deploy the unpacked war file using the tomcat manager site of your tomcat server, but this will end up first with a non functional iceScrum - don't worry about. We will repair this problem.

If you have not deployed the war using the manager aplication restart the tomcat server. The deployment process take about 20 to 120 sec. depend on your hardware environment. You can trace this process looking to your catalina.out file.

Wait until the deployment process is finished and stop your server.

Set up MySQL DB
CREATE DATABASE IF NOT EXISTS icescrum; GRANT ALL PRIVILEGES ON icescrum.* TO 'icescrum'@'localhost' IDENTIFIED BY "my_icescrum_pw"; exit;

Using external configuration file
This step will improve the upgrade possibility of iceScrum. This is suggested but not necessary.

Set up tomcat
Give the server the appropriate permissions:

Give the application the necessary memory (512MB should also be enough). And say tomcat and iceScrum that an external configuration file exist.

Start tomcat and watch output
No errors should be plotted for iceScrum. Some informations about "ehcache" seems to be normal at the moment. If you see "FileNotFoundExceptionError" look into iceScrum Forum.

First touch with iceScrum
Start your preferred browser and choose the site: "http://localhost:8080/icescrum". All new users can register first and then immediately login the application. But there is an default administration account. Therefore you have to login as "admin" and change the default password "adminadmin!" (2x "admin" followed by an "!").

=Troubleshooting= Have a look at your:

To enable debug logging set icescrum.debug.enable = true in

If pdfs are not generated check that you have installed the ebuild urw-fonts.

=Important links=
 * http://www.icescrum.org/en/installing-on-a-server/ installation instructions from icescrum
 * http://forum.icescrum.org/ iceScrum forum for instructions, questions and help