最近研究Roller，一直手癢，想搞個(gè)Java 的博客玩玩，網(wǎng)上查了下，Roller像是比較出名，所以就選擇他了。
     可惜網(wǎng)上中文的文檔不多，官方e文的文檔也不多，連API也沒(méi)有提供，所以，我覺(jué)得，先把他的三個(gè)文檔翻譯下，一來(lái)方便我學(xué)習(xí)，二來(lái)，給同時(shí)給感興趣的又不敢冒e文同志的一些方便（聲明下，我像是也不怎么感冒e文，所以敢同身受）。
   廢話少說(shuō)，先貼點(diǎn)出來(lái)，接下來(lái)連載啦。
                  ------------------------------------------------------------
                                                                   Roller  安裝指南

目錄
1 概述
  1.1 版權(quán)和商標(biāo)信息
  1.2 反饋
  1.3 文檔說(shuō)明
 1.4 更改和補(bǔ)充
2 5分鐘安裝
3 準(zhǔn)備滾動(dòng)了嗎？
 3.1 Tomcat：Javamail 和 Activation（發(fā)郵件的java API ）
 3.2 Tomcat：URI編碼國(guó)際化支持（I118N）
4 下載和解壓Roller
 4.1 安裝目錄說(shuō)明
 4.2 Roller博客打包（WAR包）
5 準(zhǔn)備Roller所需數(shù)據(jù)庫(kù)
 5.1 創(chuàng)建Roller數(shù)據(jù)庫(kù)
 5.2 檢驗(yàn)JDBC數(shù)據(jù)庫(kù)驅(qū)動(dòng)設(shè)置
 5.3 MySQL和Oracle的注意事項(xiàng)
6 配置Roller
 6.1 以MySQL為例子
7 部署Roller
  7.1 把 roller-custom.properties 放到 classpath的路徑下
 7.2 通過(guò)控制臺(tái)部署Roller
8 開(kāi)始使用Roller
  8.1 引導(dǎo)完成Roller的安裝
  8.2 注冊(cè)一個(gè)用戶及創(chuàng)建一個(gè)博客
9 配置技巧和小竅門(mén)
   9.1  設(shè)置 Roller的Planet聚合器
   9.2  修改security.xml里的關(guān)鍵字
   9.3  使用服務(wù)器提供的數(shù)據(jù)庫(kù)和郵件資源
   9.4  手動(dòng)創(chuàng)建及其升級(jí)表的操作
10 升級(jí)Roller
   10.1 從Roller 2.x升級(jí)到Roller 4.0
  10.2 備份Roller老版本
  10.3 安裝設(shè)置Roller新版本
11 roller.properties

 

1 概述
      這份文檔是講如何安裝 Apache Roller 博客軟件的。將會(huì)告訴你首先該裝什么，如何下載Roller，如何設(shè)置Roller，以及如何將Roller安裝到現(xiàn)有的java應(yīng)用服務(wù)器及其關(guān)聯(lián)數(shù)據(jù)庫(kù)上。同樣也提供了更具有親和的5分鐘安裝說(shuō)明。
1.1 版權(quán)和商標(biāo)信息
這份文檔遵循Apache Software License的條款（嘻嘻，開(kāi)源啦～）。
在這個(gè)文件里的所有的商標(biāo)屬于法定所有者（估計(jì)就是Roller的開(kāi)發(fā)者或組織）。
1.2 反饋（聯(lián)系方式）
  如有對(duì)這個(gè)文檔有任何意見(jiàn)或建議，請(qǐng)直接發(fā)送到： user@roller.apache.org。
1.3 文檔說(shuō)明
 這份文檔的初始版本是由Dave Johnson撰寫(xiě)的，當(dāng)前版本是由Apache 組織下的Apache Roller 項(xiàng)目組維護(hù)。
 這份文檔的格式是基于OpenOffice.org項(xiàng)目下的OpenDS項(xiàng)目文檔模板。
1.4 更改和補(bǔ)充

