[Liferay6.2]Liferay社区版开发环境基础配置

安装环境

操作系统：Windows 7 旗舰版 x64

jdk：jdk1.6.0_45

数据库：mysql-community-5.6.24.0（新建lportal_t数据库，作为liferay开发环境数据库）

Liferay准备

2015年4月17日，Liferay发布了最新的Liferay CE 6.2 Ga4版本，该社区版软件下载地址是http://sourceforge.net/projects/lportal/files/。

核心包是配置开发环境必须下载的，可选包则是非必须的。

核心包

集成开发环境eclipse：liferay-ide-eclipse-windows-x64-2.2.3-ga4-201505281145.zip

插件开发工具包：liferay-plugins-sdk-6.2-ce-ga4-20150416163831865.zip

Tomcat捆绑应用包：liferay-portal-tomcat-6.2-ce-ga4-20150416163831865.zip

可选包

liferay文档包：liferay-portal-doc-6.2-ce-ga4-20150416163831865.zip

liferay源代码包：liferay-portal-src-6.2-ce-ga4-20150416163831865.zip

解压核心包

将三个核心包同时解压到D:\liferay6.2cega4目录下，分别得到以下文件夹:

集成开发环境eclipse：eclipse

插件开发工具包：liferay-plugins-sdk-6.2

Tomcat捆绑应用包：liferay-portal-6.2-ce-ga4

配置集成开发环境

1、运行eclipse\eclipse.exe启动集成开发环境，将默认工作空间workspace设置为D:\liferay6.2cega4\workspace，点击OK按钮，进入eclipse。

2、打开Windows-Preferences配置窗口，选择Liferay菜单进入Liferay配置界面。

 

在右侧的liferay shotcuts快捷方式中，我们可以快速完成配置liferay sdk、创建liferay运行时环境、创建liferay 服务器等liferay配置。

3、配置liferay插件开发工具包，点击“Configure installed Liferay Plugin SDKs”快捷方式，在打开的窗口中点击“Add”按钮，在弹出的窗口中，选择之前解压好的目录D:\liferay6.2cega4\liferay-plugins-sdk-6.2，其他默认，然后点击OK即可。

4、点击“Create a new server runtime environment”快捷方式，打开“新建服务器运行时环境”配置窗口，由于我们之前下载Tomcat捆绑应用包是v6.2，因此选择“Liferay v6.2 CE（Tomcat 7）”，同时勾选“Create a new local server”复选框，同时创建一个新的本地服务器（可以省掉单独再点击“Create a new liferay server”快捷方式的步骤）。

然后点击Next按钮进入下一步，在“Liferay Tomcat Rumtime”窗口中，点击“Browse...”按钮，选择D:\liferay6.2cega4\liferay-portal-6.2-ce-ga4作为Liferay Tomcat directory。

到这一步，就可以点击“Finish”按钮结束Liferay Tomcat的配置了。再点击“Next”按钮就是一些Liferay Tomcat 捆绑的配置了，例如javadoc、source配置就可以关联到到我们对应下载的文档包和源码包，Tomcat bundle就可以用到Tomcat捆绑应用包。

完成以上配置之后，关闭Windows-Preferences配置窗口，我们会在eclipse中的“Servers”选项卡中看到新建好的Liferay本地服务器。

5、双击“Servers”选项卡中的Liferay本地服务器，可以打开配置页面，在Liferay settings中将user timezone用户时区改为中国所在时区GMT+8，解决开发环境时间比中国时间少8个小时的问题。 

启动开发运行环境

完成以上配置之后，我们可以选择Liferay v6.2 CE Server，然后点击start按钮，启动开发运行环境。

基本配置

启动完成之后，会自动在电脑的默认浏览器中打开http:\\localhost:8080基本配置页面，默认是英文页面，可以在Default Language中选择“中文（中国）”，点击“Change”按钮应用改变，将配置界面变成中文界面。

基本配置页面主要分为Portal、管理员用户、数据库三部分配置。

Portal可以配置Portal名称，默认语言，以及添加示例数据；

管理员用户可以配置管理员的名字、姓以及必须的电子邮件；

数据库配置中，默认数据库是Hypersonic（Hypersonic SQL是纯Java开发的关系型数据库,可以通过jdbc driver来存取。支持ANSI-92 标准 SQL语法。而且他占的空间很小。大约只有160K,拥有快速的数据库引擎），但是该数据仅能满足开发和演示目的，官方并不推荐将这一数据库作为生产环境使用。

