iceScrum v7 supports Java 8 (recommended) and Java 7. Java 6 is not supported anymore, and Java 9, 10 and higher are not supported.
If you already have another version of Java installed, it is not a problem: different versions can cohabit.
Here are the supported Tomcat versions, and the manual operations required to use them:
First, you need to configure the Tomcat server itself.
In the tomcatDir/conf/server.xml file, update the connector to use the NIO protocol and set the port to be used for iceScrum (here 8080). Be careful, the port must be free, and starting on port 80 requires admin privileges.
<Connector port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol" connectionTimeout="2000" maxThreads="500" URIEncoding="UTF-8"/>
Then, you need to configure the Java options.
If you use the Tomcat service manager on Windows then the options must be entered in the GUI rather than in a script and the memory options are entered in separate dedicated fields.
Otherwise, add them to the CATALINA_OPTS environment variable (if you use Jetty, define the JAVA_OPTIONS variable instead).
The following flags are usually already configured by default, but we recommend that you check that they are provided to the JVM:
To write these options in the CATALINA_OPTS variable, you can create an script in tomcatDir/bin/ called setenv.sh (setenv.bat for Windows) and give it execution permissions on your OS.
export CATALINA_OPTS="$CATALINA_OPTS -Duser.timezone=UTC -Xmx1024m -XX:MaxPermSize=256m"
set "CATALINA_OPTS=%CATALINA_OPTS% -Duser.timezone=UTC -Xmx1024M -XX:MaxPermSize=256m"
First, you may want to remove everything in tomcatDir/webapps/ to start with a clean Tomcat installation.
Download icescrum.war here: https://www.icescrum.com/download/ (click on the “box icon”) and move it to the tomcatDir/webapps/ directory.
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.
Once it is configured, you can start the Tomcat server by running the tomcatDir/bin/startup.sh script (startup.bat for Windows). Depending on how you installed it, tomcat can also be started as a service as so: service tomcat8 start. Tomcat will start iceScrum automatically if the WAR is found in the tomcatDir/webapps/ directory.
You can then open the how to install iceScrum documentation and follow the “Configure iceScrum” section in order to get started.
Here are some common issues related to custom application server:
If it doesn’t help, please refer to the main troubleshooting documentation.