日期	變更描述
2007七月	重寫(xiě)了Roller4.0簡(jiǎn)單安裝步驟

2  5分鐘安裝
如果你知道將要怎么做，你只需要快速的預(yù)覽獲取的Roller安裝包以及恰當(dāng)支持的平臺(tái)（如，Tomcat和MySQL），或許你就可以通過(guò)本寫(xiě)簡(jiǎn)單的5分鐘安裝步驟完成安裝。如果你沒(méi)有信心完成，可以跳到第三部分。下面就開(kāi)始介紹如何在5分鐘內(nèi)安裝Roller：
 第一步：下載Roller（Zip或GNU Tar）壓縮包，解壓到你本機(jī)的硬盤(pán)上。
 第二步：創(chuàng)建一個(gè)放置Roller數(shù)據(jù)表的數(shù)據(jù)庫(kù)。
 例如，在MySQL上你或許會(huì)這么做：

 第三步: 創(chuàng)建一個(gè)roller-custom.properties配置文件，放在Servlet 容器的Classpath下，例如，Tomcat上就放在common/classes.如下配置你的數(shù)據(jù)庫(kù)以及郵件服務(wù)器替換文件里的粗體部分。
 

 1installation.type=auto
 2database.configurationType=jdbc
 3database.jdbc.driverClass=com.mysql.jdbc.Driver
 4database.jdbc.connectionURL=jdbc:mysql://localhost:3306/rollerdb
 5database.jdbc.username=scott
 6database.jdbc.password=tiger
 7mail.configurationType=properties
 8mail.hostname=smtp-server.example.com
 9mail.username=scott
10mail.password=tiger

第四步：校驗(yàn)?zāi)鉺ervlet容器下的JDBC和javamail的設(shè)置。確保你的數(shù)據(jù)庫(kù)的JDBC驅(qū)動(dòng)在你的Servlet容器的classpath路徑下，例如Tomcat的驅(qū)動(dòng)放置的路徑為common/lib。如果你還需要發(fā)送郵件的話，還要把Javamail和Activation.jar（mail.jar和activation.jar）放到該路徑下。
第五步：使用Servlet 容器管理控制臺(tái)部署Roller目錄到Servlet 容器上。Roller應(yīng)用就會(huì)安裝到webapp/roller目錄下第六步：瀏覽打開(kāi)Roller（或許是http：//localhost:8080/roller）。如果Roller運(yùn)行正常，那么就繼續(xù)第八部分，開(kāi)始使用Roller。如果Roller沒(méi)法運(yùn)行而且你無(wú)法形容為什么這樣，那就試著采用正常安裝步驟從以下第三部分開(kāi)始。


3 準(zhǔn)備滾了嗎？
首先，我們來(lái)確認(rèn)你用來(lái)安裝和運(yùn)行Roller要做的每一件事。
Roller是一個(gè)需要數(shù)據(jù)庫(kù)驅(qū)動(dòng)的java 網(wǎng)絡(luò)應(yīng)用。所以你要運(yùn)行該應(yīng)用，需要Java，Java Servlet 容器像Tomcat和 一個(gè)數(shù)據(jù)庫(kù)像MySQL。特別明確下，安裝和運(yùn)行Roller所要具備的條件：
 . Java開(kāi)發(fā)工具集（JDK），需要Sun Java2 SE 1.5 JDK。在你的計(jì)算機(jī)上安裝Roller就要配置Java SE 5。Roller 3.x是最后一個(gè)支持Java1.4.2的版本。
 . 一個(gè)Java 應(yīng)用服務(wù)，特別指出要支持Servlet2.4API的Servlet 容器。在下面，都稱其為服務(wù)（server）。Roller社區(qū)往往就對(duì)Tomcat 5.5，Tomcat 6.0，Sun Web Server 7.0以及Glassfish2.0的使用中的問(wèn)題作答。
