搭建liferay-portal5.2.3的过程

一、 运行环境

如果你只是想了解一下 liferay 里面有什么，对她只是尝试一下，了解一下，要“搭建”这个运行环境，那是非常简单的事情。

1、  下载 jdk ，然后安装，并配置好环境变量。添加 JAVA_HOME 环境变量，值为 JDK 安装路径，如： C:\jdk1.5

2、  安装 tomcat6 （假设我们用 tomcat6 ），在环境变量 path 中，添加 %JAVA_HOME%\bin; 开发环境；（甚至这一步都不用）

3、  上 lifray 官网下载 lifray5.2.3 的运行包 liferay-portal-tomcat-6.0-5.2.3.zip 。
http://www.liferay.com/downloads/liferay-portal/overview
或
http://sourceforge.net/projects/lportal/

4、  解压 liferay-portal-tomcat-6.0-5.2.3.zip ，然后运行包中 tomcat-6.0.18\bin\startup.bat ，如果启动过程中没有报任何的错误，你就成功了。（一般都不会报错，至少我 N 次都没报过错）

5、  使用 http://localhost:8000 访问项目，可以看到主页面，证明你成功了。

二、 开发环境

如果你是想用 liferay ，并对她需要二次开发，那么你就得需要部署 liferay 的 ext 扩展开发环境了。

1、  不管怎么说上面的运行环境还是建议做一遍，一个是开发环境下同样需要 jdk 和 tomcat ，另一点是可以先了解 liferay 是什么样的；

2、  然后开始部署开发环境了。上官网下载 liferay5.2.3 源码 liferay-portal-src-5.2.3.zip ，还是刚刚那地址 http://sourceforge.net/projects/lportal/ 下载 liferay-portal-src-5.2.3.zip ；

3、  在你的平常开发 JAVA 的空间建一个文件夹，如： my_liferay5.2.3 ；

4、  把下载的源码 liferay-portal-src-5.2.3.zip 解压到 my_liferay5.2.3 中，更名为 portal ；

5、  把之前下载的运行包 liferay-portal-tomcat-6.0-5.2.3.zip 解压后下面的 tomcat-6.0.18 拷到 my_liferay5.2.3

6、  打开 eclipse ，导入 portal 项目；

7、  根据下面步骤安装和配置 ant

下面是 ant 安装及配置参考《 liferay 二次开发》中的内容

 

8、  选中 portal 项目

 

9、  在 my_liferay5.2.3 下建一个 ext 文件夹，用于存放 build 出来的 ext 扩展项目；

10、              现在开始配置 portal 项目中的两个文件，这里很重要，我就是很长时间在这里总是没搞定； portal 项目下的 app.server.properties 和 release.properties 文件

11、              配置 app.server.properties

找到以下这几行进行相应修改

app.server.type=tomcat

 

app.server.parent.dir=${project.dir}/..

 

app.server.tomcat.version=6.0

app.server.tomcat.dir=${app.server.parent.dir}/tomcat-6.0.18

 

我后面再贴上

12、              配置 release.properties

lp.source.dir=${project.dir}

 

lp.ext.dir=${project.dir}/../ext

 

lp.eclipse.dir=D:/eclipse3.4

lp.eclipse.project.name=ext

 

ant.installer.dir=C:/ant

 

13、              我后面贴上了这两个文件内容，具体各位可以参考一下，我原来配不成功，也是找了群里的一个朋友，让他发他的给我对照配的。

14、              然后如果你的 portal 项目按 clear 、 stare 、 build 出来的 ext 目录没有报任何错，证明你成功了一半；

15、              接着你在 eclipse 中导入 ext 项目；

16、              然后选择 build.xml 进行 deploy ，如果你整个过程中可以看到不断有文件 copy 到你的 tomcat-6.0.18 目录下，而且整个过程完成后没报错，证明你成功了 80% ；

17、              然后你到 tomcat-6.0.18\bin\startup.bat 下，运行 startup.bat ，启动成功，并可以 http://localhost:8000 访问项目，可以看到主页面，证明你成功了。

恭喜你！

三、 附录

## app.server.properties 文件内容

##

## DO NOT EDIT THIS FILE.

##

## To update the properties of this file, create a separate properties file

## named "app .server.${user.name}.properties" with the properties to overwrite.

##

 

##

## Server Type

##

 

    #app .server.type=geronimo -tomcat

    #app .server.type=glassfish

    #app .server.type=jboss -tomcat

    #app .server.type=jetty

    #app .server.type=jonas -jetty

    #app .server.type=jonas -tomcat

    #app .server.type=oc4j

    #app .server.type=resin

    app.server.type= tomcat

 

##

## Server Directory

##

 

    app.server.parent.dir= ${project.dir }/..

 

##

## Geronimo +Tomcat

