搭建Liferay开发环境 5.1.1

搭建开发环境
1. 安装 JDK1.6.0_07, jikes1.22, ant1.7.0
以安装在D盘为例
      设置环境变量：
ANT_HOME  =D:\Java\ant-1.7.0
JAVA_HOME =D:\Java\JDK1.6.0_07
JIKES_HOME=D:\Java\jikes1.22
设置path变量,增加下面信息
%ANT_HOME%\bin;%JAVA_HOME%\bin;%JIKES_HOME%\bin;
部分情况,classpath变量会干扰环境，可以删除。但我机器上没删除classpath都可以正常运作。
设置完环境变量后，最好重新启动机器，保证设置生效。
点击 开始 -- 运行 -- CMD 在命令提示符中依次舒服 java -version, ant -version, jikes -version,能够
打印出每个软件的版本说明JDK1.6.0_07, jikes1.22, ant1.7.0安装成功.
2. 安装 Myeclipse并建立portal工程
准备好liferay-portal-src-5.1.1.zip、liferay-portal-tomcat-5.5-5.1.1.zip等软件包(可以在sourceforge.net上下载)
(1)安装myeclipse,
(2)在D盘建立D:\portalspace目录，将liferay-portal-src-5.1.1.zip解压到D:\portalspace\portal目录下,
(3)进入myeclipse，设置file-->Switch Workspace 输入D:\portalspace，OK确认,
(4)File -->New-->project-->java project 输入项目名称为portal,其他默认，Finish结束,
如果一切顺利，则在myeclipse左侧边Navigator上看到portal的整个目录结构
建立ext工程（扩展环境）
(1)在myeclipse下，切换到resource视图模式，展开portal工程目录，我们可看到一个release.properties文件，
实际上我们要建一个它的扩展配置文件，
文件名为release.${username}.properties。 ${username}是计算机当前用户名，比如administrator,apple等等.
在计算机开始菜单运行cmd出来的 C:\Documents and Settings\MiJunfeng>
为什么非得计算机当前用户名，因为portal用了ant作deploy，里面有个xml配置文件使用了系统环境变量。懒得
去修改配置文件，就照它要求做。
我文件名是release.MiJunfeng.properties，文件内容只一行：lp.ext.dir=D:\portalspace\ext
即扩展工程放置路径。
(2)打开myeclipse里面ant视图（window--> show view --> ant) , 在ant视图中，点击添加，
选择  :\portalspace\portal\目录下build.xml
顺序执行clean ,start ,build-ext 成功的话，在D:\portalspace\ext目录下产生一系列的文件和目录。
有时候在执行过程中会失败，报错。主要是portal工程本身没有compile完整。将portal重新build
（project--build automatily）选择上，请注意，
让build完成后，再执行clean ,start ,build-ext完成标志是myeclipse 右下角进度条完成100%。
(3)将 liferay-portal-tomcat-5.5-5.1.1.zip解压到 D:\portalspace\bundles\tomcat-5.5.26下,
在D:\portalspace\ext目录下我们可以看到app.bundles.properties文件，
同样我们也要建立一个扩展配置文件 app.server.${username}.properties，文件内容两行：
lp.ext.dir=D:\portalspace\ext
app.server.type=tomcat
(4) 同样建立一个java project。工程名为ext.在myeclipse的Navigator里面可以看到ext工程的目录结构。
配置ext工程tomcat服务器设置
(1) 打开 window --> preference --> myeclipse --> application servers 将其他应用服务器disabble掉，
找到tomcat5，将tomcat home diretory 指向D:\portalspace\bundles\tomcat-5.5.26，
展开tomcat5，JDK选择我们配置好的JDK1.6.0_07,
JDK选项下面 optional jave vm argument输入如下内容：
-Xms256m
-Xmx512m
-XX:MaxPermSize=128m
-Djava.security.auth.login.config=D:/portalspace/bundles/tomcat-5.5.26/conf/jaas.config
(2) 将D:\portalspace\bundles\tomcat-5.5.26\conf\Catalina\localhost目录下的ROOT.xml文件内容修改为：
<Context path="" crossContext="true">
  <!-- PostgreSQL -->
  <Resource
   name="jdbc/LiferayPool"
   auth="Container"
   type="javax.sql.DataSource"
   driverClassName="org.postgresql.Driver"
   url="jdbc:postgresql://192.168.0.44:5432/lportal"
   username="demo"
   password="demo"
   maxActive="20"
  />
  <!-- Mail -->
  <Resource
   name="mail/MailSession"
   auth="Container"
   type="javax.mail.Session"
   mail.imap.host="localhost"
   mail.pop3.host="localhost"
   mail.smtp.host="localhost"
   mail.store.protocol="imap"
   mail.transport.protocol="smtp"
  />
  <!-- JAAS -->
  <Realm
   className="org.apache.catalina.realm.JAASRealm"
   appName="PortalRealm"
   userClassNames="com.liferay.portal.kernel.security.jaas.PortalPrincipal"
   roleClassNames="com.liferay.portal.kernel.security.jaas.PortalRole"
  />
</Context>
建立ext工程数据库
(1) 在服务器上192.168.0.44安装建PostgreSQL数据库服务。
(2) 在192.168.0.44数据库上执行了D:\portalspace\ext\sql\create下的create-postgresql.sql
(3)在PostgreSQL数据库上建立用户名为demo，password =demo,并将"超级用户"的角色赋予demo
(4)  解压mysql-connector-java-3.1.12.zip，
将postgresql-8.3-603.jdbc3.jar 拷贝到D:\portalspace\ext\bundless\tomcat-5.5.26\common\lib下。
使PostgreSQL的jdbc启动程序正常可用。

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

3. Portlet常见问题

(1). 运行提示portlet path 找不到，则一般是liferay-port-ext文件里面portlet的struts–path有问题。
(2). 启动提示jaas.config错误，没有在tomcat的jdk参数配置jaas.config文件或配置路径不对
(3). 提示html/../..找不到，一般是struts-config文件里面path路径有问题。
(4). 有执行和数据库存取数据时候，提示“columnname_”字段不存在，去修改ext-hbm.xml文件，ant执行
build service任务时候，产生ext-hbm.xml信息有时会不准确，将对应的<property name="columnname"
column="columnname_ " />的column调整为数据库对应正确的字段名。
(5). 大家在清除不用的portlet时候，请先登录系统，将不用的portlet关闭，然后再删除或屏蔽对应的代码。
不然直接删除或屏蔽代码，重新启动后，会提示portlet找不到。注册后的portlet会写信息到数据库中。
(6). 执行ant任务时报下列异常
BUILD FAILED
D:\portalspace\portal\build.xml:6: The following error occurred while executing this line:
D:\portalspace\portal\build-common.xml:151: Class org.apache.tools.ant.taskdefs.ConditionTask doesn't support the nested "antversion" element.
是因为myeclipse自带的ant版本太低,可在Window -- Preferences --Ant -- Runtime 中指定Ant Home为ant的安装路径