安装 WebSphere Partner Gateway

当满足上一部分中提到的所有先决条件时,您已经为运行“数据库装入器”和 WebSphere Partner Gateway 安装向导准备就绪。可以直接执行这些向导,或通过启动板来执行。请参阅启动板以获取更多信息。

注:
使用 AIX 上的缺省 tar 程序不能成功将 AIX 电子产品映像 tar 文件解压缩,因为映像的路径长度超过了 100 个字符。 不过,IBM 发布了一个 tar 程序,它可以成功解压缩 AIX 电子产品映像 tar 文件。可以从 AIX Toolbox for Linux Applications 的下列位置获得该 tar 程序:
http://www-1.ibm.com/servers/aix/products/aixos/linux/download.html

DISPLAY 环境变量

“数据库装入器”和中心安装向导在 UNIX 上使用 X Windows System 来显示图形用户界面。 X Window System 要求将 DISPLAY 环境变量导出到系统环境。下列行可以从 Bourne shell 将 DISPLAY 环境变量设置为 IP_Address。

DISPLAY=IP_Address:0.0

export DISPLAY

使用适合您 shell 的语法来设置 DISPLAY 环境变量。

注:
通过从命令行运行 X 客户机程序(如 xclock)来测试是否正确地配置 DISPLAY 系统环境变量和 X Windows System。 如果 xclock 客户机在 X 服务器窗口(本地或远程)上显示,则向导也可以正确地显示。

启动板

WebSphere Partner Gateway 提供了“启动板”程序,可以提供对产品概述、自述文件、产品文档、数据库装入器和 WebSphere Partner Gateway 安装程序的“一站式”访问。或者,您可以使用所提供的 setup*.* 程序启动“数据库装入器”和安装程序。请参阅创建数据库使用安装向导安装组件

注:
启动板上的某些选项要求已安装某个浏览器,并且该浏览器在系统路径中可用。

启动板的可执行文件位于:

{CD_ROM/MEDIA DIR}/LaunchPad.sh

创建数据库

WebSphere Partner Gateway 包含一个设置数据库表的安装向导。该向导就是“数据库装入器”,它负责收集信息以为您创建和填充表。此外,它还可以保存用于创建表的 SQL 文件。然后您可以使用这些 SQL 文件创建和填充表。手动运行 SQL 文件允许数据库管理员在填充数据库表之前查看它们。

开始之前,请验证已安装了数据库服务器,该服务器已经进行了正确配置,并且正在运行。

DBLoader 可以在不具备实际数据库的机器上运行。Oracle/DB2 应该安装在该机器上,但是实际的数据库可以在另一台机器上。DBA 需要为此进行某些配置更改,这可能超出了本指南的范围。首先在远程机器上创建数据库。 然后利用将安装 dbloader 的机器上的 oracle/db2 配置远程数据库,指定将要在哪一台机器上运行以及使用哪一个端口。一旦完成该配置,DBLoader 就可以像数据库安装在本地一样运行。Oracle/DB2 将自动处理余下事务。所有针对该数据库的的 sql 命令都将转至正确的机器进行处理。SQL 可以自动运行。

下列步骤描述了如何使用“数据库装入器”GUI 来配置数据库。也可以不使用 GUI 安装“数据库装入器”。请参阅使用命令行安装组件以获取信息。

注:
请查阅 DB2 文档以了解具体的操作系统需求,例如配置设置或所需要的产品版本。