##

 

    app.server.geronimo-tomcat.dir= ${app .server.parent.dir }/geronimo -tomcat -2.1.3

    app.server.geronimo-tomcat.bin.dir= ${app .server.geronimo -tomcat .dir }/bin

    app.server.geronimo-tomcat.classes.global.dir= ${app .server.geronimo -tomcat .dir }/var /shared/classes

    app.server.geronimo-tomcat.classes.portal.dir= ${app .server.geronimo -tomcat .portal.dir }/WEB-INF/classes

    app.server.geronimo-tomcat.credentials= --user system --password manager

    app.server.geronimo-tomcat.deploy.dir= ${app .server.geronimo -tomcat .dir }/deploy

    app.server.geronimo-tomcat.lib.global.dir= ${app .server.geronimo -tomcat .dir }/var /shared/lib

    app.server.geronimo-tomcat.lib.portal.dir= ${app .server.geronimo -tomcat .portal.dir }/WEB-INF/lib

    app.server.geronimo-tomcat.portal.dir= ${app .server.geronimo -tomcat .deploy.dir }/liferay -portal.war

    app.server.geronimo-tomcat.log.dir= ${app .server.geronimo -tomcat .dir }/var /temp

    app.server.geronimo-tomcat.temp.dir= ${app .server.geronimo -tomcat .dir }/var /temp

    app.server.geronimo-tomcat.work.dir= ${app .server.geronimo -tomcat .dir }/var /temp

    app.server.geronimo-tomcat.zip.name= liferay -portal-geronimo -tomcat -${downloads .version}.zip

    app.server.geronimo-tomcat.zip.url= ${sourceforge .mirror}/${app .server.geronimo -tomcat .zip .name}

 

##

## Glassfish

##

 

    app.server.glassfish.version= 2

    app.server.glassfish.dir= ${app .server.parent.dir }/glassfish

    app.server.glassfish.addons.dir= ${app .server.glassfish .dir }/lib /addons

    app.server.glassfish.bin.dir= ${app .server.glassfish .dir }/bin

    app.server.glassfish.classes.global.dir= ${app.server.glassfish.instance.dir}/lib/classes

    app.server.glassfish.classes.portal.dir= ${app.server.glassfish.portal.dir}/WEB-INF/classes

    app.server.glassfish.deploy.dir= ${app.server.glassfish.instance.dir}/autodeploy

    app.server.glassfish.dist.dir= ${app.server.glassfish.dir}

    app.server.glassfish.installer.dir= ${app.server.glassfish.dir}

    app.server.glassfish.instance.dir= ${app.server.glassfish.dir}/domains/domain1

    app.server.glassfish.lib.global.dir= ${app.server.glassfish.instance.dir}/lib

    app.server.glassfish.lib.portal.dir= ${app.server.glassfish.portal.dir}/WEB-INF/lib

    app.server.glassfish.log.dir= ${app.server.glassfish.instance.dir}/logs

    app.server.glassfish.portal.dir= ${app.server.glassfish.deploy.dir}/liferay-portal.war

    app.server.glassfish.temp.dir= ${app.server.glassfish.instance.dir}/logs

    app.server.glassfish.work.dir= ${app.server.glassfish.instance.dir}/logs

    app.server.glassfish.zip.name= glassfish-installer-v2.1-b60c-${glassfish.os}.jar

    app.server.glassfish.zip.url= http : //www.java.net/download/javaee5/v2.1_branch/promoted/${app.server.glassfish.zip.name}

 

    #

    # Uncommment the following lines to deploy the portal in GlassFish 3 instead

    # of GlassFish 2.

    #

    #app.server.glassfish.version=3

    #app.server.glassfish.zip.name=glassfish-v3-prelude.zip

    #app.server.glassfish.zip.url=http://download.java.net/glassfish/v3-prelude/release/${app.server.glassfish.zip.name}

 

##

## JBoss+Tomcat

##

 

    app.server.jboss-tomcat.version= 4.2

    app.server.jboss-tomcat.dir= ${app.server.parent.dir}/jboss-tomcat-4.2.3

    app.server.jboss-tomcat.bin.dir= ${app.server.jboss-tomcat.dir}/bin

    app.server.jboss-tomcat.classes.global.dir= ${app.server.jboss-tomcat.instance.dir}/lib/ext

    app.server.jboss-tomcat.classes.portal.dir= ${app.server.jboss-tomcat.portal.dir}/WEB-INF/classes

    app.server.jboss-tomcat.deploy.dir= ${app.server.jboss-tomcat.instance.dir}/deploy

    app.server.jboss-tomcat.instance.dir= ${app.server.jboss-tomcat.dir}/server/default

    app.server.jboss-tomcat.lib.global.dir= ${app.server.jboss-tomcat.instance.dir}/lib/ext

    app.server.jboss-tomcat.lib.portal.dir= ${app.server.jboss-tomcat.portal.dir}/WEB-INF/lib

    app.server.jboss-tomcat.portal.dir= ${app.server.jboss-tomcat.deploy.dir}/ROOT.war

    app.server.jboss-tomcat.log.dir= ${app.server.jboss-tomcat.instance.dir}/log

    app.server.jboss-tomcat.temp.dir= ${app.server.jboss-tomcat.instance.dir}/tmp

    app.server.jboss-tomcat.work.dir= ${app.server.jboss-tomcat.instance.dir}/work

    app.server.jboss-tomcat.zip.name= liferay-portal-jboss-tomcat-4.2-${downloads.version}.zip

    app.server.jboss-tomcat.zip.url= ${sourceforge.mirror}/${app.server.jboss-tomcat.zip.name}

 

    #

    # Uncommment the following lines to deploy the portal in JBoss+Tomcat 5.0.x

    # instead of JBoss+Tomcat 5.0.x.

    #

    #app.server.jboss-tomcat.version=5.0

    #app.server.jboss-tomcat.dir=${app.server.parent.dir}/jboss-tomcat-5.0.0

    #app.server.jboss-tomcat.classes.global.dir=${app.server.jboss-tomcat.instance.dir}/lib

    #app.server.jboss-tomcat.lib.global.dir=${app.server.jboss-tomcat.instance.dir}/lib

    #app.server.jboss-tomcat.zip.name=liferay-portal-jboss-tomcat-5.0-${downloads.version}.zip

 