.一個(gè)關(guān)聯(lián)數(shù)據(jù)庫(kù) 例如，MySQL或Apache Derby。Roller社區(qū)傾向于使用和回答問(wèn)題關(guān)于MySQL and Apache Derby,但是Roller也可以使用其他數(shù)據(jù)庫(kù)。Roller創(chuàng)建了針對(duì)DB2，Derby,HSQL-DB,Microsoft SQL Server,MySQL，Oracle 和PostgreSQL這些數(shù)據(jù)庫(kù)的腳本。
如果你正在使用Tomcat的話，下面部分將驗(yàn)證Tomcat所需具備的事項(xiàng)，否則，你可以直接看第四部分：下載解壓Roller。
3.1 Tomcat:JavaMail and Activation
Tomcat沒(méi)有包含Roller所需電郵公告（發(fā)送）的java Mail 和 Activation 的jar包，所以，如果你要使用Roller的電郵公告的功能，你就需要下載那些jar包放到Tomcat的Classpath下。需要從Sun的站點(diǎn)下載（http://java.sun.com/products/javamail）然后放到Tomcat的common/lib 目錄下。
3.2 Tomcat：URI 編碼國(guó)際化（I118N）
Roller 支持國(guó)際化（I18N），但是Tomcat需要另外的一些設(shè)置。你必須確保Tomcat的URI編碼是設(shè)置為UTF-8.因此你要修改Tomcat配置文件conf/server.xml在每一個(gè)連接元素加URIEncoding="UTF-8",就像下面這樣：
<Connector port="8080"
  maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
  enableLookups="false" redirectPort="8443" debug="0"
  acceptCount="100" connectionTimeout="20000"
  disableUploadTimeout="true"
  URIEncoding="UTF-8" />
確保Roller所要用到的連接加以修改。例如，你使用AJP連接或HTTPS 連接，同樣也要加URIEncoding="UTF-8"的屬性。

4 下載解壓Roller

從http://roller.apache.org下載Apache Roller 版本文件.如果你是Windows用戶就下載.zip文件，用你所喜愛(ài)的解壓工具解壓這個(gè)文件。Unix用戶就下載.tar.gz文件，使用GNU tar 來(lái)解壓。
4.1 安裝目錄展示
一旦你解壓這個(gè)文件，你將發(fā)現(xiàn)如下結(jié)構(gòu)的目錄

 

LICENCE.txt 和 NOTICE.txt包含了Apache Software Liscense以及其他一些同版本關(guān)聯(lián)的法律條文。README.txt指出了這篇文檔所在的doc目錄。
4.2 Roller博客網(wǎng)絡(luò)應(yīng)用程序
Roller博客程序在webapp/roller目錄下，采用了標(biāo)準(zhǔn)的Java EE WAR 的目錄結(jié)構(gòu)。一般來(lái)說(shuō)，你不需要修改者里面的任何文件。你可以部署這個(gè)在目錄表單里，或者部署一個(gè)文件，那就要打包成.war文件。
例如，這里是打包成WAR文件的方法：

5 準(zhǔn)備Roller所需的數(shù)據(jù)庫(kù)
在你安裝Roller之前，先要為Roller所需的數(shù)據(jù)庫(kù)做一些準(zhǔn)備工作。
你在一些地方存放Roller的數(shù)據(jù)表，有的人稱之為數(shù)據(jù)表空間，但是我們情愿稱其為數(shù)據(jù)庫(kù)。
你需要?jiǎng)?chuàng)建一個(gè)數(shù)據(jù)庫(kù)，或讓數(shù)據(jù)庫(kù)管理員來(lái)為你創(chuàng)建。然后你需要為你的數(shù)據(jù)庫(kù)選擇一個(gè)JDBC驅(qū)動(dòng)來(lái)安裝。
如果你正在將Roller安裝到Glassfish并JavaDB/Derby數(shù)據(jù)庫(kù)的話，你就可以跳過(guò)這一部分了；Derby不需要?jiǎng)?chuàng)建數(shù)據(jù)庫(kù)，并且Glassfish也包含了Derby的JDBC驅(qū)動(dòng)。
5.1 創(chuàng)建一個(gè)Roller所需的數(shù)據(jù)庫(kù)
  如果你有幸有自己的數(shù)據(jù)庫(kù)管理員，就請(qǐng)他們安裝一個(gè)數(shù)據(jù)庫(kù)，當(dāng)他們做完后，問(wèn)他們要如下的信息，你之后會(huì)用到：
  . 用來(lái)連接數(shù)據(jù)庫(kù)的用戶名和密碼
  . 連接數(shù)據(jù)庫(kù)的 JDBC的地址（URL）
  . JDBC的類(lèi)名
