LiferayPortal应用之配置.doc

1、Liferay Portal 应用之配置Liferay Portal 缺省只有一个系统管理员用户test，且以用户的电子邮件地址test 为登录用户名， 密码是test。Liferay Portal 针对不同的用户会展现出不同的服务网页。当浏览 Portal 主页网址 http:/localhost:8080/ 时，自动转入网址http:/localhost:8080/web/guest/home 调出面向所有人的Guest社区公共主页。一个注册用户登录系统后，可以选择访问不同类型的 Portal 主页。这也是Portal 同传统网站所不同的地方。以 test 用户登录 Liferay Por

2、tal 系统，鼠标移到右上角的Welcome Test Test！ 处调出菜单。再把鼠标移到 我的地方 ，可以看到test 用户可以访问的 Portal 类型有 我的公共 ， TestOrganization ，Test Location 和Guest ，且每一项又分为 公开页和 私有页 。其中 公开页是其他人可以访问的网页， 私有页 则仅自己或注册用户且经过授权才可访问。如 我的公共 中的 公开页 可以被所有人访问，而其 私有页 仅用户自己访问。在每个 Portal 的主页中可以建立若干个网页， 每个网页可以定义为不同的类型： Portlet，Panel，Embedded，Article ，

3、URL和 Link to Page 。其中 Portlet 网页是最常用的一类。 在 Portlet网页中，可以按照需要布置若干个Portlet 插件。每个Portlet插件实现不同的功能，在独立的小窗口中展现内容。在 Portlet 窗口的右上角有 5 个图标，分别用来设置外观，配置功能属性，设置 最小化或最大化显示，或者关闭 Portlet窗口。有权限的用户，可以添加、配置或删除Portlet 。系统的配置是由系统管理员实施的。以test 用户登录后，先进入 我的公共 私有页中，删除不需要的Portlet，只保留 语言 Portlet 。然后再从菜单中打开 增加应用 工具窗口，在 Admi

4、n 分类下，选取添加新的 Portlet ： 管理者 和 企业 Admin 。 管理者 Portlet 用来管理 Liferay Portal 系统，监测系统运行情况，清理系统缓冲区，以及关闭系统等。 企业 Admin 则用来设置和管理系统的应用参数，如企业属性，用户，群组，角色，以及认证方式等。现在我们要对系统的缺省配置进行修改。一、基本配置将 企业 AdminPortlet 窗口最大化，点击不同的标签进行配置。1、总体配置（1）企业属性点击标签 配置 一般 ，来设置用户企业资料，修改 名称 ， 邮件网域名 ，设置 语言 和 时区 ，更改本单位的图标。其它参数如 法律身份证 ， SIG 名称

5、 ， 产业 等等，可以不予理会。（2）缺省社区在 缺省用户协会 （社区）中指定新建用户所在的社区和具有的角色。在default community names 窗口中输入社区名称，缺省只有一个社区 Guest，也可以先建立新的社区。Guest 社区供非注册用户访问，如果注册用户也要访问Guest社区网页，则要在此窗口中添加Guest 行。每个注册用户至少要有一个User 角色。Power User 角色的用户可以拥有自己的私人网页和公开网页。如果不允许用户建立自己的网页则从default role names 窗口中去掉Power User 行。（3）保留字 后备的屏幕名称 用来建立保留名称，

6、即不允许其他人使用的系统保留名称和邮件地址等。如果你的Portal 允许访客自己注册建立帐号的话，最好在此建立一个需要保留的用户名称和邮件地址列表。（ 4）用户认证系统缺省要求用户使用电子邮件地址来登录认证。我们习惯于使用用户名来登录系统，因此在 用户怎么证实 栏选择 由屏幕名称 。 用户识别码 也不方便认证， 因为 用户识别码 （ userid）是系统自动生成的唯一码，用户也不便记忆。另外，可以设置是否允许客人自己建立新账号以及他们的邮件地址等。2、配置使用者、组织、用户群、角色（1）使用者在 使用者 标签下管理注册用户，可以修改用户资料，设置权限，配置主页等。先把test用户名修改为便于记

