Xplanner(英文版) 安装手册  for V0.6.1, 英文原版, joson翻译

Xplanner(英文版) 安装手册  for V0.6.1

参照: Upgrading to 0.6.2 and 0.7.
注意: 本手册不适用于0.7版，请参照发行包的README.txt文件.

基本需求

• Ant
  
• MySQL 是XPlanner 的首选数据库. Configure MySQL with transacted tables (InnoDB)! (See also: other databases.)
  
• JDK 1.4+
  
• Servlet 2.3 (JSP 1.2) or 其他更好的兼容的web容器 (e.g. Tomcat 4.x )
  

1. 获取源码

下载 最新版本 or check out the sources from Subversion.
如果你使用的是Tomcat.请看 Tomcat 安装须知. 其中包含如何到如何导入一个已有的tomcat-users.xml 文件. 另外还要看看 OC4J application server使用须知.

2. 数据库配置

XPlanner 使用提前设置好的关系数据库来存储数据.
设置JDBC driver:
XPlanner 附带了 MySQL 和HSQLDB的JDBC 驱动.使用其他数据库请看《 关于使用其他数据库的信息》,来获得相关 JDBC driver并放置到lib/jdbc-driver 目录下，然后再重新编译XPlanner.建议提前测试确认驱动程序是否能正确连接数据库.
关于MySQL的其它配置参见 这里.
配置 properties文件:
要在xplanner.properties文件中设置修改数据库连接属性.
尽管可以直接修改xplanner.properties中的属性来达到目的，但是还是建议不要修改原始的xplanner.properties,而是建立一个定制的属性文件xplanner-custom.properties (文件名不能改变,仅包含需要修改的内容)来代替修改xplanner.properties，这样可以避免你的设定值被新的发行版所覆盖，注意:xplanner.properties要在同一个目录内;xplanner-custom.properties中的属性值优先于xplanner.properties.
hibernate.dialect=<hibernate dialect>
hibernate.connection.url=<your JDBC url>
hibernate.connection.username=<数据库用户,要在数据库提前设置好>
hibernate.connection.password=<数据库用户密码,要在数据库提前设置好>
xplanner.properties中有MySQL和HSQL等数据库的配置例子. 以下是一个mysql的配置：
# Hibernate MySQL Configuration
hibernate.dialect=com.technoetic.xplanner.db.hibernate.XPlannerMySQLDialect
hibernate.connection.driver_class=com.mysql.jdbc.Driver
hibernate.connection.url=jdbc:mysql://localhost/xplanner6?useUnicode=true&characterEncoding=GBK&autoReconnect=true
hibernate.connection.username=xpadmin
hibernate.connection.password=
安装数据库模式（schema）:
注意:可以使用xplanner/sql来升级XPlanner 0.4 MySQL database，这些脚本也可以用来被参照修改其它类型的数据库，升级前要做好数据备份!
有两种安装方式：自动和手工.
自动安装间但可能会覆盖以前的数据建议在全新安装专用于Xplanner的数据库时使用. 自动安装方法，在Xplanner根目录下运行：
$ ant install.db.schema
将会使用xplanner.properties 中的信息来建表，同时建立用户 'sysadmin'，口令'admin' ，此用户用于初始访问，建议立即改口令.
手工安装，在Xplanner根目录下运行：
$ ant create.db.schema.script
此命令会在build目录下建立脚本hibernate_schema.sql ，其中包含根据xplanner.properties设定所需的所有的 DDL 脚本.

3. 配置 email

Xplanner使用email来通知协同工作。配置过程就是修改 xplanner.properties文件以下内容(建议不要修改原始的xplanner.properties,而是建立一个定制的仅包含需要修改内容的属性文件xplanner-custom.properties,来代替修改xplanner.properties，这样可以避免你的设定值被新的发行版所覆盖，注意:xplanner.properties要在同一个目录内;xplanner-custom.properties中的属性值优先于xplanner.properties.)：
xplanner.mail.smtp.host=localhost        # 输入SMTP 主机
xplanner.mail.from=[e-mail]  # 输入XPlanner messages信息的发信人地址

4. 生成xplanner.war 文件

进入XPlanner 目录(包含 build.xml文件). 运行
$ ant build.war
将在xplanner 根目录生成xplanner.war 文件.

5. (可选的) 配置JVM 用于在unix服务器生成图形

如果在类Unix系统上运行Xplanner，如果没有X window 服务，会发生问题，错误日志如下...
java.lang.NoClassDefFoundError
    at com.jrefinery.chart.axis.Axis.<init>(Unknown Source)
    at com.jrefinery.chart.axis.CategoryAxis.<init>(Unknown Source)
    ...
以下是几个解决方案：
There are several solutions to this problem. You can run an X server on the XPlanner host. Often this is not desirable if the host is a dedicated serverhost. You can also add a parameter to the JVM running your servlet engine.
   Add a -Djava.awt.headless=true to your JVM command-line. This works
   fine unless the application tries to call methods which interrogate
   the screen-size and so on. Using JDK1.4.1_03 I've got Cewolf working
   under Linux for another application, so it should work for XPlanner too.
   - Neal Sanche
I've tried this approach and it worked on our Linux server. For Tomcat, add the option to the JAVA_OPTS environment variable before starting the server (edit the startup.sh program used to start Tomcat). There is also a program called Xvfb (X virtual frame buffer) that can be used as a replacement for a full X server. A few other potential solutions exist, but I'd recommend trying the JVM option first before exploring others.
2004-4-5 21:30:32 brokendoor：xplanner 的报表程序在linux环境下无XWin运行可能会出现上面的错误，简单的解决办法是使用jdk 1.4以上版本并且在运行resin时加上启动参数. 因为本地没有x-win-server 而java-awt/swing组件需要本地的x-server 有两种解决方法 :
1。 java 1.4以上 ：启动java时加上-Djava.awt.headless=true 的参数，
2。 java 1.4以前 ：下载 xvfb 或者其他的 虚拟x-window软件，再在java运行环境里的DISPLAY作相应改变！！
比如我使用的是tomcat, 设置以下参数：
export CATALINA_OPTS=-Djava.awt.headless=true
./startup.sh

6. 部署WAR 文件

对于Tomcat, 把xplanner.war 文件放到$CATALINA_HOME/webapps 目录即可.

7. 启动servlet 容器，开始使用XPlanner

用"sysadmin"用户（初始口令"admin"）登陆. 建议立即改口令。现在可以使用了，祝你好运!

---

配置iCal 客户端
使用 iCal 来获得一个远程的日历，可以使用以下信息 (使用 XPlanner 用户).
URL: http://www.yourhost.com:8080/xplanner/ical/ user.ics
User ID: user
Password: yourpassword

---

运行单元测试
使用 ant的运行任务unit.tests 来运行 XPlanner 单元测试. 测试使用了junit，所以Junit的jar文件必须在ant的class搜索目录中才能运行.

---

运行验收/功能测试
与单元测试类似. 功能测试使用了junit，所以Junit的jar文件必须在ant的class搜索目录中才能运行，以下是功能测试步骤:

1. 配置 xplanner-custom.properties 中的xplanner.application.url 参数来指向你的Xplanner测试安装地址.
   
2. 设置 xplanner-custom.properties 中的xplanner.test.user 和 xplanner.test.password 参数以便于登陆Xplanner
   
3. • 使用Ant 运行acceptance.tests 任务，开始测试。