liferay portal 中文安装指南

Liferay portal  安装指南(初稿)--------温兵

 

 

 

liferay porta 安装指南(初稿)

 

 

 

 

 

liferay porta 安装指南(初稿) ...........................................................................................................1

1 介绍 ..............................................................................................................................................2

1.1 入门....................................................................................................................................2

1.2 推荐配置............................................................................................................................2

2 安装 ..............................................................................................................................................2

2.1 配置开发环境....................................................................................................................2

2.2 获得 liferay portal  源码....................................................................................................3

2.3 安装你的 IDE--Eclipse......................................................................................................3

2.4 用 liferay 的源码做开发 ...................................................................................................3

2.4.1  获得 Orion 容器 .....................................................................................................4

2.4.2  在 Eclipse 中配置 Orion.........................................................................................4

2.4.3  启动 Orion ..............................................................................................................5

2.4.4  配置你的 Properties................................................................................................6

2.4.5  配置 Orion ..............................................................................................................6

2.5 创建扩展环境....................................................................................................................7

2.5.1  启动扩展.................................................................................................................7

2.5.2  添加插件(主要是编译专业版) ..............................................................................8

2.5.3  挂载数据库.............................................................................................................8

2.5.4 starting Liferay .........................................................................................................8

3 关于翻译.......................................................................................................................................8

 

 

 

 

 

 

 

 

Liferay portal 安装指南(初稿)--------温兵

 

 

1 介绍

 

 

1.1 入门

 

 

牋□ 在这个文档中,我的目标是帮助大家设置你的额开发环境,使你可以自己在这个软件上开发出 portlets.这个文档的起点是你必须具备一些 web 常识以及做 Servlet,jsp 的开发经验.你们 可能会在不同的操作系统上运行.我的能力有限,但是我会尽量保证这个配置可以适用于不同的 系统

 

 

1.2 推荐配置

 

 

牋 虽然你的配置可能不高,但是作为开发和定制化 Liferay,我们推荐下列硬件配置:

 

1 G 内存

 

2.0 G CPU

 

 

2 安装

 

 

2.1 配置开发环境

 

 

配置 Liferay 可以完成任何企业级的 JAVA 应用任务.

 

Liferay 控制使用几个框架. 幸运的是,大部分的框架 Liferay 已经把它捆绑在了一起. 如果你想在 Liferay 上安装一些其他的工具.首先你要确保你的机器上已经正确安装 java JDK.你最好在你的机器上安装最新稳定的 J2SE1.4.2 这个版本.如果你没有请到 http://java.sun.com 这里去下载最新的版本.假设我下载以后解压缩放在 D:\Java 这 个目录中!当然你也可安装在你喜欢的目录中,但是从现在开始下文提到的{Java}我们 都指的是这个安装目录.虽然你喜欢使用 Sun 的默认 java 编译器,但是我们推荐你使用 IBM 的 Jikes 编译器--通常它可以描述更多的编译错误.确定你下载的是 Jikes 的 1.21 的版本,因为 1.22 是在 JDK1.5 下工作运行的,由于不能向后兼容所以 Liferay portal 不能用.最终你还需要从 http://ant.apache.org.下载Ant这个Java基本编译工具,解 压缩到上面我们提到的那个目录(D:\Java).

 

接着设置你的环境变量:在 WIndows 下,打开控制面板/系统/高级/环境变量,新建变 量:JAVA_HOME,ANT_HOME,JIKES_HOME

 

注意要把他们的路径写正确.设置 JAVA 的 CLASSPATH 以便其他的应用能在机器上运行.在 PATH 中添上%ANT_HOME%\bin;%JAVA_HOME%\bin;%JIKES_HOME%\bin

 

 

 

 

 

 

Liferay portal  安装指南(初稿)--------温兵

 

 

2.2 获得 liferay portal 源码

 

 

现在开始,从 http://www.liferay.com/web/guest/downloads/portal_source

 

