使用 WebSphere Information Integrator Content Edition 将 IBM® WebSphere® OmniFind™ 与 WebSphere Portal Document Manager 集成。然后，OmniFind 可以在任意数量的指定 Portal Document Manager 项目类上爬行（crawl）、解析、索引和搜索 Portal Document Manager 知识库。

简介

企业搜索系统为搜索任意数量的结构化和非结构化数据源提供广泛的功能，而且只要求单点访问。随 WebSphere Information Integrator OmniFind Edition (OmniFind) 一起安装的搜索组件可以收集不同的企业信息，并使之可以被搜索到。

在 OmniFind, Version 8.3 中，WebSphere Portal Document Manager 是一个最新受支持的数据源。OmniFind 与 WebSphere Information Integrator Content Edition 相集成，以便在一个 Portal Document Manager 知识库中配置搜索 crawler。完成这一集成后，OmniFind 便可以在任意数量的指定 Portal Document Manager 项目类上爬行、解析、索引和搜索 Portal Document Manager 知识库。

本文为使用 WebSphere Information Integrator Content Edition 执行 OmniFind 与 Portal Document Manager 之间的集成提供逐步的说明。注意，企业搜索集合中的其他 WebSphere Information Integrator Content Edition 知识库，例如 Documentum Content Server、FileNet Content Services、Hummingbird Enterprise Document Management 等也可以使用本文中的设置。

回页首

前提条件

本文中的说明假设您的环境与 图 1 中的环境设置得一样。在图 1 中，企业搜索服务器安装在一个多服务器配置中（要了解关于安装过程的更详细的信息，请参阅 OmniFind Information Center），而 Portal 机器则在另一个节点上。

特别注意，OmniFind 被安装在一个多服务器配置中，在该配置中，搜索 crawler 组件没有位于拥有应用服务器的机器上。在这种情况下，crawler 所使用的 WebSphere Information Integrator Content Edition 连接器必须使用 direct 模式访问 Portal Document Manager 知识库 -- 这正是本文要讲到的场景。当碰到这种部署方式的变种时，仍然可以使用本文作为参考，配置步骤几乎都是一样的。

本文中涉及的产品及版本包括：

• WebSphere Information Integrator OmniFind Edition, Version 8.3
• WebSphere Information Integrator Content Edition, Version 8.3
• WebSphere Portal Enable, Version 5.1.0.1 （Portal Document Manager 是 Portal 的一个组件）。

回页首

概述

为了成功地在 OmniFind 中设置 Portal Document Manager crawler，需要执行的高级任务有：

1. 在 Portal 机器上安装 WebSphere Information Integrator Content Edition RMI 代理连接器。
2. 配置 WebSphere Information Integrator Content Edition Portal Document Manager 连接器。
3. 配置到 Portal Document Manager（一个 WebSphere Information Integrator Content Edition 知识库）的 direct 访问模式。
4. 安装 APAR PK10952。
5. 在 OmniFind 中创建 WebSphere Information Integrator Content Edition crawler。

回页首

在 Protal 节点上安装 WebSphere Information Integrator Content Edition RMI 代理连接器

本节描述在运行 AIX 操作系统的门户节点上安装 WebSphere Information Integrator Content Edition RMI 代理连接器时需要执行的操作。首先，请确认您的系统上有 230MB 的剩余空间用于安装目录。

1. 以 root 或具有 root 权限的管理员身份登录。
   
   
2. 启动 WebSphere Information Integrator Content Edition InstallShield 向导。（请确保在系统上安装了 JRE 1.4。）
   
   
3. 在第一个面板上单击 Next，以便选择安装 WebSphere Information Integrator Content Edition。
   
   
4. 接受安装 WebSphere Information Integrator Content Edition 的默认路径。该默认路径为 /opt/IBM/WebSphereIICE。 （注意：本文的后面将这个路径称为 IICE_HOME 目录。） 单击 Next。
   
   图 2. WebSphere Information Integrator Content Edition 安装屏幕 - 选择安装路径
   
   
   
5. 选择 Connectors Only 安装选项，然后单击 Next。
   
   图 3. WebSphere Information Integrator Content Edition 安装屏幕 - 选择安装类型
   
   
   
