级别: 初级 Elliotte Want (wante@us.ibm.com), 数据管理认证专家, IBM Advanced Technical Support
2004 年 7 月 01 日 您需要将自己的企业数据存储到一个可以在 Web 上使用的内容管理系统中吗?本文将向您介绍如何使用 DB2 Content Manager 和 WebSphere Portal 5 实现这种功能。
简介
当企业部署战略性解决方案(包括由企业内容管理系统所管理的业务内容)时,通常需要将这些内容发布到自己的 Web 门户上。 IBM ®DB2® Content Manager 与 WebSphere® Portal 一起使用可以提供这种解决方案。本文将向您展示如何将保存在 DB2 Content Manager 中的数据通过 WebSphere Portal V5 发布到 Web 上。
假设和条件
下面我们将逐步介绍这种解决方案的设置过程。首先我们假设现在已经满足下面这两个条件:
- 您已经在一台 Microsoft Windows® 机器上安装了 WebSphere Portal V5。
- 您已经在网络中某个地方安装了 IBM DB2 Content Manager V8.2 (CM)。(假设在 WebSphere Portal 服务器上没有安装 DB2。)
IBM 为 DB2 Content Manager V8.2 提供了对 portlet 的支持,从而可以提供对 CM 系统的只读访问。它们可以在线分布到 WebSphere Portal Catalog 中,正如下面
获得 DB2 Content Manager V8.2 portlet一节所介绍的一样。从 CM 的角度来看, portlet 被认为是一个 CM 客户端。作为一个 CM 客户端,它与任何 CM 客户端都具有相同的条件。它必须具有对 CM Library Server Database(CM 库服务器数据库)的 DB2 访问权限。
由于本文的假设是在 WebSphere Portal 服务器上没有安装 DB2,因此必须要在其上安装 DB2 Runtime 客户端。在 CM 介质包中提供了这种客户端。另外一个条件是 CM V8 连接器,它是 DB2 Information Integrator for Content (II for C) 的一部分。在 CM 介质包中也提供了 II for C 的代码。最终的架构如
图 1所示:
图 1. 这种配置的架构
注意:要下载 portlet,必须要先获得一个免费的 IBM Support Download Id。在后面的
获得 IBM DB2 Content Manager V8.2 portlet一节中详细介绍了注册过程中的步骤。
安装 DB2 Runtime 客户端
DB2 Runtime 客户端代码和修复包都可以从 Web 站点上下载。url 为:
http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/download.d2w/report#V8LFP。
选择要下载的客户端代码的适当平台和版本。如果您在判断需要哪个修复包时需要一些帮助,请参考
安装 DB2 Runtime 修复包。
按照下面的步骤安装 DB2 Runtime 客户端:
- 切换到保存 DB2 Run-time Client 安装文件的地方,并点击
Setup。如果您有安装 CD,现在就请将 CD 插入光驱。
- 在 Welcome 窗口中点击 Next,如
图 2所示。
图 2. Welcome 窗口
- 同意许可证协议,点击
Next。
图 3. 许可证协议
- 选择缺省的 Typical 安装类型,并点击
Next。现在请耐心等候。
图 4. 选择安装类型
- 点击
OK。
图 5. 点击 OK
- 使用缺省的目标目录,并点击 Next。现在请耐心等候。
图 6. 选择安装文件夹
- 根据所采用的网络,可以建立 NetBIOS 通信。对于本教程来说,我们不使用 NetBIOS 协议。点击
Next。
图 7. 配置 NetBIOS
- 现在开始真正安装代码。点击
Install。
图 8. 开始拷贝文件
- 现在会显示 Status 窗口。
图 9. 安装 Runtime 客户端
- 点击
Finish。
图 10. 安装完成
安装 DB2 Runtime 修复包
您的 DB2 Runtime 客户端应该与 Content Manager Library Server DB2 安装相同的修复级别。为了确定要采用的修复级别,可以在 Library Server 系统上运行下面这个命令。在验证修复级别之后,就可以从
http://www-306.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/download.d2w/report#V8LFP下载适当的修复包了。
-
在 CM Library Server 上:
为了确定 Content Manager Library Server DB2 的修复级别,请在 Library Server 上启动一个命令提示符窗口。
输入
db2level 并按
回车键。
本例中是 FixPak 2。
图 11. db2level
-
在 Portal Server 上:
找到适当的修复包,并将其放到 WebSphere Portal 机器上。如果该文件是压缩过的文件,请将其解压。根据修复包的不同,输入
setup 或
update 。现在您将看到:
图 12. 在 Portal Server 上安装 DB2 修复包
图 13. 准备开始安装
- 配置过程并点击
Update。
图 14. Update 屏幕
- 现在会看到一条 status 消息。
图 15. Status 消息
- 看到 completion 窗口时,请点击
Finish。
图 16. Completion 窗口
- 现在您已经成功安装了修复包。
配置 DB2 Runtime 客户端
本教程假设 Content Manager Library Server 在一台不同的机器上。在这种情况中,您需要配置 DB2 Runtime 客户端。
DB2 Runtime 客户端的配置包括为 DB2 定义一些信息:这些信息用来连接到 Content Manager Library Server 数据库所在的 DB2 数据库管理程序上。您需要了解以下内容:
- 使用哪种类型的通信。本教程中使用 TCP/IP。
- 远程机器的主机名。
- 在远程机器上数据库管理程序监听远程连接所使用的端口号。缺省是 50000。
以下步骤可以帮助您判断 Content Manager Library 服务器的端口号,然后配置 DB2 Runtime 客户端。
在 Content Manager Library Server 上:
- 点击
Start->
Programs->
IBM DB2->
Command Line Tools->
Command Line Processor。
图 17. DB2 命令行处理器
- 输入
get database manager configuration ,然后在这个 DOS 窗口中就会列出配置。
- 查找 TCP/IP 服务名。缺省是 db2c_DB2。这时一个名字或一个实际的端口号。名字是 services 文件中的一项,它对应一个端口号。
图 18. TCP/IP 服务名
- 要确定 services 文件中的端口号,请切换到 WINNT\system32\drivers\etc 目录。使用记事本打开 Services 文件。查找与步骤 3 中 TCP/IP 服务名匹配的项。
图 19. Services 文件
- 了解了这些信息,现在就可以返回到 WebSphere Portal 机器上了。
- 点击
Start->
Programs->
IBM DB2->
Command Line Tools->
Command Line Processor。
- 在 DB2 命令行窗口中输入:
catalog tcpip node <your CM LS host name> remote <your CM LS host name> server <your service port from step 4>
并按
回车键。
例如:
catalog tcpip node iccdemols remote iccdemols server 50000
|
- 现在输入
catalog database <your CM LS database name> at node <your LS host name> ,并按
回车键。
例如:
catalog database icmnlsdb at node iccdemols
|
- 要对连接进行测试,请输入
connect to <your CM LS database name> user <your CM LS admin id> using <your CM LS admin password> 。
例如:
connect to icmnlsdb user icmadmin using oneclick
|
如果成功,就会显示数据库连接的信息。
- 输入
connect reset 。这将关闭连接,然后可以关闭这个 DB2 命令行窗口了。现在就已经配置好 DB2 Runtime 客户端了。

 |

