Liferay全局配置（二）

一、 客户化字段

客户化字段是在门户中添加属性到许多类型集合中的一种方法。例如，如果你使用Liferay创建了一个书籍评级站点，你可以在门户中增加客户化字段到许多集合中，例如可以在User对象中增加Favorite Books（最爱书籍）字段。如果你使用wiki实现书籍评价，你可以增加Book Title（书名）和Book Author（作者）等客户化字段。

增加客户化字段非常简单，在控制面板中点击Custom Fields链接，点击Edit，选择Add Custom Field。

在这里增加客户化字段key，key将作为表单中域的标签。对于一些portal集合（例如user）,客户化字段在表单中是一个独立的部分。另外的一些，客户化字段与默认字段整合在一个表单中。开发人员可以通过<liferay-ui:custom-attribute />访问客户化字段。

你可以创建多种不同类型的字段：text fields(索引或者保密的)，integers（整型），selection of multiple values（多选菜单）等等。字段创建后不能更改其类型。

二、 监控（Monitoring）

控制面板左边的下一个链接是monitoring，使用该功能，你可以看到门户当前所有活动的sessions（会话）。出于性能考虑，在产品中通常将该功能设置为关闭状态，但是如果启用了该功能，可以在这里看到所有的活动会话。

三、 插件配置

Plugins Configuration链接包含三种类型插件标签：portlets, themes（主题）, layouts（布局），通过这些标签，你可以看到那些角色有权限增加插件到页面，也可以设置插件的活动或非活动状态。

注意这里只是基本的配置：如果你想查询给定portlet存在的权限配置或者修改已存在角色的权限配置，可以再这里操作，但是如果需要为一个新角色增加给定portlet的权限，使用控制面板中的角色部分的Actions → Define Permissions按钮。

四、 页面模板

Page Templates链接允许你创建一个可以复用的模板页面，该页面包含需要的布局、portlet和web内容。这里同时也可以编辑已存在的模板或者修改权限。

增加一个页面模板，选择Add，输入模板的名称和描述，在描述字段下面确定该模板的活动或者非活动状态，再下面的链接可以打开模板进行编辑。上图所示的模板是一个大学门户中返校生使用的页面。点击Open Page Template链接打开Manage Pages接口，Manage Pages接口在下一章中描述。

在页面中完成增加内容、layout和portlets后，返回Page Template portlet（在浏览器的另外一个标签）点击Save按钮。

在站点中使用模板创建一个新页面是很简单的，导航到Control Panel → Pages，在增加一个页面时，新建的模板将出现在模板下拉菜单中。

五、 站点模板

Site Templates链接允许你定义一组预定义的页面，当为组织或者社区创建新站点时使用。你可以定义和编辑站点模板和它的权限。

增加一个站点模板，在控制面板中点击Site Template链接，选择Add，输入模板的名称和描述信息，在描述信息下面可以将该模板设置为活动或者非活动状态。

结束后，点击Actions → Manage Pages，这里可以为模板增加页面，通过管理主题与CSS文件配置展现，导出.lar模板文件。同时，在这里也可以导入一个.lar模板文件。

在为模板创建的页面上，你可以增加想要的porlet和内容，完成后，你可以再创建新社区时使用这些模板。在增加社区时，将出现模板的下拉菜单。

六、 服务器管理

Server Administration链接可以对整个portal服务器进行多项任务管理，与portal资源管理截然相反，点击该链接既可以清晰的看到大量信息：即刻可以看到一个目前JVM可用资源的情况图表。

(一) 资源（Resources）

第一个标签页是Resources，该标签涵盖上述提到的图表以及许多管理可以执行的服务器级别操作，包含以下内容：

Garbage collection：向JVM发送垃圾收集请求。

Clearing VM caches：向JVM发送清除单个VM缓存请求。

Clearing caches across the cluster：向JVM发送清除整个集群内容缓存请求。

Clearing database caches：向JVM发送清除数据库缓存请求。