7、忆的名称admin，姓名改为系统管理员，电子邮件地址改为adminzhongshan.pbc，问候语改为 系统管理员 。把 组织 栏选项 Test Location 去掉不选。 然后设置新的用户密码。至于其它内容，可以根据自己的需要进行设置。如果不允许客人注册用户帐号，就需要系统管理员来逐个建立新用户了。对于人员较多的单位来说，手工建立用户资料的工作量是非常巨大的。因此，最好的办法是编写一个程序，把人员资料按格式自动加入到Liferay 的数据库中。但要注意，用户资料是保存在多个表里面的，其中涉及的数据库表主要有： user_， users_usergroups， users_roles，us

8、ers_permissions， users_orgs， users_groups， usergrouprole，usergroup， contact_。（2）组织 组织 指用户所属的机构组织。Liferay Portal能够适应于跨区域的大型企业应用，因此可以定义一个企业在各个地区的各个分支机构。在我们的应用中，仅有一个机构组织，所以把不需要的地域组织名TestLocation 删除掉，保留 TestOrganization 进行修改使用：把名称修改为中国人民银行中山市中心支行 ，所在国家为China 。在这里还可以给组织分配用户，设置权限，定义组织专有的公开网页和私有网页等等。（3）用户群

9、 用户群 即对用户进行分类，以方便按类别管理用户，特别在进行访问控制配置中，可以按用户群来集体授权而不是对各个用户逐一授权。但在 Liferay Portal 中，用户群的使用并不方便。比如，只能在用户群管理中给用户群分配用户，而不能在用户管理中给用户指定用户群。这样的话，用户不知道自己属于哪些用户群中，管理员也不能从用户管理界面上直接查询到用户所属的用户群，而只能从各个用户群中检查某个用户是否在该群组中，非常不方便！（ 4）角色角色是访问控制的一种手段。不同的资源要求有不同的角色才能够访问。比如对 Liferay Portal 进行配置要求用户具有Administrator角色；要想自建网站

10、，用户必须具有 Power User 角色。在角色管理中，可以对系统缺省的角色重新定义权限。也可以增加新的角色，赋予不同的权限。二、配置网站和网页可能与传统建站方式不同，使用 Liferay 建立门户网站会更加简便直观， 完全是以 所见即所得 的方式进行设计，布局和配置的。Liferay Portal 缺省有一个Guest 社区公共网站，且只有一个名为 Welcome 的网页。系统管理员可以配置或编辑该网页，也可以为网站增加新的网页，配置外观，设置访问权限等。系统管理员admin 登录后，在网页标签栏右端出现一个 增加页面 的标签， 点击此并输入一个网页的名字 中支简介 ，按 存储 按钮即建立

11、了新网页。新网页 中支简介 是空白的，需要配置网页类型和外观属性，然后添加需要的内容。移鼠标到网页右上角 系统管理员 （原来是Welcome Test Test！ ）调出工具菜单，点 处理页（ Manage Page改称为 网页配置 较易理解） 对网页进行配置处理，配置网页的类型、外观、访问权限，子网页和网页排列顺序等。由于中文译文不准确，有些词语难以理解，因此在配置时最好是切换到英文界面以便于操作。1、配置网站外观主题打开 处理页 的工作窗口， 在最上面一行的标签栏中， 标签 页（ Pages） 即用来定义网站某个页面的属性， 外观与风格（ Look and Feel ）用来定义网站的外观主

12、题风格， 出口 /进口（ Export/Import ） 用来导出或导入相关定义参数。依次点击标签 外观与风格 -> 规则浏览器 -> 主题风格 ，可以看到系统提供了三种外观主题：Brochure ， Classic 和 Liferay Jedi 。我们选择 Classic 主题，并在 色彩设计 中挑选了 blue 风格。这里的 规则浏览器（ Regular Browsers ） 即指普通电脑的浏览器，是相对于 流动设备 （如手机）浏览器。LiferayPortal 网站可以向手机和PDA 等移动上网设备提供服务，缺省只有一个Mobile 主题。Liferay 提供外挂主题风格的功

