Liferay Portal 是市场上适应应用服务环境最灵活的应用程序之一,Liferay Portal可以在在多节点的开源tomcat上面运行,也可以在商业环境中运行。现实中,Liferay也每天都被运行在这些环境上。
Liferay的部署选择相当灵活,也非常容易安装,假如你已经有一个应用服务器,可以利用应用服务器自身的部署工具轻松安装liferay。假如没有现成的服务器,Liferay也提供许多服务器bundles可以选择。简单的安装加简单的配置,就可以实现可投入应用的系统。
版本
Liferay有两个不同的版本,社区版本(CE)和商业版本(EE)。CE版本和前面几年Liferay的版本一样:快速、频繁的新特性更新,社区版本免费提供,采用GNU开源授权。该授权允许通过编码构建自己的portlet、theme,、hook、layout、Ext或者web plugins并在Liferay中使用。但是,如果你直接修改了liferay的代码,被修改过的内容需要贡献到该开源产品中,这有两个好处:其一你可以自由的使用你的代码做任何事,其二:Liferay也可以不断的得到提升和完善。EE版本是一个被支持的版本,具备坚固的安全性以及高可靠性,EE提供支持订阅和支持包,允许企业在一段教长时间内所提供稳定的版本上构建自己的企业门户。
由于EE版本的发布周期比CE版本长,每一个EE版本都拥有4年的支持时间。在整个订阅区间里,所有Liferay Portal的BUG修复都会反馈到你的版本中。Liferay Portal EE版本可以稳定的运行许多年,让企业可以在一个有成功案例并且稳定的平台上面构建自己的站点。另外,Liferay的专业服务团队为EE版本用户提供培训和咨询,为用户提供长期稳定的支持。
在我们的网站(http://www.liferay.com)上可以免费下到CE版本。点击位于页面顶端的Downloads 超链接,看到获取Liferay的多个选择,包括方便的bundles或者可以安装在你的应用服务器的.war包。
通过支持订阅获得Liferay EE版本,订阅后,将收到获得EE版本的bundle或者.war包的下载链接。
什么是一个bundle?bundle就是预安装了Liferay的开源应用服务(tomcat等)。Liferay提供多种bundles供下载。假如你还没有一个现成的应用服务,最好下载Tomcat bundle,因为Tomcat是最小、最容易配置的之一。当然,你也可以根据自己的喜好选择适合的bundles。所有的bundles都自带了一个Windows版的JRE;假如要在不同的操作系统中运行,需要在启动Liferay之前安装对应操作系统的JDK。
Liferay不提供像WebLogic或者WebSphere这些应用服务bundles,因为这些应用服务不是开源授权方式。但是Liferay Portal同样可以在这些应用服务上面运行良好,你可以通过.war包在这些应用服务上面安装Liferay。
采用手工方式安装,需要Liferay的.war包文件以及Liferay的依赖.jars。后续章节将详细介绍在目前的主流应用服务上面安装liferay的方法。
安装
不管在任何应用服务上,Liferay portal均包含相同的目录结构。顶层文件夹名称通常为Liferay发布名称,有时候名称也叫Liferay Home,如下图所示:
文件夹里面,有各种不同用处的文件夹。
Data:该文件夹存放Bundles用到的嵌入式HSQL数据库,Jackrabbit JSR-170内容库的数据和配置信息,Lucene搜索索引文件。
Deploy:将你要部署到Liferay的插件拷贝到这个文件夹,在控制面板中的Liferay图形插件安装程序也使用该文件夹。
License:包含liferay License和其他一些liferay内部用到的开源项目的License。
[Application Server]:同样也有一个应用服务器文件夹,根据你下载Bundle不同而不同,该文件夹包含安装Liferay的应用服务。
在大部分情况下,安装一个bundle只需要解压文件后运行应用服务即可。例如,在Tomcat上安装Liferay Protal,你只需要将Bundle解压到本地。
在Bin文件夹里面的一个脚步开源启动tomcat,通过命令行方式导航到该文件夹,在Windows环境下使用如下命令启动Tomcat:
Startup |
在Linux/Mac/Unix环境下:
此时,Liferay/Tomcat Bundle启动,假如你是在Windows环境下,Tomcat命令行控制台自动被打开。在Linux环境下,你可以通过以下脚本打开控制台:
tail -f ../logs/catalina.out |
Tomcat启动完成后,会自动打开浏览器并打开Liferay首页,假如没有,启动浏览器并在地址栏中输入:http://localhost:8080,既可以打开Liferay的默认首页。配置等信息存储在嵌入式数据库中,功能完整。现在,你马上可以浏览Liferay的各项功能。
Liferay默认包含一个名叫7 Cogs.的简单Web站点,你可以访问该站点,用不同的用户登录,熟悉和了解Liferay的功能。
安装其他bundle也应用类似步骤:解压bundle,启动应用服务器,在浏览器里面查看。
正如你看到的,应用bundle运行Liferay是最简单的方式。Buddle安装后,一个预配置的Liferay可以使用,可以立即浏览Liferay的各种功能。通过最小量的额外配置(后续章节描述),bundles既可以转换为一个完整的应用系统。
在服务器上安装Bundle 的Liferay Portal后,你会发现通过简单的重新配置既可以进行企业应用,这是最快、最简单让Liferay系统运行的方法。但是很多企业都已经构建了J2EE基础运行环境,常常需要根据自身情况进行Liferay个性化安装,bundle经常无法完全满足实际应用需求。本章剩余的大部分内容主要关注在已有应用服务上面安装Liferay。
Liferay CE版本提供很多示例数据帮助你了解Liferay可以做什么,其中7 Cogs是一个展示Liferay如何使用很好的例子。当你开始构建自己的站点时,不希望这些示例数据保留在数据库中。因此,在你连接Liferay到你的数据库之前,确保样例7 Cogs相关的数据已经被移除,移除数据与卸载已安装7 Cogs数据的应用程序一样简单。
在Bundle中只有一个应用程序需要被移除,它在Liferay启动时将7 Cogs的数据Copy到数据中。因为我们想要恢复Liferay到干净安装的默认状态,需要移除sevencogs-hook 应用程序。另外两个和7 Cogs相关的应用程序都是themes(主题),你可以根据需要选择移除或者保留。
假如在你连接真实数据库之前忘记卸载sevencogs-hook,示例数据将在数据库中创建,这样可能会引起一些小问题,特别是如果数据库中已有数据时。因此,在构建应用服务前,需要确保sevencogs-hook应用程序已经被卸载。采用应用服务自身的方法卸载应用程序以便移除相关示例数据。
Liferay Portal引用一个定义为Liferay Home的特殊文件夹,该文件夹比应用服务自身所在文件夹更高一层,这就是为什么Bundle将应用服务放在Bundle的根目录。
假如Liferay不能在该文件夹下面创建所需要的资源,或者发现自己运行在某个应用服务上,它将回退并在运行liferay的用户ID的主文件夹创建home文件夹。
正如在Bundles小结里面所描述的,Home文件夹对于Liferay操作来说非常重要。上述文件夹(数据,deploy和license)都将在该文件夹创建,同时,你也可以放置名叫portal-ext.properties的特殊文件在这里面。
该文件将在第六章:高级liferay配置中详细说明,在本章中,我们将用到部分基础配置,例如,与数据建立连接配置等。
1.4.3.1 缺省方法:自动
假如你创建了数据库并且将所有访问权限授予一个用户,Liferay可以用这个数据库用户自动创建索引以及表结构。推荐采用这种方法安装Liferay,采用自动方式构建,可以在升级或者安装需要构建表的插件时利用Lifeay的自动维护功能。这时迄今为止安装Liferay最好的方法。
假如你准备采用推荐方式安装Liferay,可以跳过下个小节。
1.4.3.2 手动创建
注意:这不是Liferay安装的推荐方式,本文为那些具有严格限制标准的企业提供一个Liferay安装的次优数据库设置方法。假如可能的话,Liferay推荐采用上文描述的自动方法安装。
虽然Liferay可以自动构建数据库文件,但一些企业不允许应用服务的数据库用户具备Liferay所必须的权限以及插件维护自己表的权限。在这些 组织,增、删、查、改等一般权限都是被控制的,因此,我们将介绍如何采用手工方式创建Liferay的数据库。假如你的企业愿意授权Liferay 用户创建和删除表操作权限,可以采用推荐方式安装,可以跳过本节内容。
另外提醒一点:Liferay有一个数据库自动更新的功能,当Liferay升级到一个新的版本时运行,假如数据库用户不具有创建/修改/删除 数据表的数据库权限,在首次运行Liferay更新程序前,需要将这些权限授予数据库用户。一旦更新完成后,可以将这些权限收回直到下一次更新。许多Liferay提供的插件需要在数据库中创建表,如果没有相应数据库操作权限,插件就不能被安装。假如想要安装这些插件,需要在安装前授予相应的数据库权限。
在Liferay的网站上面提供SQL脚本下载。CE版本脚本,可以在附加的文件章节下载页面下载。EE版本在提供的给你的特殊链接中下载。下载解压数据库脚本文件,你将看到几个不同类型的文件夹(full(完全),minimal(最小),upgrade(更新)),下一层有针对不同类型数据库的脚步。
最好用minimal脚本在开发、QA或者产品服务器上创建一个全新的Liferay。该脚本在数据库中创建Liferay必须的表结构以及最小量的配置信息,这是Liferay全新安装最合适的。
创建脚本,相比之下,将http://www.liferay.com的部分内容配置到Liferay数据库。对开发者视图非常有用,包含了许多Liferay功能应用的实例,包含内容管理系统。
在create或者create-minimal文件夹中包含了所有Liferay所支持数据库的脚本。DBA可以使用这些脚本创建数据库,构建性能优化的相关索引等。一旦创建成功,确保Liferay使用的数据库链接用户至少具备查看、插入、更新和删除权限,最好具备创建、删除表和索引的权限,具备这些权限可以使Liferay更新操作更容易。但针对表及索引操作的权限在Liferay的日常操作中不是必须的。
一旦DBA构建了数据库、提供相关访问认证,既可以开始2.4.4配置Bundle形成企业门户或者2.4.5在已存在的应用服务上手动安装liferay。
形成企业门户
Liferay Portal提供以下可选的Bundle(Servlet容器和完整的J2EE应用服务):
l Geronimo+Tomcat
l Glassfish 3
l JBoss
l Jetty
l JOnAS
l Resin
l Tomcat 6.0
通过我们提供的EE版本下载链接或者Liferay的下载页面(CE版本)选择合适的bundle下载,运行任何bundle的先决条件是在安装Liferay的机器上安装合适版本的JDK(1.5以上版本)。确保设置了JAVA_HOME环境指向JDK的安装地址。
解压bundle到你准备运行的地方,例如,在Window环境下你可以用D:/apps,在Linux或者Unix下用/opt,默认bundle安装Liferay Portal采用嵌入式数据库,是快速运行、快速评估或者开发的好办法,但是有以下一些缺点:
l 一次只能有一个用户访问,因为数据被存储在磁盘的文件里面,文件变化时将被HSQL锁住。
l 数据存储在Bundle里面,重新部署可能会丢失。
l 配置不稳定,在多个用户访问系统时会出现性能等方面的问题。
非常明显,你不会选择在嵌入式数据库中运行Liferay。幸运的是,Liferay支持许多稳定的数据库系统,同时非常容易通过Liferay的配置使用这些数据库系统,详细的操作过程依赖于具体的应用服务和数据库,但可以总结为以下几步:
1) 在特定的DBMS系统中创建数据库(见上节描述)。
2) 【可选】在应用服务中创建一个名叫jdbc/LiferayPool的数据源,数据源指向你的数据库并且具备合适的访问证书。
3) 【可选】在应用服务中创建一个名到mail/MailSession的邮件会话并指向邮件服务器,这样Liferay就可以发送邮件了。
4) 在Liferay Home文件夹中创建portal-ext.properties文件,该文件直接指向数据库和邮件会话或者指向应用服务的数据源和邮件会话。
5) 启动Liferay,Lifeay将自动创建数据库表并启动。否则,你必须首先运行合适的脚步准备数据库。
不同应用服务配置的相关细节请参考下面提到的手动安装相关说明。Liferay bundles和正常在我们网站上面有的针对不同应用服务的archives是没有什么区别的,除了Liferay bundles是预安装的,JVM相关设置根据Liferay进行了特殊优化。
1.4.4.1 portal-ext.properties文件
为了将Liferay Bundle指向你自己的数据库,在Liferay Home文件夹创建一个名叫portal-ext.properties的文件。该文件覆盖Liferay的默认属性设置。利用该文件将Liferay默认指向HSQL嵌入式数据库的配置覆盖。
可以采用两种方式创建连接:
l 采用应用服务的数据库连接池。
l 采用自建的数据库连接池。
假如想要使用应用服务的连接池,你必须在应用服务中创建一个名称为jdbc/LiferayPool并指向数据库的连接池,在portal-ext.properties文件中加入以下配置:
使用内建的C3P0连接池,针对不同数据库的配置模板将在第六章中描述,以下给出Mysql配置的模板示例:
# MySQL # jdbc.default.driverClassName=com.mysql.jdbc.Driver jdbc.default.url=jdbc:mysql://localhost/lportal? useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false jdbc.default.username= jdbc.default.password= |
需要为usrname和password提供访问的用户名和密码。
配置邮件和上述过程相同。同样有两种邮件配置方式:
l 采用应用服务的邮件会话。
l 采用自建的邮件会话。
采用应用服务的邮件会话配置,需要首先在应用服务中创建一个邮件会话并指向你的邮件服务器,创建完成后,在portal-ext.properties文件中增加如下配置:
To use the built-in mail session, add the following directives to your
portal-ext.properties file, substituting your mail server information:
应用内建邮件会话,在portal-ext.properties文件中加入以下配置内容,代替你的邮件服务器信息:
mail.session.mail.pop3.host=localhost mail.session.mail.pop3.password= mail.session.mail.pop3.port=110 mail.session.mail.pop3.user= mail.session.mail.smtp.auth=false mail.session.mail.smtp.host=localhost mail.session.mail.smtp.password= mail.session.mail.smtp.port=25 mail.session.mail.smtp.user= mail.session.mail.store.protocol=pop3 mail.session.mail.transport.protocol=smtp |
保存文件后,既可以启动你的应用服务。
本节详细描述使用WAR包安装Liferay Portal,通过这种方式允许管理员在已经存在的应用服务上面安装Liferay。如果你很清楚如何在应用服务上部署JAVA EE应用程序,推荐使用这种方式。
1.4.5.1 10步安装Liferay
在一个已存在的应用服务上面安装Liferay通常经历以下10个步骤:
1) 获得Liferay .war文件以及相关的依赖包。
2) 确保在应用服务的根目录(/)没有应用程序监听,如果有,移到其他位置或者将其卸载。
3) 确定是否采用应用服务容器连接池或是Liferay自带连接池,假如想要采用应用服务容器链接池,创建一个名称为jdbc/LiferayPool的连接池。
4) 确定是否采用应用服务容器邮件会话或者Liferay自带邮件会话,如果想要采用应用服务邮件会话,创建一个名称为mail/MailSession的邮件会话。
5) 关闭应用服务。
6) 提取依赖包到应用服务的全局类路径,这能够让Liferay和插件都能使用这些包。
7) 在Liferay Home文件夹中创建portal-ext.properties文件,在下面查看针对不同应用服务容器Liferay Home文件夹的位置。
8) 在文件中增加JNDI数据源名称或者JDBC参数以保证Liferay链接数据库。
9) 在文件中增加JNDI邮件源名称或者邮件参数以保证Liferay链接邮件服务器。
10) 启动应用服务,部署Liferay .war。
下面将针对Liferay所支持的特定应用服务进行说明。Liferay支持非常广泛的应用服务和数据库组合,因此,本节将假设数据库为MySQL,且数据库已经被创建,采用自建的应用服务邮件会话和数据源。如果要采用其他数据库,替代这里描述的MySQL的相关JDBC驱动和URL配置即可。
这里假设你的应用服务已经可以正常安装,假如还没有安装,请参考相关应用服务的安装文档进行应用服务安装。
这里同时假设在本机进行安装,当需要在远程服务器安装,将localhost替代为相应的远程服务器IP。
注意:Liferay5.x以上版本需要JDK1.5以上版本才能运行,不要尝试在运行JDK1.4或者更低版本的服务器上安装Liferay6.x版本系统,不能运行,假如你需要在运行JDK1.4或者更低版本的服务器上面安装Liferay,需要升级相关应用服务容器以便运行Liferay合适的版本。Liferay4.x可以再这些服务器上面运行良好。
记住,不管任何应用服务容器,在Liferay Home文件夹中创建portal-ext.-Properties文件,并确保相关配置指向数据库和邮件会话。
1.4.5.2 GlassFish 3.x安装
Liferay Home位于Glassfish根目录文件夹,我们假设你使用默认domain存在在[GlassFish
Root]/glassfish/domains/domain1。
1) 在启动GlassFish前,需要修改将被使用的域默认配置,增加默认内存分配总量,在域目录下有个config文件夹,打开其中的domain.xml文件。
2) 在大约166行为之,你将发现JVM设置如下:
<jvm-options>-Xmx512m</jvm-options> |
修改为
<jvm-options>-Xmx1024m</jvm-options> |
3) 增加如下配置内容:
<jvm-options>-XX:MaxPermSize=256m</jvm-options> |
保存并关闭该文件。
4) 在domain文件夹里面有一个叫docroot的文件夹,该文件夹里面有一个名称为index.html的默认页面,将其删除或者移动到其他地方。
5) 将liferay相关依赖包、JDBC驱动放在domain的lib文件夹里面。
l 数据库配置
管理数据源,使用以下配置说明,假如使用Liferay自建数据源,可以跳过本段。
1) 打开GlassFish 控制台:http://localhost:4848.
2) 在Other Tasks下,选择Create New JDBC Connection Pool。
3) 在第一个页面,将其命名为LiferayPool,资源类型为javax.sql.ConnectionPoolDataSource,选择MySQL做为数据库。点击next.
4) 在下一个页面,向下滚动到Additional Properties section,找到名叫URL的属性,设置值为:
jdbc:mysql://localhost/lportal?useUnicode=true&characterEncoding=UTF-8&emulateLocators=true |
5) 假如你的数据库和GlassFish不在同一个服务器上,将localhost替换为数据库所在的服务器IP地址。
6) 点击Add Property,增加一个名称为user的属性,并设置值为数据库连接用户名。
7) 点击Add Property,增加一个名称为password的属性,并设置值为数据库连接密码。
8) 点击Finish。
9) 现在,你将看到一个Connection Pools列表,点击LiferayPool上面的Ping测试连接,假如得到Ping Succeeded提示信息,表示数据库构建成功。
10) 点击JDBC Resources,将看到一个采用JNDI命名的JDBC Resources。
11) 点击New。
12) 将JNDI名称命名为jdbc/LiferayPool,选择先前创建的LiferayPool。
13) 点击OK。
假如使用GlassFish管理邮件会话,使用以下配置说明,假如使用Liferay自建邮件会话,可以跳过本段。
1) 在Resources下,点击JavaMail Sessions。
2) 点击New。
3) 将JavaMail session的JNDI名称命名为mail/MailSession,同时在表单的剩余部分填入描述邮件服务器的合适信息。
4) 点击OK。
l 部署Liferay
1) 创建portal-ext.properties文件,加入以下配置:
jdbc.default.driverClassName=com.mysql.jdbc.Driver jdbc.default.url=jdbc:mysql://localhost/lportal? useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false jdbc.default.username=root jdbc.default.password=root |
如果使用GlassFish提供的JNDI数据源,采用以下配置:
jdbc.default.jndi.name=jdbc/LiferayPool |
邮件会话采用相似配置,如果采用liferay自建邮件会话,采用以下配置:
mail.session.mail.pop3.host=localhost mail.session.mail.pop3.password= mail.session.mail.pop3.port=110 mail.session.mail.pop3.user= mail.session.mail.smtp.auth=false mail.session.mail.smtp.host=localhost mail.session.mail.smtp.password= mail.session.mail.smtp.port=25 mail.session.mail.smtp.user= mail.session.mail.store.protocol=pop3 mail.session.mail.transport.protocol=smtp |
如果使用GlassFish提供的邮件会话,采用以下配置:
mail.session.jndi.name=mail/MailSession |
保持并关闭该文件。
2) 打开GlassFish控制台:http://localhost:4848。
3) 点击左侧树中的Applications。
4) 点击Deploy按钮。
5) 在Packaged File to Be Uploaded to the Server下点击Choose File,浏览并选择Liferay .war。
6) 保持其他的选项为默认设置并点击OK。
Liferay将被部署并自动启动。
1.4.5.3 Jetty6
Liferay Home文件夹在Jetty安装路径的上层。
1) 下载安装jetty6。
2) 下载liferay的Portal.war文件。
3) 下载liferay的依赖类库。
4) 复制所有依赖类库到$JETTY_HOME/lib/ext目录下。
5) 编辑$JETTY_HOME/extra/etc/start-plus.config。
$(jetty.home)/lib/ext/ $(jetty.home)/lib/ext/* |
6) 编辑$JETTY_HOME/etc/jetty.xml,创建一个数据源绑定到jdbc/LiferayPool。
<Call name="addService"> <Arg> <New class="org.mortbay.jetty.plus.JotmService"> <Set name="Name">TransactionMgr</Set> <Call name="addDataSource"> <Arg>jdbc/LiferayPool</Arg> <Arg> <New class="org.enhydra.jdbc.standard.StandardXADataSource"> <Set name="DriverName">com.mysql.jdbc.Driver</Set> <Set name="Url">jdbc:mysql://localhost/lportal? useUnicode=true&characterEncoding=UTF-8</Set> <Set name="User"></Set> <Set name="Password"></Set> </New> </Arg> <Arg> <New class="org.enhydra.jdbc.pool.StandardXAPoolDataSource"> <Arg type="Integer">4</Arg> <Set name="MinSize">4</Set> <Set name="MaxSize">15</Set> </New> </Arg> </Call> </New> </Arg> </Call> |
7) 下载mysql-connector-java-${version}-bin.jar, 复制到$JETTY_HOME/lib/ext目录。这是MySQL的JDBC驱动。如果你想使用其他数据库,请拷贝其他驱动。
8) 编辑$JETTY_HOME/ect/jetty.xml文件,创建一个邮件会话绑定到mail/MailSession:
<Call name="addService"> <Arg> <New class="org.mortbay.jetty.plus.MailService"> <Set name="Name">MailService</Set> <Set name="JNDI">mail/MailSession</Set> <Put name="mail.smtp.host">localhost</Put> </New> </Arg> </Call> |
9) 创建$JETTY_HOME/ect/jass.config文件。
PortalRealm { com.liferay.portal.kernel.security.jaas.PortalLoginModule required; }; |
10) 创建目录$JETTY_HOME/webapps/root,然后解压缩liferay.war文件到这个目录。
11) 到文件夹$JETTY_HOME/webapps/root/WEB-INF/lib下删除xerces-Impl.jar和xml-apis.jar。
12) 复制$JETTY_HOME/webpaps/root/WEB-INF/lib/commons-logging.jar到$JETTY_HOME/ext目录(覆盖已经存在的)。
13) 创建一个批处理文件:run.bat。
@echo off if "" == "%JAVA_HOME%" goto errorJavaHome %JAVA_HOME%/bin/java -Xmx512m -Dfile.encoding=UTF8 -Duser.timezone=GMT -Djava.security.auth.login.config=../etc/jaas.config -DSTART=../extra/etc/start-plus.config -jar ../start.jar ../etc/jetty.xml goto end :errorJavaHome echo JAVA_HOME not defined. goto end :end |
注意:在启动Jetty时,如果你收到一个java.lang.OutOfMemoryError异常,则设置-Xmx1024m给你的JVM分配更多的内存。
使用run.bat启动jetty。打开浏览器访问http://localhost:8080。你应该就能看见默认的Liferay首页。
1.4.5.4 JBOSS 5.x
Liferay Home文件夹在JBoss安装路径的上层。
1) 下载并在合适位置安装JBoss AS 5.0.1 GA。这个目录将被通过$JBOOS_HOME引用。
2) 下载最新版本的Liferay Portal的war文件。
3) 下载mysql-connector-java-{$version}-bin.ja,并且复制到$JBOSS_HOME/server/default/lib/文件夹下。这是MySQL的JDBC驱动。可以更换使用你的数据库合适的驱动。
4) 下载liferay Portal依赖类库,并解压缩到$JBOSS_HOME/server/default/lib目录。
5) 编辑 $JBOSS_HOME/server/default/conf/login-config.xml文件配置JAAS,在115-131行注释策略other相关的XML。
<!--<application-policy name = "other">--> ... <!--<authentication> <login-module code = "org.jboss.security. auth.spi.UsersRolesLoginModule" flag = "required" /> </authentication> </application-policy>--> |
l 数据库配置
如果你想JBoss管理数据源,使用下面的操作。如果你想使用Liferay内置的数据源,你可以跳过这小节。
创建$JBOSS_HOME/server/default/deploy/liferay-ds.xml,并附加下面的内容:
<datasources> <local-tx-datasource> <jndi-name>jdbc/LiferayPool</jndi-name> <connection-url> jdbc:mysql://localhost/lportal? useUnicode=true&characterEncoding=UTF-8 </connection-url> <driver-class>com.mysql.jdbc.Driver</driver-class> <user-name></user-name> <password></password> <min-pool-size>0</min-pool-size> </local-tx-datasource> </datasources> |
l 邮件配置
如果你想使用JBoss管理你的邮件配置,使用下面的操作。如果你想使用liferay内置的,你可以跳过这小节。
使用下面的内容替换$JBOSS_HOME/server/default/deploy/mail-service.xml中的邮件相关属性:
<?xml version="1.0"?> <server> <mbean code="org.jboss.mail.MailService" name="jboss:service=MailSession"> <attribute name="JNDIName">mail/MailSession</attribute> <attribute name="User">nobody</attribute> <attribute name="Password">password</attribute> <attribute name="Configuration"> <configuration> <property name="mail.store.protocol" value="imap" /> <property name="mail.transport.protocol" value="smtp" /> <property name="mail.imap.host" value="localhost" /> <property name="mail.pop3.host" value="localhost" /> <property name="mail.smtp.host" value="localhost" /> </configuration> </attribute> </mbean> </server> |
l 部署Liferay
1) 删除$JBOSS_HOME/server/default/deploy/ROOT.war下的所有文件和文件夹。
2) 解压缩Liferay .war文件到ROOT.war目录下。
3) 从 $JBOSS_HOME/server/default/deploy/ROOT.war/WEB-INF/lib目录删除jaxen.jar,jaxrpc.jar,stax.jar,xercesImpl.jar和xml-apis.jar。
4) 浏览JBoss的那个Liferay Home文件夹。
5) 创建文件portal-ext.properties。增加下面的内容:
jdbc.default.driverClassName=com.mysql.jdbc.Driver jdbc.default.url=jdbc:mysql://localhost/lportal? useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false jdbc.default.username=root jdbc.default.password=root |
如果你使用JBoss数据源则增加JNDI名称替代:
jdbc.default.jndi.name=jdbc/LiferayPool |
使用相同的方法设置邮件Session。如果你使用内建的配置则设置下面的属性:
mail.session.mail.pop3.host=localhost mail.session.mail.pop3.password= mail.session.mail.pop3.port=110 mail.session.mail.pop3.user= mail.session.mail.smtp.auth=false mail.session.mail.smtp.host=localhost mail.session.mail.smtp.password= mail.session.mail.smtp.port=25 mail.session.mail.smtp.user= mail.session.mail.store.protocol=pop3 mail.session.mail.transport.protocol=smtp |
如果你使用JBoss邮件session则增加JNDI名称替代:
mail.session.jndi.name=mail/MailSession |
保存并关闭这个文件。
启动JBoss。使用浏览器访问http://localhost:8080。你应该就可以看到liferay的默认首页。
1.4.5.5 Resin3.1.x
Liferay Home文件夹在Resin安装路径的上层。
1) 下载并在合适位置安装Resin。这个目录将被通过$RESIN_HOME引用。
2) 编辑文件$RESIN_HOME/conf/resin.conf。使用下面的内容替换8-13行:
<class-loader> <tree-loader path="${resin.home}/lib"/> <tree-loader path="${server.root}/lib"/> <compiling-loader path="$ {server.rootDir}/common/classes"/> <library-loader path="${server.rootDir}/common/lib"/> </class-loader> |
再增加下面内容:
<database> <jndi-name>jdbc/LiferayPool</jndi-name> <driver type="com.mysql.jdbc.Driver"> <url>jdbc:mysql://localhost/lportal? useUnicode=true&characterEncoding=UTF-8</url> <user></user> <password></password> </driver> <prepared-statement-cache-size>8</prepared-statement-cache-size> <max-connections>20</max-connections> <max-idle-time>30s</max-idle-time> </database> <resource jndi-name="mail/MailSession" type="javax.mail.Session"> <init> <mail.store.protocol>imap</mail.store.protocol> <mail.transport.protocol>smtp</mail.transport.protocol> <mail.imap.host>localhost</mail.imap.host> <mail.pop3.host>localhost</mail.pop3.host> <mail.smtp.host>localhost</mail.smtp.host> </init> </resource> <system-property javax.xml.parsers.DocumentBuilderFactory="org.apache.xerces.jaxp.D ocumentBuilderFactoryImpl" /> <system-property javax.xml.parsers.SAXParserFactory="org.apache.xerces.jaxp.SAXParse rFactoryImpl" /> <system-property javax.xml.transform.TransformerFactory="org.apache.xalan.processor. TransformerFactoryImpl" /> <system-property org.xml.sax.driver="org.apache.xerces.parsers.SAXParser" /> |
3) 在$RESIN_HOME下创建一个新目录common/lib。下载mysql-connector-java-{$version}-bin.jar并复制到这个目录。这个是MySQL的JDBC驱动。如果你使用其他数据库,替换相对应的驱动。
4) 下载Liferay Portal的依赖类库,解压缩到$RES-IN_HOME/common/lib目录下。
5) 删除$RESIN_HOME/webapps/ROOT目录下的所有内容。
6) 解压缩liferay-portal-x.x.x.war到$RESIN_HOME/webapps/ROOT目录下。
7) 如果你使用Resin 3.1.9或更高本版,则删除$RES-IN_HOME/lib/portlet-01.jar文件。它包含旧的Portlet 1.0类文件。Portlet 2.0是向后兼容的,所以不会有任何影响。
8) 下一步,你将需要一个包含在Liferay portlet源代码发布包中的several .jar。许多应用服务器已经包含了这个文件到classpath,但是Resin没有。获取这个文件正确的版本的最好方法是下载Liferay源码发布包,从里面查找它。一旦你已经下载了Liferay源码发布包,解压缩到一个临时目录。
1. 到$LIFERAY_SOURCE/lib/development/目录复制activa-tion.jar和mail.jar到$RESIN_HOME/common/lib目录。复制sax-path.jar和xalan.jar到$RESIN_HOME/lib目录。
2. 到$LIFERAY_SOURCE/lib/portal目录复制xercesImpl.jar和xml-apis.jar到$RESIN_HOME/lib目录。
9) 为了启动服务器,打开一个命令提示符,并且浏览到$RES-IN_HOME目录下键入:
java -jar lib/resin.jar start |
10) 打开浏览器访问http://localhost:8080。你应该可以看到Liferay 默认的首页。
1.4.5.6 Resin3.2.x
Liferay Home文件夹在Tomcat安装路径的上层。
1. 下载并在合适位置安装Resin 3.2.1,安装Resin的路径用$RESIN_HOME代表。
2. 编辑$RESIN_HOME/conf/resin.conf,使用下面的内容替换9-13行:
<tree-loader path="${resin.home}/ext-lib"/> <tree-loader path="${resin.root}/ext-lib"/> <tree-loader path="${resin.home}/lib"/> <tree-loader path="${resin.root}/lib"/> <compiling-loader path="${server.rootDir}/common/classes"/> <library-loader path="${server.rootDir}/common/lib"/> |
3. 在resin.conf文件中搜索<jvm-arg>标签,替换下面的内容:
<jvm-arg>-Xmx256m</jvm-arg> <jvm-arg>-Xss1m</jvm-arg> <jvm-arg>-Dcom.sun.management.jmxremote</jvm-arg> <jvm-arg>-Xmx1024m</jvm-arg> <jvm-arg>-XX:MaxPermSize=256m</jvm-arg> <jvm-arg>-Dfile.encoding=UTF-8</jvm-arg> <jvm-arg>-Duser.timezone=GMT</jvm-arg> |
4. 到$RESIN_HOME目录下创建一个新目录common/lib。下载mysqlconnector-java-{$version}-bin.jar并复制到这个目录。这是MySQL的JDBC驱动,如果你使用其他数据库,替换对应的JDBC驱动文件。
5. 下载Liferay portal的依赖类库,并解压缩到$RES-IN_HOME/common/lib目录。
6. 删除$RESIN_HOME/webapps/ROOT目录下的所有文件和文件夹。
7. 解压缩liferay-portal-x.x.x.war到$RESIN_HOME/webapps/ROOT目录。
8. 下一步,你将需要一个包含在Liferay portlet源代码发布包中的several .jar。许多应用服务器已经包含了这个文件到classpath,但是Resin没有。获取这个文件正确的版本的最好方法是下载Liferay源码发布包,从里面查找它。一旦你已经下载了Liferay源码发布包,解压缩到一个临时目录。
1. 到$LIFERAY_SOURCE/lib/development目录复制saxpath.jar到$RESIN_HOME/common/lib
9. 为了启动服务器,打开一个命令提示符,并且浏览到$RESIN_HOME目录下键入:
java -jar lib/resin.jar start |
10. 打开浏览器访问http://localhost:8080。你应该可以看到Liferay 默认的首页。
1.4.5.7 Tomcat6.x
Liferay Home文件夹在Tomcat安装路径的上层。
1) 下载并在合适位置安装Tomcat 6.0.X,安装Tomcat的路径用$TOMCAT_HOME代表。
注意:针对JDK1.5用户:移动$TOMCAT_HOME/webapps/ROOT/WEBINF/lib/xercesImpl.jar到$TOMCAT_HOME/common/endorsed下,Liferay5.x以上版本不再支持JDK1.4。
2) 创建并编辑$TOMCAT_HOME/conf/Catalina/localhost/ROOT.xml,建立门户Web应用。
</Context> |
3) 下载liferay-portal-x.x.x.war。
4) 下载Liferay门户的相关依赖包,创建一个$TOMCAT_HOME/common/lib/ext目录,解压依赖包到该目录。如果文件没有放在这个目录,确保把他们移动到正确的位置。
5) 编辑$TOMCAT_HOME/conf/catalina.properties文件
${catalina.home}/classes,/ .../ ${catalina.home}/lib/ext/*.jar |
6) 确保数据库服务器已经安装并且运行正常。假如数据库服务安装在不同的机器上,请确保安装Liferay的机器能够访问到。
7) 为数据库配置数据源:获取相应数据库的JDBC驱动程序,确保Tomcat能够访问相关数据库JDBC驱动。在示例中,我们使用mysql- connector-java-{$version}-bin.jar,接下来,将JDBC驱动移到$TOMCAT_HOME/common/lib/ext文件夹。
8) 编辑$TOMCAT_HOME/conf/Catalina/localhost/ROOT.xml文件:
<Context> <Resource name="jdbc/LiferayPool" auth="Container" type="javax.sql.DataSource" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost/lportal? useUnicode=true&characterEncoding=UTF-8" username="" password="" maxActive="100" maxIdle="30" maxWait="10000" /> </Context> |
9) 在上述文件中合适的地方填入访问数据库的用户名和密码。
10) 创建邮件会话绑定到mail/MailSession,编辑HOME/conf/Catalina/localhost/ROOT.xml配置邮件会话。
<Resource name="mail/MailSession" auth="Container" type="javax.mail.Session" mail.transport.protocol="smtp" mail.smtp.host="localhost" mail.store.protocol="imap" mail.imap.host="localhost" /> </Context> |
11) 配置JAAS:编辑$TOMCAT_HOME/conf/Catalina/localhost/ROOT.xml,配置安全区域。
<Context...> <Realm className="org.apache.catalina.realm.JAASRealm" appName="PortalRealm" userClassNames="com.liferay.portal.security.jaas.PortalPrincipal" roleClassNames="com.liferay.portal.security.jaas.PortalRole" debug="99" useContextClassLoader="false" /> </Context> |
12) 创建$TOMCAT_HOME/conf/jaas.config文件:
PortalRealm { com.liferay.portal.kernel.security.jaas.PortalLoginModule required; }; |
13) 编辑$TOMCAT_HOME/bin/catalina.bat (Windows平台)或者
set JAVA_OPTS=-Xms128m -Xmx512m -Dfile.encoding=UTF8 -Duser.timezone=GMT -Djava.security.auth.login.config= %CATALINA_HOME%/conf/jaas.config |
14) 删除$TOMCAT_HOME/webapps/ROOT文件夹中的内容,卸载默认的Tomcat主页。
15) 解压liferay-portal-x.x.x.war 到 $TOMCAT_HOME/webapps/ROOT。
16) 为了支持UTF-8 URI编码,编辑$TOMCAT_HOME/conf/server.xml。
<Connector port="8080" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="UTF-8" /> |
17) 启动Tomcat,在浏览器中打开http://localhost:8080即可看见Liferay的默认首页。
1.4.5.8 WebLogic10
Liferay Home是安装Liferay的domain的主目录。
这些操作指示假设你已经配置好一个domain和一个server,并且可以进入WebLogic控制台。
依赖类库
1) 浏览你正在安装Liferay的domain的目录。在这个目录下有一个lib目录。解压缩Liferay的依赖类库到这个目录。
2) 复制你使用数据库对应的JDBC驱动到lib目录。
3) 部署Liferay时将会获得一个SAX解析错误,你将需要xercesImpl.jar文件。你可以从http://xerces.apache.org下载这个文件,复制这个文件到lib目录。
4) 在$WEB-LOGIC-HOME/jrockit90_150_04/jre/lib目录下创建一个endorsed文件夹,然后复制rhino.jar,serializer.jar和xalan.jar到这个目录。
l 数据库配置
如果你想WebLogic管理你的数据源,使用下面指令。如果你使用Liferay内置的数据源,你可以跳过这小节。
1. 进入你的WebLogic控制台,点击页面左边domain结构树上的Lock&Edit按钮。
2. 在左边的domain结构树上选择Data Sources。再点击屏幕右边的New按钮。
3. 给数据源一个名称,例如LiferayDataSource。
4. 定义一个JNDI名称jdbc/LiferayPool。
5. 选择你的数据库类型和驱动类,然后点击Next按钮。
6. 点击Next按钮接受下一个屏幕的默认设置。
7. 在下一个屏幕,输入你的数据库名称,主机名称,数据库用户名和密码。如果你使用默认设置,那么你应该使用lportal,localhost,root和空密码。点击Next按钮。
8. 下一个屏幕允许你测试数据库配置。点击Test Connection按钮。如果测试成功,说明你的数据库配置正确。勾选上你想部署这个数据源到的服务器(默认是AdminServer)。点击Finish按钮。
9. 点击左边domain结构树上的Activate Changes按钮。
l 邮件配置
如果你想WebLogic管理你的邮件会话,使用下面的指令。如果你想使用Liferay内置的邮件会话,你可以跳过这小节。
1. 在domain结构树上选择Mail Sessions。再点击Lock&Edit按钮启用修改这些设置。
2. 点击屏幕右边的New按钮。
3. 给这个邮件会话一个名称,例如:LiferayMail。
4. 从列表中点击选择你新建的LiferayMail会话。
5. 在出现的屏幕定义一个JNDI名称mail/MailSession。点击Save按钮。
6. 点击Targets标签页。勾选上你想部署这个邮件会话到的服务器(默认是AdminServer)。
l 部署Liferay
1. 在屏幕左边的domain结构树上点击Deployments。
2. 点击domain结构树的Lock&Edit按钮。
3. 点击屏幕右边的Install按钮。
4. 点击Upload your file(s)链接。
5. 浏览你保存Liferay .war文件的目录,选择他,并点击Next按钮。
6. 从列表中选择那个Liferay .war文件,点击Next按钮。
7. 保留Install this deployment as an application的勾选状态,点击Next按钮。
8. 给应用起一个名称(直接使用默认名称也可以)。保留默认的勾选状态,点击Finish按钮。
9. WebLogic现在将部署Liferay。当部署完成时,将显示一个摘要页面。点击左边domain结构树的Activate Changes链接。
10. 在Liferay Home目录创建一个portal-ext.properties。如果你使用Liferay内置的数据源,增加数据库设置:
jdbc.default.driverClassName=com.mysql.jdbc.Driver jdbc.default.url=jdbc:mysql://localhost/lportal? useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false jdbc.default.username=root jdbc.default.password=root |
如果你使用WebLogic的数据源,则增加JNDI名称替代:
jdbc.default.jndi.name=jdbc/LiferayPool |
使用相同的方法设置邮件会话。如果你使用内置配置,设置下面的属性:
mail.session.mail.pop3.host=localhost mail.session.mail.pop3.password= mail.session.mail.pop3.port=110 mail.session.mail.pop3.user= mail.session.mail.smtp.auth=false mail.session.mail.smtp.host=localhost mail.session.mail.smtp.password= mail.session.mail.smtp.port=25 mail.session.mail.smtp.user= mail.session.mail.store.protocol=pop3 mail.session.mail.transport.protocol=smtp |
如果你使用WebLogic的邮件会话,则增加JNDI名称替代:
mail.session.jndi.name=mail/MailSession |
11. 在Deployment屏幕,选择Liferay应用,点击Start按钮。在弹出窗口中选择Servicing All Requests。
12. 在下一屏幕点击Yes按钮继续。
Liferay将启动。你可以浏览http://<server name>:7001访问。如果你的浏览器和你安装Liferay的是同一台机器,URL是 http://localhost:7001 。
1.4.5.9 Oracle WebLogic 10.3
如果你还有一个mainWebApp模块已安装,你需要先卸载它。
复制所有依赖类库.jar文件和JDBC驱动到domain/lib目录。
启动WebLogic。
l 数据库配置
如果你想WebLogic管理你的数据源,使用下面的指示。如果你使用Liferay内置的数据源,你可以跳过这小节。
1) 选择JDBC->Data sources。点击New按钮。
2) 给你的数据源一个名称,比如:Liferay Data Source。JNDI名称应该是Liferay Data Source。
3) 选择数据库类型。
4) 点击Next按钮两次。你应该在Connection Properties页面。输入数据库名称,主机名称,端口号,数据库用户名和密码。WebLogic将使用这个信息构建一个相应的JDBC URL连接你的数据库。点击NEXT按钮。
5) WebLogic将让你确认获得的信息。对于MySQL,一些附加的参数需要被加到JDBC URL。有参数时应该这样修改JDBC URL:
jdbc:mysql://localhost/lportal? useUnicode=true&characterEncoding=UTF-8& / useFastDateParsing=false |
6) 点击Test Configuration按钮确保WebLogic能成功地连接你的数据库。如果可以,点击Finish按钮。
7) 你需要返回数据源列表。注意你的新建的数据源在Target列应该没有值。点击你的数据源编辑它。
8) 点击Targets标签页,勾选你想部署你的数据源的服务器实例,然后点击Save按钮。
l 邮件配置
1. 选择Mail Sessions,创建一个新的邮件会话指向你的邮件服务器。
2. 给他一个名称Liferay Mail,给他一个JNDI名称mail/MailSession,然后点击Next按钮。
3. 选择你的服务器,然后点击Finish按钮。
l 部署Liferay
1. 在Liferay Home目录创建一个portal-ext.properties文件。如果你使用Liferay内置的数据源,增加数据库设置:
jdbc.default.driverClassName=com.mysql.jdbc.Driver jdbc.default.url=jdbc:mysql://localhost/lportal? useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false jdbc.default.username=root jdbc.default.password=root |
如果你使用WebLogic的数据源,增加JNDI名称替代:
jdbc.default.jndi.name=jdbc/LiferayPool |
使用相同的方法配置邮件会话。如果你的使用内置配置,设置下面的属性:
mail.session.mail.pop3.host=localhost mail.session.mail.pop3.password= mail.session.mail.pop3.port=110 mail.session.mail.pop3.user= mail.session.mail.smtp.auth=false mail.session.mail.smtp.host=localhost mail.session.mail.smtp.password= mail.session.mail.smtp.port=25 mail.session.mail.smtp.user= mail.session.mail.store.protocol=pop3 mail.session.mail.transport.protocol=smtp |
如果你使用WebLogic的邮件会话,增加JNDI名称替代:
mail.session.jndi.name=mail/MailSession |
保存并且关闭文件。
2. 增加下面的内容到server.xml文件:
<library-ref> <library-name>jsf</library-name> <specification-version>1.2</specification-version> <implementation-version>1.2</implementation-version> <exact-match>false</exact-match> </library-ref> |
3. 选择Deployments链接,点击Install按钮。从WebLogic的公共文件目录上传jsf-1.2.war,并勾选Install this deployment as a library。
4. 安装JSF类库后,返回deployments页面,从文件系统选择Liferay的.war文件或者点击Upload Your File(s)链接上传他,再点击Next按钮。
5. 勾选Install this deployment as an application,点击Next按钮。
6. 如果默认名称是和你的安装匹配的则保留它。否则,给他一个你选择的名称。点击Next按钮。
7. 点击Finish按钮。当部署完成,点击Save按钮。
提示:完成Liferay安装后,你也许会看见一个Web Proxy portlet的初始化错误。因为XSL解析器默认配置使用的weblogic不能编译这个portlet的一个样式,Liferay默认是被禁用的。为了重新启用这个portlet,从Liferay.war中解压缩xalan.jar和serializer.jar,并复制它们到你的JDK的类库文件夹。如果你使用JRockit,这个目录应该是[BeaHome]/jrockit_160_05/jre/lib/ext。 |
1.4.5.10 WebSphere6.1
提示:在安装和配置过程中,WebSphere将提示你点击Save按钮应用修改到主配置。所有应该经常保存你的修改。 |
Liferay Home是在当前运行WebSphere的用户的home目录下一个名叫liferay的文件夹。
l 安装
1) 下载Liferay Portal WAR文件。
2) 下载并解压缩这些Liferay的.jar文件到 web-sphere/appserver/lib/ext目录。
u Liferay Portal依赖类库
u 你的数据库的JDBC驱动.jar文件
u 当前你也需要从Liferay的依赖类库中复制portlet.jar到 Web-Sphere/AppServer/java/jre/lib/ext文件夹,WebSphere已经包含一个更旧版本的portlet.jar,必须在最高级别的classpath里覆盖它。这个问题也许会在将来的发布版本中解决;可以到Liferay的wiki上检查这个问题的更新。
l 数据库配置
1) 启动WebSphere。
2) 打开Administrative控制台并登陆。
3) 点击Resources,点击JDBC Providers。
4) 点击New按钮。
5) 在name中输入JDBC 提供商的名称(例如:MySQL JDBC Provider)。
6) 在Implementation class name中输入你数据库驱动的连接池数据源的实现类名。对于MySQL,输入:
com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource |
7) 点击Next按钮。
8) 清除class path中的文字。因为你已经复制必须的.jar文件到你的服务器的classpath。
9) 点击Next按钮。
10) 点击Finish按钮。
11) 点击Additional Properties下的Data Sources。
12) 点击New按钮。
13) 输入一个名称:liferaydatabasesource.
14) 输入JNDI:jdbc/LiferayPool。
15) 其他的都保留默认值。
16) 点击Next按钮。
17) 在Additional Properties下点击Custom Properties。
18) 点击Next按钮。
19) 参照下面的表格的每行输入Name,Value并点击OK创建三个自定义的属性。
Name | Value |
1.user | root |
2.serverName | localhost |
3.databaseName | lportal |
20) 点击Data Sources -> Test Connection测试连接。
l 邮件配置
1) 点击Resources -> Mail Providers。
2) 点击Built-in Mail Provider。
3) 点击Mail Sessions。
4) 点击New。
a) Name: liferaymail
b) JNDI Name: mail/MailSession
5) 点击OK按钮。
6) 点击Security。
7) 点击Secure administration,applications和infrastructure。
8) 选择启用application security。
9) 取消勾选Use Java 2 security to restrict application access to local resources。
l 安装Liferay
1) 点击Applications -> Install new applications。
2) 浏览到liferay-portal-x.x.x.war文件。
3) 在context root中输入/。
4) 点击Next按钮。1到3步都点击Next按钮应用默认设置。
5) 选择邮件会话和数据源,然后点击Next按钮。
6) 指定一个你想运行Liferay的虚拟主机。
7) 在Summary页面,点击Finish按钮。
8) 等待安装进程的完成。
9) 点击System administration and Save Changes to Master Repository保存这个配置到主配置。
10) 在Liferay Home目录创建一个portal-ext.properties文件。对于WebSphere,这是一个在运行WebSphere用户的home目录下一个名叫liferay的目录。如果你使用Liferay内置的数据源,则增加数据库设置:
jdbc.default.driverClassName=com.mysql.jdbc.Driver jdbc.default.url=jdbc:mysql://localhost/lportal? useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false jdbc.default.username=root jdbc.default.password=root |
如果你使用WebSphere的前面创建的数据源,则增加JNDI名称替代:
jdbc.default.jndi.name=jdbc/LiferayPool |
使用相同的方法配置邮件会话。如果你使用内置的配置,则设置下面的属性:
mail.session.mail.pop3.host=localhost mail.session.mail.pop3.password= mail.session.mail.pop3.port=110 mail.session.mail.pop3.user= mail.session.mail.smtp.auth=false mail.session.mail.smtp.host=localhost mail.session.mail.smtp.password= mail.session.mail.smtp.port=25 mail.session.mail.smtp.user= mail.session.mail.store.protocol=pop3 mail.session.mail.transport.protocol=smtp |
如果你使用WebSphere的邮件会话,则增加JNDI名称替代:
mail.session.jndi.name=mail/MailSession |
保存并关闭这个文件。
l 启动Liferay Portal
1) 选择Applications.。
2) 点击Enterprise Applications。
3) 卸载 DefaultApplication,PlantsByWebSphere和SamplesGallery。
4) 选择liferay-portal.war,点击Start按钮。
5) 打开浏览器,访问http://localhost:9080。将显示默认的Liferay首页。
1.4.5.11 WebSphere7.0
Liferay Home是在当前运行WebSphere的用户的home目录下一个名叫liferay的文件夹。
1) 下载Liferay Portal的WAR文件。
2) 下载解压缩Liferay的jars文件到web-sphere/appserver/lib/ext目录下。
a) LiferayPortal依赖类库文件
b) 你的数据库的JDBC驱动
l 数据库配置
如果你想使用WebSphere管理你的数据库连接,则参照下面的指示。
1) 启动WebSphere。
2) 打开Administrative控制台并登陆。
3) 点击Resources → JDBC Providers。
4) 点击New按钮。
5) 在name字段输入JDBC提供商的名称(例如:MySQL JDBC Provider)。
6) 在Implementation class name字段输入:
com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource |
7) 点击Next按钮。
8) 清除class path字段的文本。因为你已经复制必须的.jar文件到服务器的classpath。
9) 点击Next按钮。
10) 点击Finish按钮。
11) 点击Additional Properties下的Data Sources。
12) 点击New按钮。
13) 输入一个名称:liferaydatabasesource。
14) 输入JNDI名称:jdbc/LiferayPool。
15) 其他的保留默认设置。保存数据源。
16) 完成后,返回data source页面,点击Custom Properties,然后点击Show Filter Function按钮。这是New和Delete按钮下的倒数第二个小图标。
17) 在search terms中键入user,点击Go按钮。
18) 选择user属性,给他设置你的数据库用户名。点击OK按钮并保存到主配置。
19) 搜索过滤url属性。给他设置指向你的数据库的JDBC URL。例如:MySQL URL应该是:jdbc:mysql://localhost/lportal?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false。点击OK按钮并保存到主配置。
20) 搜索过滤password属性。输入之前数据库用户对应的密码。点击OK按钮并保存到主配置。
21) 在浏览足迹条上点击返回data source页面。点击Test Connection按钮。它应该可以连接成功。
l 邮件配置
1) 点击Resources -> Mail -> Mail Providers。
2) 为你服务器点击Built-In Mail Provider。
3) 点击Mail Sessions,再点击New按钮。
4) 设置 name为liferaymail,JNDI name为 mail/MailSession。点击OK按钮并保存到主配置。
5) 点击Security -> Global Security, 取消选择Use Java 2 security to restrict application access to local resources。点击Apply按钮。
l 安装Liferay
1) 点击Applications -> New Application -> New Enterprise Application。
2) 浏览到那个Liferay.war文件,点击Next按钮。
3) 保留选项Fast Path选中,点击两次Next按钮。
4) 确保你的服务器是选中的,点击Next按扭。
5) 保持context root设置/,点击Next按钮。
6) 点击Finish按钮。当Liferay安装完成,点击Save to Master Configuration按钮。
l 启动Liferay
1) 在Liferay Home目录创建一个portal-ext.properties文件。对于WebSphere,这是一个在运行WebSphere用户的home目录下一个名叫liferay的目录。如果你使用Liferay内置的数据源,则增加数据库设置:
jdbc.default.driverClassName=com.mysql.jdbc.Driver jdbc.default.url=jdbc:mysql://localhost/lportal? useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false jdbc.default.username=root jdbc.default.password=root |
如果你使用WebSphere的前面创建的数据源,则增加JNDI名称替代:
jdbc.default.jndi.name=jdbc/LiferayPool |
2) 使用相同的方法配置邮件会话。如果你使用内置的配置,则设置下面的属性:
mail.session.mail.pop3.host=localhost mail.session.mail.pop3.password= mail.session.mail.pop3.port=110 mail.session.mail.pop3.user= mail.session.mail.smtp.auth=false mail.session.mail.smtp.host=localhost mail.session.mail.smtp.password= mail.session.mail.smtp.port=25 mail.session.mail.smtp.user= mail.session.mail.store.protocol=pop3 mail.session.mail.transport.protocol=smtp |
如果你使用WebSphere的邮件会话,则增加JNDI名称替代:
mail.session.jndi.name=mail/MailSession |
3) 保存并关闭这个文件。
4) 点击Application Types -> WebSphere Enterprise Application。
5) 卸载default应用。
6) 选择Liferay应用,点击Start按钮。
应用程序同时使用
Liferay Portal默认的配置位置在应用服务的根目录(例如:/)。应用服务单独运行Liferay Portal是一个很好的做法,让WEB 应用与Portal环境分离。Liferay定义为应用在自己的开发平台,这种方式通常是门户的最佳实践。因为这个原因,Liferay实例可以作为许多应用程序的主应用,可以轻松的将许多应用程序整合致一个页面,因此,你需要确保Portal环境具备进行整合所需要的所有资源,将Liferay配置为其他部署在应用服务中的.war文件的唯一消费者,这样可以确保系统运行时最佳状态。
Liferay当然也不会阻止你在应用服务中将Liferay与其他应用程序分享空间,在这种情况下,不能将Liferay作为应用服务的root context默认应用程序。需要通过以下两步进行修改:
1) 在不是ROOT的上下文中部署Liferay(例如:/portal)。
2) 修改portal-ext.properties,告诉Liferay部署的context。
改变文件,在文本编辑器中打开,将portal.ctx放在文件的顶端:
portal.ctx=/ |
以上默认配置定义Liferay Portal作为位于root context的应用程序,假如将其改变为其他,例如/portal,Liferay将会部署到指定的context而不是默认的root context。
针对portal-ext.properties的完整讨论将在第六章进行。
Weblogic用户注意:WebLogic也需要修改Liferay中所包含的weblogic.xml。在weblogic.xml文件中定义context root如下:
<context-root>/</context-root> |
将该定义修改为与portal-ext.-properties文件一致,你必须修改在Liferay.war中的weblogic.xml,将其从.war中取出,修改完成后重新放入.war文件。然后将liferay.war部署到服务器上合适的context。
本章主要介绍Liferay的安装过程,介绍了使用 Liferay bundle或者在一个已有应用服务上面的安装、运行方法,Liferay Portal可无缝的整合到你的企业级JAVA环境中。比其他的portal平台支持更多的应用服务容器,可以节省在应用服务容器选择方面的投资,提升切换不同应用服务容器平台的自由度。我们拥有100测试服务器验证我们的build,针对每个版本大约有超过1000个测试用例。每一个测试用例都必须在我们所支持的应用服务、数据库、操作系统组合中运行通过。因此你可以确信我们可以支持你所选择的环境,你可以自由的选择适合企业的软件平台,Liferay都能在上面运行良好。