Welcome to the iceScrum iceScrum install guide. If you don’t want to manage your own iceScrum installation, you may want to consider our Cloud offers (you can try iceScrum Cloud for free!)

Introduction

If you are new to iceScrum, you may want to use the iceScrum Server desktop application. It requires no computing skills and will allow you to try iceScrum easily .

However, this application is not suitable for production purposes. That’s why we recommend you to follow this guide to install iceScrum manually in order to use it in a real production context.

Installing and configuring the server environment (application server, database, configuration) may require advanced computing skills. Kagilum provides install services, including custom configuration, and remote installation, if you are interested, feel free to contact us.

Hardware requirements

Please note that hardware requirements highly depend on your use of the tool (total number of users, number of concurrent users, other applications running on your machine…).

However, here is an estimated minimal server configuration:
- Processor: a modern one, e.g. 2GHz+, 2+ cores
- RAM: 2GB+ (iceScrum requires at least 768MB but you also need RAM for the OS, other applications etc.)
- Hard disk: 10GB+ (iceScrum itself doesn’t require
much space but you need space for the OS, DB, application server, user
attachments etc.)

Software requirements

Operating system

We recommend the use of Ubuntu 12.04 LTS (Long Term Support).

However, iceScrum can be used with other Linux distributions, Windows
and Mac OS. If you use Windows or Mac OS, you may be interested in the iceScrum Server desktop application.

Java

iceScrum requires Java 6 or 7. Please note that early versions of Java 6 may not work properly and that Java 8 support is planned but not available yet.

You will also need to ensure that the JAVA_HOME environment variable is defined and points to the Java installation directory (which is the directory that contains the bin directory so it is NOT the bin directory itself).

Application server

iceScrum is packaged as a Java Web Application ARchive (WAR). This
WAR needs to be run in a Servlet container compatible with Servlet 3.0.
We recommend the use of Tomcat,
a widely used open source Servlet container. If needed, you can use
another application server (e.g. Jetty) but this guide explains the
install procedure for Tomcat only.

We will use the name tomcatDir to represent the directory where Tomcat is installed. The user who starts Tomcat must have write permissions on tomcatDir.

Here are the supported Tomcat version, and the manual operations required to use them:
- Tomcat 7 (7.0.23 or greater), recommended: you need to remove the tomcatDir/lib/tomcat-jdbc.jar library.
- Tomcat 6 (6.29 or greater): you need to add the geronimo-servlet_3.0_spec-1.0.jar library to the tomcatDir/lib/ directory.

Please note that Tomcat 8 support is planned but not available yet.

Application server

Configuration

First, you need to configure the Tomcat server itself. In the tomcatDir/conf/server.xml file, configure the connector to use the NIO protocol and set the port to be used for iceScrum (start with the port 8080 if it is available, you will be able to change it later):

server.xml configuration
<Connector port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol"
           connectionTimeout="2000" maxThreads="500" URIEncoding="UTF-8"/>

If you use an Apache server as a frontend proxy for your Tomcat server, you will need to use mod_proxy_http with for example the following configuration for your virtualHost:

ProxyRequests Off
ProxyPreserveHost On
ProxyStatus On
ProxyPass       /icescrum/         http://localhost:8080/icescrum/
ProxyPassReverse    /icescrum/         http://localhost:8080/icescrum/ 

iceScrum is not compatible with mod_proxy_ajp as it doesn’t support HTTP streaming / push.

Then, you need to configure the CATALINA_OPTS environment variable
(if you use Jetty, define the JAVA_OPTIONS variable instead). A good
place to define it is a tomcatDir/bin/setenv.sh script (setenv.bat for Windows), please read the Tomcat documentation for more information.

Add the following settings to the CATALINA_OPTS variable:

Log directory (by default it will use the logs directory in the current path)
-Dicescrum.log.dir=/path/to/dir/where/i/can/write/
Timezone (has to be UTC)
-Duser.timezone=UTC
Config file (see the Settings section)
-Dicescrum_config_location=/path/to/dir/where/i/can/write/config.groovy
Maximum Java heap size (at least 512 Mo)
-Xmx512m
Maximum Permanent Generation size (at least 256 Mo)
-XX:MaxPermSize=256m

The following flags are usually already configured by default, but we
recommend that you check that they are provided to the JVM:

Headless mode (required for iceScrum pdf/doc/... exports)
-Djava.awt.headless=true
Server mode
-server
Install the iceScrum WAR

You can choose either iceScrum or iceScrum Pro. iceScrum Pro is an enhanced version that includes support and additional features dedicated to organizations.

Once you have chosen and downloaded the WAR file, move it to the tomcatDir/webapps/ directory.

Configure iceScrum

If you want to change config in a nice user interface and to have your changes taken into account immediately, have a look at iceScrum Pro.

If you don’t use iceScrum Pro, you have to create a file called config.groovy
that follows the Groovy format. The path of this file must be defined
in your CATALINA_OPTS (refer to the application configuration section).
We recommend that you put it in your home folder (avoid any tomcat
folder). All config changes need an application restart to apply if the
server is running.

iceScrum Pro

If you are an iceScrum Pro user, you won’t need to edit a config
file. Settings can be edited by the administrator through a nice user
interface. Please refer to the iceScrum Pro settings documentation.

Additionally, iceScrum Pro features come with their own settings when needed. Please refer to the iceScrum Pro features documentation for more information.

Config format

iceScrum config must follow the Groovy format:

// Inline comment
/*
    Block comment
*/
key = value            // For booleans and numbers values
key = "string value"   // For strings values

All paths in your config.groovy must use ‘/’ (forward slash)

You may find old config examples where string values have no quotes, when iceScrum used the Properties format (.properties). This format is now deprecated. Look at Upgrade config.properties to config.groovy format

Application settings

Here are the available application settings with their default value, given in the Groovy format (.groovy):

Project
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
Users
icescrum.gravatar.secure = false
icescrum.gravatar.enable = false
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 = "dev@icescrum.org"
icescrum.alerts.subject_prefix = "[icescrum]"
icescrum.alerts.enable = true
icescrum.alerts.default.from = "webmaster@icescrum.org"
Attachments
icescrum.attachments.enable = true
Technical Settings
Server URL
grails.serverURL = "http://localhost:8080/icescrum"
                   /* Changing the port will require to change
                     it in the Tomcat server.xml Connector*/
Logging (for debug purposes)
icescrum.debug.enable = false
icescrum.securitydebug.enable = false
Working directory
icescrum.baseDir = "<yourHome>/icescrum"
                   /* Use a custom directory where Tomcat has write rights
                      (not webapps!!). Path must use '/' (forward slash) */