如果你沒(méi)有數(shù)據(jù)庫(kù)管理員，那你就只能參照文檔準(zhǔn)備數(shù)據(jù)庫(kù)。你需要?jiǎng)?chuàng)建一個(gè)Roller所需的數(shù)據(jù)庫(kù)，并使用用戶名和密碼來(lái)保護(hù)。例如，你正在使用的數(shù)據(jù)庫(kù)是MySQL，請(qǐng)如下操作：

5.2 檢查JDBC驅(qū)動(dòng)設(shè)置
確保在服務(wù)器上安裝的是正確的JDBC驅(qū)動(dòng)。通常，基本上都是JDBC驅(qū)動(dòng)的jar包，然后放在服務(wù)器的CLasspath的路徑下。例如，在Tomcat5.5上是common/lib,在Tomcat6.0上是在lib，在Glassfish的domain的lib目錄下。
5.3 MySQL和Oracle考慮事項(xiàng)
基于我們支持MySQL的經(jīng)驗(yàn)，我們?nèi)缦碌慕ㄗh：
 .  對(duì)于MySQL，確保TCP/IP網(wǎng)絡(luò)是可用的。
 .  對(duì)于MySQL4.1.x 使用J/Connector3.0.xJDBC驅(qū)動(dòng)替代更加新的3.1.x系列。
 .  對(duì)于MySQL5.x 使用J/Connector3.1.xJDBC驅(qū)動(dòng)替代更加新的3.1.x系列。
 .  確保MySQL的 UTF-8支持可用。詳情見(jiàn)如下的頁(yè)面：
 http://rollerweblogger.org/wiki/Wiki.jsp?page=SetupUTF8onMySQL
 .對(duì)于Oracle的用戶，請(qǐng)使用ojdbc14.jar的10g（10.1.0.2更高）驅(qū)動(dòng)，即使是在對(duì)Oracle9服務(wù)器操作。

先貼到這里，明天繼續(xù)。
 

 

 

6  設(shè)置Reller

可能讓你設(shè)置Roller的文件只有一個(gè)：

roller-custom.properties

那是一個(gè)簡(jiǎn)單的Java屬性配置文件，

一個(gè)重寫(xiě)了Roller內(nèi)部默認(rèn)設(shè)置(roller.properties)文件。用來(lái)設(shè)置你所看到的Roller內(nèi)部配置文件，決定哪些屬性你需要重寫(xiě)，可以在roller-custom.properties文件里設(shè)置那些屬性。

你可以找到完整的Roller 內(nèi)部配置文件（roller.properties）在第11部分，也建議你可以看一下，但是在這里我們舉個(gè)簡(jiǎn)單的例子只要你知道如何配置數(shù)據(jù)庫(kù)讓Roller運(yùn)行。

創(chuàng)建一個(gè)名為roller-custom.properties內(nèi)容如下的的文本文件，但是從、需要替換斜體部分的文字用來(lái)設(shè)置你的數(shù)據(jù)庫(kù)和郵件服務(wù)器。