然后在实际开发中，由于该数据库比较小众，也不便于通过客户端查看数据，我还是建议在开发环境中更换成常用的数据库，例如本文中mysql，。

点击“（更改）”链接，打开数据库配置界面，依次选择数据库类型、输入JDBC URL、JDBC驱动类名称、用户名及密码，完成数据库的配置。

点击“完成配置”按钮，会显示“正在安装Liferay。这需要几分钟的时间”的提示信息。

正常完成安装之后，会跳转到以下提示页面，告诉我们配置保存成功，以及配置文件portal-setup-wizard.properties的保存路径。

访问我的Portal

点击“访问我的Portal”，会默认以管理员即[email protected]账户（默认密码为test）跳转到管理员的“用户条款”页面。

由于liferay汉化不彻底，该条款内容全是英文的，不用关心内容，直接拉到页面最下面，点击“我同意”按钮，进入“密码提示”界面。

输入“密码提示”信息之后，点击“保存”按钮之后，会进入LiferayPortal的首页。

到了这一步，liferay的开发环境就算是完全搭建成功了。

 

liferay运行环境目录

配置完成后的liferay运行环境目录如下图所示，比起配置前增加了deploy、logs两个文件夹和portal-ide.properties、portal-setup-wizard.properties两个配置文件。

 

data：数据文件夹，存放了document_library文档库、hsql、jackrabbit、lucene、opensocial、osgi等数据

deploy：部署文件夹，liferay的部署包war文件，需要放在deploy文件夹中，由liferay自动部署到tomcat-7.0.42中

license：许可证文件夹，保存了liferay版权和版本信息

logs：日志文件夹，记录了liferay运行过程中产生的各种日志

tomcat-7.0.42：tomcat文件夹，liferay的web服务器tomcat

portal-ide.properties：liferay 集成开发环境eclipse的配置文件

portal-setup-wizard.properties：liferay 安装向导配置文件

readme.html：全英文liferay的帮助说明文档

portal-ide.properties说明

portal-ide.properties文件中默认生成的配置信息如下：

#Tue Apr 21 01:09:16 CST 2015
json.service.auth.token.enabled=false
auto.deploy.tomcat.conf.dir=D\:\\liferay6.2cega4\\liferay-portal-6.2-ce-ga4\\tomcat-7.0.42\\conf\\Catalina\\localhost
jsonws.web.service.public.methods=*
com.liferay.portal.servlet.filters.etag.ETagFilter=false
com.liferay.portal.servlet.filters.header.HeaderFilter=false
auto.deploy.interval=1000

 

说明：

json.service.auth.token.enabled:是否启用json服务认证，false为禁用，true为启用
auto.deploy.tomcat.conf.dir:自动部署tomcat的配置信息目录
jsonws.web.service.public.methods:json web service公共方法，默认为*
com.liferay.portal.servlet.filters.etag.ETagFilter:ETagFilter过滤器，false为禁用，true为启用
com.liferay.portal.servlet.filters.header.HeaderFilter:request头信息过滤器，false为禁用，true为启用
auto.deploy.interval:自动部署的扫描间隔频率，单位是毫秒

portal-setup-wizard.properties说明

portal-ide.properties文件中默认生成的配置信息如下：

admin.email.from.address=test@liferay.com
admin.email.from.name=Test Test
jdbc.default.driverClassName=com.mysql.jdbc.Driver
jdbc.default.password=root
jdbc.default.url=jdbc:mysql://localhost/lportal_t?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false
jdbc.default.username=root
liferay.home=D:/liferay6.2cega4/liferay-portal-6.2-ce-ga4
setup.wizard.enabled=false

 说明：

admin.email.from.address：管理员电子邮件
admin.email.from.name：管理员姓名
jdbc.default.driverClassName：数据库JDBC的驱动类名称
jdbc.default.password：数据库密码
jdbc.default.url：数据库JDBC的URL地址
jdbc.default.username：数据库用户名
liferay.home：liferay主目录
setup.wizard.enabled：是否启用安装向导，就是输入http:\\localhost:8080是否打开基本配置页面，false代表不启用，如果想重新配置liferay，则可以将此项改为true重新启动liferay进入基本配置页面。