liferay portal 中文安装指南
Liferay portal ?安裝指南(初稿)--------溫兵
?
?
?
liferay porta 安裝指南(初稿)
?
?
?
?
?
liferay porta 安裝指南(初稿) ...........................................................................................................1
1 介紹 ..............................................................................................................................................2
1.1 入門....................................................................................................................................2
1.2 推薦配置............................................................................................................................2
2 安裝 ..............................................................................................................................................2
2.1 配置開發環境....................................................................................................................2
2.2 獲得 liferay portal? 源碼....................................................................................................3
2.3 安裝你的 IDE--Eclipse......................................................................................................3
2.4 用 liferay 的源碼做開發 ...................................................................................................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 創建擴展環境....................................................................................................................7
2.5.1? 啟動擴展.................................................................................................................7
2.5.2? 添加插件(主要是編譯專業版) ..............................................................................8
2.5.3? 掛載數據庫.............................................................................................................8
2.5.4 starting Liferay .........................................................................................................8
3 關于翻譯.......................................................................................................................................8
?
?
?
?
?
?
?
?
Liferay portal 安裝指南(初稿)--------溫兵
?
?
1 介紹
?
?
1.1 入門
?
?
牋□ 在這個文檔中,我的目標是幫助大家設置你的額開發環境,使你可以自己在這個軟件上開發出 portlets.這個文檔的起點是你必須具備一些 web 常識以及做 Servlet,jsp 的開發經驗.你們 可能會在不同的操作系統上運行.我的能力有限,但是我會盡量保證這個配置可以適用于不同的 系統
?
?
1.2 推薦配置
?
?
牋 雖然你的配置可能不高,但是作為開發和定制化 Liferay,我們推薦下列硬件配置:
?
1 G 內存
?
2.0 G CPU
?
?
2 安裝
?
?
2.1 配置開發環境
?
?
配置 Liferay 可以完成任何企業級的 JAVA 應用任務.
?
Liferay 控制使用幾個框架. 幸運的是,大部分的框架 Liferay 已經把它捆綁在了一起. 如果你想在 Liferay 上安裝一些其他的工具.首先你要確保你的機器上已經正確安裝 java JDK.你最好在你的機器上安裝最新穩定的 J2SE1.4.2 這個版本.如果你沒有請到 http://java.sun.com 這里去下載最新的版本.假設我下載以后解壓縮放在 D:\Java 這 個目錄中!當然你也可安裝在你喜歡的目錄中,但是從現在開始下文提到的{Java}我們 都指的是這個安裝目錄.雖然你喜歡使用 Sun 的默認 java 編譯器,但是我們推薦你使用 IBM 的 Jikes 編譯器--通常它可以描述更多的編譯錯誤.確定你下載的是 Jikes 的 1.21 的版本,因為 1.22 是在 JDK1.5 下工作運行的,由于不能向后兼容所以 Liferay portal 不能用.最終你還需要從 http://ant.apache.org.下載Ant這個Java基本編譯工具,解 壓縮到上面我們提到的那個目錄(D:\Java).
?
接著設置你的環境變量:在 WIndows 下,打開控制面板/系統/高級/環境變量,新建變 量:JAVA_HOME,ANT_HOME,JIKES_HOME
?
注意要把他們的路徑寫正確.設置 JAVA 的 CLASSPATH 以便其他的應用能在機器上運行.在 PATH 中添上%ANT_HOME%\bin;%JAVA_HOME%\bin;%JIKES_HOME%\bin
?
?
?
?
?
?
Liferay portal ?安裝指南(初稿)--------溫兵
?
?
2.2 獲得 liferay portal 源碼
?
?
現在開始,從 http://www.liferay.com/web/guest/downloads/portal_source
?
下載最新穩定的 Liferay portal 企 業 版 代 碼 . 我 把 它 解 壓 縮 到 這 個 目 錄 D:\cvsroot\liferay (我使用 CVS 來儲存代碼),接下來我們將使用{Liferay}來代表這 個目錄. 當你下載了這個穩定的 Liferay,Then download the latest stable Liferay, 這個指南已經包括了基于 tomcat 的專業版.我將在稍后在這章介紹關于 Tomcat 的捆綁.
?
?
2.3 安裝你的 IDE--Eclipse
?
?
盡管你可能用記事本修改或者部署Liferayportal 一些簡單的事情,但是一個好的 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/JavaBuildPath 點擊右邊Libraries 你需要的 jar 包都已經加載上了.這些 jar 文件是通過{Liferay}\portal 下面 的 .classpath 文件定義加載的.
?
?
?
添加Eclipse的插件是很容易的事情. 自從 Eclipse 集成 Ant 以后,啟動 Ant 是個很容易的事情在 Window 菜單下選擇 ShowView/Ant. 你就可以看到這個 Ant 顯示在你的透視 圖中.
?
增加 Liferay’s 構建文件也是這樣的簡單.簡單到你就選擇透視圖上面的 Ant 然后單 擊 Ant +這個符號. 注意這樣會用 Ant 讀到出現每個目錄中自己的 build.xml 文件. 我 們單擊選擇 portal 這個目錄中的 build.xml 文件. 你的啟動圖形如圖 2.3.
?
?
2.4 用 liferay 的源碼做開發
?
?
在一下部分我們主要介紹怎么使用Orion這個容器對Liferay的源碼做開發和調試.It is important to note that working off the core source is not
?
recommended.如果你想要擴充Liferayportal的功能的話,它是你要增加一個擴充的環 境(在2.5節我們主要講怎么擴展功能).Development of the core portal should only
?
?
?
?
?
?
?
?
?
?
?
Liferay portal ?安裝指南(初稿)--------溫兵
?
?
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.
?
?
2.4.1 獲得 Orion 容器
?
?
首先從 http://www.orionserver.com , 下 載 Orion. 把 這 個 文 件 釋 放 到 (i.e.
{Java}\orion-2.0.6)這個目錄,以下我將使用{orion}來代表上面這個路徑.運行這個 命令來測試你的服務“java –jar orion.jar”.
?
2.4.2 在 Eclipse 中配置 Orion
?
?
在Eclipse中啟動運行Orion需要我們稍微花些時間設置一下.首先在你的透視圖下,右 鍵工程名稱在出來的菜單中選擇 Debug as/Debug,然后會出來一個對話框.
?
?
?
如果你以前在 Java Application 下面已經配置好一些,你可以新建一個或者刪除它.在 前面點擊 New 這個按鈕, 并且改變下列內容:
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.undertheUserEntriesgroup,removethe “portal (default classpath)” entry
2. 單擊 AddExternalJARs,在系統中找到你安裝 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
?
?
Liferay portal 安裝指南(初稿)--------溫兵
?
?
(from the left navigation) --
Installed JREs.
?
?
?
?
2.4.3 啟動 Orion
?
?
配置Orion有三個關鍵的文件. 第一個, {orion}\config\server.xml,
?
let’s you specify which “web-sites” will be accessible when started up. 增 加一個新的
website 并插入這些內容:
?
<web-site path="./web-sites/portal.liferay.com- web.xml" />
?
你還的指定一個Orion的另一個編譯器:
?
<compiler executable="jikes" classpath="{Java}\jre\lib\rt.jar" />
?
現在你已 經詳細指 定了這個 新的 website, 你 需 要創建一 個調用 文件 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增加一個適當的參考. 注意你可以在 Orion 中通 過使用"file:"前綴直接找文件. An advantage
of using this prefix is that you don’t have to deploy your files to the server. 這個可以有助于你快速的調試 JSPs (簡單的保存和更新你的 JSP).另一個原因是它可以 很好的編譯和部署 source 文件成為 class.
?
Note: Whenusingthe“file:”prefixfortheportal-ejb module, you need to ensure that
the? portal-ejb.jar does? not? exist? within your
{orion}\applications\ directory.
?
最后,你必須編輯 {orion}\config\data- sources.xml 是你的應用能訪問到你的數據
庫. 如果你使用的 mysql 請確認 mysql.jar 已經部署到 {orion}\lib\目錄, 配置你
data- sources.xml 文件例似下面:
?
<data-sources>
?
<data-source class="com.evermind.sql.DriverManagerDataSource" name="Liferay"
?
?
?
?
?
Liferay portal 安裝指南(初稿)--------溫兵
?
?
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>
?
?
2.4.4 配置你的 Properties
?
?
Liferay 的配置多數都在 portal.properties 這個文件中. 類似于你的這個文件 build.properties, 你 在????????????????? portal- ext.properties 設 置 它 的 屬 性 都 比 在 portal.properties 它本身根方便.
?
給你的portal配置一個,創建一個新的文件在{Liferay}\portal\util-java\ 這個目錄中文件名為 portal- ext.properties. 在里面添加下列設置:
portal.ctx=/portal
此外,注意在這個 ?portal- ?ext.properties ?設 置這個屬性就不用考慮在
portal.properties?設置.
?
?
2.4.5 配置 Orion
?
?
如果你想要你的 Ant 命令知 道在什 么 地方部 署 它,你需 要 創建一 個 擴展名 類
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 開始啟動.
?
?
?
?
?
?
Liferay portal 安裝指南(初稿)--------溫兵
?
?
2.5 創建擴展環境
?
?
通過擴展環境來開發和部署你的portlets 是你最感興趣的. 這樣可以改良你的 portal 但是不會讓你有任何頭痛的. 任何時間發布一個新的穩定的 Liferay portal 的版本, 是你做的并且是一個震驚的,你可以把它賣掉.同樣可是說你開發一個健壯的擴展環境. 所有新的 classes,JSPs,和所有的新的改變都應該在{Liferay}\ext 里面.
?
?
?
ItisinyourbestinteresttodevelopyourportletsviaanExtensionEnvironment. 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
?
andyou’resettogo.Withthatsaid,yourdevelopmentshouldonlybedonewithinthe
?
Extension Environment as well. Meaning, all new classes, JSPs, and all changes in
general, should be within {Liferay}\ext.
?
?
2.5.1 啟動擴展
?
?
設置啟動你的擴展環境是很簡單的. 在做任何事情之前,你需要改變一個屬性文件 (.properties)在 {Liferay}\portal 目錄中. 注意在這個.properties 默認的文件中 你從未改變這個值. 在每個.properties 文檔的頂部遵循它的注釋替換(改變),需要創 建一個擴展名類似于這個 release.{username}.properties 的文件. 你可以在開始/運 行 下打開一個命令提示這個${username}的值會出現在 DocumentsandSettings 后面. 在你的這個新的.properties 文件中添加正確的一行({Liferay}是真實的目錄:
?
lp.ext.dir={Liferay}/ext
(Note that it’s a forward slash)
?
?
?
接下來, 在 2.3 節中描述的 Ant 顯示中,你能夠擴展 portal build.xml 中的對象 (taegets)列表. 在這些對象(taegets)中,你可以看到 clean, start, build- ext.向 前雙擊那些對象(taegets)一會兒觀察它的輸出. 你將看到一大堆文本的輸出通過指示 說明你的擴張環境在運行.請仔細檢查控制臺輸出的紅色錯誤. 你可能發現你有一些可 怕的錯誤設置在你的屬性中. 如果所有的都很好,那么你應該能到這里瀏覽你你擴展目 錄
?
{Liferay}\ext!
?
?
?
?
Liferay portal ?安裝指南(初稿)--------溫兵
?
?
2.5.2 添加插件(主要是編譯專業版)
?
?
主要是添加一個 Tomcat 編譯環境老啟動 Liferay 的專業版.大家看文檔吧,確實累了
?
2.5.3 掛載數據庫
?
?
對?? 于??? 這??? 樣??? 掛??? 載??? 數??? 據??? 庫??? 請??? 大??? 家??? 參??? 考??? 這 個,http://www.liferay.com/web/guest/documentation/development/databases
?
?
2.5.4 starting Liferay
?
?
現在你有一個完整的開發環境,到前面單擊Tomcat這個圖標來啟動你的web 服務.此時 在你的 portal 已經啟動,你可以在瀏覽器中輸入 http://localhost來查看運行效果!
?
?
3 關于翻譯
?
?
liferay.cn ?蚊子 MSN:wenbin151@hotmail.com歡迎大家關注中文 Liferay .因為本人水平有 限 ( 實際 還沒 有通 過英 語四 級 ), 一些 文字 描述 是根 據我 的理 解寫 的 . 也有 我同事 (flora:flora@hotmail.com)的幫助.我代表中文 Liferay 謝謝我的 partner:flora(MM).呵呵.Good luck!
牋 2005-08-31
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
總結
以上是生活随笔為你收集整理的liferay portal 中文安装指南的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: java timertask 初始化_定
- 下一篇: 奇的哲学观