Project Midgard 部署指南
Step 1 - 获得 Project Midgard
你可以用 Subversion 获得 Project Midgard 的最新源代码:
svn co http://project-babel.googlecode.com/svn/midgard/trunk midgard
执行这条指令之后,Project Midgard 的最新源代码将被下载到 midgard 目录中。
Step 2 - 安装依赖的软件
编译及调试 Project Midgard 将需要 JDK 5 以上的版本及 Apache Ant 1.7 以上的版本:
Sun JDK: http://java.sun.com/javase/downloads/index.jsp
Apache Ant: http://ant.apache.org/bindownload.cgi
确认你的系统上已经装好 JDK 及 Ant 之后,在 midgard 目录中执行以下指令:
ant fetch-extlib
这样将会把 Project Midgard 所依赖到的 Java 库从 V2EX Labs 下载到本地。
Step 3 - 配置文件
将 midgard 目录下 conf 目录中的 config.example.xml 复制为 config.xml 然后打开之后编辑。这个文件的默认状态是:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<!-- mode: v2ex | avalon -->
<entry key="mode">v2ex</entry>
<!-- dbType: mysql | derby -->
<entry key="dbEnable">yes</entry>
<entry key="dbType">mysql</entry>
<entry key="dbHome">/src/midgard/db</entry>
<entry key="dbServer">localhost</entry>
<entry key="dbPort">3306</entry>
<entry key="dbUsername">root</entry>
<entry key="dbPassword"></entry>
<entry key="dbSchemata"></entry>
<entry key="cacheRepo">/src/midgard/cache/repo</entry>
<entry key="xmppServer">gmail.com</entry>
<entry key="xmppUsername"></entry>
<entry key="xmppPassword"></entry>
<entry key="xmppStatus">V2EX | software for internet</entry>
</properties>
其中各项的含义是:
* mode - 信息处理器(Message Processor)的模式,在 R200 中包括了两个信息处理器 v2ex 和 avalon。
* dbEnable - 是否使用关系型数据库,某些信息处理器不需要使用到关系型数据库,比如 avalon。
* dbType - 数据库类型,目前支持两种数据库,MySQL 和 Apache Derby,如果你使用的是 v2ex 信息处理器连接 Project Babel 的话,这里需要设置为 mysql。
* dbHome - 如果你使用 Derby 数据库的话,数据库文件的位置在这里设置。
* dbServer - 数据库服务器的地址。
* dbPort - 数据库服务器的端口。
* dbUsername - 用于连接数据库服务器的用户名。
* dbPassword - 用于连接数据库服务器的用户密码。
* cacheRepo - 缓存文件位置,Project Midgard 使用了一个 HSQLDB 数据库作为高速缓存的存储,这里需要指定 HSQLDB 数据库的位置。
* xmppServer - XMPP 服务器的地址。
* xmppUsername - 用于连接 XMPP 服务器的用户名。
* xmppPassword - 用于连接 XMPP 服务器的用户密码。
* xmppStatus - 用户的状态信息(即签名)。
如果你是在 Google Talk 系统中使用 Project Midgard 的话,请将 xmppServer 的地址设置为 gmail.com。
如果你是在本地调试 Project Midgard 的话,推荐你可以安装 Openfire 用于调试。Openfire 是一个开放源代码的 XMPP 服务器,功能非常强大。
Step 4 - 运行
配置好 config.xml 之后,在 midgard 目录中输入:
ant
ant run
即可编译运行 Project Midgard。