6. 选择 IBM WebSphere Portal Document Manager connector， 然后单击 Next。
   
   图 4. WebSphere Information Integrator Content Edition 安装屏幕 - 选择 Portal Document Manager 连接器
   
   
   
7. 查看安装总结，然后单击 Install。
   
   图 5. WebSphere Information Integrator Content Edition 安装屏幕 - 总结信息
   
   
   
8. 安装完成时，检查安装日志，以确认安装成功。

完成这个步骤后，您便已经成功地将 vbr.jar 和 vbr_pdm.jar 文件安装到门户服务器上。

回页首

配置 WebSphere Information Integrator Content Edition Portal Document Manager 连接器

本节描述将 services.war 文件部署到 WebSphere Portal Server 所需执行的操作。 services.war 文件位于 <IICE_HOME>/war 目录。

1. >启动 WebSphere Application Server Administrative Console。

   对于 WebSphere Application Server, Version 5，可以通过打开一个 Web 浏览器并访问 http://hostname:port/admin 来启动 Administrative Console，其中 hostname 是 WebSphere Portal Server 的主机名，port 是 WebSphere Application Server Administrative Console 的端口号。通常，管理控制台的端口号为 9090。

2. 在 WebSphere Application Server Administrative Console 的右侧面板中，展开 Application， 然后单击 安装 New Application。
   
   
3. 选中服务器路径旁的单选按钮，然后输入 <IICE_HOME>/war/services.war，其中 <IICE_HOME> 是 WebSphere Information Integrator Content Edition 安装目录。（请参阅 前一节。) 在 Context Root 下，输入参数 /services， 然后单击 Next。
   
   图 6: 安装 Services.war
   
   
   
4. 在下一个屏幕上，接受默认值，然后单击 Next 或 Continue 继续。
   
   
5. 选择 "IBM WebSphere Information Integrator Content Edition Services" 旁的复选框，并选择列表 Clusters and Servers 下的 WebSphere:cell=<cell_name>, node=<node_name>,server=WebSphere_Portal，将新的应用程序映射到 WebSphere Portal。Cell_name 和 node_name 是您的 WebSphere Portal Server 的单元名和节点名。单击 Apply，然后单击 Next。
   
   图 7. 将应用程序映射到 WebSphere Portal
   
   
   
6. 单击 Next，然后单击 Finish。
   
   
7. 单击最后一个应用程序安装屏幕上的 Save to Master Configuration，然后再次单击 Save。
   
   图 8. 保存应用程序安装到主配置
   
   
   接下来的步骤将文件 vbr.jar 和 vbr_pdm.jar 添加到 services.war 应用程序的共享库中，以完成门户服务器机器上的 WebSphere Information Integrator Content Edition Portal Document Manager 配置。
   
   
8. 在 WebSphere Application Server Administrative Console 中，展开左侧面板中的 Environment，然后选择 Shared Libraries，创建一个名为 IICE Library 的共享库。单击 New。
   
   
9. 在新的共享库面板中，在 configuration 选项卡中的 general properties 下：
   1. 在 Name 文本域中输入 IICE Library。
   2. 在 Description 文本域中输入一个简短的描述，例如 "contains library for service_war application"。
   3. 在 Classpath 文本域中输入 <IICE_HOME>/lib/vbr.jar 和 <IICE_HOME>/ejb/vbr_pdm.jar。
   
   
   图 9. 新的共享库
   
   
   
10. 浏览到 services_war 应用程序：
    1. 展开左侧面板中的 Applications。
    2. 选择 Enterprise Applications。
    3. 从显示的列表中找到并选择 services_war 应用程序。这时将显示 services_war 配置页面。
11. 在 Configuration 屏幕中的 additional properties 中，选择 Libraries， 然后单击 Add。选择 IICE Library 作为要添加的库引用。 单击 Apply，然后单击 Save，将设置保存到主配置文件中。
    
    图 10. 添加库引用
    
    
    
12. 访问 http://<hostname>:9081/services/，确认服务运行正常，其中 hostname 是 WebSphere Portal 机器的主机名。在浏览器中应该可以看到 WebSphere Information Integrator Content Edition 服务的状态，类似于 图 11 中所示的屏幕快照。
    
    图 11. 服务监视器
    
    
    
