Liferay学习笔记（一）Liferay Portal5.2.3环境的初步搭建

Liferay Portal5.2.3 环境的初步搭建 一、 准备工作 1、 开发包 目前 Liferay 官网 http://www.liferay.com/zh/home 上只提供最新版本的 liferay 包下载，下载 5.2.3 版本需要到开源社区 http://sourceforge.net/projects/lportal/files/Liferay%20Portal/

Liferay Portal5.2.3环境的初步搭建

一、  准备工作

1、     开发包

目前Liferay官网http://www.liferay.com/zh/home上只提供最新版本的liferay包下载，下载5.2.3版本需要到开源社区http://sourceforge.net/projects/lportal/files/Liferay%20Portal/，选择5.2.3版本下载下面两个包：

Portal源码包：liferay-portal-src-5.2.3.zip

Tomcat捆绑包：liferay-portal-tomcat-6.0-5.2.3.zip

2、     开发工具

开发工具       建议版本         本文使用版本

JDK          1.6以上             1.6.0_22

Ant           1.7以上             1.8.2

MyEclipse     5.5以上             7.5

Tomcat        6.0以上             6.0.18

注意：这里的Tomcat是liferay-portal-tomcat捆绑包中的tomcat，所以不需要再另外下载；Ant到http://ant.apache.org/bindownload.cgi下载最新的apache-ant-1.8.2.bin.zip

3、     目录结构

本文假设操作目录结构如下：

D:/workspace                      根目录

D:/workspace/ant                  ant的安装目录

D:/workspace/Liferay              liferay工作目录

D:/workspace/Liferay/portal       liferay-portal源代码目录

D:/workspace/Liferay/service      liferay-portal捆绑Tomcat的目录

D:/workspace/Liferay/ext          liferay-portal的扩展项目目录

二、  基础配置

1、JDK的安装配置

JDK的安装配置和以前一样，这里不再赘述，提醒一下安装配置完成别忘了使用“java -version”和“javac”来检查是否安装成功

2、Ant的安装配置

   解压缩apache-ant-1.8.2.bin.zip到D:/workspace/ant目录下，在环境变量（Windows7下右键点击“计算机”后选择“高级系统设置—>高级—>环境变量”）中为Path系统变量新增如下路径：“D:/workspace/ant/apache-ant-1.8.2/bin;”，保存。

打开dos，输入“ant -version”检查配置是否正确

3、Tomcat的安装配置

解压缩liferay-portal-tomcat-6.0-5.2.3.zip到D:/workspace/Liferay/service目录下，在环境变量的Path系统变量中新增如下路径：“D:/workspace/Liferay/service/tomcat-6.0.18/bin;”，保存。

运行tomcat的startup.bat，服务器正常启动说明安装成功

4、MyEclipse的安装配置

这里只说一下MyEclipse中Tomcat服务器的配置。

将MyEclipse中Tomcat配置为第3步中安装的Tomcat，将Tomcat下的JDK配置为第1步中安装的JDK，并为JDK配置虚拟机参数如下：

-Xmx1024m -XX:MaxPermSize=256m -Dfile.encoding=UTF8 -Duser.timezone=GMT -Djava.security.auth.login.config="%CATALINA_HOME%/conf/jaas.config" -Dorg.apache.catalina.loader.WebappClassLoader.ENABLE_CLEAR_REFERENCES=false

提示：打开tomcat的bin目录下的setenv.bat文件，找到名为JAVA_OPTS的变量，其参数值即为需要copy的虚拟机参数。这个步骤非常重要，否则会导致内存溢出。

三、  建立开发环境

方法一：

1、  部署Liferay源码

将liferay-portal-src-5.2.3.zip解压缩到D:/workspace/Liferay/portal目录下

 

2、  新建配置文件release.${username}.properties

找到portal源码中的release.properties文件，在同目录下新建release.${username}.properties文件。${username}为本机的用户名，可以在dos下使用set命令查看username的值。我的机器username值为Administrator，故新建release.Administrator.properties文件，文件内容只有一行：

lp.ext.dir=D:/workspace/Liferay/ext

注：lp.ext.dir为Liferay指定扩展项目的目录，注意路径中必须使用“/”而不是“/”。

3、  生成扩展目录

运行dos，进入D:/workspace/Liferay/portal目录下，输入“ant clean start build-ext”命令执行，等待ant执行完成（需要3到10分钟）后，在Liferay的ext目录下会出现下列文件：

 

4、  新建配置文件app.server.${username}.properties

在ext目录下新建app.server.Administrator.properties文件，添加如下内容：

app.server.type=tomcat

app.server.tomcat.dir=D:/workspace/Liferay/service/tomcat-6.0.18

注：app.server.type为Liferay指定服务器类型，app.server.tomcat.dir为Liferay指定Tomcat服务器的安装目录。

5、  执行配置

打开dos，进入D:/workspace/Liferay/ext目录下，输入“ant clean deploy”命令执行，等待ant执行完成。

6、  开发环境建立完毕。

 

方法二：

1、  同方法一的步骤1

2、  同方法一的步骤2

3、  在与release.properties文件同目录下新建app.server.Administrator.properties文件，内容和方法一的步骤4文件内容一样。

4、  找到与release.properties文件同目录下的build.xml文件，找到下图中的节点：

 

并在该节点下新增子节点fileset，内容如下：

"." includes="app.server.Administrator.properties"/>

5、同方法一的步骤3，不同的是执行完后生成的ext目录下多了一个名为app.server.Administrator.properties的文件

6、同方法一的步骤5

7、  开发环境建立完毕。

四、  测试开发环境

运行startup.bat启动tomcat服务器，一段时间后会弹出一个登录网页，默认用户名为：test@liferay.com；密码：test；登录即进入Liferay Portal账户，可以对Portlet进行定制。

注：如果修改了后台数据库文件里的用户信息，则需要换一个Admin身份的用户进行登录，具体用户信息请查阅数据库。这里谢谢一楼nwpubin的提醒^_^

五、  环境搭建完成。