在系統(tǒng)環(huán)境變量里面新建JAVA_HOME、JIKES_HOME、ANT_HOME,在PATH環(huán)境變量里面添加%JAVA_HOME%\bin;%JIKES_HOME%\bin;%ANT_HOME%\bin。這里的ANT_HOME和PATH也可以不用設(shè)置,使用eclipse中自帶的就好,這里就順便設(shè)置下。另:這里使用的是JDK1.4,若要使用1.5則需使用官網(wǎng)提供的tomcat的JDK1.5綁定版。
二、Eclipse環(huán)境下的portal工程加載
Liferay的源代碼實(shí)際上是一個(gè)Eclipse工程文件(該項(xiàng)目名稱叫portal)。在Eclipse工作目錄(我的目錄為D:\liferay_4.2,此后記為${WORKSPACE})下建立portal目錄,然后把下載下來(lái)的源代碼liferay-portal-src-4.2.2.zip解壓縮portal目錄下。
選擇File->New->Project->Java Project,輸入項(xiàng)目名稱為“portal”,保持默認(rèn)的“create new project in workspace”,選擇“Finish”結(jié)束。
如果上一步成功,那么已經(jīng)可以在左側(cè)欄看到源代碼的目錄結(jié)構(gòu)了;并且右鍵點(diǎn)擊項(xiàng)目的根目錄,選“Properties”,選“Java Build Path”的“Libraries”標(biāo)簽,應(yīng)該能夠看到所有需要的jar格式庫(kù)文件在里面了。
加載了portal項(xiàng)目之后的Eclipse的Package Explorer欄。
選擇Windows ?show?View?Ant在出現(xiàn)的Ant視圖中單擊Add build files,在彈出對(duì)話框中選擇portal項(xiàng)目中根目錄下build.xml文件。
三、基于Tomcat的擴(kuò)展開(kāi)發(fā)環(huán)境建立
修改portal下release.properties文件:
- lp.source.dir=D:/liferay_4.2/portal
- lp.ext.dir=D:/liferay_4.2/ext
- lp.eclipse.dir=D:/liferay_4.2/eclipse
- lp.eclipse.project.name=ext
編輯在${WORKSPACE}/portal\tools\ext_tmpl\ext-ejb\classes下的portal-ext.properties文件,修改#portal.release=enterprise為portal.release=professional。
然后在最后加入下面的語(yǔ)句:
- hibernate.dialect=org.hibernate.dialect.DB2Dialect
- custom.sql.function.isnull=CAST(? AS VARCHAR(32672)) IS NULL
- custom.sql.function.isnotnull=CAST(? AS VARCHAR(32672)) IS NOT NULL
liferay使用了hibernate做持久化,而liferay 4.3以前的所有版本在對(duì)DB2的支持上都有問(wèn)題,所以這里需要手動(dòng)配置hibernate.dialect和null的問(wèn)題,否則無(wú)法啟動(dòng)或啟動(dòng)后出現(xiàn)莫名其妙的問(wèn)題。
回到Eclipse中的Ant視圖中,雙擊展開(kāi)根節(jié)點(diǎn)Portal,雙擊打開(kāi)根目錄下的build.xml,應(yīng)該可以在Outline看到很多Ant任務(wù)。
Outline下的ANT任務(wù):
順序執(zhí)行 clean, start, build-ext 。屏幕下方的命令行窗口會(huì)跳躍相關(guān)文字提示信息,如果一切正確,那么其中不應(yīng)該有紅色的錯(cuò)誤信息(絕大多數(shù)此處可能出現(xiàn)的錯(cuò)誤都是配置文件不正確所引起的)。特別注意的是,如果你已經(jīng)正確設(shè)置了JIKES_HOME和PATH卻仍然提示“需要JIKES”,則把你的PATH設(shè)置為絕對(duì)路徑如:C:\jikes\bin(我曾被這個(gè)問(wèn)題郁悶了N久!^0^!)。一切正常的話,那么${WORKSPACE}\ext 目錄下應(yīng)該生成了很多東西了。
解壓縮下載的liferay-portal-tomcat-4.2.2.zip(可運(yùn)行的Liferay)到安裝目錄,以后假定此解壓縮目錄為${TOMCAT_HOME}。在${WORKSPACE}/ext目錄下創(chuàng)建。
app.server.${username}.properties配置文件,在其中添加如下內(nèi)容:
- lp.ext.dir=${WORKSPACE}/ext
- app.server.type=tomcat
- app.server.tomcat.dir=${TOMCAT_HOME}
仿照建立portal項(xiàng)目,選擇File->New->Project->Java Project,輸入項(xiàng)目名稱為“ext”,保持默認(rèn)的“create new project in workspace”,選擇“Finish”結(jié)束。
如果上一步成功,那么已經(jīng)可以在左側(cè)欄看到ext項(xiàng)目的目錄結(jié)構(gòu)了;并且右鍵點(diǎn)擊項(xiàng)目的根目錄,選“Properties”,選“Java Build Path”的“Libraries”標(biāo)簽,應(yīng)該能夠看到所有需要的jar格式庫(kù)文件在里面了。
安裝Tomcat插件支持(這里不在詳述)。
然后,在ant中點(diǎn)擊deploy,即可完成部署。
四、配置DB2數(shù)據(jù)庫(kù)支持
創(chuàng)建liferay數(shù)據(jù)庫(kù)lportal:
將${WORKSPACE}\sql下的build.xml加入ant試圖,啟動(dòng)rebuild-db2即可(當(dāng)然,你應(yīng)該先裝好DB2)。
修改 ${TOMCAT_HOME}\conf\Catalina\localhost下的ROOT.xml文件:
xml 代碼
- <Context path="">
- <Resource
- name="jdbc/LiferayPool"
- auth="Container"
- type="javax.sql.DataSource"
- driverClassName="COM.ibm.db2.jdbc.app.DB2Driver"
- url="jdbc:db2:lportal"
- username=""
- password=""
- maxActive="100"
- maxIdle="30"
- maxWait="10000"
- />
- <Resource
- name="mail/MailSession"
- auth="Container"
- type="javax.mail.Session"
- mail.imap.host="localhost"
- mail.pop3.host="localhost"
- mail.smtp.host="localhost"
- mail.store.protocol="imap"
- mail.transport.protocol="smtp"
- />
- <Realm
- className="org.apache.catalina.realm.JAASRealm"
- appName="PortalRealm"
- userClassNames="com.liferay.portal.security.jaas.PortalPrincipal"
- roleClassNames="com.liferay.portal.security.jaas.PortalRole"
- debug="99"
- useContextClassLoader="false"
- />
- Context>
然后將db2java.jar拷貝到 ${TOMCAT_HOME}\common\lib\ext下面即可。
至此,擴(kuò)展開(kāi)發(fā)環(huán)境搭建完成!
PS:
附件是本文的word文檔,插入了一些圖片可供參考。