搭建Liferay开发环境

搭建开发环境（初学liferay必看）

本文内容是用来说明Liferay Portal 是什么，并且帮助Java开发者在Windows 操作系统上搭建，运行，并尽快转换为生产力。本文是高水平的并且不打算来回答比较深入的问题。然而，本文将会详细说明如何部署指定文件完成必要的安装任务。

• 所需文件

下载下面列出的所有文件为安装部署做准备。这些文件都是搭建Liferay开发环境必需的。其中一些工具，你可以选择其他的替代。例如你可以选择IntelliJ IDE来代替Eclipse，但是为了简单起见，建议你安装下面的工具

JDK 5
Download the JDK here:
http://java.sun.com/javase/downloads/index_jdk5.jsp

Ant 1.7
Download Ant 1.7 here:
[url]http://apache.eu.lucid.dk/ant/binaries/apache-ant-1.7.0-bin.zip [/url]

Jikes 1.22
Download Jikes 1.22 here:
[url]http://downloads.sourceforge.net/jikes/jikes-1.22-1.windows.zip?modtime=1096862035&big_mirror=0 [/url]

Liferay Portal Source 4.3.2

Eclipse 3.3
Download Eclipse 3.3 here:
[url]http://www.eclipse.org/downloads/ [/url]

• 安装工具

JDK 5
当你定位安装路径时，修改默认安装路径为：

C:\Java\jdk1.5.0_13\ 

[img]http://fantasyyong840205.iteye.com/upload/picture/pic/8002/701a1179-f707-3045-b2c7-4434fcae04cc.jpg [/img]

同样修改JRE安装路径:

C:\Java\jre1.5.0_13\

• 设置JAVA_HOME.

设置系统变量JAVA_HOME to "C:\Java\jdk1.5.0_13\"
[img]http://fantasyyong840205.iteye.com/upload/picture/pic/8004/dcb856f1-50d6-31ad-b2c9-f120a4b9a488.png [/img]

• 设置path变量

修改PATH路径。系统变量PATH路径的开头增加下面内容：

%JAVA_HOME%\bin; 

[img]http://fantasyyong840205.iteye.com/upload/picture/pic/8006/c79e2637-2d41-37b6-a3d8-46f7bf9f4ca8.png [/img]

同样步骤设置Ant 1.7和Jikes 1.22路径：

ANT_HOME：C:\Java\apache-ant-1.7.0

增加PATH路径：%ANT_HOME%\bin; 

JIKES_HOME：C:\Java\jikes-1.22

增加PATH路径：%JIKES_HOME%\bin; 

检查Windows确认Java虚拟机版本：


同样，通过ant -version和jikes -version命令可以查看ant 和 jikes 版本。

解压源文件到：D:\portal-4.3.2\portal

• 建立ext工程（扩展环境）

开发者为了把自己开发的客户化代码和Liferay 源代码分离开。Liferay 推荐开发者在EXT 环境下开发，因为Liferay 修复bugs升级最新版本，这样方便了和新版本的Liferay 同步。 本质上，EXT 环境是建立在Liferay 源代码之上的一层结构。在EXT环境中，源代码封装在JAR 文件中。当你在EXT环境中执行build 时，你会创建更多的JAR 文件。

为了方便进行自己的修改和定制开发，同时又能与Liferay的更新保持兼容，我们使用单独的目录来放置自己的修改，这样在Liferay发布新版本时，可以直接升级Liferay部署，而不会与我们的修改相冲突。这里使用D:\portal-4.3.2\ext目录来放置所有的扩展（包括JSP、class文件及依赖库等）。

下面我们用之前解压的Liferay源文件来创建EXT 环境。

在myeclipse下，切换到resource视图模式，展开portal工程目录，我们可看到一个release.properties文件，实际上我们要建一个它的扩展配置文件，文件名为

release.${username}.properties

${username}是计算机当前用户名，比如administrator,apple等等.在计算机开始菜单运行cmd出来的

c:\document and setting\username>

[img]http://fantasyyong840205.iteye.com/upload/picture/pic/8014/3e08a044-5292-3826-846a-298f4f00d8af.png [/img]

为什么非得计算机当前用户名，因为portal用了ant作deploy，里面有个xml配置文件使用了系统环境变量。按照官方文档要求配置：
我文件名是release.fanyong.properties，文件内容只一行：

引用

lp.ext.dir=D:/portal-4.3.2/ext

即扩展工程放置路径。

打开myeclipse里面ant视图（window--> show view --> ant) , 在ant视图中，点击添加，选择D:/portal-4.3.2/portal目录下build.xml顺序执行clean ,start ,build-ext 任务（Eclipse的ant视图中双击任务名称即执行该任务），执行ant任务时，控制台打印ant日志信息，提示Ext环境正在部署。 部署成功的话，在D:/portal-4.3.2/ext目录下产生一系列的文件和目录。