13、能，使用者可以按照Liferay的要求自己定义新的主题风格插件，也可以从Liferay 社区下载其他用户制作的主题风格插件，加入到自己的LiferayPortal 系统中使用。 具体的方法将在Liferay Portal应用之开发 篇中介绍。2、配置网页在右侧的网站名 Guest 下排列出现有的网页名字，可以点击某个网页名称，选取右边的标签 Page ，Children 和 Look and Feel ，对该网页进行配置处理。（1）网页类型同普通的 HTML 格式网页不同， Liferay Portal 的网页规定了以下六种类型：lPortlet：网页内容由Portlet 组成。lPanel：

14、将网页划分成左右两版，左侧显示选定的Portlet 应用列表，右侧显示从左侧列表中指定的一个Portlet应用。即相当于在左侧建立一个Portlet 应用的树形菜单，右侧显示菜单内容。lEmbedded：本网页内嵌入指定网址的网页。在URL 栏指定一个网址。lArticle ：本网页显示指定的期刊文章内容。在Article ID栏输入期刊文章的ID 号。lURL ：将本网页跳转到指定的网址上。在URL 栏指定一个网址。lLink to Page ：将本网页链接到本网站的某个网页上。在 Link to Page 栏选择要链接去的网页。网页类型 URL同 Embedded的区别： URL网页是脱离

15、当前网站直接跳转到指定的网址网页上， 而 Embedded 网页是把指定网址的网页调入当前网站在本网页里显示之。网页类型 URL同 Link toPage 的区别： URL网页可以跳转到指定的任何网址上，包括本网站网页和外部网站网页，而Link to Page 网页只能跳转到本网站内的网页上。（ 2）子页子页的用处不太明确。当在一个网页里定义了几个子页后，在该网页可能看不到子页的存在，除非在网页里添加了网站地图（ Site Map ） Portlet 或导航（ Navigation ）Portlet 才有机会使用它的子页。（ 3）网页外观属性除了网站整体的主题格式外，还可以对网页单独定义它的外

16、观属性，选择主题，配置色调等，而不会影响到其它网页。（ 4）网页访问权限对各个网页可以单独设定其访问权限，确定哪些人可以浏览该网页，是否可以参加评论，是否可以修改网页等。（ 5）页面布局对于类型为Portlet 的网页，可以定义网页中Portlet的布局格式，即Portlet 应用窗口如何在网页中摆放，如何对齐。从 系统管理员 菜单下进入 布局模板（Layout Template ） 选择窗口，缺省提供了10 种布局模板可供使用。每个模板由一到几个版块构成，每个版块内可以放置若干个Portlet，但 Portlet 在某个版块里横向只能放置一个，即同一版块里的Portlet 不能并排放，纵向则

17、不受限制，可以依次排列多个Portlet 。 Welcome 页面选用的是2 Columns (30/70)布局模板，左边的版块占页宽的 30%，右边版块占70%。但要注意，版块宽度的比例并不是绝对的， 当把一个需要更宽位置的Portlet 放置到只有30%的版块中时，并不是把该Portlet 缩窄，而是把所处的版块给加宽了，相应地，其它板块随之缩窄了。另外，版块的长度是不受限制的，正如 Portlet 窗口的高度会随它的内容无限制地向下扩展一样。使用者也可以根据自己的需要，定义自己的布局模板插件或者从 Liferay 社区下载网友制作的其他布局模板插件。具体的方法将在 Liferay Por

18、tal应用之开发 篇中介绍。三、制作网页前面已经介绍过，Liferay Portal 的网页有六种类型，其中Embedded、 Article 、 URL 和 Link-to-Page 属于链接型网页，只需定义网页的链接对象即可，而Portlet 和 Panel 类型的网页则需要添加应用内容。其实 Panel 网页也是在页面配置时，已经基本确定了网页的架构，分为左右两列栏目，左栏是选定的 Portlet 应用列表， 右栏内容则由使用者随时从左栏列表中挑选使用，因此Panel 网页也无需特别制作。现在，唯有Portel 网页需要特别制作。与传统网页的制作方式有所不同， Portlet 网页的制作