|
安装 DB2 Information Integrator for Content
这个安装指南将向您逐步介绍安装 DB2 Content Manager 连接器代码的详细步骤。
注意:DB2 Content Manager V8.2 介质包中包括了 Information Integrator for Content (II for C) 安装 CD,它可以与 DB2 Content Manager 一起使用。这个 CD 包含了您要安装的 DB2 Content Manager V8 的连接器代码。
几点假设:
数据搜集
在安装之前,需要首先向 DB2 Content Manager 管理员询问以下问题:
- 访问 Content Manager Library Server 所需要的 Windows Database Connection ID 和密码。
- 在上一节中建立的 Library Server 别名。
- Library Server 模式名。
对于本教程来说,我们使用
ICMNLSDB作为 Library Server 名字,
ICMADMIN作为模式名,
ICMCONCT作为 Database Connection ID,
oneclick作为密码。
- 首先开始安装 Information Integrator for Content。切换到刚才保存 DB2 Information Integrator for Content 安装包的地方,并点击
Setup。如果您有安装 CD,现在就将 CD 插入光驱。
- 在 Welcome 窗口中点击
Next。
- 接受缺省设置,在 Save Files in Folder 窗口中点击
Next。
- 等待大约十分钟,等文件展开。
- 接受许可证协议。
图 20. 软件许可证协议
- 点击
Next。
图 21. 继续安装
- 使用缺省的 Desktop Client,并点击
Next。
图 22. 选择机器类型
- 使用缺省的目标目录,并点击
Next。
图 23. 选择目标
- 现在显示 Component Selection 窗口。只选择
Content Manager V8 connector子组件,这样会自动选择 Local connectors Component 。
点击
Next。
图 24. Component Selection 窗口
- 不用 RMI 特性。点击
Next。
图 25. RMI 特性
- 本教程使用的所有文件都是本地的。当将 Content Manager 安装到适当的位置时,就已经确定了一个实现,并且确定了是使用 Local 选项还是 Remote 选项。
点击
Next。
图 26. 系统配置
- 不选 Catalog remote EIP database。
将 Database name 修改为
ICMFED。
注意:您并不是在创建 Federated Database,而是任何情况下都需要的内容。
输入数据库连接的密码
oneclick。
图 27. Federated server connection screen
- 警告,这个窗口与上一个窗口非常类似,此处使用的数据库名是 DB2 Client Connect 为 CM Library Server 数据库设置的
数据库别名。
输入数据库名和模式名。
输入数据库连接 ID 和密码。点击
Next。
图 28. 配置 Content Manager Server Connection
- 点击
Next,开始拷贝文件。
图 29. 开始拷贝文件
- 点击
Finish完成安装过程。注意:这将重新启动系统。
图 30. 安装完成
- 在系统重启之后,您将开始安装 II for C 的修复包。通常您应该仔细阅读 readme 文件中的说明,下面就是 II for C V8.2 修复包 2 的说明。
现在您应该已经下载了与 Content Manager V 8.2 Server 修复包级别匹配的 II for C 的修复包。支持 Portlets 所需要的最小级别是修复包 2。 url 为
ftp://ftp.software.ibm.com/ps/products/enterprise_information_portal/fixes/v8.2/。
- 启动一个命令行提示符窗口。
- 切换至包含所下载的修复包的目录。输入
Update_EIP_win_ENU , 启动修复包程序。
图 31. Update_EIP_win_ENU
- 现在请耐心等候, 5 分钟或更长时间之后, 就会显示 Install Shield 向导。点击
Next。
图 32. Update_EIP_win_ENU
- 现在会显示总结窗口。点击
Next。
图 33. Install 总结
- 现在会显示进度窗口。此处除了保持耐心之外,不需执行任何操作。
图 34. 进度窗口
- 当屏幕上显示 Installation Complete 完成窗口时,点击
Finish。
图 35. 完成
- 到现在为止,您已经完成了添加 WebSphere Portal V5 平台的条件。下一节将介绍 CM V8 Portlet 的部署。
- 现在也已经完成了 II for C 的安装。

 |

