在Tomcat 6.0.33上安裝Liferay 6.1.0 CE的步驟

1、準備工做

下載tomcat 6.0.33, liferay 6.1.0 CE的war文件包、源碼包、SQL腳本包以及附加依賴包。本例子採用Mysql數據庫做爲存儲引擎，故請安裝Mysql數據庫並確保mysql服務已經啓動。因爲在使用liferay的過程當中，可能須要發送郵件（好比用戶註冊時發送驗證郵件），所以須要一臺郵件服務器。爲了簡單起見，本例子在本機上安裝了一個windows郵件服務器——hmailserver（關於hmailserver的安裝與配置，請參考相關文檔）.

2、安裝與配置

1） 在D盤上創建一個liferay.home目錄

cd d:
mkdir java
mkdir liferay-6.1-ce

D:\java\liferay-6.1-ce 就是咱們的liferay.home目錄，咱們用變量LIFERAY_HOME來表示。

2) 將tomcat-6.0.33壓縮包解壓到%LIFERAY_HOME%目錄下，並將解壓後的tomcat目錄名改成tomcat-6.0.33。咱們用變量TOMCAT_HOME表示%LIFERAY_HOME%\tomcat-6.0.33

3) 咱們用變量TOMCAT_WEBAPPS表示%TOMCAT_HOME%\webapps\ROOT。 先清空%TOMCAT_WEBAPPS%目錄下的全部內容，而後將liferay 6.1.0 CE的war文件包解壓到%TOMCAT_WEBAPPS%

4) 在%TOMCAT_HOME%\lib目錄下創建ext目錄，將liferay 6.1.0 CE的附加依賴包解壓到該目錄裏

5）解壓liferay 6.1.0 CE源碼包至某個目錄，假設爲d:\src\liferay-portal-src-6.1.0-ce-ga1, 咱們用變量LIFERAY_SRC_6_1來表示這個目錄。將%LIFERAY_SRC_6_1%\lib\development目錄的如下文件：

• activation.jar
• jms.jar
• jta.jar
• jutf7.jar
• mail.jar
• persistence.jar
• mysql.jar  （mysql 數據庫驅動庫）

拷貝到%TOMCAT_HOME%\lib\ext目錄裏. 另外，將%LIFERAY_SRC_6_1%\lib\development目錄下的文件:

• resin.jar
• script-10.jar

拷貝到%TOMCAT_HOME%\temp\liferay\com\liferay\portal\deploy\dependencies目錄裏 .

注意：若是你使用tomcat 7， 請將%LIFERAY_SRC_6_1%\lib\portal\ccpp.jar拷貝到%TOMCAT_HOME%\lib\ext目錄裏。
 

6) 在%TOMCAT_HOME%\conf\Catalina\localhost目錄下，建立包含以下內容的ROOT.xml文件

<Context path="/" crossContext="true" > 
    <!-- JAAS -->  
    <!--<Realm className="org.apache.catalina.realm.JAASRealm" appName="PortalRealm" userClassNames="com.liferay.portal.kernel.security.jaas.PortalPrincipal" roleClassNames="com.liferay.portal.kernel.security.jaas.PortalRole" /> -->  

    <!-- Uncomment the following to disable persistent sessions across reboots. --> 
    <!--<Manager pathname="" />-->  

    <!-- Uncomment the following to not use sessions. See the property "session.disabled" in portal.properties. -->
    <!--<Manager className="com.liferay.support.tomcat.session.SessionLessManagerBase" />--> 

</Context>

7) 將liferay 6.1 cesql壓縮包解壓至某個臨時目錄，好比d:\sql\liferay-portal-sql-6.1.0-ce-ga1， 咱們用變量LIFERAY_SQL_6_1表示這個目錄。執行%LIFERAY_SQL_6_1%\create目錄下的create-mysql.sql腳本，該腳本會建立一個名爲lportal的數據庫，並創建表和索引，而後載入一些基礎數據和測試數據

8) 在%LIFERAY_HOME%目錄下建立portal-ext.properties文件。該文件用於配置liferay運行參數，好比數據庫鏈接配置，郵件服務器配置，servlet過濾器配置，加載javascript和css的配置等。實際上，portal-ext.properties的配置項會覆蓋%TOMCAT_HOME\webapps\ROOT\WEB-INF\lib\portal-impl.jar壓縮包中的portal.properties的配置項, 這種作法能夠在不改變原配置文件的同時，提供可靈活定製的方法。

9）接下來咱們須要在portal-ext.properties中配置數據庫鏈接和郵件服務器

•  配置數據庫鏈接

若是使用liferay內置的c3p0數據庫鏈接池，請直接在portal-ext.properties添加以下的配置:

#  MySQL # 
jdbc.default.driverClassName=com.mysql.jdbc.Driver
jdbc.default.url=jdbc:mysql://localhost/lportal?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false
jdbc.default.username=root
jdbc.default.password=1234