Reindex all search indexes：发送重新生成所有搜索索引请求，如果你没有使用Solr搜索服务器（查看第七章了解更多信息），这非常影响portal性能，因此，不要轻易执行除非没有用户访问的时间。

Generate Thread Dump：如果执行测试工作，你能够产生一个线程dump文件，该dump文件检查是否有死锁或者什么地方可能有死锁。

Verify database tables of all plugins：检查所有数据库表准确对应他们索引。

(二) 日志级别

在这里可以动态的为门户中任何层次的类修改日志级别。如果你有客户化的代码已经部署但不在该列表中，可以使用Add Category增加。如果你修改了类层次顶级的日志级别（例如com.liferay）,所有继承该层次的类日志级别也被更改。如果测试特定的东西，类级别层次越明确越好级别去修改日志级别。如果修改的类继承层次太高，会产生很多不必要的信息。

(三) 性能

Liferay和JVM包含很多在属性文件中定义的设置，这里有两个标签：一个现实系统属性，一个显示portal属性。

system properties（系统属性）显示详细的JVM及Liferay的系统属性列表。这些信息可以在调试或者检查当前运行的portal的设置中使用。

portal properties（portal属性）显示详细的portal属性列表，这些属性可以进行客户化设置，这块将在下一章中详细描述。如果想检查某个属性的当前值，通过该功能可以在不关闭portal或者不打开任何属性文件的情况下查看。

(四) 验证码

默认情况下，Liferay提供简单的验证码服务，通过验证码可以防止恶意注册。你也可以使用google的reCaptcha服务替换默认验证码服务。

设置很简单，启用ReCaptcha，在提供的文本框中输入你的公共和私有keys，点击Save。此时，Liferay将使用reCaptcha代替简单的验证码。

(五) 数据迁移

如果你正在升级Liferay版本或者需要整合两个系统数据，本节介绍如何在不编写任何客户化代码的情况下完成升级或者数据迁移工作。

第一部分，可以从当前正在运行的数据库中拷贝整个Liferay数据库到指定的数据库字段集合。你需要输入驱动名称（驱动必须位于liferay得classpath中），被拷贝数据库的JDBC URL，访问该数据库得用户名、密码，输入完成后，点击Execute拷贝数据。

下一部分实现文档整合，如果想脱离Jackrabbit JSR-170存储库到文件系统中，或者从文件系统中形成Jackrabbit JSR-170存储库，或者形成其他文档库支持的存储库，这是非常简单的。在合并运行前，确保已经在portal-ext.properties建立了合适的钩子（hook）。在想文档整合的地方选择代表它的Document Library hook，点击Execute。你的文档将被整合到新的存储库中，此时，你可以关闭Liferay，在portal-ext.properties修改默认为新的存储库，运行Liferay。

采用同样的方式可以从图片库中整合图片。

(六) 文件上传

既然Liferay在许多地方允许用户上传文件，你可能需要限定用户上传文件的类型和大小。在这里，你可以为全局设置允许上传文件的最大尺寸，针对特定的应用覆盖该设置。也可以限制允许上传的文件扩展。这些都可以进行灵活设置。

(七) 邮件

与在前面章节中使用portal-ext.properties配置邮件的方式不同，你也可以再这里配置邮件服务器。假如门户是接受邮件（查看第五章中的Message Boards portlet），你可以连接一个POP邮件服务器。当然，portal也应该能发送邮件（发送通知给用户），你可以连接一个SMTP服务器，强烈推荐。

注意，如果在这里增加了邮件服务器设置，将覆盖portal-ext.properties中的设置。

(八) OpenOffice

Liferay提供用户多种创建内容的格式：web content（Web内容）, images（图片）以及files（文件），这些都通过内容管理系统实现，有时候，将不管什么格式的内容转换为一个非常方便用户浏览的内容非常有用，Liferay portal允许用户通过整合OpenOffice.org实现。

OpenOffice.org是一个开源的office套件，通常以图形界面模式创建文档，但是OpenOffice可以使用“服务器”模式运行，当以服务器模式运行时，OpenOffice.org能够用来与它所支持类型的文档相互转换。Liferay可以使用该功能在联机情况下进行自动内容转换。