19、过程是：定义布局模板，配置外观主题，添加和配置Portlet 应用。显然，在制作网页之前，必须把需要的Portlet 应用模块预备好了，也要把Portlet应用模块所需要的内容准备好了，这样才能够把相应的内容展现在网页上。好在 Liferay Portal 预制了几十个常用的Portlet 模块，经过配置能够满足一般的门户应用。对本单位业务有关的数据内容，就需要自己编写Portlet 模块来实现必要的功能，添加到需要的 Portlet 网页上使用。在 Liferay 内置的那些Portlet 中，除了系统管理和配置方面的 Portlet 外，最常用的是网站内容管理类（CMS） Portlet

20、：l文件图书馆（ Document Library ）管理上载文件。l文件图书馆显示（Document Library Display ）列表显示上载的文件。l期刊（ Journal）以 所见即所得 方式制作网页内容，即相当于新闻稿件。l期刊文章（ Journal Article ）列表显示新闻稿件。l期刊内容（ Journal Content）显示某篇新闻稿件内容。l图像画廊（ Image Gallery ）管理上载图片，显示上载图片内容。l财产出版者（莫名其妙的中文名，Asset Publish ）上述 Portlet 工具的集合，可以管理上载文件和图片，制作新闻稿件，列表显示文件/图片

21、/稿件 /博客，也可以显示其内容。借助于上述 Portlet 工具，完全可以制作出丰富多彩的网页来。而且与传统网页不同的是，能够对 Portlet 网页中的任何版块进行精细管理，设置访问权限，如哪些人可以上载文件，文件上载到哪个目录；哪些人可以查看哪些目录中的哪些文件；谁可以制作新闻稿件，稿件是否需要批准，谁有批准权限，稿件何时可被浏览；哪些人可以查阅哪些稿件等等。显然， Portlet 网页的制作过程要比传统网页的更为简便，更加灵活。四、配置用户认证方式为了能够同其它应用系统共享用户资料，我们打算使用LDAP 来替代 MySQL 数据库进行用户认证。1、安装配置LDAP 服务器Liferay

22、 支持许多款LDAP 服务器产品。 LDAP 可以同 Liferay安装在同一台服务器中，也可以单独安装。对于中小型应用来说，开源LDAP 是个不错的选择，其中的姣姣者是ApacheDS 和 openLDAP 。ApacheDS 即 Apache Directory Server ，是 Apache 开源项目中的子项目，当前版本号是1.5.3，提供了适用于Linux ，Mac OS和 Windows 环境的多个安装版本，下载地址是/apacheds/1.5/。此外， 该项目还提供了一个优秀的LDAP 管理器 Apache Directory

23、Studio ，可以从/studio/ 下载 Windows 版本的安装软件 ApacheDirectoryStudio-win32-1.2.0.v20080818.exe 。另一个有名的 LDAP 管理器是 JXplorer （ / ）。 OpenLDAP 是最为著名的开源 LDAP ，可以在许多 Linux 系统版本中发现她的存在。但在openLDAP 的网站 里，可供下载的是需要自己编译的源码程序包。 对于在 Windows 环境下使用它， 只能到互联网中搜索了。 openLDAP 的当前版本

24、号是 2.4.11，在网上找到的适合 Windows 的版本号最高只有 2.2.29，显然后续的版本没有保证了。如果在生产环境中使用，建议选择Linux+openLDAP模式。但我们的测试环境是Windows XP ，还是需要临时安装一个windows 版本的 openLDAP 。有两个地方提供openLDAP 的Windows 版本：http:/www.ilex.fr/openldap.htm/， openLDAP 版本 2.0.27http:/download.bergmans.us/openldap/ ，openLDAP 版本 2.2.29选择后一个。从http:/download.be