|
获得 IBM DB2 Content Manager V8.2 portlet
在 WebSphere Portal Catalog 中可以使用 Portlets for IBM DB2 Content Manager。Catalog 在 Internet 上的 url 是
http://www.ibm.com/developerworks/websphere/zones/portal/catalog。
提醒您一下,本节还将介绍获得免费的 IBM Support Download ID 的步骤。
- 使用上面的 url 连接到 WebSphere Portal Catalog 的主页,然后点击
Click HERE to…..链接。
图 36. WebSphere Portal Catalog 主页
- 点击
NavCode选项,输入 portlet 代码
1WP1000G6,并点击
GO。
图 37. NavCode option
- 点击
Download now按钮,开始下载 portlet war 文件。另外,关于其他任何变化,您也可以查看安装文档。本教程基于 portlet Version 1.2 。
图 38. Download now
- 现在会警告说您将离开 Portlet Catalog 的 web 站点。Catalog 中的有些 Portlets 在其他一些公司的 Web 站点上。点击
Continue。
图 39. 离开 Portlet Catalog Web 站点
- 如果您还没有 IBM Support ID,点击
I have not registered before。
图 40. 注册过程
- 填写注册信息,并点击
Accept License。
图 41. 注册
- 现在会自动重定向到下载页面中。
图 42. 重定向到下载页面
- 点击
Download now。
图 43. Download now
- 根据浏览器设置的不同,您可能会看到 File Download 窗口。点击
Save。
图 44. File download 窗口
- 将该文件保存到一个您可以记住的地方。根据调制解调器的速度,下载过程应该少于 1 分钟。
图 45. Save file 窗口
- 现在您已经成功获得了 IBM DB2 Content Manager V8.2 portlet,可以关闭 Web 浏览器,并继续学习下一节。
为 portlet 配置 WebSphere Application Server
安装要求的软件之后,可以采取两类操作来部署 portlet。
- 第一类操作是使用 WebSphere 管理终端来修改环境。
- 第二类操作是使用 WebSphere Portal 管理功能部署 portlet 。
本节将介绍 WebSphere Application Server 环境的变化,此处假设 WebSphere Application Server 已经启动了。
数据搜集
对于本节来说,您需要了解以下信息:
- WebSphere Application Server 采用的 WebSphere 安全性可以支持 WebSphere Portal 吗?
- 如果支持,那么 WebSphere 管理员的 ID 和密码是什么?
- 用来安装 Information Integrator for Content 的路径是什么?本教程将使用缺省的位置。
警告
WebSphere Application Server 的配置参数是大小写敏感的。在部署 portlet 时必须注意,否则就会出现 “Class not found" 的错误。
- 点击
Start->
Programs->
IBM WebSphere->
Application Server V5.0->
Administrative Console.
- 如果没有启用 WebSphere 的安全性,就可以输入任何字符串。输入
a,并点击
OK。
如果已经启用了 WebSphere 安全性,就使用一个有效的 WebSphere 管理员 ID 登录。
图 46. WebSphere 安全性
- 在 WebSphere Administrative Console 窗口的左边面板上,点击
Environment-<
Manage WebSphere Variables。
在右边面板的 WebSphere Variables 中,点击
Browse Servers。
图 47. 浏览服务器
- 选择
WebSphere_Portal并点击
OK。
图 48. 选择 WebSphere Portal
- 这两个新环境变量用来定义路径。向下滚动屏幕,并点击
NEW。
图 49. 定义环境变量
- 输入
Name:
CMB_LIB
Value:
C:/CMBROOT/LIB
(是的,其中有斜线。)系统中 Information Integrator for Content 将使用这个安装位置。
Description:
IBM Information Integrator for Content jar file directory
点击
OK。
图 50. 配置属性
- 创建第二个环境变量。向下滚动屏幕,并点击
NEW。
图 51. 创建第二个环境变量
- 输入
Name:
CMB_INSTALL_ROOT
Value:
C:/CMBROOT
(是的,其中有斜线。)系统中 Information Integrator for Content 将使用这个安装位置。
Description:
IBM Information Integrator for Content Installation root directory
点击
OK。
图 52. 创建 CMB_INSTALL_ROOT 环境变量
- 验证环境变量 DB2_JDBC_DRIVER_PATH 已经存在,其值是一个路径,其中包含了 DB2java.zip 文件。本教程使用的是 C:\Program Files\IBM\SQLLIB\java。
图 53. DB2_JDBC_DRIVER_PATH
- 在 WebSphere Administrative Console 窗口的左边面板中,点击
Environment->
Shared Libraries.
在右边面板的 Shared Libraries 中,点击
Browse Servers。
图 54. WebSphere administrative console
- 选择
WebSphere_Portal并点击
OK。
图 55. 选择 WebSphere_Portal
- 按照以下步骤为 Information Integrator for Content jar 文件新建一个共享库。
向下滚动屏幕,并点击
New。
图 56. 新的共享库
- 输入
Name:
idmlib
Description:
IBM Content Manager V8 Connector shared libraryI
Classpath
$(CMB_LIB)/cmbview81.jar
$(CMB_LIB)/cmb81.jar
$(CMB_LIB)/cmbsdk81.jar
$(CMB_LIB)/cmbtag81.jar
$(CMB_LIB)/cmbservlets81.jar
$(CMB_LIB)/cmbutil81.jar
$(DB2_JDBC_DRIVER_PATH)/db2java.zip
Native Library Path:
$(CMB_INSTALL_ROOT)/DLL
点击
OK。
图 57. Save file
- 在 WebSphere Administrative Console 窗口的左边面板上,点击
Servers->
Application Servers.
在 Application Servers 的右边面板上,点击
WebSphere_Portal->
Classloader->
Classloader_1->
Libraries.
点击
Add。
图 58. 添加库
- 在这个下拉列表中,选中
idmlib并点击
OK。
图 59. 选中 idmlib 库
- 在 WebSphere Administrative Console 窗口的左边面板上,点击
Servers->
Application Servers.
在 Application Servers 的右边面板上,点击
WebSphere_Portal->
Process Definition->
Java Virtual Machine。
将路径加入到 CM V8 Connector 的 .ini 文件 C:/Progra~1/IBM/CMgmt 中。
点击
OK。
图 60. JVM
- 请注意,在窗口的顶端有一条消息,表示
本地配置已经发生变化。现在将这些变化保存到主配置文件中。点击
Save。
图 61. 保存到主配置中
- 现在点击
Save 按钮,
图 62. 保存文件
- 点击
Logout 按钮,结束本次对话。
图 63. 保存文件
-
在服务面板上,停止后重新启动 WebSphere Portal 服务。
请注意:当服务面板上的 WebSphere 门户服务状态显示为“Started”之后,可监视 Windows 任务管理器的性能窗口。请等到处理器的活动结束之后。WebSphere Portal 在它启动的时候也启动了若干进程。这些进程的启动过程结束之后才能继续操作。
- 现在就可以部署 CM portlet 了。

 |