##

## Jetty

##

 

    app.server.jetty.dir= ${app.server.parent.dir}/jetty-6.1.14

    app.server.jetty.bin.dir= ${app.server.jetty.dir}/bin

    app.server.jetty.classes.global.dir= ${app.server.jetty.dir}/resources

    app.server.jetty.classes.portal.dir= ${app.server.jetty.portal.dir}/WEB-INF/classes

    app.server.jetty.deploy.dir= ${app.server.jetty.dir}/webapps

    app.server.jetty.lib.global.dir= ${app.server.jetty.dir}/lib/liferay

    app.server.jetty.lib.portal.dir= ${app.server.jetty.portal.dir}/WEB-INF/lib

    app.server.jetty.portal.dir= ${app.server.jetty.deploy.dir}/root

    app.server.jetty.log.dir= ${app.server.jetty.dir}/logs

    app.server.jetty.temp.dir= ${app.server.jetty.dir}/work

    app.server.jetty.work.dir= ${app.server.jetty.dir}/work

    app.server.jetty.zip.name= liferay-portal-jetty-${downloads.version}.zip

    app.server.jetty.zip.url= ${sourceforge.mirror}/${app.server.jetty.zip.name}

 

##

## JOnAS+Jetty

##

 

    app.server.jonas-jetty.dir= ${app.server.parent.dir}/jonas-jetty-4.10.3

    app.server.jonas-jetty.bin.dir= ${app.server.jonas-jetty.dir}/bin

    app.server.jonas-jetty.classes.global.dir= ${app.server.jonas-jetty.dir}/lib/ext

    app.server.jonas-jetty.classes.portal.dir= ${app.server.jonas-jetty.portal.dir}/WEB-INF/classes

    app.server.jonas-jetty.deploy.dir= ${app.server.jonas-jetty.dir}/webapps/autoload

    app.server.jonas-jetty.lib.global.dir= ${app.server.jonas-jetty.dir}/lib/ext

    app.server.jonas-jetty.lib.portal.dir= ${app.server.jonas-jetty.portal.dir}/WEB-INF/lib

    app.server.jonas-jetty.portal.dir= ${app.server.jonas-jetty.deploy.dir}/liferay-portal.war

    app.server.jonas-jetty.log.dir= ${app.server.jonas-jetty.dir}/logs

    app.server.jonas-jetty.temp.dir= ${app.server.jonas-jetty.dir}/work

    app.server.jonas-jetty.work.dir= ${app.server.jonas-jetty.dir}/work

    app.server.jonas-jetty.zip.name= liferay-portal-jonas-jetty-${downloads.version}.zip

    app.server.jonas-jetty.zip.url= ${sourceforge.mirror}/${app.server.jonas-jetty.zip.name}

 

##

## JOnAS+Tomcat

##

 

    app.server.jonas-tomcat.dir= ${app.server.parent.dir}/jonas-tomcat-4.10.3

    app.server.jonas-tomcat.bin.dir= ${app.server.jonas-tomcat.dir}/bin

    app.server.jonas-tomcat.classes.global.dir= ${app.server.jonas-tomcat.dir}/lib/ext

    app.server.jonas-tomcat.classes.portal.dir= ${app.server.jonas-tomcat.portal.dir}/WEB-INF/classes

    app.server.jonas-tomcat.deploy.dir= ${app.server.jonas-tomcat.dir}/webapps/autoload

    app.server.jonas-tomcat.lib.global.dir= ${app.server.jonas-tomcat.dir}/lib/ext

    app.server.jonas-tomcat.lib.portal.dir= ${app.server.jonas-tomcat.portal.dir}/WEB-INF/lib

    app.server.jonas-tomcat.portal.dir= ${app.server.jonas-tomcat.deploy.dir}/liferay-portal.war