13. 最后，设置 Portal JVM 中的 vbr.home 环境变量，使之指向 <IICE_HOME>，通常的路径为 /opt/IBM/WebSphereIICE。
    1. 展开 Servers 并选择左侧面板中的 Application Servers。
    2. 单击 WebSphere_Portal，显示配置页面。
    3. 在 additional properties 下，单击 Process Definition。
    4. 在 additional properties 下，单击 Java Virtual Machines。
    5. 在 additional properties 下，单击 Custom Properties。
    6. 在 General Properties 页面中，在 name 文本域中输入 vbr.home，在 value 文本域中输入 <IICE_HOME>。
    7. 单击 Apply，然后单击 Save。
    
    
    图 12. 设置 vbr.home 变量
    
    
    

回页首

配置到 Portal Document Manager（一个 WebSphere Information Integrator Content Edition 知识库）的 direct 访问模式

本节描述如何配置 WebSphere Information Integrator Content Edition 管理控制台，以便以 direct 模式运行，以及如何配置 PDM connector on the OmniFind 搜索 crawler 服务器。

1. 请确认环境变量 VBR_HOME 和 JAVA_HOME 指向 <IICE_INSTALL_ROOT> 的正确目录。通常，<:IICE_INSTALL_ROOT> 为 OmniFind crawler 服务器上的 /opt/IBM/es/content_edition，而 VBR_HOME 则是服务器上的 /opt/IBM/es/content_edition。
   
   
2. 将 vbr.as.operationMode=direct 添加到 <IICE_INSTALL_ROOT>/bin/Admin.sh 文件中。该文件应该包含以下内容：

            java -classpath             "$VBR_CLASSPATH"             -Dvbr.home="$VBR_HOME"             -Dvbr.as.operationMode=direct             -Dlog4j.category.com.venetica.vbr.tools.admin=WARN             com.venetica.vbr.tools.admin.AdminFrame $1 $2 $3 $4
            

3. 为了以 direct 模式启用 WebSphere Information Integrator Content Edition 管理工具，运行 <IICE_INSTALL_ROOT>/bin 中的 Admin.sh。
   
   
4. 创建一个新的 WebSphere Portal Document Manager 连接器:
   1. 右键单击 Connectors。
   2. 选择 NEW IBM WebSphere Portal Document Manager 连接器。
      
      图 13. WebSphere Information Integrator Content Edition 中新的 WebSphere Portal Document Manager 连接器
      
      
      
5. 通过设置以下参数，配置 Portal Document Manager 连接器，以使用 RMI 代理：
   1. 将 Use RMI 代理连接器属性设置为 TRUE。
   2. 将 RMI 代理连接器 URL 设置为 rmi://<WebSpherePortal_Server>:1251/RMIBridgeServer2，其中 <WebSpherePortal_Server> 是 WebSphere Portal Server 机器的主机名。
      
      图 14. 在 WebSphere Information Integrator Content Edition 中配置 Portal Document Manager 连接器
      
      
      
6. 右键单击 Portal Document Manager 连接器，并选择 Test Connection，以确认您的配置正确。如果 RMI 代理连接器配置成功，您将收到如 图 15 所示的一条消息。
   
   图 15: 在 WebSphere Information Integrator Content Edition 中测试连接
   
   
   

回页首

安装 APAR PK10952

关于安装 APAR PK10952 的说明，请参阅 OmniFind Information Center。

回页首

创建 Content Edition crawler

完成前面所有的步骤后，便可以创建一个 Content Edition crawler，以便允许在 WebSphere Information Integrator OmniFind Edition Administrative Interface 中的 Portal Document Manager 知识库中进行搜索。

关于配置 crawler 的配置说明，请参阅 OmniFind Information Center。

回页首

结束语

本文带您亲历了在 WebSphere Information Integrator OmniFind Edition 中创建 Content Edition crawler 之前必须执行的一些步骤。这些步骤包括在 Portal Server 上安装 WebSphere Information Integrator Content Edition RMI 代理 Portal Document Manager 连接器，以及将 WebSphere Information Integrator Content Edition 与 WebSphere Portal Server 集成。完成这些步骤后，就可以在 OmniFind 管理员界面上直接爬行、解析、索引和搜索。