Cross-domain (CORS) support for API
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 */
Mail server (These exemple values aren't set by default)
grails.mail.host = "smtp.gmail.com"
grails.mail.port = 465
grails.mail.username = "username@gmail.com"
grails.mail.password = "mypassword"
grails.mail.props = ["mail.smtp.auth":"true",
        "mail.smtp.socketFactory.port":"465",
        "mail.smtp.socketFactory.class":"javax.net.ssl.SSLSocketFactory",
        "mail.smtp.socketFactory.fallback":"false"]
        /* The props are required for SSL connections */

Database

iceScrum comes with an embedded HSQLDB database so you can try iceScrum without needing to install nor configure a DBMS. The default HSQLDB configuration is NOT suitable for production environments in terms of reliability and performances.

This configuration needs to be set in the config file (please refer
to the above section). Any change will require you to restart your
server if it is running.

Don’t forget to define a sensible charset/collation configuration when creating an empty DB in a custom DBMS. We recommend the use of UTF-8, which allows a wide range of user input.

HSQLDB

HSLQLDB is the default DB in iceScrum. It is bundled so it is
possible to try iceScrum without installing a DBMS. The DB is stored as a
script file in your file system.

Your database structure and data is stored as SQL statements in a file is called prodDba.script and prodDba.properties that are located in the directory where you started Tomcat from. To backup your DB, just keep a copy of these files.

MySQL

The MySQL JDBC connector is included in iceScrum. Consequently, you just have to configure the connection in your config file.

MySQL5 (with InnoDB storage engine) example settings, assuming an empty icescrum database
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 = "myDbPass"
Oracle

Oracle support is available only for iceScrum Pro.

The Oracle JDBC connector doesn’t come with iceScrum so you will have to download it manually and put it in tomcatDir/lib.

Oracle 11g XE example settings
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"
Other DBMS

iceScrum also supports PostgreSQL and SQL Server. The corresponding
JDBC connector doesn’t come with iceScrum so you will have to download
it manually and put it in tomcatDir/lib.

PostgreSQL example settings, assuming an empty icescrum database
dataSource.driverClassName = "org.postgresql.Driver"
dataSource.url = "jdbc:postgresql://localhost:5432/icescrum"
dataSource.username = "postgres"
dataSource.password = "myDbPass"
SQLServer example settings, assuming an empty icescrum database
dataSource.driverClassName = "com.microsoft.sqlserver.jdbc.SQLServerDriver"
dataSource.url = "jdbc:sqlserver://localhost:1433;databaseName=icescrum"
dataSource.username = "sa"
dataSource.password = "myDbPass"

Start iceScrum

Once everything is configured (Tomcat, settings, DB…), you can start the Tomcat server by running the tomcatDir/bin/startup.sh script (startup.bat for Windows). Tomcat will start iceScrum automatically if the WAR is found in the tomcatDir/webapps/ directory.

It may take some time to start it for the first time. When the server
is started, enter the iceScrum URL (corresponding to the Server URL you
defined) in your favorite browser.

First, you need to register: click on “Register”, fill in the form and validate. Follow the getting started guide to enjoy the great iceScrum features!

Troubleshooting

If you find an unexpected behaviour, please read the following information.

Support

You may want to get help for your install and configuration. iceScrum developers can help you! We can install and configure your iceScrum server (contact us) and iceScrum Pro comes with dedicated support (email, skype, phone).

Common issues

- Related to configuration (DB, emails, etc.):
First, verify iceScrum is using your configuration : the config file
used is mentioned in the tomcat standard output. If so, it may be not
well formatted so check again the config format. You can also try a
trivial setting (like disabling registration) and see if it works. If
so, the config file is parsed properly so your specific setting may be
wrong. Please try with trivial values (e.g. Gmail for emails) to see if
the problem comes from your values.

- Related to exports (PDF etc.):
Ensure that your JVM is configured in headless mode as explained in this
guide and that you don’t use a not supported application server such as
Tomcat8 or an unsupported JDK.

- Related to special character input (when creating items or importing a project):
Ensure that your server DB has a sensible charset/collation as suggested in this guide. We recommend the use of UTF-8.

- Related to network (DB, LDAP, emails, push):
If you use a proxy or a firewall, it may be the reason why it doesn’t work.

- Related to server URL (attachments, redirection after logging in, etc.):
If defined a custom URL (domain, port), please ensure that your defined the Server URL setting and the proper tomcat connector.

- Related to SSL:
iceScrum does work with SSL (we are sure about that because iceScrum
Cloud uses SSL). Don’t forget to change the Server URL setting. If SSL
still doesn’t work, please check the config of your proxy (Nginx and
Apache should work fine, if configured properly).

Common errors in logs:

- java.lang.NoClassDefFoundError: javax/servlet/http/Part:
You application server doesn’t provide native support to Servlet 3.0. Tomcat 6 users, please refer to the software requirements section.

- java.lang.ClassNotFoundException: org.hsqldb.jdbcDriver (or com.mysql.jdbc.Driver)
If you use Tomcat 7, you should remove the tomcat-jdbc.jar library from the tomcatDir/lib folder as explained in the software requirements section.

- Infos: validateJarFile(/var/lib/tomcat7/webapps/icescrum/WEB-INF/lib/geronimo-servlet_3.0_spec-1.0.jar) – jar not loaded
This message can be ignored. Geronimo-servlet is here to provide compatibility with Tomcat 6.

- “Unknown column ‘text_as’” or “Unknown column ‘added’” on startup, marked as ERROR:
These errors can be ignored. They are not actual errors: the column are
missing because we removed them when migrating the database structure.
The queries remain in order to allow migration from former versions.

- java.lang.NoSuchFieldException: count:
This error can be ignored. It’s a minor compatibility issue between the
version of the programming language iceScrum is written in (Groovy) and
Java 7.

- java.lang.NullPointerException on CoyoteAdapter:
Your Tomcat 7 version is probably outdated, please refer to the software requirements section.

- Error messages in the Tomcat process when shutting down iceScrum:
it’s a known problem that shouldn’t affect your application. We
recommend that you check that the Java process has been really killed.

If you didn’t find the cause of your problem, please read the following sections about logs.

Logging

You should find a logs directory in the directory where you started Tomcat from, or in the icescrum.log.dir if you defined it in your CATALINA_OPTS.

You may want to enable more log information. If you are using
iceScrum Pro, you have to enable verbose logging in the settings
administration. Otherwise, you have to add the following line to your
settings:

Enable verbose logging
icescrum.debug.enable = true

Then, please have a look at the icescrum.log file.

Upgrade config.properties to config.groovy format

If your current config file is called config.properties, you will have to follow these instructions:

- Copy the config.properties file and name the copy: config.groovy.
- Open your freshly created config.groovy file and change the content as follows:

Where you have String value, wrap the value with double quotes.
Additionally, comment syntax has changed so you will have to replace all
the # by //. For instance, when you had:

# Data Source
dataSource.driverClassName=com.mysql.jdbc.Driver

Now you will have:

// Data Source
dataSource.driverClassName="com.mysql.jdbc.Driver"

If you have key/value with Boolean or Number values, no change is required.

icescrum.registration.enable=true
mail.port=25

Then:
- Delete or move your old config.properties file
- Don’t forget to update your config location if it is defined:

-Dicescrum_config_location=myLocation/config.groovy

IceScrum敏捷开发工具的安装文档-官方最新版的更多相关文章

  1. Azkaban使用安装文档

    Azkaban使用安装文档 Azkaban简介 Azkaban的是什么 Azkaban是由Linkedin公司推出的一个批量工作流任务调度器,用于在一个工作流内以一个特定的顺序运行一组工作和流程.Az ...

  2. 环境安装文档(for Ubuntu)

    这个文档的目标是:各位小伙伴通过这个文档,可以在一台全新的 Ubuntu 电脑上搭建平常开发使用的环境,主要包含 Node.js, git 和 编辑器部分. 这是针对 Ubuntu 系统的安装文档,W ...

  3. 【分享】iTOP4412开发板-Bluetooth移植文档

    [分享]iTOP4412开发板-Bluetooth移植文档 最近须要把Bluetooth移植到iTOP-4412 开发平台.查阅了相关资料,经过一段时间的研究.调试,最终成功的将蓝牙功能移植到了开发板 ...

  4. Apache PDFbox开发指南之PDF文档读取

    转载请注明来源:http://blog.csdn.net/loongshawn/article/details/51542309 相关文章: <Apache PDFbox开发指南之PDF文本内容 ...

  5. Greenplum/Deepgreen(集群/分布式)安装文档

    Deepgreen分布式安装文档 环境准备 1.安装VMware虚拟机软件,然后在VMware安装三台Linux虚拟机(使用centos7版本) 2.使用的虚拟机如下: 192.168.136.155 ...

  6. CentOS6.5下安装JDK1.7+MYSQL5.5+TOMCAT7+nginx1.7.5环境安装文档

    ----------------CentOS6.5下安装JDK1.7+MYSQL5.5+TOMCAT7+nginx1.7.5环境安装文档----------------------- [JDK1.7安 ...

  7. airflow2.0.2分布式安装文档

    需要安装的组件 组件 功能 Airflow Webserver 查询元数据以监控和执行DAGs的web界面. Airflow Scheduler 它检查元数据数据库中的DAG和任务的状态,在必要时创建 ...

  8. ORACLE LINUX 6.3 + ORACLE 11.2.0.3 RAC + VBOX安装文档

    ORACLE LINUX 6.3 + ORACLE 11.2.0.3 RAC + VBOX安装文档 2015-10-21 12:51 525人阅读 评论(0) 收藏 举报  分类: Oracle RA ...

  9. Oracle 11g 单实例安装文档

    这里介绍在Red Hat Enterprise Linux Server release 5.7 (Tikanga)下安装ORACLE 11.2.0.1.0的过程,本文仅仅是为了写这样安装指导文档而整 ...

随机推荐

  1. URAL - 1091 Tmutarakan Exams (简单容斥原理)

    题意:K个不同数组成的集合,每个数都不超过S且它们的gcd>1.求这样的数的个数 分析:从2开始枚举gcd,但这样会发生重复.譬如,枚举gcd=2的集合个数和gcd=3的集合个数,枚举6的时候就 ...

  2. 对Java CAS的一些了解(正在整理学习中)

    ①引言 在JDK 5之前Java语言是靠synchronized关键字保证同步的,这会导致有锁 锁机制存在以下问题: (1)在多线程竞争下,加锁.释放锁会导致比较多的上下文切换和调度延时,引起性能问题 ...

  3. ReentrantLock的底层实现机制 AQS

    ReentrantLock的底层实现机制是AQS(Abstract Queued Synchronizer 抽象队列同步器).AQS没有锁之类的概念,它有个state变量,是个int类型,为了好理解, ...

  4. QML中的state 状态

    QML中的状态其实很好理解,任何事物在某一事件都是有一个状态的. 比如你看到的一个窗口,这个时候里面的文字和图片正处于某个状态中.比如一个超链接,你点击了,发现颜色变了,你按了Ctrl+A,整个窗体好 ...

  5. The type javax.http.HttpServletRequest cannot be resolved.It is indirectly 解决办法

    原因:项目中缺少servlet-api.jar文件. 解决办法:将E:\tomcat\apache-tomcat-6.0.24\lib下的servlet-api.jar拷贝到项目中,然后编译即可.(根 ...

  6. 关于URL和http协议,http消息格式

    转自:http://crystal2012.iteye.com/blog/1447845 在WWW(全球资讯网)中想要连结到某个网页,便需要给浏览器一个位址,而URL在此的功能就是告知浏览器某个资源在 ...

  7. wget指定目录下载以及其它的使用方式

    转自 http://java-er.com/blog/wget-useage-x/ 有时候我们需要wget一个文件下载到指定的目录下,或者重命名成指定的名字 wget -r -p -np -k -P ...

  8. openwrt的编译系统在哪里对程序进行开机自动启动配置

    答:在include/rootfs.mk里的宏prepare_rootfs中进行的

  9. 建站有很多技术,如 HTML、HTML5、XHTML、CSS、SQL、JavaScript、PHP、http://ASP.NET、Web Services、浏览器脚本、服务器脚本等。它们的区别是什么?新手一点不懂,想理清所有这些技术之间的关系和应用范围。

    先普及用户通过 浏览器 访问网页 的过程: 网页内容是通过服务器运算得出的结果,将结果(网页代码)传输给浏览器,网页代码再通过浏览器运算(计算.渲染),最终展示在用户的眼前的. 至此,我们知道了有2个 ...

  10. RedHat7.4最小化安装没有ifconfig命令

    软件环境 VirtualBox 5.2.8 rhel-server-7.4-x86_64-dvd.iso 系统环境 Win10 64 位 8G内存 最小化安装了RedHat7.4之后,进入系统之后使用 ...