使用该标签告诉Liferay如何连接正在运行的OpenOffice.org实例，你可以将OpenOffice.org与Liferay安装在同一个服务器上，安装完成后，你可以使用以下命令启动OpenOffice.org的服务器模式：

soffice -headless -accept="socket,host=127.0.0.1,port=8100;urp;" -nofirststartwizard

正如你看到的，以上命令行指定OpenOffice.org的使用端口8100运行，这是控制面板中的默认端口。如果使用该端口，你需要做的只是勾选启用框，既完成Liferay与OpenOffice.org的整合。

如果有其他内容已经占用了8100端口，找到一个空闲的端口，更改命令行与控制面板中的相应端口，结束后，点击Save。

(九) 脚本

Liferay包含一个脚步控制台，管理员可以在这个地方执行迁移或管理任务代码。支持许多种脚步语言，包含JavaScript, Groovy, Python, Ruby, 以及Beanshell。更多详细内容查看Liferay API文档，http://wiki.liferay.com或者Liferay in Action。

(十) 关闭（Shut Down）

如果在有用户已经登录的情况下需要关闭Liferay Portal服务器，你可以使用Shutdown标签通知已登录用户Portal即将关闭。你可以定义门户即将执行关闭的时间，该时间将显示给已登录用户。

用户将在他们的页面顶端看到你所设置的持续时间。当时间过期后，所有的portal页面将显示the portal has been shut down信息。这个世界，服务器将重启并恢复访问。

七、 Portal实例

Liferay门户允许你在单个服务器上面运行多个Portal实例，各Portal实例的数据相互独立。然而，所有的portal数据，都保存在相同的数据库中。

每个portal都需要一个自己的域名，Liferay将使用各个门户实例的域名引导用户访问。因此，在配置一个实例前，首先在网路上配置该实例的域名。如果这些已经准备好了，点击这里的Add按钮。这里有三个字段：

Web ID：通常情况下与域名相同，表示该实例的user-generated ID。

Virtual Host：输入你在网络上配置的域名，当用户使用该域名访问Liferay服务器，Liferay既可以将他们发送到合适的Portal实例。

Mail Domain：输入该Portal实例使用的邮件主机。Liferay将使用该邮件主机发送email通知。

当表单填写完成后，点击Save，在浏览器中用新域名打开，既可以看到一个跟干净安装一样的Liferay。新的Portal实例可以根据你的需求进行配置。

八、 插件安装

打开Plugins Installation链接，看到所有目前已安装的插件，有以下几个标签分类portlets, themes, layout templates,Hook plugins, Web plugins。如果要安装一个新的插件，点击Install More Portlets按钮，打开Liferay的Plugin Installer，在这里可以浏览Liferay的portlets库或者安装你自己的portlet，插件安装将在第6章中描述。

九、 总结

本章描述了Liferay Portal中可以为你的站点进行基础配置的相关资源，了解如何通过Liferay用户接口在portal中导航，我们同样了解了portal的整个架构以及如何使用Liferay设计站点。

接下来，我们深入了解了Liferay的控制面板，使用控制面板，我们学会了如何管理用户、组织，用户组和角色。我们同样学习了相关的服务器配置，例如认证、LDAP整合以及单点登录。我们也学会了配置默认关联用户的用户组、社区以及角色。同时，我们也看到了如何设置保留的昵称以及邮件地址。

接下来，我们看到如何查看和配置整个服务器的设置，了解了如何查看当前服务器的内存使用情况，执行垃圾收集，线程dump，搜索索引重新生成，清除缓存等内容。学习了如何通过修改日志级别以及查看门户中定义的熟悉进行portal中的部分内容调试。

最后，我们学习了如何在Liferay关闭时通知用户以及如何启用OpenOffice.org整合，在单个portal服务器上运行多个portal实例以及查看当前已安装插件等内容。

所有这些信息都是设计用来让你成为一个经验丰富的Liferay管理员。