Java开源Blog实现，Roller 2.0 的安装手记！

Roller 是一个Struts + Hibernate 的 Java 开源实现，正好拿来研究研究，首先就是要把它安装起来了，整理
了一下步骤和注意事项，记录如下：

准备需要的基本环境：

1. Java 2 SDK 1.4.2_10
2. Tomcat 5.0.28
3. Roller 2.0
4. MySQL 5.0.16

首先，确保MySQL开启了对InnoDB和UTF-8的支持，在my.ini中开启下面的参数：

[mysqld]
default-storage-engine=innodb
default-character-set=utf8

启动好MySQL待用...D:\MySQL\mysqld.exe --console --datadir=I:\MyData\Data

假设我的Tomcat主目录为：$CATALINA_HOME=D:\J2EE_HOME\AppServer\Tomcat

把压缩的Roller文件 roller-2.0-incubating.tar 解开...
并放到$CATALINA_HOME\WebApp\roller下面...如图...



开始建立MySQL中的数据库：

    I:> CD %CATALINA_HOME%\webapps\roller\WEB-INF\dbscripts\mysql
    I:> mysql -u root -p
    password: *****
    mysql> create database roller;
    mysql> grant all on roller.* to scott@'%' identified by 'tiger';
    mysql> grant all on roller.* to scott@'localhost' identified by 'tiger';
    mysql> use roller;
    mysql> source createdb.sql
    mysql> quit

在 $CATALINA_HOME\conf\Catalina\localhost 中放置Roller的Web Application的部署
配置档案 roller.xml，内容如下：

<Context path="/roller" docBase="${catalina.home}/webapps/roller" debug="0">
    <Realm className="org.apache.catalina.realm.JDBCRealm"
        driverName="com.mysql.jdbc.Driver" 
        connectionURL="jdbc:mysql://localhost:3306/roller?autoReconnect=true&amp;useUnicode=true&amp;characterEncoding=utf-8&amp;mysqlEncoding=utf8"
        connectionName="scott"
        connectionPassword="tiger"
        userTable="rolleruser"
        userNameCol="username"
        userCredCol="passphrase"
        userRoleTable="userrole"
        roleNameCol="rolename" debug="0" />

    <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.mysql.jdbc.Driver</value>
        </parameter>
        <parameter>
            <name>url</name>
            <value>jdbc:mysql://localhost:3306/roller?autoReconnect=true&amp;useUnicode=true&amp;characterEncoding=utf-8&amp;mysqlEncoding=utf8</value>
        </parameter>
        <parameter>
            <name>username</name>
            <value>scott</value>
        </parameter>
        <parameter>
            <name>password</name>
            <value>tiger</value>
        </parameter>
        <parameter>
            <name>maxActive</name>
            <value>20</value>
        </parameter>
        <parameter>
            <name>maxIdle</name>
            <value>3</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>

完成上面的设定后，接下来，我们修改一下Tomcat中的Connector的设定，使它能够支持UTF-8的编码，
打开 $CATALINA_HOME\conf\server.xml，做如下修改...

<!-- Define a non-SSL Coyote HTTP/1.1 Connector on port 8080 -->
<Connector port="80"
    URIEncoding="UTF-8"
    maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
    enableLookups="false" redirectPort="8443" acceptCount="100"
    debug="0" connectionTimeout="20000"
    disableUploadTimeout="true" />

到这里，基本上Tomcat相关的设定就完成了，因为Roller Blog可以支持上传附件和全文检索等功能，
所以，我们还有一个设定的动作...

在 $CATALINA_HOME\WebApp\roller 中新建下面层次的目录：

 $CATALINA_HOME\WebApp\roller
                         |
                         +---data
                               |
                               +---search-index
                               +---uploads

找到 $CATALINA_HOME\webapps\roller\WEB-INF\classes\roller.properties  ，做如下修改：

# The directory in which Roller will upload files
# uploads.dir=${user.home}/roller_data/uploads
uploads.dir=${TOMCAT_HOME}/webapps/roller/data/uploads

# force Roller to recreate the entire search index)
# search.index.dir=${user.home}/roller_data/search-index
search.index.dir=${TOMCAT_HOME}/webapps/roller/data/search-index

好了，大功告成，启动Tomcat，可以运行Roller了！