版本:Liferay 6.2.4

1. 下载与安装

1.1 首先下载以下文件:

  Eclipse中的Liferay插件
    liferay-ide-updatesite-3.1.0-m2-201702090100.zip
  Liferay SDK
    liferay-plugins-sdk-6.2-ce-ga5-20151118111117117.zip
  Tomate和LiferayPortal集成的Server
    liferay-portal-tomcat-6.2-ce-ga5-20151119152357409.zip
  Eclipse Noen2
    eclipse-jee-neon-2-win32-x86_64.zip
  JDK 7
    JDK 7
  LiferayPortal的源码(可以查看源码)
    liferay-portal-src-6.2-ce-ga5-20151118111117117.zip
  oracle 11g express和java jdbc驱动包
    OracleXE112_Win64.zip, ojdbc6_g.jar

 

1.2 把上面几个zip文件拷贝到本地目录,并且解压这些zip文件:

  最好解压后的文件都放到同一个目录下面,例如我的是:D:\liferay6.2,
  另外,如果使用原文件夹名字,可能会在使用Service Builder的时候,抛出异常,
  是说CreateProcess error=206, 文件名或扩展名太长。
  原因是读取SDK的目录太长,需要为文件夹重命名,所以解压缩之后将他们都放在同一个目录下,并且将文件夹重命名。

1.3 安装Java JDK 7。然后一定要把Java配置JavaHome到ClassPath中去。

1.4 到eclipse解压后的目录中,打开eclipse.

1.5 在eclipse中安装Liferay的插件:

  步骤为Help > Install New Software > 选择 liferay-ide-updatesite-2.2.4-ga5-201507230603.zip> 勾选要初始化的插件 > next > accept > finished

1.6 根据提示重启Elicpse

2. 在新建项目的过程中如果报错可根据提示修改liferay sdk中的build.properties文件

 具体步骤为:

2.1 首先把build.properties 这个文件拷贝一份,然后命名为 build.你自己机器的名称.properties

  例如:把 D:\liferay6.2\sdk\build.properties 这个文件拷贝一份到相同目录下,
  然后命名为 build.Candice.Wang.properties, 再修改下面两个地方。

2.2 把liferay SDK和Tomcat关联起来,将app.server.parent.dir改成tomcat的路径,

  app.server.parent.dir=D:\liferay6.2\tomact

2.3 下面这个修改是因为Liferay在不同的小版本里面还略有差异,有的版本有这个问题,有的没有,

  具体请参考:http://www.huqiwen.com/2016/04/06/liferay6-2-5-ga6-dev-environment-install/
  修改如下:
    ivy.jar.url=https://repository.liferay.com/nexus/content/repositories/liferay-public-snapshots/com/liferay/org.apache.ivy/${ivy.version}/org.apache.ivy-${ivy.version}.jar

3. 在Eclipse中配置Liferay SDK。

(这个不同的版本的liferay略有不同,只需要第一次创建的时候关联。)

  首先要创建一个Liferay工程, 在创建的向导中会要你去关联Liferay的SDK。步骤如下:
  打开Elicpse > File -> New -> Liferay Plugin Project(Liferay 6.x) >New Liferay Plugin Project(Liferay 6.x) > 输入工程名字 >
  选择Portlet framework: Liferay MVC > Next > 选择SDK Location D:\liferay6.2\sdk > OK

4. Build项目

  4.1 如果是maven项目,还需要先安装maven,

    Liferay安装manven:
      4.1.1 首先下载个maven zip包,解压缩之后配置一下环境变量;
      4.1.2 下载一个ant 包,同样配置一下环境变量;
      4.1.3 下载maven 的支持,liferay-portal-maven-6.2-ce-ga5,
      4.1.3.1 在该目录下,复制build.properties文件为build.{username}.properties(username是cmd出现的用户名)
      4.1.3.2 添加mvn.path=D:\\liferay6.2\\apache-maven-3.5.0(mvn.path是自己命名的,值为当前maven路径)
      4.1.3.3 修改build.xml文件,将其中的路径"." 改为3.2 中添加的值,例如为"${mvn.path}",搜索bat, 把bat改成cmd
      4.1.3.4 通过cmd进入dos窗口,并进入到liferay-portal-maven-6.2-ce-ga5目录下,执行ant install。
      4.1.3.5 执行完成之后,再将步骤3.2中的修改复原,再次执行ant install。
      4.1.4 build的时候,右键选中项目->run as ->maven install,完成后再右键选中项目->run as ->maven build.    

  4.2 如果是ant项目,只需要在create的时候选择ant,不需要额外安装支持。

      把build.xml文件拖拽到Ant中,双击build。第一次build可能会比较久。

5. 在Eclipse中添加Tomcat

  Window > Perference > Server > Runtime Environments > Add > 一定要选择Liferay,Inc > Liferay v6.2 CE (Tomcat7)
  > 输入Name > 选择Tomcat目录为D:\liferay6.2\tomact\tomcat-7.0.62在(然后还可以在这里选择源码)
  > 选择你之前配置的JRE > Next > 添加Liferay source源码: D:\liferay6.2\liferay-portal-src-6.2-ce-ga5-20151118111117117.zip

6. 安装orcal

6.1 安装Oracle数据库,

  双击\OracleXE112_Win64\DISK1\Oraclesetup.exe, 根据向导安装。注意安装的时候一定要记住自己填写的密码,之后链接数据库要用到

6.2 安装完Oracle数据库之后,连接数据库,并且创建一个新用户,并且给新用户赋权限。

  开始 > 运行 > cmd
  连接数据库:sqlplus
  请输入用户名: system
  输入口令:
  用sysdba链接: conn / as sysdba
  创建一个root/password的用户和密码:create user root identified by password;
  给root用户赋予dba的权限:grant dba to root;
  用刚才创建的账号连接一下数据库: conn root/password;

可参考:http://www.cnblogs.com/shlcn/archive/2011/07/21/2112879.html

6.3 把Oracle数据的驱动包放到Tomcate的lib下面

  例如:
  把这个包ojdbc6_g.jar 放到 D:\liferay6.2\tomact\tomcat-7.0.62\webapps\ROOT\WEB-INF\lib下,

6.4 使用navicat查看orcal数据库的时候,需要如下配置:

  1. service Name/SID改成XE
  2. 将instantclient-basic32 放到本地,以便使用其中的oci.dll,具体为:
    Tools-->options-->OCI-->OCI Libraries : D:\liferay6.2\instantclient-basic32\instantclient_12_2\oci.dll
    Tools-->options-->OCI-->SQL Plus : C:\oraclexe\app\oracle\product\11.2.0\server\bin\sqlplus.exe 分别找到对应的文件

7. 启动项目

  在eclipse中把Server窗口显示出来,然后把项目添加到Tomcat中去。右键Liferay v6.2 CE (Tomcat7) > Add and Remove > 把刚才新建的项目添加进去,然后启动。


8. 打开浏览器, 配置Portal的admin账号和连接数据,

  访问:http://127.0.0.1:端口号/
  配置完成之后,会显示如下,告诉你:你刚才配置的信息保存到这里来了。
  The configuration was saved in D:\liferay6.2\tomact\portal-setup-wizard.properties.

  如果你不想每次打开http://127.0.0.1:8888/都跳转到这个配置向导来,那么就可以修改这个文件中的setup.wizard.enabled=false即可。

  如果你的数据库用户名或者密码有变化,也可以到这里来修改。