有时候在执行过程中会失败，报错。主要是portal工程本身没有compile完整。将portal重新build（project--build automatily）选择上，注意，让build完成后，再执行clean ,start ,build-ext完成标志是myeclipse 右下角进度条完成100%。

Eclipse中创建Java工程"ext" 选择"Create project from existing source" 选项，选择D:\portal-4.3.2\ext目录。
[img]http://fantasyyong840205.iteye.com/upload/picture/pic/8020/47e5bfe2-ffd3-3243-8cbe-93e75f0fc881.png [/img]

将 liferay-portal-tomcat-6.0-4.3.2.zip解压到 D:\portal-4.3.2/ext/servers/tomcat下,在D:/portal-4.3.2/ext目录下我们可以看到app.server.properties文件，同样我们也要建立一个扩展配置文件app.server.${username}.properties，文件内容两行：

引用

lp.ext.dir=D:/portal-4.3.2/ext
app.server.type=tomcat

如果不想建立扩展配置文件，需要修改app.server.properties内容，这里采用直接修改app.server.properties内容的方式：

1.修改Tomcat所放置的文件夹

引用

##
## Server Directory
##

    app.server.parent.dir=D:/portal-4.3.2/ext/servers/tomcat

2.去掉其中的注释就可以在Tomcat 6.0.x系列服务器中发布

引用

   #
    # Uncommment the following lines to deploy the portal in Tomcat 6.0.x
    # instead of Tomcat 5.5.x.
    #
    #app.server.tomcat.version=6.0
    #app.server.tomcat.dir=${app.server.parent.dir}/tomcat-6.0.13
    #app.server.tomcat.classes.global.dir=${app.server.tomcat.dir}/lib
    #app.server.tomcat.lib.endorsed.dir=${app.server.tomcat.dir}/lib/ext
    #app.server.tomcat.lib.global.dir=${app.server.tomcat.dir}/lib/ext
    #app.server.tomcat.lib.support.dir=${app.server.tomcat.dir}/lib/ext
    #app.server.tomcat.support.dir=${app.server.tomcat.dir}/lib/ext
    #app.server.tomcat.zip.name=liferay-portal-tomcat-6.0-${downloads.version.file.name}.zip

    #
    # Uncommment the following lines to deploy the portal to use the global
    # class loader.
    #
    #app.server.tomcat.classes.portal.dir=${app.server.tomcat.classes.global.dir}
    #app.server.tomcat.lib.portal.dir=${app.server.tomcat.lib.global.dir}

• 配置ext工程tomcat服务器设置

1.为了防止Java虚拟机内存溢出，在Eclipse中配置JDK可用内存：

[img]http://fantasyyong840205.iteye.com/upload/picture/pic/8036/3baf7618-2acc-3b3b-a951-c1c5618327ed.png [/img]

2.ROOT.xml中默认配置使用hsql数据库，修改为使用Mysql数据库
将D:\portal-4.3.2\ext\servers\tomcat\tomcat-6.0\conf\Catalina\localhost目录下的ROOT.xml文件中已经给出了Mysql数据库的配置示例，只需要把注释去掉即可。

	<!-- MySQL -->

	<!--<Resource
		name="jdbc/LiferayPool"
		auth="Container"
		type="javax.sql.DataSource"
		driverClassName="com.mysql.jdbc.Driver"
		url="jdbc:mysql://localhost/lportal?useUnicode=true&amp;characterEncoding=UTF-8"
		username=""
		password=""
		maxActive="20"
	/>-->

• 建立ext工程数据库

(1) 启动mysql数据库服务。

(2) 执行E:\cmproject\ext\sql\create下的create-mysql.sql（执行脚本创建lportal数据库和portal需要的数据库表）

(4) 将mysql-connector-java-5.0.5-bin.jar拷贝到 D:\portal-4.3.2\ext\servers\tomcat\tomcat-6.0\lib下，使mysql的jdbc启动程序正常可用。

以上所有步骤顺利完成后，启动myeclipse 里面tomcat服务，启动正常的话，在浏览器里输入http://localhost:8080可以看到portal系统了。

评论

1 楼 supercode 2008-04-03  

      在扩展环境中安装tomcat

修改ext项目下的app.server.properties文件,注释掉app.server.type=jboss-jetty，将app.server.type=tomcat前面的注释去掉。将tomcat安装包liferay-portal-tomcat-4.1.3.zip放在d:\workspace\ext\downloads下，右键点击ext\servers\build.xml文件，选择run as/ant build，在build菜单中选择install tomcat然后点run进行tomcat安装。安装好的tomcat在d:\workspace\ext\servers\tomcat下面。



六、            部署扩展环境到tomcat

       右键点击d:\workspace\ext\build.xml，选择run as/ant build，在build窗口中选择deploy，然后点击run进行部署。

七、            运行

       打开tomcat的bin目录d:\workspace\ext\servers\tomcat\bin，双击startup.bat脚本启动tomcat。打开浏览器，在地址栏输入http://localhost:8080，访问liferay页面。