若是使用tomcat提供的鏈接池，則須要先在%TOMCAT_HOME%\conf\Catalina\localhost\ROOT.xml的Context節點下添加這段JNDI數據源配置：

<Resource name="jdbc/LiferayPool" auth="Container" type="javax.sql.DataSource" 
          driverClassName="com.mysql.jdbc.Driver" 
          url="jdbc:mysql://localhost/lportal?useUnicode=true&amp;characterEncoding=UTF-8"
          username="root" password="root" maxActive="100" maxIdle="30" maxWait="10000" />

而後在portal-ext.properties引用該JNDI資源：

jdbc.default.jndi.name=jdbc/LiferayPool

• 配置郵件服務器
  
  若是使用liferay內置的mail session,則直接在portal-ext.properties添加以下配置：

# mail session # 
mail.session.mail.pop3.host=localhost.com
mail.session.mail.pop3.password=
mail.session.mail.pop3.port=110
mail.session.mail.pop3.user=
mail.session.mail.smtp.auth=false
mail.session.mail.smtp.host=localhost.com
mail.session.mail.smtp.password=
mail.session.mail.smtp.port=25
mail.session.mail.smtp.user=
mail.session.mail.store.protocol=pop3
mail.session.mail.transport.protocol=smtp

注意：本例子在C:\Windows\System32\drivers\etc\hosts文件中將域名localhost.com,liferay.com映射到127.0.0.1

若是使用tomcat提供的mail session，則須要先在%TOMCAT_HOME%\conf\Catalina\localhost\ROOT.xml的Context節點下添加這段JNDI數據源配置：

<Resource name="mail/MailSession" auth="Container" type="javax.mail.Session" 
          mail.pop3.host="pop.gmail.com" mail.pop3.port="110" mail.smtp.host="smtp.gmail.com"
          mail.smtp.port="465" mail.smtp.user="user" mail.smtp.password="password"
          mail.smtp.auth="true" mail.smtp.starttls.enable="true" 
          mail.smtp.socketFactory.class="javax.net.ssl.SSLSocketFactory"
          mail.imap.host="imap.gmail.com" mail.imap.port="993" mail.transport.protocol="smtp"
          mail.store.protocol="imap" />

 而後在portal-ext.properties引用該JNDI資源：

mail.session.jndi.name=mail/MailSession

10) 修改tomcat的類加載路徑. 打開%TOMCAT_HOME%\conf\catalina.properties, 將common.loader屬性值改成： 

common.loader=\
${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib, \
${catalina.home}/lib/*.jar,${catalina.home}/lib/ext,${catalina.home}/lib/ext/*.jar

11）修改tomcat啓動參數。 建立或打開%TOMCAT_HOME%\bin\setenv.bat, 添加以下的JVM啓動參數：

SET "JAVA_OPTS=-Dfile.encoding=GBK -Dorg.apache.catalina.loader.WebappClassLoader.ENABLE_CLEAR_REFERENCES=false
      -Duser.timezone=GMT+8 -Xms512m -Xmx1024m -XX:MaxPermSize=256m %JAVA_OPTS%"

注意：

• 在中文Windows操做系統下默認的字符編碼是GBK，所以file.encoding選項要設置爲GBK，不然tomcat控制檯打印出來的日誌會出現中文亂碼
• user.timezone選項用於指定JVM在建立時間戳時所參照的時區，默認是當前操做系統所設置的時區. 這裏咱們設置GMT+8，即北京時區
  
  

12) 禁用liferay安裝嚮導。默認狀況下，第一次啓動liferay時會啓動安裝嚮導，該向導會爲咱們配置數據庫鏈接和建立數據庫，並在%LIFERAY_HOME%目錄下生成一個 portal-setup-wizard.properties配置文件。這個文件的配置項會覆蓋portal-ext.properties中的相同配置項(portal-ext.properties又會覆蓋portal.properties的相同配置項）。因爲咱們是手動安裝liferay，所以須要禁止liferay啓動安裝嚮導。方法是在portal-ext.properties添加一項配置：

setup.wizard.enabled=false

13)　最後在%LIFERAY_HOME%下創建一個初始化環境腳本command.bat:

set "CATALINA_HOME=%~dp0%tomcat-6.0.33"
set "PATH=%CATALINA_HOME%\bin:%PATH%"
start

3、啓動Liferay

    至此，咱們已經完成liferay的安裝與部署。接下來咱們嘗試啓動tomcat，讓liferay跑起來。雙擊%LIFERAY_HOME%\command.bat ，打開命令行窗口。先腳本已正確初始化CATALINA_HOME環境變量。在控制檯輸入echo %CATALINA_HOME%,若是控制檯回顯D:\java\liferay-6.1-ce\tomcat-6.0.33，則表示該環境變量已正確設置。而後輸入catalina run 啓動tomcat，觀察控制檯輸出的日誌，若是一切正常，啓動結束後會自動打開默認瀏覽器訪問http://localhost:8080