tomcat6下icescrum的安装
tomcat6下icescrum的安装
关于icescrum的简介，可以参见http://www.oschina.net/p/icescrum：“iceScrum是一个用于敏捷开发的开源平台。iceScrum设计用于Scrum，Scrum是流行的敏捷方法。”。
这一段是官网的安装说明，来自http://www.icescrum.org/en/installing-on-a-server/：
Prerequisites
* JavaVirtual Machine (JVM) 1.6 or greater,
* Web application server Java compatible servlet 2.4.
* Web browser : InternetExplorer 7+, Firefox 3+, Safari 3+, Chrome
* Installation of a database is no longer necessary, iceScrum is now delivered with a HSQLDB (a relational database engine written in Java)
Recommendations
* Your web container must be able to allocate sufficient memory for iceScrum : at least 512 Mb.
* Add at least the following settings to the JVM (environment variable JAVA_OPTS) : -Xmx512M -XX:MaxPermSize=512M.
Installation
1. Download the most recent WAR from the website.
2. Copy the WAR to the root directory <web-apps> of your container or use your application server’s administration tool to deploy the WAR.
3. In the file config.properties, change : grails.serverURL = http://[url_to_icescrum]/[context_name] (by défault it is http://localhost:8080/icescrum)
4. For a Tomcat server, change the file server.xml so the catalina connector owns this configuration : <Connector port=”8080″ protocol=”org.apache.coyote.http11.Http11NioProtocol” connectionTimeout=”2000″ maxThreads=”500″ URIEncoding=”UTF-8″/>
5. (OPTIONAL) If your container is “recent” (Tomcat6, Glassfish, …), then it might already include the libraries supplied in the WAR. In this case, delete the following files from the WAR (either using an archive tool or deleting them from the destination directory) : el-ri.jar, el-api.jar, jsf-api.jar, jsf-impl.jar, myfaces-api.jar, myfaces-impl.jar
6. Start your server.
7. In your web browser, go to URL : http://[host_adress]/[web-app] (par exemple, http://localhost:8080/icescrum).
8. Finally, you need to register : click on “Register”, fill in the form and validate. You can now create a project.
=================================以下是对照的意译，及一些个人的经验====================================
准备工作
*jvm1.6，这确实是必须的。我这儿用的是jrockit-jdk_1.6
*官方文档中提到的“Web application server Java compatible servlet 2.4.”，是指能运行servlet2.4的web容器。但是我没有在weblogic9.2.3和weblogic10.3.2上发布成功过；也没有尝试tomcat6以外的其它版本。
*浏览器版本，官方文档中的要求是IE7以上，FF3以上，等等。我尝试了FF3.6和IE8，没有问题。
*最后提到iceScrum已经自带了HSQLDB数据库，可以不用单独安装数据库了。这是个好事儿，但是有隐患。linux下安装成功后，如果服务出了问题要重启服务，请一定使用tomcat自带的shutdown.sh脚本，或者其它的正常关闭服务的脚本，而千万不要直接kill进程。kill进程会导致重启服务时，icescrum无法获取HSQLDB的changeloglock，从而无法启动。发生这个错误时，应该进入数据库去手动修改一个管理表的列值，但且我不知道如何进入HSQLDB……所以……呵呵……
如果要使用独立的数据库，ms是在comfig.properties中进行配置。我目前的工作还没涉及到这一点。呵呵。留作TODO吧
推荐配置
*web容器至少给icescrum分配512m的堆内存……我的开发机器因此而被bs……
*至少将这两项配置加到jvm的启动参数中：-Xmx512M -XX:MaxPermSize=512M。linux下的配置方法是：
找到tomcat安装路径/bin下的Catalina.sh，在其中增加JAVA_OPTS ="$JAVA_OPTS -Xmx512M -XX:MaxPermSize=512M"。
不过我不是这么写的……我是在脚本中原有的一处JAVA_OPTS的后面追加了-Xmx512M -XX:MaxPermSize=512M这么一串。因为linux下配置jvm参数的方法没上面那段写的那么简单……
另外，如果tomcat用的不是sun的jdk，而是jrockit-jdk，那么，-XX:MaxPermSize=512M这个参数实际起不到作用……至于要怎样配置才行……我还不知道……
安装步骤
1、下载安装文件。官网提供两种文件下载。一个是单纯的war包；一个是包含了tomcat5服务的一个bundle包。下载地址是：http://www.icescrum.org/en/download-en/。我下载的是第一种。实际这个文档也是介绍的war包的安装部署。
2、把war包复制到发布路径下。
3、修改文件config.properties中的grails.serverURL值，把它改成实际值。
这个文件在war包里面，路径是icescrum.war/WEB-INF/classes/config.properties。文件中最后一行是#grails.serverURL = http://localhost:8080/icescrum。把“#”删掉，把"localhost"换成服务器的实际ip即可。
4、在tomcat服务器上发布时，去tomcat的server.xml文件里修改一下<Connector port=”8080″ 的相关配置，把它改成<Connector port=”8080″ protocol=”org.apache.coyote.http11.Http11NioProtocol” connectionTimeout=”2000″ maxThreads=”500″ URIEncoding=”UTF-8″/>
5、可选步骤。如果web容器版本较高，那么也许需要从war包中删掉一些jar包。估计这么做是为了避免jar包冲突。不过我没有删，也没有发现问题。
6、启动服务器。
7、启动正常的话，就可以访问了。访问路径是http://ip地址:8080/icescrum。
基本操作
注册和登录
进入主界面后，点击右上角“connect”，在登陆表单那儿点击“Register”来注册用户。如果想要使用中文界面，在注册用户时的语言选项请选择“cn”（中文）。注册成功后回到登陆界面，填写用户名密码，点击connect即可。登陆界面是英文的，登陆成功后将切换到中文界面。
基本操作流程
首先在“意见箱”中录入用户故事，“意见箱”即产品BackLog；被接受了的用户故事将进入“产品积压”面板，“产品积压”即冲刺BackLog；在“产品积压”界面将用户故事分配到冲刺周期后，将在“冲刺计划”界面展示此冲刺计划中包含的用户故事，并可在此界面中完成任务拆解、产品白板、进度日志等相关功能。“主面板”中的“图表”选项可以查看燃尽图、燃耗图等各类图表。
关于icescrum的简介，可以参见http://www.oschina.net/p/icescrum：“iceScrum是一个用于敏捷开发的开源平台。iceScrum设计用于Scrum，Scrum是流行的敏捷方法。”。
这一段是官网的安装说明，来自http://www.icescrum.org/en/installing-on-a-server/：
Prerequisites
* JavaVirtual Machine (JVM) 1.6 or greater,
* Web application server Java compatible servlet 2.4.
* Web browser : InternetExplorer 7+, Firefox 3+, Safari 3+, Chrome
* Installation of a database is no longer necessary, iceScrum is now delivered with a HSQLDB (a relational database engine written in Java)
Recommendations
* Your web container must be able to allocate sufficient memory for iceScrum : at least 512 Mb.
* Add at least the following settings to the JVM (environment variable JAVA_OPTS) : -Xmx512M -XX:MaxPermSize=512M.
Installation
1. Download the most recent WAR from the website.
2. Copy the WAR to the root directory <web-apps> of your container or use your application server’s administration tool to deploy the WAR.
3. In the file config.properties, change : grails.serverURL = http://[url_to_icescrum]/[context_name] (by défault it is http://localhost:8080/icescrum)
4. For a Tomcat server, change the file server.xml so the catalina connector owns this configuration : <Connector port=”8080″ protocol=”org.apache.coyote.http11.Http11NioProtocol” connectionTimeout=”2000″ maxThreads=”500″ URIEncoding=”UTF-8″/>
5. (OPTIONAL) If your container is “recent” (Tomcat6, Glassfish, …), then it might already include the libraries supplied in the WAR. In this case, delete the following files from the WAR (either using an archive tool or deleting them from the destination directory) : el-ri.jar, el-api.jar, jsf-api.jar, jsf-impl.jar, myfaces-api.jar, myfaces-impl.jar
6. Start your server.
7. In your web browser, go to URL : http://[host_adress]/[web-app] (par exemple, http://localhost:8080/icescrum).
8. Finally, you need to register : click on “Register”, fill in the form and validate. You can now create a project.
=================================以下是对照的意译，及一些个人的经验====================================
准备工作
*jvm1.6，这确实是必须的。我这儿用的是jrockit-jdk_1.6
*官方文档中提到的“Web application server Java compatible servlet 2.4.”，是指能运行servlet2.4的web容器。但是我没有在weblogic9.2.3和weblogic10.3.2上发布成功过；也没有尝试tomcat6以外的其它版本。
*浏览器版本，官方文档中的要求是IE7以上，FF3以上，等等。我尝试了FF3.6和IE8，没有问题。
*最后提到iceScrum已经自带了HSQLDB数据库，可以不用单独安装数据库了。这是个好事儿，但是有隐患。linux下安装成功后，如果服务出了问题要重启服务，请一定使用tomcat自带的shutdown.sh脚本，或者其它的正常关闭服务的脚本，而千万不要直接kill进程。kill进程会导致重启服务时，icescrum无法获取HSQLDB的changeloglock，从而无法启动。发生这个错误时，应该进入数据库去手动修改一个管理表的列值，但且我不知道如何进入HSQLDB……所以……呵呵……
如果要使用独立的数据库，ms是在comfig.properties中进行配置。我目前的工作还没涉及到这一点。呵呵。留作TODO吧
推荐配置
*web容器至少给icescrum分配512m的堆内存……我的开发机器因此而被bs……
*至少将这两项配置加到jvm的启动参数中：-Xmx512M -XX:MaxPermSize=512M。linux下的配置方法是：
找到tomcat安装路径/bin下的Catalina.sh，在其中增加JAVA_OPTS ="$JAVA_OPTS -Xmx512M -XX:MaxPermSize=512M"。
不过我不是这么写的……我是在脚本中原有的一处JAVA_OPTS的后面追加了-Xmx512M -XX:MaxPermSize=512M这么一串。因为linux下配置jvm参数的方法没上面那段写的那么简单……
另外，如果tomcat用的不是sun的jdk，而是jrockit-jdk，那么，-XX:MaxPermSize=512M这个参数实际起不到作用……至于要怎样配置才行……我还不知道……
安装步骤
1、下载安装文件。官网提供两种文件下载。一个是单纯的war包；一个是包含了tomcat5服务的一个bundle包。下载地址是：http://www.icescrum.org/en/download-en/。我下载的是第一种。实际这个文档也是介绍的war包的安装部署。
2、把war包复制到发布路径下。
3、修改文件config.properties中的grails.serverURL值，把它改成实际值。
这个文件在war包里面，路径是icescrum.war/WEB-INF/classes/config.properties。文件中最后一行是#grails.serverURL = http://localhost:8080/icescrum。把“#”删掉，把"localhost"换成服务器的实际ip即可。
4、在tomcat服务器上发布时，去tomcat的server.xml文件里修改一下<Connector port=”8080″ 的相关配置，把它改成<Connector port=”8080″ protocol=”org.apache.coyote.http11.Http11NioProtocol” connectionTimeout=”2000″ maxThreads=”500″ URIEncoding=”UTF-8″/>
5、可选步骤。如果web容器版本较高，那么也许需要从war包中删掉一些jar包。估计这么做是为了避免jar包冲突。不过我没有删，也没有发现问题。
6、启动服务器。
7、启动正常的话，就可以访问了。访问路径是http://ip地址:8080/icescrum。
基本操作
注册和登录
进入主界面后，点击右上角“connect”，在登陆表单那儿点击“Register”来注册用户。如果想要使用中文界面，在注册用户时的语言选项请选择“cn”（中文）。注册成功后回到登陆界面，填写用户名密码，点击connect即可。登陆界面是英文的，登陆成功后将切换到中文界面。
基本操作流程
首先在“意见箱”中录入用户故事，“意见箱”即产品BackLog；被接受了的用户故事将进入“产品积压”面板，“产品积压”即冲刺BackLog；在“产品积压”界面将用户故事分配到冲刺周期后，将在“冲刺计划”界面展示此冲刺计划中包含的用户故事，并可在此界面中完成任务拆解、产品白板、进度日志等相关功能。“主面板”中的“图表”选项可以查看燃尽图、燃耗图等各类图表。