25、rgmans.us/openldap/openldap-2.2.29/下载安装软件openldap-2.2.29-db-4.3.29-openssl-0.9.8a-win32_Setup.exe ，然后直接运行，安装到C:JavaOpenLDAP-2.2.29 目录下。安装完成后，在Windows 系统中添加了OpenLDAP程序组，且可以在Windows 系统中添加或移除openLDAP 服务。在启动 openLDAP 运行之前，我们要对它进行适当的配置，添加初始内容。进入安装目录C:JavaOpenLDAP-2.2.29 ，打开配置文件slapd.conf 进行如下编辑：（ 1）添加对象类

26、型在如下行：include./schema/core.schema的后面，添加下面两行：includeinclude./schema/cosine.schema./schema/inetorgperson.schema（ 2）定义单位域名把下面的行：suffixdc=my-domain,dc=com修改为：suffixdc=zhongshan,dc=pbc（ 3）设置管理员用户把下面两行：rootdnrootpwcn=Manager,dc=my-domain,dc=comsecret修改为：rootdnrootpwcn=manager,dc=zhongshan,dc=pbcschnell其中，

27、管理员用户名manager，口令 schnell。在当前目录再建立一个初始化文件init.ldif ，其内容如下：dn: dc=zhongshan,dc=pbcobjectclass: topobjectclass: dcObjectobjectclass: organizationo: zhongshan dc: zhongshan然后打开 DOS 窗口，进入openLDAP 的安装目录下执行：slapadd -f slapd.conf -l init.ldif将把init.ldif文件中的初始化数据装载到openLDAP数据库中。至此，可以进入 Windows 的服务管理中， 启动 ope

28、nLDAP 应用服务。2、安装配置LDAP 管理器接下来需要安装一个 LDAP 管理器，以方便维护 openLDAP 中的用户资料。 Apache Directory Studio 是个不错的选择， 功能上要强于 JXplorer 管理器。只需要直接运行下载的安装软件 ApacheDirectoryStudio-win32-1.2.0.v20080818.exe ，并指定工作目录为 C:JavaApacheDirectoryStudio-1.2 。安装结束后，建立了程序组 Apache Directory Suite ，我们可以进入 Studio 目录，启动Studio 管理器。在 Studi

29、o 管理器初始启动界面中，点击右下角的Workbench图标进入工作台。把鼠标移动到左下角的Connections 窗口内，点击右键，选 New Connection 打开连接 LDAP 的配置窗口。指定参数 Connection name 为 openLDAP ， Hostname 为 LDAP 的安装主机名，在本机上可以使用 localhost 或本机名 neu。openLDAP 缺省 Port 端口号是 389。然后点击 Check Network Parameter按钮进行连接测试，提示连接成功。接下来配置openLDAP 管理员用户认证方式：Authentication Method

30、 :Simple AuthenticationBind DN or user :cn=manager,dc=zhongshan,dc=pbcBind password :schnell同样进行测试，按下 Check Authentication 按钮，提示认证成功。按 Finish 按钮完成配置，连接 openLDAP 进入管理界面。现在，按照我们的实际情况，设计 LDAP 数据库中的组织和用户架构如下：利用 LDAP 管理器可以很方便地建立起上述架构的用户资料。作为测试之用，先建立两个群组 系统 和 科技科 ，建立两个用户admin 和niujingxiao，且用户admin 隶属 系统 组

31、，niujingxiao同时隶属于 系统 和 科技科 两个 组。具体操作步骤在此不作详述。3、配置 Liferay 使用 LDAP 认证用户系统管理员 admin 登录 Liferay 系统，从 我的地方 到 我的公共 打开 私有页 。把 企业 AdminPortlet 窗口最大化显示，依次点击标签 设置 -> 认证->LDAP。（）开启LDAP 认证：勾选 使能 ，允许从 LDAP 读取用户资料来认证用户。未勾选 必需 ，即不要求用户必须在LDAP 中，仅在Liferay 系统里也可以获得认证。（）配制LDAP 连接参数：基本的提供者URL：ldap:/neu:389/基地 DN：dc=