下载最新稳定的 Liferay portal 企 业 版 代 码 . 我 把 它 解 压 缩 到 这 个 目 录 D:\cvsroot\liferay (我使用 CVS 来储存代码),接下来我们将使用{Liferay}来代表这 个目录. 当你下载了这个稳定的 Liferay,Then download the latest stable Liferay, 这个指南已经包括了基于 tomcat 的专业版.我将在稍后在这章介绍关于 Tomcat 的捆绑.

 

 

2.3 安装你的 IDE--Eclipse

 

 

尽管你可能用记事本修改或者部署Liferayportal 一些简单的事情,但是一个好的 IDE 工具可以加速提升你的工作.我向你展示 Eclipse 这个工具,它可以很方便的部署和运 行 Liferay portal.下载最新的 Eclipse 版本

 

http://www.eclipse.org/downloads/index.php. 安装 Eclipse 到 {Java}\eclipse

且运行它.在菜单上 选择 File/ Switch Workspace…然后选择 {Liferay}这个目录.

 

 

 

在 workspace 中启动你的工程, 选择 File /New/Project. 在对话框中选择 Java Project 然后点击 Next.在这个新的窗口中输入 portal 作为 Project Name 然后点击 Finish.

 

 

 

如果你恰当设置Workspace, 你应该可以在导航中看到 portal 这个工程的透视图. 在这 个工程的根目录上单击鼠标右键选择 Properties/JavaBuildPath 点击右边Libraries 你需要的 jar 包都已经加载上了.这些 jar 文件是通过{Liferay}\portal 下面 的 .classpath 文件定义加载的.

 

 

 

添加Eclipse的插件是很容易的事情. 自从 Eclipse 集成 Ant 以后,启动 Ant 是个很容易的事情在 Window 菜单下选择 ShowView/Ant. 你就可以看到这个 Ant 显示在你的透视 图中.

 

增加 Liferay’s 构建文件也是这样的简单.简单到你就选择透视图上面的 Ant 然后单 击 Ant +这个符号. 注意这样会用 Ant 读到出现每个目录中自己的 build.xml 文件. 我 们单击选择 portal 这个目录中的 build.xml 文件. 你的启动图形如图 2.3.

 

 

2.4 用 liferay 的源码做开发

 

 

在一下部分我们主要介绍怎么使用Orion这个容器对Liferay的源码做开发和调试.It is important to note that working off the core source is not

 

recommended.如果你想要扩充Liferayportal的功能的话,它是你要增加一个扩充的环 境(在2.5节我们主要讲怎么扩展功能).Development of the core portal should only

 

 

 

 

 

 

 

 

 

 

 

Liferay portal  安装指南(初稿)--------温兵

 

 

be done for bug fixes or

 

enhancements that potentially would make it into the next build. Typical developers will

not need to read this section.

 

 

2.4.1 获得 Orion 容器

 

 

首先从 http://www.orionserver.com , 下 载 Orion. 把 这 个 文 件 释 放 到 (i.e.

{Java}\orion-2.0.6)这个目录,以下我将使用{orion}来代表上面这个路径.运行这个 命令来测试你的服务“java –jar orion.jar”.

 

2.4.2 在 Eclipse 中配置 Orion

 

 

在Eclipse中启动运行Orion需要我们稍微花些时间设置一下.首先在你的透视图下,右 键工程名称在出来的菜单中选择 Debug as/Debug,然后会出来一个对话框.

 

 

 

如果你以前在 Java Application 下面已经配置好一些,你可以新建一个或者删除它.在 前面点击 New 这个按钮, 并且改变下列内容:

Main Tab 页:

1. 改变 name 配置为 “orion”

 

2. 设置 Main class 为 “com.evermind.server.ApplicationServer”

 

 

 

Arguments Tab 页:

 

1. Program arguments: -config {orion}/config/server.xml - userThreads (note that

you need to change the directory path)

 