installation.type=auto是告訴Roller是自動(dòng)安裝模式。在這個(gè)模式下，提供非常詳細(xì)的錯(cuò)誤詳情來(lái)幫助你調(diào)試數(shù)據(jù)庫(kù)連接的問(wèn)題。如果Roller發(fā)現(xiàn)數(shù)據(jù)庫(kù)存在但是表不存在，則會(huì)運(yùn)行數(shù)據(jù)庫(kù)創(chuàng)建腳本，如果發(fā)現(xiàn)表存在，但是不是當(dāng)前版本的Roller則會(huì)提供表的升級(jí)。一旦Roller安裝成功，并且需要在線使用，則你應(yīng)該設(shè)置installation.type=manual。

6.1 MySQL例子

這里的roller-custom.properties示范了MySQL連接。顯示了MySQL JDBC

驅(qū)動(dòng)類(lèi)名，MySQL連接URL，以及用來(lái)連接郵件服務(wù)器的用戶名、密碼

 

接下來(lái)，我們來(lái)部署Roller。

 

7 部署Roller

現(xiàn)在你已經(jīng)有了Roller War和Roller配置文件roller-custom.properties，你可以準(zhǔn)備部署Roller到服務(wù)器上了。首先，部署你的配置文件。

7.1 把roller-custom.properties放到Classpath下
Roller能夠找到你的配置文件通過(guò)不同的方法，詳情你可以看第11部分。

最簡(jiǎn)單的事，你要做的是把文件在你的應(yīng)用服務(wù)器的classpath下，就是放到Classes的目錄下。啟動(dòng)時(shí)，Roller將找到配置文件。這里對(duì)一些熱門(mén)的服務(wù)器的路徑地址。

 在Tomcat5.5，拷貝到common/classes目錄下。

 在Tomcat6.0，拷貝到lib目錄下。

 在Glassfish，拷貝到你的domain的lib/classes目錄下。

現(xiàn)在你可以準(zhǔn)備部署Roller了。

7.2 通過(guò)管理控制臺(tái)部署Roller

使用服務(wù)器管理控制臺(tái)來(lái)部署Roller網(wǎng)絡(luò)應(yīng)用。

你可以部署一個(gè)目錄，在這種情況下，配置你的安裝路徑webapp/Roller。或者你可以部署一個(gè)WAR文件，在這個(gè)情況下你得先創(chuàng)建一個(gè)WAR文件（第4.2部分有交代）。

我們來(lái)看看如何在Tomacat6.0和Glassfishv2.0部署的。

部署到Apache Tomcat 6.0上

你可以在Tomcat上部署

WAR文件或者是目錄。下面這個(gè)截屏展示了基于目錄的部署項(xiàng)。

         

 

一旦Roller被部署，你將看到其他應(yīng)用的列表里列出。那個(gè)/roller是用來(lái)鏈接到Roller的，還有啟動(dòng)，停止，重載，卸載部署的選項(xiàng)。

 

 

如果Roller沒(méi)法啟動(dòng)，請(qǐng)查看問(wèn)題日志。能在Tomcat的log目錄下找到。

Tomcat的日志文件在catalina.out，Roller的日志文件在roller.log下。

  

部署到Glassfish v2.0上

同樣你也可以部署一個(gè)WAR文件或者一個(gè)目錄到Glassfish上。下面的截屏展示基礎(chǔ)目錄部署項(xiàng)。



 

一旦Roller被不是上，你將看到Roller也被列在應(yīng)用列表里。在映射連接到Roller上，有的按鈕可用，有的則不展示，或置灰。

如果Roller沒(méi)有啟動(dòng)，可以在日志里查看問(wèn)題。你能在Glassfish的domain的logs目錄下找到。Glassfish日志是server.log，Roller日志是在roller.log.


 

8 開(kāi)始使用Roller

在你完成了安裝步驟后，現(xiàn)在你可以準(zhǔn)備開(kāi)始使用Roller了，所以我們將帶你進(jìn)入Roller，注冊(cè)一個(gè)用戶和創(chuàng)建一個(gè)博客。我們也會(huì)針對(duì)發(fā)生錯(cuò)誤，就是什么問(wèn)題。

8.1 瀏覽Roller，完成安裝

