Liferay Portal二次开发环境搭建
Liferay版本:4.2.2
一、软件平台需求:
1、jdk1.5.0_07-windows-i586-p.exe
2、apache-ant_1.7.1
3、jikes-1.22
4、Eclipse 3.2
5、MyEclipse 5.5
6、Tomcat 基于Eclipse插件 3.2.0
7、liferay-portal-src-4.2.2.zip
8、liferay-portal-tomcat-4.2.2.zip
9、liferay-portal-sql-4.2.2.zip
具体软件,参见软件包。
二、安装过程
说明:为了方便管理,将所需的软件,全部放在C:/Java目录下,具体安装情况可以因个人喜好而定。
1、安装jdk1.5.0_07,运行jdk1.5.0_07-windows-i586-p.exe文件后,对JDK进行安装。安装完JDK后,进行以下配置:
设置JAVA_HOME:
JAVA_HOME= C:/Java/jdk1.5.0_07
设置PATH路径:
%JAVA_HOME%/bin;
2、安装jikes-1.22,安装好Jikes后,安装完JDK后,进行以下配置:
设置JIKES_HOME:
JIKES_HOME=C:/Java/jikes-1.22
设置PATH路径:
%JIKES_HOME%/bin;
3、安装ANT1.7.1,对ANT1.7.1进行解压缩后,放在C:/Java目录下。
设置ANT_HOME:
ANT_HOME=C:/Java/apache-ant_1.7.1
设置PATH路径:
%ANT_HOME%/bin;
说明:设置PATH路径时需果注意顺序,由于Jikes与Ant需果JDK支持所以:
%JAVA_HOME%/bin;%JIKES_HOME%/bin;%ANT_HOME%/bin;
4、安装Eclipse3.2与MyEclipse5.5,由于MyEclipse需要Eclipse3.2支持,所以需要先安装Eclipse3.2。
5、安装MySQL5.0数据库及MySQL管理工具MySQL-Front3.2。
在保证以上软件全部都顺利安装后,才能够对Liferay Portal的二次开发环境进行搭建,这里数据库选择MySQL5.0版本,其他与其类似,请自行测试,Tomcat采用Liferay自带的Tomcat5.5版本。
6、创建Eclipse工作空间,所在位置为:C:/Java/Liferay
7、将liferay-portal-src-4.2.2.zip解压到此目录中,并修改为portal,用Eclipse导入到当前的工作空间中,请检查源代码,保证没有错误。
8、修改Eclipse集成的ANT,将ANT HOME修改为解压后C:/Java/apache-ant_1.7.1目录下。
9、配置扩展开发环境,在portal项目中,添加文件:
release.Administrator.properties,其中“Administrator”为当前系统所在的用户名
在该文件中,添加的内容,主要是用于修改系统的release.properties文件的内容,以满足用户的需要:
文件内容:
lp.ext.dir={Liferay}/ext
用于其中“{Liferay}”指的是Liferay源代码存放的上级目录,当前所在环境里为:lp.ext.dir=C:/Java/Liferay/ext,同时在C:/Java/Liferay目录下创建ext目录。
10、选中portal项目中的build.xml文件后,选择run as -> run ant菜单后,顺序勾选:clean, start, build-ext,最后点击run进行编译,前提,必须保证在编译过程中,不出现任何红色的错误信息,如果提示关于JDK的告警消息提示,可以忽略,例如:
[javac] 注意:C:/Training/Liferay/portal/portal-ejb/src/com/liferay/portal/smtp/SMTPServerUtil.java 使用了未经检查或不安全的操作。
[javac] 注意:要了解详细信息,请使用 -Xlint:unchecked 重新编译。
此步骤容易出现一些莫名其妙的错误,在配置时要小心谨慎,在编译过程中,需要3分钟左右的时间,请耐心等待。
11、检查ext目录下,是否有新的文件生成,在上步操作成功后,会将二次开发的一些扩展程序保存到当前目录中。
12、解压liferay-portal-tomcat-4.2.2.zip文件,将解压后的目录改名为tomcat,同时覆盖C:/Java/Liferay/ext/servers/的tomcat目录,或是将解压后的全部文件及文件夹复制到C:/Java/Liferay/ext/servers/tomcat目录中也可。
13、在C:/Java/Liferay/ext/目录下创建app.server.Administrator.properties文件,用来扩展app.server.properties文件的配置,其中的“Administrator”为当前登录的用户名,可以根据实际的登录名进行设置。
添加内容如下:
lp.ext.dir=C:/Java/Liferay/ext
app.server.type=tomcat
用来指定扩展项目所在的位置及应用运行的服务器类型。
由于指定的服务器类型为tomcat,所以还需要将app.server.properties文件中基于tomcat服务器的相关配置信息添加到app.server.Administrator.properties文件中:
主要是下面这句,将后面的tomcat-5.5.17改为tomcat
app.server.tomcat.dir=${app.server.parent.dir}/tomcat-5.5.17
具体配置:
app.server.tomcat.dir=${app.server.parent.dir}/tomcat
app.server.tomcat.bin.dir=${app.server.tomcat.dir}/bin
app.server.tomcat.classes.global.dir=${app.server.tomcat.dir}/common/classes
app.server.tomcat.classes.portal.dir=${app.server.tomcat.portal.dir}/WEB-INF/classes
app.server.tomcat.deploy.dir=${app.server.tomcat.dir}/webapps
app.server.tomcat.lib.global.dir=${app.server.tomcat.dir}/common/lib/ext
app.server.tomcat.lib.portal.dir=${app.server.tomcat.portal.dir}/WEB-INF/lib
app.server.tomcat.portal.dir=${app.server.tomcat.deploy.dir}/ROOT
app.server.tomcat.log.dir=${app.server.tomcat.dir}/logs
app.server.tomcat.temp.dir=${app.server.tomcat.dir}/temp
app.server.tomcat.work.dir=${app.server.tomcat.dir}/work
app.server.tomcat.zip.name=liferay-portal-tomcat-${downloads.version.file.name}.zip
#app.server.tomcat.zip.name=liferay-portal-tomcat-jdk5-${downloads.version.file.name}.zip app.server.tomcat.zip.url=${sourceforge.mirror}/${app.server.tomcat.zip.name}
14、用Eclipse将ext项目导入到当前的工作空间中,请检查源代码,保证没有错误。
15、添加Tomcat插件,由于在ext中已经添加了基于Liferay的tomcat服务器,建议添加Tomcat插件,用来快速完成对服务器的配置:
将tomcat插件文件中的tomcat目录复制到Eclipse的安装目录下面,进入到
C:/Java/Eclipse/eclipse/links目录下,创建文件tomcat.link连接文件,其中文件主名可以不叫tomcat,但为了保持一致,建议取名tomcat,扩展名必须为link。添加如下内容:
path=C://Java//Eclipse//tomcat
这里为tomcat插件所在的位置。
也可以:path=C:/Java/Eclipse/tomcat
重新启动Eclipse,查看是Tomcat插件是否配置成功,如要在工具栏上面有三只猫,表示配置成功。
16、配置Tomcat插件:
(1)选择:Windows -> Preferences,选择“Tomcat”,选择“Version 5.x”版本。
(2)修改参数“Tomcat Home”为“C:/Java/Liferay/ext/servers/tomcat”,
(3)修改参数“Server.xml”文件的位置:
“C:/Java/Liferay/ext/ext/servers/tomcat/conf/server.xml”。
(4)修改参数“Context files”路径的位置:
“C:/Java/Liferay/ext/servers/tomcat/conf/Catalina/localhost”
以上具体以个人Tomcat所在位置而定。
(5)配置Tomcat执行的JVM虚拟机增加运行参数,启用JAAS支持以及扩大默认内存占用量,也就是展开“Tomcat”标签,选择“JVM Settings”,在“Append to JVM Parameters”选择“Add”:
先添加
-Djava.security.auth.login.config=C:/Java/Liferay/ext/servers/tomcat/conf/jaas.config
再添加
-Xmx512m
(6)配置Tomcat所需的JDK版本,选择Eclipse中配置的已安装的JDK版本。
17、由于Liferay默认带的数据库为HSQL数据库,目前在开发过程中,需要替换为具体的数据库,目前以MySQL为例:
解压liferay-portal-sql-4.2.2.zip文件后,进入create目录后,打开create-mysql.sql文件,选中文件中的SQL脚本通过工具MySQL Front将导入到MySQL数据库,相对应的数据库名为lportal。
18、在数据库导入成功后,将MySQL的驱动mysql-connector-java-3.1.12-bin.jar文件复制到C:/Java/Liferay/ext/servers/tomcat/common/lib/ext这个目录下。
19、修改C:/Java/Liferay/ext/servers/tomcat/conf/Catalina/localhost目录下的 ROOT.xml文件,指定连接到MySQL的驱动类名称、数据库URL及用户和密码,设置如下:
<Resource
name="jdbc/LiferayPool"
auth="Container"
type="javax.sql.DataSource"
driverClassName="com.mysql.jdbc.Driver"
url="jdbc:mysql://localhost/lportal?useUnicode=true&characterEncoding=UTF-8"
username="root"
password="root"
maxActive="20"
/>
具体设置与MySQL数据库连接的用户名及密码相同。
20、修改控制台的中文乱码
进入到C:/Java/Liferay/ext/servers/tomcat/conf中的logging.properties 文件,在最后添加一行:
java.util.logging.ConsoleHandler.encoding=GBK
即可。
21、进入Eclipse中导入的ext项目,选中build.xml文件后,点击deploy即可部署到Tomcat服务器上,检查在部署过程中,不出现错误。
22、通过添加的Tomcat插件,启动Tomcat服务器,会在控控台报出一些错误,不用管它,可以直接通过进入到C:/Java/Liferay/ext/servers/tomcat/bin目录下,
运行startup.bat文件即可。
23、当Tomcat服务器启动后,打开浏览器,在地址栏输入http://localhost:8080即可出现liferay界面。到此,Liferay的二次开发环境已经搭建完成。
说明:如果朋友在开发过程中出现一些问题,别着急,慢慢来,一定会搞定的,我也是在开发过程中走了很多弯路,最后,总结出一些心得,希望与大家分享。
刘羽
2010-6-13