要设置数据库表:

  1. 以 root 用户登录。

    “数据库装入器”需要管理员特权以自动运行负责创建/更改表空间目录所有权的 SQL。

  2. 从 Database Loader 目录中,运行表 9中所列出的特定于您的平台的 setup 可执行程序:

    cd DBLoader

    表 9. 特定于平台的安装程序可执行文件
    平台 可执行文件

    Linux

    setupLinux

    AIX

    setupAIX

    Solaris

    setupSunOS

    “数据库装入器”向导会启动和显示欢迎窗口。单击下一步

  3. 在“软件许可证协议”窗口中,阅读“软件许可证协议”。如果同意协议中的条款,请选择我接受许可证协议中的条款。单击下一步
  4. 在“目录名”窗口中,输入“数据库装入器”在设置数据库时将使用的目录的路径和目录名。IBM 建议您创建一个新目录位置,或选择一个空目录。目录名中不应使用嵌入空格或特殊字符。

    选择一个可为您的数据库提供足够空间的位置,所有的应用程序数据都将存储在该位置中。单击下一步。

    注:
    在选择了希望的安装路径后,当进行浏览以选择目录时,请在输入文件名字段中输入“.”。如果没有输入“.” ,则选择目录窗口不会返回到启动它的窗口。
  5. 在“数据库类型选择”窗口中,选择要用于 WebSphere Partner Gateway 的数据库服务器。您可以选择 DB2 8.2 或者 Oracle 9i 9.2.0.4 或更高版本。单击下一步
  6. 在“数据库信息”窗口中,输入以下数据库信息,然后在完成时单击下一步

    DB2

    如果您选择 DB2,则出现“DB2 数据库信息”窗口。输入下列 DB2 数据库信息:

    Oracle

    1. 如果您选择 Oracle,则出现“Oracle 数据库信息”窗口。输入下列 Oracle 数据库信息:
      • 管理员登录标识
      • 管理员密码
      • Oracle SID
      • 模式所有者登录
      • 模式所有者密码
    2. 会出现 Oracle 起始位置窗口。输入 Oracle 主目录位置或单击浏览以输入。请参阅图 2

      图 2. Oracle 主目录位置窗口
  7. 在“数据库位置”窗口,图 3对于 DB2 和图 4 Oracle,输入数据库位置的完整路径和数据库服务器上的各个表空间。例如,DB2 数据库目录路径可能象这样:DB2Home/IBM/bcgdbloader/tables
    注:
    在选择了希望的安装路径后,当进行浏览以选择目录时,请在输入文件名字段中输入“.”。如果没有输入“.” ,则选择目录窗口不会返回到启动它的窗口。
    如果更改了这些值中的任何值,则在执行 SQL 文件前它们必须存在。如果不存在,则必须手工创建它们。

    一旦输入好必需的信息,请单击下一步

    注:
    请选择具有充分空间保存数据库和所有应用程序数据的文件系统位置。 在运行 WebSphere Partner Gateway 时数据库大小会增大。

    DB2

    图 3. “DB2 数据库位置”窗口

    Oracle

    图 4. “Oracle 数据库位置”窗口
  8. 在“组件配置”窗口(图 5)中,输入 WebSphere Partner Gateway 组件的登录信息以及公共共享文件的位置。完成时单击下一步

    在社区控制台、文档管理器和接收器的用户名密码字段中,输入用于每个组件的用户的名称和密码。如果使用 DB2,则这些用户是在配置服务器时创建的。

    组名字段中,输入包含 WebSphere Partner Gateway 用户的组的名称。

    图 5. “组件配置”窗口
  9. 从共享信息窗口的“安装点”中,输入 WebSphere Partner Gateway 的主组件通用共享文件的位置。
    注:
    1. 如果您正在在多台机器上安装 WebSphere Partner Gateway,那么所有这些机器上的共享通用文件夹必须使用相同的安装点和目录结构。
    2. 在选择了希望的安装路径后,当进行浏览以选择目录时,请在输入文件名字段中输入“.”。如果没有输入“.” ,则选择目录窗口不会返回到启动它的窗口。
  10. 向导将显示一个供您选择的窗口,在其中您可以选择“数据库装入器”是只创建 SQL 文件,还是创建 SQL 文件然后运行这些文件。请参阅图 6

    当“数据库装入器”运行 SQL 文件时,它完成下列工作:

    因为“数据库装入器”会重新启动作为其例程一部分的 DB2 实例,所以当您在设置 WebSphere Partner Gateway 数据库时,请断开正在使用 DB2 实例的任何应用程序。

    如果您希望“数据库装入器”为您运行这些文件,请选中运行 SQL 文件复选框。单击下一步

    图 6. “运行 SQL 文件”窗口
  11. 确认“数据库装入器”的安装位置。单击下一步
  12. “完成”按钮启用时,请单击完成
  13. 如果您正在手工运行 SQL,则请参阅 bcgdbloader/scripts 子目录(由“数据库装入器”安装向导安装)中的 Instructions.txt 文件,以获取更多信息。

    设置好 WebSphere Partner Gateway 数据库后,您已经为安装 WebSphere Partner Gateway 组件准备就绪。

    下一部分描述了如何使用 InstallShield 向导 GUI 安装组件。也可以不使用 GUI 安装组件。请参阅使用命令行安装组件以获取信息。

使用安装向导安装组件

WebSphere Partner Gateway 包含三个主要组件:社区控制台、接收器和文档管理器。所有三个组件都共享公共内容。您可以将组件和公共内容安装在一台服务器上,或者将每个组件安装独立的服务器上,也可以组合使用这两种选项。至少 必须在一台服务器上安装每个组件的一个实例。请参阅环境规划拓扑以获取有关如何规划将各种组件放置在不同服务器上的信息。

注:
如果在多台机器上安装 WebSphere Partner Gateway,则共享的 common 文件夹必须在所有的机器上使用相同的安装点和目录结构。

