搭建liferay-portal5.2.3的过程

感谢liferay群中的tony、六子、guest、叫花子等伙伴及liferay的朋友，终于把liferay5.2.3搭起来了，详细可以参看我的博客。
http://simon700.blog.163.com/blog/static/30228542201001942042776/edit/

一、 运行环境
如果你只是想了解一下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
    app.server.jonas-tomcat.log.dir=${app.server.jonas-tomcat.dir}/logs
    app.server.jonas-tomcat.temp.dir=${app.server.jonas-tomcat.dir}/work
    app.server.jonas-tomcat.work.dir=${app.server.jonas-tomcat.dir}/work
    app.server.jonas-tomcat.zip.name=liferay-portal-jonas-tomcat-${downloads.version}.zip
    app.server.jonas-tomcat.zip.url=${sourceforge.mirror}/${app.server.jonas-tomcat.zip.name}

##
## OC4J
##

    app.server.oc4j.dir=${app.server.parent.dir}/oc4j-10.1.3.3.0
    app.server.oc4j.bin.dir=${app.server.oc4j.dir}/bin
    app.server.oc4j.classes.global.dir=${app.server.oc4j.dir}/j2ee/home/applib
    app.server.oc4j.classes.portal.dir=${app.server.oc4j.portal.dir}/WEB-INF/classes
    app.server.oc4j.deploy.dir=${app.server.oc4j.dir}/j2ee/home/autodeploy
    app.server.oc4j.lib.global.dir=${app.server.oc4j.dir}/j2ee/home/applib
    app.server.oc4j.lib.portal.dir=${app.server.oc4j.portal.dir}/WEB-INF/lib
    app.server.oc4j.portal.dir=${app.server.oc4j.dir}/j2ee/home/default-web-app
    app.server.oc4j.log.dir=${app.server.oc4j.dir}/j2ee/home/log
    app.server.oc4j.temp.dir=${app.server.oc4j.dir}/j2ee/home/application-deployments
    app.server.oc4j.work.dir=${app.server.oc4j.dir}/j2ee/home/application-deployments
    app.server.oc4j.zip.name=oc4j_extended_101330.zip
    app.server.oc4j.zip.url=http://download.oracle.com/otn/java/oc4j/101310/${app.server.oc4j.zip.name}

##
## Resin
##

    app.server.resin.dir=${app.server.parent.dir}/resin-3.1.8
    app.server.resin.bin.dir=${app.server.resin.dir}
    app.server.resin.classes.global.dir=${app.server.resin.dir}/common/classes
    app.server.resin.classes.portal.dir=${app.server.resin.portal.dir}/WEB-INF/classes
    app.server.resin.deploy.dir=${app.server.resin.dir}/webapps
    app.server.resin.lib.global.dir=${app.server.resin.dir}/common/lib
    app.server.resin.lib.portal.dir=${app.server.resin.portal.dir}/WEB-INF/lib
    app.server.resin.portal.dir=${app.server.resin.deploy.dir}/ROOT
    app.server.resin.log.dir=${app.server.resin.dir}/logs
    app.server.resin.temp.dir=${app.server.resin.dir}/logs
    app.server.resin.work.dir=${app.server.resin.dir}/logs
    app.server.resin.zip.name=resin-3.1.8.zip
    app.server.resin.zip.url=http://www.caucho.com/download/${app.server.resin.zip.name}

##
## Tomcat
##

    app.server.tomcat.version=6.0
    app.server.tomcat.dir=${app.server.parent.dir}/tomcat-6.0.18
    app.server.tomcat.bin.dir=${app.server.tomcat.dir}/bin
    app.server.tomcat.classes.global.dir=${app.server.tomcat.dir}/lib
    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.endorsed.dir=${app.server.tomcat.dir}/lib/ext
    app.server.tomcat.lib.global.dir=${app.server.tomcat.dir}/lib/ext
    app.server.tomcat.lib.portal.dir=${app.server.tomcat.portal.dir}/WEB-INF/lib
    app.server.tomcat.lib.support.dir=${app.server.tomcat.dir}/lib/ext
    app.server.tomcat.portal.context=ROOT
    app.server.tomcat.portal.dir=${app.server.tomcat.deploy.dir}/${app.server.tomcat.portal.context}
    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-6.0-${downloads.version}.zip
    app.server.tomcat.zip.url=${sourceforge.mirror}/${app.server.tomcat.zip.name}

    #
    # Uncommment the following lines to deploy the portal in Tomcat 5.5.x
    # instead of Tomcat 6.0.x.
    #
    #app.server.tomcat.version=5.5
    #app.server.tomcat.dir=${app.server.parent.dir}/tomcat-5.5.27
    #app.server.tomcat.classes.global.dir=${app.server.tomcat.dir}/common/classes
    #app.server.tomcat.lib.endorsed.dir=${app.server.tomcat.dir}/common/endorsed
    #app.server.tomcat.lib.global.dir=${app.server.tomcat.dir}/common/lib/ext
    #app.server.tomcat.lib.support.dir=${app.server.tomcat.dir}/server/lib
    #app.server.tomcat.zip.name=liferay-portal-tomcat-5.5-${downloads.version}.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}