瀏覽Roller，如果你使用的是Tomcat或Glassfish安裝的，那么Roller也許在http://localhost:8080/roller。你或許會(huì)看到一個(gè)有錯(cuò)誤信息的頁(yè)面，一個(gè)提供創(chuàng)建數(shù)據(jù)庫(kù)表的網(wǎng)頁(yè)或一個(gè)提示你完成注冊(cè)一個(gè)管理員用戶及創(chuàng)建首頁(yè)博客的網(wǎng)頁(yè)。首先，我們來(lái)看看當(dāng)發(fā)生錯(cuò)誤的時(shí)候，就近出了什么問(wèn)題。

如果是你數(shù)據(jù)庫(kù)設(shè)置問(wèn)題，Roller將會(huì)展示一個(gè)錯(cuò)誤信息頁(yè)面來(lái)幫助你診斷這個(gè)問(wèn)題。或許是連錯(cuò)了的JDCB驅(qū)動(dòng)類(lèi)名，URL鏈接，用戶名，密碼。亦或許你的數(shù)據(jù)庫(kù)沒(méi)有啟動(dòng)起來(lái)。利用所提供的資料，以確定哪些是錯(cuò)的，修理，然后重新部署Roller。


 

自動(dòng)創(chuàng)建表

如果你的數(shù)據(jù)庫(kù)沒(méi)有問(wèn)題，但是Roller沒(méi)能找到數(shù)據(jù)表，那么Roller將會(huì)提供自動(dòng)創(chuàng)建的頁(yè)面。如果你

如果使用這個(gè)頁(yè)面，Roller將會(huì)運(yùn)行創(chuàng)建數(shù)據(jù)庫(kù)表的腳本及可以看到創(chuàng)建結(jié)果。然后你可以進(jìn)行下一步設(shè)置你的第一個(gè)用戶帳戶和博客。

 

8.2 注冊(cè)一個(gè)用戶，創(chuàng)建一個(gè)博客

如果Roller啟動(dòng)好了，但是沒(méi)有找到博客的首頁(yè)，那么下面將展示如何注冊(cè)你第一個(gè)用戶，創(chuàng)建你第一個(gè)博客，設(shè)置你的站點(diǎn)的首頁(yè)。

你必須要決定什么作為你Roller站點(diǎn)的首頁(yè)。如果你使用Roller來(lái)運(yùn)行你的個(gè)人博客，那么你就要你的博客作為站點(diǎn)的首頁(yè)。這樣的話，只要?jiǎng)?chuàng)建的你自己的博客，不要選擇首頁(yè)主題但是要設(shè)置你的博客作為站點(diǎn)的首頁(yè)博客。




 

如果你用來(lái)創(chuàng)建一個(gè)社區(qū)性的多用戶博客，那么你可以在首頁(yè)展示全部博客的匯總，這樣的話，創(chuàng)建一個(gè)博客用來(lái)服務(wù)于首頁(yè)的博客，并設(shè)置為首頁(yè)博客，一定要設(shè)置“匯總首頁(yè)”做為服務(wù)管理頁(yè)。

不要忘了：重置installation.type標(biāo)志
現(xiàn)在你已經(jīng)完成安裝，你應(yīng)該關(guān)閉roller自動(dòng)安裝系統(tǒng)了。編輯roller-custom.properties文件，設(shè)置installation.type=manual。
然后重啟你的服務(wù)器，Roller就接受了新的設(shè)置。
接下來(lái)做什么？
一旦你啟用了Roller，Roller用戶指南有關(guān)于更多運(yùn)行Roller系統(tǒng)和博客的信息。通過(guò)Roller模板指南信息，來(lái)定制你的博客。如果你通過(guò)文檔無(wú)法找到你需要的關(guān)于Roller使用的描述，那么你在郵件列表里提問(wèn)：地址是：http://cwiki.apache.org/confluence/display/ROLLER/Roller+Mailing+Lists



未完待續(xù)