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的另一个编译器:
现在你已 经详细指 定了这个 新的 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