##
## Clean
##

    clean.log.dir=true
    clean.temp.dir=true
    clean.work.dir=true

##
## Downloads
##

    downloads.dir=${project.dir}/downloads
    downloads.version=@lp.version@

##
## SourceForge Mirror
##

    #sourceforge.mirror=http://belnet.dl.sourceforge.net/sourceforge/lportal
    #sourceforge.mirror=http://citkit.dl.sourceforge.net/sourceforge/lportal
    #sourceforge.mirror=http://cogent.dl.sourceforge.net/sourceforge/lportal
    #sourceforge.mirror=http://easynews.dl.sourceforge.net/sourceforge/lportal
    sourceforge.mirror=http://heanet.dl.sourceforge.net/sourceforge/lportal
    #sourceforge.mirror=http://jaist.dl.sourceforge.net/sourceforge/lportal
    #sourceforge.mirror=http://kent.dl.sourceforge.net/sourceforge/lportal
    #sourceforge.mirror=http://mesh.dl.sourceforge.net/sourceforge/lportal
    #sourceforge.mirror=http://nchc.dl.sourceforge.net/sourceforge/lportal
    #sourceforge.mirror=http://optusnet.dl.sourceforge.net/sourceforge/lportal
    #sourceforge.mirror=http://ovh.dl.sourceforge.net/sourceforge/lportal
    #sourceforge.mirror=http://puzzle.dl.sourceforge.net/sourceforge/lportal
    #sourceforge.mirror=http://switch.dl.sourceforge.net/sourceforge/lportal
    #sourceforge.mirror=http://voxel.dl.sourceforge.net/sourceforge/lportal

##--------------------------------------------------------

## release.properties文件内容

##
## DO NOT EDIT THIS FILE.
##
## To update the properties of this file, create a separate properties file
## named "release.${user.name}.properties" with the properties to overwrite.
##

##
## Version
##

    lp.version=5.2.0

##
## Release Info
##

    #release.info=on

##
## Release Source
##

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

##
## Extension Environment
##

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

##
## Plugins Environment
##

##    lp.plugins.dir=${project.dir}/../../plugins/build

##
## Eclipse
##

    lp.eclipse.dir=D:/eclipse3.4
    lp.eclipse.project.name=ext

##
## SVN
##

    svn.revision=

##
## AntInstaller
##

    ant.installer.dir=C:/ant

评论

7 楼 sargeguo 2010-07-13  

请问楼上liferay-portal-src-6.0.0.zip在哪里下载的？

6 楼 tianshiyeben 2010-04-20  

多谢了 楼主

5 楼 wuxi7227 2010-04-16  

很不幸，我下载了liferay-portal-src-6.0.0.zip，然后按照上面步骤去做，最后发现根本没有build-ext这个target。原来6.0版本已经做成plugin方式了，直接在6.0版本中开发就可以了。

4 楼 摆渡人 2010-04-02  

hu437 写道

LifeRay开发还是很快的，其实楼主做的这些很多是没有必要的~~Liferay 5.2.3直接下载ext包就可以了，不用从源码构建的~~

了解一下也好

最近正在研究这个liferay，说说看，你是如何个简单配置进行二次开发。

3 楼 hu437 2010-01-28  

LifeRay开发还是很快的，其实楼主做的这些很多是没有必要的~~Liferay 5.2.3直接下载ext包就可以了，不用从源码构建的~~

了解一下也好

2 楼 src_bord 2010-01-28  

哎，悲剧啊！最近接触liferay真烦人。。实在是太慢了！portlet老是出不来。。

1 楼 hanjiangit 2010-01-21  

好像对liferay多不怎么感兴趣哈