liferay porta安裝指南(初稿).............................................................................................. 1
1 介紹............................................................................................................................. 2
1.1 入門................................................................................................................... 2
1.2 推薦配置............................................................................................................ 2
2 安裝............................................................................................................................. 2
2.1 配置開發(fā)環(huán)境..................................................................................................... 2
2.2 獲得liferay portal 源碼........................................................................................ 3
2.3 安裝你的IDE--Eclipse......................................................................................... 3
2.4 用liferay的源碼做開發(fā)........................................................................................ 3
2.4.1 獲得Orion容器......................................................................................... 4
2.4.2 在Eclipse中配置Orion.............................................................................. 4
2.4.3 啟動Orion................................................................................................. 5
2.4.4 配置你的Properties.................................................................................... 6
2.4.5 配置Orion................................................................................................. 6
2.5 創(chuàng)建擴展環(huán)境..................................................................................................... 7
2.5.1 啟動擴展................................................................................................... 7
2.5.2 添加插件(主要是編譯專業(yè)版).................................................................... 8
2.5.3 掛載數(shù)據(jù)庫............................................................................................... 8
2.5.4 starting Liferay............................................................................................ 8
3 關于翻譯...................................................................................................................... 8
1
牋 在這個文檔中,我的目標是幫助大家設置你的額開發(fā)環(huán)境,使你可以自己在這個軟件上開發(fā)出portlets.這個文檔的起點是你必須具備一些web常識以及做Servlet,jsp的開發(fā)經(jīng)驗.你們可能會在不同的操作系統(tǒng)上運行.我的能力有限,但是我會盡量保證這個配置可以適用于不同的系統(tǒng)
牋 雖然你的配置可能不高,但是作為開發(fā)和定制化Liferay,我們推薦下列硬件配置:
1 G內(nèi)存
2.0 G CPU
配置Liferay可以完成任何企業(yè)級的JAVA應用任務.
Liferay控制使用幾個框架. 幸運的是,大部分的框架Liferay已經(jīng)把它捆綁在了一起. 如果你想在Liferay上安裝一些其他的工具.首先你要確保你的機器上已經(jīng)正確安裝java JDK.你最好在你的機器上安裝最新穩(wěn)定的J2SE1.4.2這個版本.如果你沒有請到http://java.sun.com這里去下載最新的版本.假設我下載以后解壓縮放在D:\Java 這個目錄中!當然你也可安裝在你喜歡的目錄中,但是從現(xiàn)在開始下文提到的{Java}我們都指的是這個安裝目錄.雖然你喜歡使用Sun的默認java編譯器,但是我們推薦你使用IBM的Jikes編譯器--通常它可以描述更多的編譯錯誤.確定你下載的是Jikes的1.21的版本,因為1.22是在JDK1.5下工作運行的,由于不能向后兼容所以Liferay portal不能用.最終你還需要從http://ant.apache.org.下載Ant這個Java基本編譯工具,解壓縮到上面我們提到的那個目錄(D:\Java).
接著設置你的環(huán)境變量:在WIndows下,打開控制面板/系統(tǒng)/高級/環(huán)境變量,新建變量:JAVA_HOME,ANT_HOME,JIKES_HOME
注意要把他們的路徑寫正確.設置JAVA的CLASSPATH以便其他的應用能在機器上運行.在PATH中添上%ANT_HOME%\bin;%JAVA_HOME%\bin;%JIKES_HOME%\bin
源碼
現(xiàn)在開始,從 http://www.liferay.com/web/guest/downloads/portal_source
下載最新穩(wěn)定的Liferay portal企業(yè)版代碼. 我把它解壓縮到這個目錄 D:\cvsroot\liferay (我使用CVS來儲存代碼),接下來我們將使用{Liferay}來代表這個目錄. 當你下載了這個穩(wěn)定的Liferay,Then download the latest stable Liferay,這個指南已經(jīng)包括了基于tomcat的專業(yè)版.我將在稍后在這章介紹關于Tomcat的捆綁.
盡管你可能用記事本修改或者部署Liferay portal 一些簡單的事情,但是一個好的IDE工具可以加速提升你的工作.我向你展示 Eclipse這個工具,它可以很方便的部署和運行Liferay portal.下載最新的Eclipse版本
http://www.eclipse.org/downloads/index.php. 安裝 Eclipse 到 {Java}\eclipse 且運行它.在菜單上 選擇File/ Switch Workspace…然后選擇 {Liferay}這個目錄.
在workspace中啟動你的工程, 選擇 File /New/Project. 在對話框中選擇Java Project 然后點擊Next.在這個新的窗口中輸入portal作為Project Name然后點擊Finish.
如果你恰當設置Workspace, 你應該可以在導航中看到portal這個工程的透視圖. 在這個工程的根目錄上單擊鼠標右鍵選擇Properties/Java Build Path 點擊右邊Libraries你需要的jar包都已經(jīng)加載上了.這些jar文件是通過{Liferay}\portal 下面的 .classpath 文件定義加載的.
添加Eclipse的插件是很容易的事情. 自從 Eclipse集成Ant以后,啟動Ant是個很容易的事情在Window菜單下選擇Show View/Ant. 你就可以看到這個Ant顯示在你的透視圖中.
增加 Liferay’s 構建文件也是這樣的簡單.簡單到你就選擇透視圖上面的Ant然后單擊Ant +這個符號. 注意這樣會用Ant讀到出現(xiàn)每個目錄中自己的build.xml文件. 我們單擊選擇portal這個目錄中的build.xml文件. 你的啟動圖形如圖 2.3.
的源碼做開發(fā)
在一下部分我們主要介紹怎么使用Orion這個容器對Liferay的源碼做開發(fā)和調(diào)試. It is important to note that working off the core source is not
recommended.如果你想要擴充Liferay portal的功能的話,它是你要增加一個擴充的環(huán)境(在2.5節(jié)我們主要講怎么擴展功能).Development of the core portal should only be done for bug fixes or
enhancements that potentially would make it into the next build. Typical developers will
not need to read this section.
容器
首先從 http://www.orionserver.com , 下載Orion. 把這個文件釋放到(i.e. {Java}\orion-2.0.6)這個目錄,以下我將使用{orion}來代表上面這個路徑.運行這個命令來測試你的服務“java –jar orion.jar”.
中配置Orion
在Eclipse中啟動運行Orion需要我們稍微花些時間設置一下.首先在你的透視圖下,右鍵工程名稱在出來的菜單中選擇Debug as/Debug,然后會出來一個對話框.
如果你以前在 Java Application下面已經(jīng)配置好一些,你可以新建一個或者刪除它.在前面點擊New這個按鈕, 并且改變下列內(nèi)容:
Main Tab頁:
1. 改變name配置為 “orion”
2. 設置 Main class 為 “com.evermind.server.ApplicationServer”
Arguments Tab頁:
1. Program arguments: -config {orion}/config/server.xml - userThreads (note that
you need to change the directory path)
2. VM arguments: -Xmx256m - Dfile.encoding=UTF8 - Duser.timezone=GMT
Classpath Tab頁:
1. under the User Entries group, remove the “portal (default classpath)” entry
2. 單擊 Add External JARs,在系統(tǒng)中找到你安裝orion的目錄中的orion.jar 添加它
注意: make sure that within your JRE Tab, your Project JRE points to a SDK as
opposed to just a JRE (i.e. my Project JRE has j2sdk1.4.2_05 next to it in parenthesis.
This may require you to add another entry within Java (from the left navigation) --
Installed JREs.
配置Orion有三個關鍵的文件. 第一個, {orion}\config\server.xml,
let’s you specify which “web-sites” will be accessible when started up. 增加一個新的
website 并插入這些內(nèi)容:
<web-site path="./web-sites/portal.liferay.com- web.xml" />
注意這里,在Liferay網(wǎng)上下載得那個config里面是這樣設置得<web-site path="./web-sites/default-web.xml" />
你還的指定一個Orion的另一個編譯器:
<compiler executable="jikes" classpath="{Java}\jre\lib\rt.jar" />
現(xiàn)在你已經(jīng)詳細指定了這個新的website,你需要創(chuàng)建一個調(diào)用文件portal.liferay.com-web.xml 在這個目錄中{orion}\config\web-sites\. 你可以看到類型于(Figure x.2. portal.liferay.com-web.xml)的圖.
最后, 在{orion}\config\application.xml, 你需要增加兩個模塊web- module 和ejb-module.所有web-app的元素聲明在你的 portal.liferay.comweb.xml但是這些聲明也必須定義在你的 application.xml:見圖(Figure x.3. application.xml)
通過插入ejb-module元素給你的EJBs增加一個適當?shù)膮⒖? 注意你可以在Orion中通過使用"file:"前綴直接找文件. An advantage
of using this prefix is that you don’t have to deploy your files to the server. 這個可以有助于你快速的調(diào)試JSPs (簡單的保存和更新你的JSP).另一個原因是它可以很好的編譯和部署source文件成為class.
Note: When using the “file:” prefix for the portal-ejb module, you need to ensure that
the portal-ejb.jar does not exist within your {orion}\applications\ directory.
最后,你必須編輯 {orion}\config\data- sources.xml 是你的應用能訪問到你的數(shù)據(jù)庫. 如果你使用的mysql請確認mysql.jar已經(jīng)部署到 {orion}\lib\目錄, 配置你data- sources.xml 文件例似下面:
<data-sources>
<data-source
class="com.evermind.sql.DriverManagerDataSource"
name="Liferay"
location="jdbc/LiferayCore"
pooled-location="jdbc/LiferayPool"
xa-location="jdbc/xa/LiferayXA"
ejb-location="jdbc/LiferayEJB"
connection-driver="com.mysql.jdbc.Driver"
url="jdbc:mysql://localhost/lportal"
username="root"
password=""
inactivity-timeout="30"
schema="database-schemas/mysql.xml"
/>
</data-sources>
Liferay的配置多數(shù)都在 portal.properties 這個文件中. 類似于你的這個文件 build.properties,你在portal- ext.properties設置它的屬性都比在portal.properties它本身根方便.
給你的portal配置一個,創(chuàng)建一個新的文件在{Liferay}\portal\util-java\ 這個目錄中文件名為portal- ext.properties. 在里面添加下列設置:
portal.ctx=/portal
此外,注意在這個portal- ext.properties設置這個屬性就不用考慮在portal.properties設置.
如果你想要你的Ant命令知道在什么地方部署它,你需要創(chuàng)建一個擴展名類app.server.{username}.properties. 在這個文件中添加一行 app.server={orion}
這個 {orion} 就是我們安裝Orion的目錄, 例如這樣 (i.e. app.server=D:/Java/orion- 2.0.5). 最后用你Eclipse的Ant 顯示, 運行你portal目錄中的start和delpoy 標記. 如果你使用"file"前綴,不要忘記去刪出portal-ejb.jar 以后部署!
你全部設置了! 在你的Debug透視圖中到前面單擊bug 這個圖標,這時在你的控制臺就會看到Orion開始啟動.
通過擴展環(huán)境來開發(fā)和部署你的portlets 是你最感興趣的. 這樣可以改良你的portal但是不會讓你有任何頭痛的. 任何時間發(fā)布一個新的穩(wěn)定的Liferay portal 的版本,是你做的并且是一個震驚的,你可以把它賣掉.同樣可是說你開發(fā)一個健壯的擴展環(huán)境. 所有新的classes,JSPs,和所有的新的改變都應該在{Liferay}\ext里面.
It is in your best interest to develop your portlets via an Extension Environment. This
would allow you to upgrade your portal without any headaches. Any time a new stable
version of Liferay Portal is released, all you would need to do is drop in the new jars
and you’re set to go. With that said, your development should only be done within the
Extension Environment as well. Meaning, all new classes, JSPs, and all changes in
general, should be within {Liferay}\ext.
設置啟動你的擴展環(huán)境是很簡單的. 在做任何事情之前,你需要改變一個屬性文件(.properties)在 {Liferay}\portal目錄中. 注意在這個.properties 默認的文件中你從未改變這個值. 在每個.properties文檔的頂部遵循它的注釋替換(改變),需要創(chuàng)建一個擴展名類似于這個release.{username}.properties的文件. 你可以在開始/運行 下打開一個命令提示這個${username}的值會出現(xiàn)在Documents and Settings 后面.在你的這個新的.properties文件中添加正確的一行({Liferay}是真實的目錄:
lp.ext.dir={Liferay}/ext
(Note that it’s a forward slash)
接下來, 在2.3節(jié)中描述的Ant顯示中,你能夠擴展portal build.xml中的對象(taegets)列表. 在這些對象(taegets)中,你可以看到 clean, start, build- ext.向前雙擊那些對象(taegets)一會兒觀察它的輸出. 你將看到一大堆文本的輸出通過指示說明你的擴張環(huán)境在運行.請仔細檢查控制臺輸出的紅色錯誤. 你可能發(fā)現(xiàn)你有一些可怕的錯誤設置在你的屬性中. 如果所有的都很好,那么你應該能到這里瀏覽你你擴展目錄
{Liferay}\ext!
主要是編譯專業(yè)版)
主要是添加一個Tomcat編譯環(huán)境老啟動Liferay的專業(yè)版.大家看文檔吧,確實累了
對于這樣掛載數(shù)據(jù)庫請大家參考這個,http://www.liferay.com/web/guest/documentation/development/databases
現(xiàn)在你有一個完整的開發(fā)環(huán)境,到前面單擊Tomcat這個圖標來啟動你的web 服務.此時在你的portal已經(jīng)啟動,你可以在瀏覽器中輸入 http://localhost 來查看運行效果!
liferay.cn 蚊子 MSN:wenbin151@hotmail.com 歡迎大家關注中文Liferay .因為本人水平有限(實際還沒有通過英語四級),一些文字描述是根據(jù)我的理解寫的.也有我同事(flora:flora@hotmail.com)的幫助.我代表中文Liferay謝謝我的partner:flora(MM).呵呵.Good luck!