开始之前,请确保已经安装了必备软件,并且这些软件已经正确配置。请查阅平台,硬件,和软件需求中所有 WebSphere Partner Gateway 服务器的需求表以了解软件先决条件,并请查阅安装概述以获取有关如何配置该软件的信息。您还必须设置好了 WebSphere Partner Gateway 数据库。有关这方面的信息,请参阅创建数据库。最后,您的数据库服务器和 WebSphere MQ 必须都在运行,包括队列管理器和侦听器。

当使用整合式拓扑以外的任何拓扑时,公共的组件只需安装一次。

要安装 WebSphere Partner Gateway:

  1. 以 root 管理员身份登录。

    中心安装程序需要 root/管理员特权以便与本机软件注册表集成在一起。

  2. 在中心目录中,运行表 10中所列出的特定于您平台的 setup 可执行程序。
    表 10. 特定于平台的安装程序可执行文件
    平台 可执行文件

    Linux

    setupLinux

    AIX

    setupAIX

    Solaris

    setupSolaris

    向导会启动和显示“欢迎”窗口。单击下一步

  3. 阅读“软件许可证协议”窗口中的许可证协议。如果同意其条款,请单击我接受许可证协议中的条款。单击下一步
  4. 在“目录名”窗口中,输入当安装“WebSphere Partner Gateway”时该向导应该使用的目录的路径和目录名。IBM 建议您创建一个新目录位置,或选择一个空目录。目 录名中不应该使用嵌入空格或特殊字符。单击下一步
    注:
    在选择了希望的安装路径后,当进行浏览以选择目录时,请在输入文件名字段中输入“.”。如果没有输入“.” ,则选择目录窗口不会返回到启动它的窗口。
  5. 在“组件选择”窗口(图 7)中,选择您想要安装在服务器上的组件。可以选择多个组件。单击下一步
    图 7. “组件选择”窗口

    本步骤的余下部分假定您将在该组件上安装所有组件。如果不安装所有组件,则本步骤的余下部分中描述的某些窗口将不会出现。

  6. 请为您正在其上安装的机器指定标准主机名称。单击下一步
  7. 选择将用于主管 WebSphere Partner Gateway 的以下 WebSphere Application Server 的一个。请参阅图 8。 单击下一步
  8. 在“数据库服务器选择”窗口中,图 9,选择您要使用的数据库。 您可以选择 DB2 8.2 或更高版本Oracle 9i 9.2.0.4 或更高版本。 单击下一步
    图 9. 数据库选择窗口
  9. 会出现“数据库信息”窗口。如果选择 DB2 作为您的数据库服务器,则遵循本步骤中特定于 DB2 的指示信息。如果选择 Oracle 作为您的数据库服务器, 则遵循本步骤中特定于 Oracle 的指示信息。

    DB2

    如果您选择了 DB2,则会出现“DB2 数据库信息”窗口。图 10.

    输入运行 DB2 的计算机的主机名,如果 DB2 尚未安装在当前系统上,则用包含 DB2 的系统的名称替换 localhost

    端口字段中,输入 DB2 实例正在使用的端口号。要了解 DB2 实例正在使用哪个端口,请使用 DB2 控制中心(GUI)来确定属性,或者在命令提示符中输入以下 DB2 配置命令:db2 get dbm cfg。“数据库装入器”也将 DB2 配置信息保存在系统的 temp/bcgdbloader/logs 目录中。缺省端口是 50000。

    所有者名所有者密码数据库名模式名字段中,分别输入所有者名称、所有者密码、数据库名和实例名。 这些名称用在“数据库装入器”安装中,以定义数据库。请参阅创建数据库

    单击下一步

    图 10. DB2 信息窗口

    Oracle:

    如果您选择了 Oracle,那么将出现数据库信息窗口,请参阅图 11

    输入有关 Oracle 数据库的必需信息。缺省端口是 1521。

    JDBC 驱动程序的全路径和名称必须指向本计算机上正确版本的驱动程序。可以在 Oracle 的安装目录中找到该驱动程序。

    也可以从 http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html 下载该驱动程序。在“JDBC 驱动程序下载”部分中,单击 Oracle xx Rx 驱动程序。 请确保选择与您正在运行的 Oracle xx 版本相匹配的驱动程序版本。

    注:
    在选择了希望的安装路径后,当进行浏览以选择目录时,请在输入文件名字段中输入“.”。如果没有输入“.” ,则选择目录窗口不会返回到启动它的窗口。

    单击下一步

    图 11. Oracle 数据库信息窗口

    会出现“数据库连接确认”窗口。请参阅图 12。如果连接成功,则请记录并确认表、视图、函数和过程的计数信息。如果连接失败,请查看信息窗口以获取指导,或者参考数据库文档以解决错误代码。

    图 12. “数据库连接确认”窗口
  10. 在“用户信息”窗口中,输入负责安装的管理员的用户名、密码和组名。 单击下一步
    注:
    该信息必须与“数据库装入器”安装中使用的信息匹配。
  11. 在“公共信息目录”窗口中,输入组件共享的公共信息的位置。单击下一步
    注:
    在选择了希望的安装路径后,当进行浏览以选择目录时,请在输入文件名字段中输入“.”。如果没有输入“.” ,则选择目录窗口不会返回到启动它的窗口。
  12. 在“WebSphere MQ 服务器”窗口(图 13)中,输入运行 WebSphere MQ 的计算机的主机名(如果它未安装同一计算机上)。如果未使用队列管理器的缺省名,则请务必更改该名称。

    如果 WebSphere MQ 不是位于当前机器上,则在主机名字段中将 localhost 替换为包含 WebSphere MQ 的系统的名称。

    队列管理器字段中,将缺省名替换为在配置 WebSphere MQ 时使用的名称(请参阅配置 WebSphere MQ 中的步骤 2)。

    侦听器端口字段中,输入侦听器正在使用的端口(请参阅配置 WebSphere MQ)。缺省端口为 9999

    单击下一步

    图 13. “WebSphere MQ 服务器”窗口
  13. 如果您选择安装“社区控制台”,则请使用“社区控制台”配置窗口配置它。请参阅图 14

    用户名字段中,输入“社区控制台”组件用于登录到数据库的用户标识。

    密码字段中,输入与用户名相关的密码。请务必输入正确的密码,因为如果密码错误,则“社区控制台”将无法运行。

    HTTP 端口字段中,输入组件进行侦听以获取消息的端口的名称。 社区控制台、接收器和文档管理器必须拥有各自唯一的端口号,而且这些端口号必须在本计算机上可用。缺省端口为 58080

    HTTPS 端口字段中,输入组件进行侦听以获取消息的安全端口的名称。 社区控制台、接收器和文档管理器必须拥有各自唯一的端口号,而且这些端口号必须在本计算机上可用。缺省端口为 58443

    单击下一步

    注:
    如果数据库连接失败,则将出现“数据库信息”窗口。请查看信息窗口以获取指导,或者请参考数据库文档以解决错误代码。
    图 14. “社区控制台配置”窗口
  14. 如果您选择了接收器或文档管理器组件,则请使用它们各自的配置窗口配置它们。这些窗口与“社区控制台配置”屏幕具有相同的字段。所有这三个组件(社区控制台、接收器和文档管理器)都必须具有不同的 HTTP 和 HTTPS 端口。 请参阅第 图 15 页上的图 图 15图 16
    注:
    如果在不同的机器上安装接收器和文档管理器,则接收器机器必须含有能被文档管理器机器解析的主机名。
    图 15. “接收器配置”窗口
    图 16. “文档管理器配置”窗口
  15. 在“RosettaNet 配置”窗口(图 17)中,输入 RosettaNet 消息的联系人信息。如果不知道正确的值,使用必需的缺省值。如果您在使用 RosettaNet,则该信息是必需的,对于所有安装都建议输入该信息。

    姓名字段中,输入在出现 RosettaNet 问题时应当联系的人员的姓名。

    电话号码传真号码字段中,输入 RosettaNet 联系人的电话号码和传真号码。

    电子邮件地址字段中,输入 RosettaNet 联系人的电子邮件地址。

    单击下一步

    图 17. “RosettaNet 配置”窗口
  16. 在“警报通知”字段(图 18)中,配置 WebSphere Partner Gateway 以便它可以通过电子邮件发送警报。这些值是必需的。如果不知道正确的值,则使用缺省值。

    SMTP 中继字段中,如果 SMTP 未运行在本计算机上,则请输入该 SMTP 的主机名。

    发件人地址字段中,输入 WebSphere Partner Gateway 将用来发送电子邮件的电子邮件地址。

    收件人地址字段中,输入目的电子邮件地址,该地址是用户响应“警报通知”时用于发送响应电子邮件的地址。

    单击下一步

    图 18. “警报通知”窗口
  17. 在“摘要”窗口上,查看该面板上的信息,该信息标识了将安装的组件。如果该信息中有任何不正确的内容,则请单击上一步以返回到前面的窗口。如果摘要窗口上的所有信息都正确,请单击下一步
  18. WebSphere Partner Gateway 安装程序安装和配置选定的组件。当该任务完成时,安装程序将激活完成按钮。单击完成

在您希望安装 WebSphere Partner Gateway 组件的每台服务器上重复上述步骤。公共内容只需安装一次,因为通过共享的文件系统可将它用于所有计算机。

安装完所有 WebSphere Partner Gateway 组件后,请参阅启动 WebSphere Partner Gateway

Copyright IBM Corp. 2003, 2005