开源webbloger Roller安装手记

近几天比较的空，心里有点空空的，无意中看到Roller这个开源博客软件，比较有兴趣，想搭建起来试用一下，本来以为根据Installation Guide很容易就可以搭建起来，可事实还是花了一翻工夫。现在把它写下来，希望能给想搭建这个软件的同仁一个参考。好了，费话少说，在开始介绍以前先说一下我的机器环境：windows2000 ad Server+jdk1.4.2+DB2 8.2+tomcat5.0.281. 首先，到www.rollerwebbloger.org根据提示在相应的网站下载roller 2.0稳定版（最好还下载源代码，实在不明白的时候可以看看相关内容的源代码：））2. 设置系统变量JAVA_HOME=c:/j2sdk142为你的JDK安装目录，然后安装tomcat，并设置系统变量CATALINA_HOME=d:/tomcat5，因为我是这安装在d:/tomcat5这个目录，这个要根据自己安装的位置进设置。3. 解压roller的下载包到CATALINA_HOME/WEBAPPS下，其实你可以解压出来将roller这个目录整个拷贝到CATALINA_HOME/WEBAPPS也可以。4. 建立roller所需要的数据库，数据表。因为我用的是DB2，所以在CLP建立数据库rollerdb，然后从CATALINA_HOME/webapps/roller/WEB-INF/dbcripts/db2下执行createdb.sql脚本建立所需数据表（这一步每个数据库的情况都不一样，所以根据具体的数据库进行设置，roller默认的数据库是mysql）5. 将JDBC驱动包拷贝到CATALINA_HOME/common/lib下，我的是db2java.zip、db2jcc.jar；同时根据安装指南，将mail.jar和activation.jar移动到CATALINA_HOME/common/lib下。6. 将从安装指南下载的roller_tomcat_5_0.xml进行修改后放到CATALINA_HOME/conf/Catalina/localhost目录下。并改名为roller.xml，下面是我的文件内容

<!--

Example roller context configuration file for Tomcat 5.0.X and MySQL 4.1.X

Place this file at CATALINA_HOME/conf/Catalina/localhost/roller.xml and replace

the following values:

DBNAME - The name of your Roller database (the name you used with 'create database')

DBUSERNAME - A MySQL user with full access to that database

DBPASSWORD - The password for that user

This file assumes you are deploying Roller to the URI "/roller" and have put it under

"roller" in your normal Tomcat appbase (typically "webapps"). If not, see the

instructions for setting up Roller to run under a different URI.

-->

<Context path="/roller" docBase="roller" debug="99" workDir="work/Catalina/localhost/roller">

<Realm className="org.apache.catalina.realm.JDBCRealm"

driverName="COM.ibm.db2.app.DB2Driver"

connectionURL="jdbc:db2:ROLLERDB"

connectionName="db2admin"

connectionPassword="12345678"

userTable="rolleruser"

userNameCol="username"

userCredCol="passphrase"

userRoleTable="userrole"

roleNameCol="rolename" debug="99" />

<Resource name="jdbc/rollerdb" auth="Container" type="javax.sql.DataSource" />

<ResourceParams name="jdbc/rollerdb">

<parameter>

<name>factory</name>

<value>org.apache.commons.dbcp.BasicDataSourceFactory</value>

</parameter>

<parameter>

<name>driverClassName</name>

<value>COM.ibm.db2.app.DB2Driver</value>

</parameter>

<parameter>

<name>url</name>

<value>jdbc:db2:ROLLERDB

</value>

</parameter>

<parameter><name>username</name><value>db2admin</value></parameter>

<parameter><name>password</name><value>12345678</value></parameter>

<parameter><name>maxActive</name><value>50</value></parameter>

<parameter><name>maxIdle</name><value>5</value></parameter>

<parameter><name>removeAbandoned</name><value>true</value></parameter>

<parameter><name>maxWait</name><value>3000</value></parameter>

</ResourceParams>

<!--

To enable email notification of comments: uncomment the resouce below,

set your mailhost, and make sure you have mail.jar and activation.jar

in <tomcat>/common/lib.

-->

<!--

<Resource name="mail/Session" auth="Container" type="javax.mail.Session"/>

<ResourceParams name="mail/Session">

<parameter>

<name>mail.smtp.host</name>

<value>mailhost.example.com</value>

</parameter>

</ResourceParams>

-->

</Context>

7. 设置tomcat服务器支持UTF-8，

<Connector

port="8080" maxThreads="150" minSpareThreads="25" maxSpareThreads="75"

enableLookups="false" redirectPort="8443" acceptCount="100"

debug="0" connectionTimeout="20000" URIEncoding="UTF-8"

disableUploadTimeout="true" />

8. 配置roller的hibernate.cfg.xml.(在roller/web-inf/classes下)系统默认的mysql，这里需要改成自己所用数据库的配置。我的配置如下：(如果不配置这一步，在访问http://localhost:8080/roller的时候会出现null|main menu|登录,请在此困惑的朋友注意，这个问题在roller mail list里有解答,看来有时候安装指南也不可靠)

<property name="show_sql">false</property>

<property name="connection.datasource">java:comp/env/jdbc/rollerdb</property>

<property name="dialect">org.hibernate.dialect.DB2Dialect</property>

9. 启动tomcat。访问http://localhost:8080/roller，现在注册新用户出来了，第一个注册的用户自动是管理员，这个时候你就可以进行配置和管理了。10. 安装完成，这里我只是采用了默认的安装方式，没有进行配置，有兴趣的朋友可以自己研究。

小结：总的来说安装还是比较简单的，关键是hibernate.cfg.xml这个一步没有在安装说明里有介绍，所以造成一些朋友安装起来以后不可以使用，比较难理解，我刚开始也是一样，后来我到roller mail list里浏览一下，找到了解答，看来开源的东东还得多看看相关的资料才行。