|
部署并使用 IBM DB2 Content Manager V8.2 的 portlet
部署 portlet 涉及到安装前面下载的 portlet,还要将其加入到门户页面中。到底加入到哪个页面中,这取决于您的解决方案。下面的截屏图中显示的是一种非常简单的缺省实现方式,可能与您的定制门户页面并不相同。不过管理的部分应该是一样的。
数据搜集
您需要具备:
- WebSpere Portal 的管理员 ID 和口令。我们将使用 ID
wpsadmin和 口令
wpsadmin。
- 下载的 portlet war 文件所在的位置。
- DB2 Content Manager 的用户 ID 和口令。我们将使用 ID
icmadmin和口令
oneclick。
- 一开始,先启动浏览器,输入门户的 url。
我们将使用缺省的 url,http://localhost/wps/myportal。
- 在
Login上点击。
图 64. 在 login 上点击
- 输入用户 ID:
wpsadmin,口令:
wpsadmin然后点击
Log in。
图 65. Log in
- 点击
Administration。
图 66. 点击 Administration
- 在
Portlets上点击。现在找到从 WebSphere Portal Catalog 下载的 portlet war 文件的位置,并在 IBM DB2 Content Manager V8.2 中安装 IBM Portlet。点击
Install
图 67. 开始安装 portlet
- 点击
Browse
图 68. 点击 Browse
- 在下载 portlet war 文件的目录下找到 ibm.war.zip,然后点击
Open。
图 69. Portlet war 文件
- 点击
Next。
图 70. 点击 Next
- 验证其是否是正确的 portlet,如果是,点击
Install。
图 71. 开始安装 portlet
- 当您接收到安装成功的消息后,安装过程就结束了。现在可以将这个 porlet 放置在门户页面中。
请注意:如果这时您看到出错信息,可检查前一节中介绍的 WebSphere 环境设置;这是最可能出问题的地方。
图 72. 已安装的 Portlets
- 要将 CM Portlet 放置在门户页面中,可点击
Portal User Interface->
Manage Pages- >
My Portal->
Welcome。
图 73. 放置 portlet
- 在 My Page 这一行中,点击 Edit Page Layout 图标。
图 74. 编辑页面布局
- 在中间一栏的底部,点击
Add portlets。
图 75. Add portlets
- 可以增加的 portlet 有 9 页之多。可在 Search for:一栏中输入 v8.2,然后点击
Search。
图 76. Searth
- 搜索结果应该只有一个。点击
Select复选框,然后点击
OK。
图 77. 选择 portlet title
- 当成功加入 portlet 之后,点击
Done。
图 78. 已经加入的 Portlet
- 现在可对门户页面进行测试。在页面顶端点击
My Portal。
图 79. 点击 My Portal
- 点击
Welcome标签。在从上往下第二行标签中点击
My Page。
图 80. 测试
- 请注意,现在这个 portlet 中有一个 Edit 图标。点击 Edit 图标。
图 81. Edit 图标
- 现在可以对部署在 My Page 中的 portlet 进行配置。
对于现在的情况,可选择 Content Manager Library Server(与 Information Integrator for Content CM V8 connector 的定义一致)。
注意,可定义多个服务器,但一次只能选择一个。然后输入相应的用户 ID 和口令。
用
icmadmin和
oneclick。
点击
Automatic Logon复选框。
图 82. 配置 portlet
然后点击
Save Changes。
图 83. 保存修改
- 这时,portlet 已经登录到 Content Manager 上。您可以搜索,可以创建新的文件夹来组织您的内容,也可以导入新的内容。我们将点击 search,查找已经存在的内容。
图 84. Portlet 窗口
- 现在 portlet 已经查询了 Library Server,确定了该登录 ID 允许看到哪些 Item Type。这些类型已在 portlet 窗口中列出。其中列出的 Item Type 应该是 CM Library Server 中定义的那些。
图 85. Item 类型
- 同时显示的还有 item 类型的搜索依据。如果没有输入搜索依据,则缺省的动作是查找所有的项。
点击
Search。
图 86. 点击 Search
- 现在显示出结果列表。请注意,其中的图标是文件夹图标。Content Manager 除了按 item 类型结合独立的内容项之外,还可以按照文件夹组织内容。您的环境中显示的可能只有文档图标。点击其中一个内容图标。
图 87. 结果列表
- 此时文件夹被打开。请注意,在 A 处您可以返回搜索结果中的另一个文件夹,按 Insurance Folder Item Type 执行另一次查询,或选择另一种查询的 Item Type。
图 88. Portlet
B处列出了与当前 Insurance Folder 相关的所有内容的 Item Types。Insurance Policy Item Type 处于激活状态,同时显示出内容项。因为 Content Manager 具有足够的灵活性,可以支持每一种 Item Type 的不同属性,所以显示出的属性与当前激活的 Item Type 相关。
C处列出了类型为 Insurance Policy 的各个内容项。每一行列出一项,同时还包括该项的属性值。该项可以是某个特定的内容对象,也可以是子文件夹。通过子文件夹可实现内容的嵌套式组织。
点击文档图标
C。
- 此时打开了 Document Viewer 窗口。请注意,为解决显示内容的大小问题,这个窗口在 portlet 的外部。(8 ½" X 11")无法在很小的 portlet 空间中正常显示。
使用 ZOOM 图标可增加显示面积。查看完毕之后,点击 X 关闭该窗口。
图 89. Document Viewer
- 您可以预览该文件夹中的其他内容项,也可以搜索另一个 Item Type。
- 选择
Log out。
图 90. Log out
- 恭喜恭喜。您已经成功地通过 CM Portlet 部署、查询和获取了数据内容!
图 91. 登出

 |

|
结束语
目前您已经了解了安装 IBM DB2 Content Manager V8.2 Portlets 及其前提条件的全过程。现在可以把业务内容放到门户中来。最后提一句,与 portlet 一起部署的是用于创建该 Portlet 的 Java 代码。这些代码可以从 <WebSphere Portal Root>\installedApps\idm_PA_1_0_69.ear\idm.war\JavaSource 处找到。您也可以用这些源代码创建自己的 portlet 来启用相关内容。
我希望这篇教程能够满足您的业务需求。
关于作者  | |  |
Elliotte Want原先是一名开发人员,现在在 Advanced Technical Support Content Management 小组工作。他提供内容管理架构、DB2 Content Manager 和 DB2 Information Integrator for Content 方面的支持。
|
对本文的评价
|