tomcat6下icescrum的安装

outlook

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>　　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  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 :
　　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文件里修改一下