蓝色梦幻的Blog

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。