2. VM arguments: -Xmx256m - Dfile.encoding=UTF8 - Duser.timezone=GMT

 

 

 

Classpath Tab 页:

 

1.undertheUserEntriesgroup,removethe “portal (default classpath)” entry

2. 单击 AddExternalJARs,在系统中找到你安装 orion的目录中的orion.jar 添加它

 

注意: make sure that within your JRE Tab, your Project

JRE points to a SDK as

 

opposed to just a JRE (i.e. my Project JRE has j2sdk1.4.2_05 next to it in parenthesis.

This may require you to add another entry within Java

 

 

Liferay portal 安装指南(初稿)--------温兵

 

 

(from the left navigation) --

Installed JREs.

 

 

 

 

2.4.3 启动 Orion

 

 

配置Orion有三个关键的文件. 第一个, {orion}\config\server.xml,

 

let’s you specify which “web-sites” will be accessible when started up. 增 加一个新的

website 并插入这些内容:

 

 

你还的指定一个Orion的另一个编译器:

 

mpiler executable="jikes" classpath="{Java}\jre\lib\rt.jar" />

 

现在你已 经详细指 定了这个 新的 website, 你 需 要创建一 个调用 文件 portal.liferay.com-web.xml 在这个目录中{orion}\config\web-sites\. 你可以看 到类型于(Figure x.2. portal.liferay.com-web.xml)的图.

 

 

 

最后, 在{orion}\config\application.xml, 你需要增加两个模块 web- module 和 ejb-module.所有 web-app 的元素声明在你的 portal.liferay.comweb.xml 但是这些声 明也必须定义在你的 application.xml:见图(Figure x.3. application.xml)

 

通过插入ejb-module元素给你的EJBs增加一个适当的参考. 注意你可以在 Orion 中通 过使用"file:"前缀直接找文件. An advantage

of using this prefix is that you don’t have to deploy your files to the server. 这个可以有助于你快速的调试 JSPs (简单的保存和更新你的 JSP).另一个原因是它可以 很好的编译和部署 source 文件成为 class.

 

Note: Whenusingthe“file:”prefixfortheportal-ejb module, you need to ensure that

the  portal-ejb.jar does  not  exist  within your

{orion}\applications\ directory.

 

最后,你必须编辑 {orion}\config\data- sources.xml 是你的应用能访问到你的数据

库. 如果你使用的 mysql 请确认 mysql.jar 已经部署到 {orion}\lib\目录, 配置你

data- sources.xml 文件例似下面:

 

 

 

 

 

 

 

Liferay portal 安装指南(初稿)--------温兵

 

 

location="jdbc/LiferayCore"

 

pooled-location="jdbc/LiferayPool" xa-location="jdbc/xa/LiferayXA"

ejb-location="jdbc/LiferayEJB"

 

connection-driver="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost/lportal" username="root"

password=""

 

inactivity-timeout="30" schema="database-schemas/mysql.xml"

/>

 

 

 

2.4.4 配置你的 Properties

 

 

Liferay 的配置多数都在 portal.properties 这个文件中. 类似于你的这个文件 build.properties, 你 在                  portal- ext.properties 设 置 它 的 属 性 都 比 在 portal.properties 它本身根方便.

 

给你的portal配置一个,创建一个新的文件在{Liferay}\portal\util-java\ 这个目录中文件名为 portal- ext.properties. 在里面添加下列设置:

portal.ctx=/portal

此外,注意在这个  portal-  ext.properties  设 置这个属性就不用考虑在

portal.properties 设置.

 

 

2.4.5 配置 Orion

 

 

如果你想要你的 Ant 命令知 道在什 么 地方部 署 它,你需 要 创建一 个 扩展名 类

app.server.{username}.properties. 在这个文件中添加一行 app.server={orion}

 

这 个   {orion} 就 是 我 们 安 装  Orion  的 目 录 ,  例 如 这 样   (i.e. app.server=D:/Java/orion- 2.0.5). 最后用你 Eclipse 的 Ant 显示, 运行你 portal 目录中的 start 和 delpoy 标 记 . 如果你使用 "file" 前 缀 , 不要忘记去删 出 portal-ejb.jar 以后部署!

 

你全部设置了! 在你的 Debug 透视图中到前面单击 bug 这个图标,这时在你的控制台就 会看到 Orion 开始启动.

 

 

 

 

 

 

Liferay portal 安装指南(初稿)--------温兵

 

 

2.5 创建扩展环境

 

 

通过扩展环境来开发和部署你的portlets 是你最感兴趣的. 这样可以改良你的 portal 但是不会让你有任何头痛的. 任何时间发布一个新的稳定的 Liferay portal 的版本, 是你做的并且是一个震惊的,你可以把它卖掉.同样可是说你开发一个健壮的扩展环境. 所有新的 classes,JSPs,和所有的新的改变都应该在{Liferay}\ext 里面.

 

 

 

ItisinyourbestinteresttodevelopyourportletsviaanExtensionEnvironment. This

 

would allow you to upgrade your portal without any headaches. Any time a new stable

 

version of Liferay Portal is released, all you would need to do is drop in the new jars

 

andyou’resettogo.Withthatsaid,yourdevelopmentshouldonlybedonewithinthe

 

Extension Environment as well. Meaning, all new classes, JSPs, and all changes in

general, should be within {Liferay}\ext.

 

 

2.5.1 启动扩展

 

 

设置启动你的扩展环境是很简单的. 在做任何事情之前,你需要改变一个属性文件 (.properties)在 {Liferay}\portal 目录中. 注意在这个.properties 默认的文件中 你从未改变这个值. 在每个.properties 文档的顶部遵循它的注释替换(改变),需要创 建一个扩展名类似于这个 release.{username}.properties 的文件. 你可以在开始/运 行 下打开一个命令提示这个${username}的值会出现在 DocumentsandSettings 后面. 在你的这个新的.properties 文件中添加正确的一行({Liferay}是真实的目录:

 

lp.ext.dir={Liferay}/ext

(Note that it’s a forward slash)

 

 

 

接下来, 在 2.3 节中描述的 Ant 显示中,你能够扩展 portal build.xml 中的对象 (taegets)列表. 在这些对象(taegets)中,你可以看到 clean, start, build- ext.向 前双击那些对象(taegets)一会儿观察它的输出. 你将看到一大堆文本的输出通过指示 说明你的扩张环境在运行.请仔细检查控制台输出的红色错误. 你可能发现你有一些可 怕的错误设置在你的属性中. 如果所有的都很好,那么你应该能到这里浏览你你扩展目 录

 

{Liferay}\ext!

 

 

 

 

Liferay portal  安装指南(初稿)--------温兵

 

 

2.5.2 添加插件(主要是编译专业版)

 

 

主要是添加一个 Tomcat 编译环境老启动 Liferay 的专业版.大家看文档吧,确实累了

 

2.5.3 挂载数据库

 

 

对   于    这    样    挂    载    数    据    库    请    大    家    参    考    这 个,http://www.liferay.com/web/guest/documentation/development/databases

 

 

2.5.4 starting Liferay

 

 

现在你有一个完整的开发环境,到前面单击Tomcat这个图标来启动你的web 服务.此时 在你的 portal 已经启动,你可以在浏览器中输入 http://localhost来查看运行效果!

 

 

3 关于翻译

 

 

liferay.cn  蚊子 MSN:wenbin151@hotmail.com欢迎大家关注中文 Liferay .因为本人水平有 限 ( 实际 还没 有通 过英 语四 级 ), 一些 文字 描述 是根 据我 的理 解写 的 . 也有 我同事 (flora:flora@hotmail.com)的帮助.我代表中文 Liferay 谢谢我的 partner:flora(MM).呵呵.Good luck!

牋 2005-08-31