正在安装 WebSphere Partner Gateway
当满足上一部分中提到的所有先决条件时,您已经为运行“数据库装入器”和 WebSphere Partner Gateway 安装向导准备就绪。
启动板
WebSphere Partner Gateway 提供了一个启动板程序来提供对产品概述、自述文件、产品文档、数据库装入器和 WebSphere Partner Gateway 安装程序的“一站式”访问。或者,您可以使用所提供的 setup*.* 程序启动“数据库装入器”和安装程序。请参阅创建数据库和使用安装向导安装组件。
注:
启动板上的某些选项要求已安装某个浏览器,并且该浏览器在系统路径中可用。
启动板可执行文件位于以下目录中:
{CD_ROM/MEDIA DIR}/LaunchPad.*
创建数据库
WebSphere Partner Gateway 包含一个设置数据库表的安装向导。该向导就是“数据库装入器”,它负责收集信息以为您创建和填充表。或者,它可以保存用来创建表的
SQL 文件,以便可以使用它们来手工创建和填充这些表。手动运行 SQL 文件允许数据库管理员在填充数据库表之前查看它们。
开始之前,请验证已安装了数据库服务器,该服务器已经进行了正确配置,并且正在运行。
下列步骤描述了如何使用“数据库装入器”GUI 来配置数据库。也可以不使用 GUI 安装“数据库装入器”。
注:
如果您打算使用 DB2 作为您的数据库服务器,那么必须以 DB2ADMIN Windows 用户身份执行 SQL(手工或自动)。
要设置数据库表:
- 如果您使用 DB2 作为您的数据库,则以 DB2ADMIN 身份登录。
- 运行位于 WebSphere Partner Gateway 系统产品 CD 上的“数据库装入器”的 CD-MediaDir\DBLoader\setup.exe 文件。
“数据库装入器”向导会启动和显示欢迎窗口。单击下一步。
- 在“软件许可证协议”窗口中,阅读“软件许可证协议”。如果同意协议中的条款,请选择我接受许可证协议中的条款。单击下一步。
-
在“目录名”窗口中,输入“数据库装入器”在设置数据库时将使用的目录的路径和目录名。IBM 建议您创建一个新目录位置,或选择一个空目录。
选择一个空间足够的位置,您的数据库和所有应用程序都将存储在该位置中。
注:
在选择了希望的安装路径后,当进行浏览以选择目录时,请在输入文件名字段中输入“.”。如果没有输入“.” ,则选择目录窗口不会返回到启动它的窗口。
单击下一步。
- 在“数据库类型选择”窗口中,选择要用于 WebSphere Partner Gateway 的数据库服务器。您可以选择
DB2 8.2 或者 Oracle 9i 9.2.0.4 或更高版本。单击下一步。
- 在“数据库信息”窗口中,输入以下数据库信息,然后在完成时单击下一步。
DB2
如果您选择 DB2,则出现“DB2 数据库信息”窗口。输入下列 DB2 数据库信息:
注:
如果更改了这些值中的任何值,则在执行 SQL 文件前它们必须存在。如果不存在,则必须手工创建它们。
Oracle
- 如果您选择 Oracle,则出现“Oracle 数据库信息”窗口。输入下列 Oracle 数据库信息:
- 管理员登录标识
- 管理员密码
- Oracle SID
- 模式所有者登录
- 模式所有者密码
- 会出现 Oracle 起始位置窗口。输入 Oracle 主目录位置或单击浏览以输入。图 19 .
注:
如果更改了这些值中的任何值,则在执行 SQL 文件前它们必须存在。如果不存在,则必须手工创建它们。
图 19. Oracle 主目录位置窗口
- 在“数据库位置”窗口,选择有足够空间的文件系统的位置来保存数据库和所有应用程序数据。
在运行 WebSphere Partner Gateway 时数据库大小将增加。
DB2
输入 RDBMS 服务器上的数据库位置和每个表空间。该字段必须包含全路径。单击下一步。请参阅图 2。
注:
在选择了希望的安装路径后,当进行浏览以选择目录时,请在输入文件名字段中输入“.”。如果没有输入“.” ,则选择目录窗口不会返回到启动它的窗口。
图 20. “DB2 数据库位置”窗口
Oracle
输入 RDBMS 服务器上的数据库的位置和每个表空间。该字段必须包含全路径。单击下一步。请参阅图 21。
注:
在选择了希望的安装路径后,当进行浏览以选择目录时,请在输入文件名字段中输入“.”。如果没有输入“.” ,则选择目录窗口不会返回到启动它的窗口。
- 在“组件配置”窗口(请参阅图 22)中,输入 WebSphere Partner Gateway 组件的登录信息以及公共共享文件的位置。
在社区控制台、文档管理器和接收器的用户名和密码字段中,输入用于每个组件的用户的名称和密码。如果使用 DB2,则这些用户是在配置服务器时创建的。
在组名字段中,输入包含 WebSphere Partner Gateway 用户的组的名称。
单击下一步。
- 系统会显示“共享信息的安装点”窗口。输入 WebSphere Partner Gateway 的主组件使用的公共共享文件的位置。单击下一步。
注:
- 如果您正在在多台机器上安装 WebSphere Partner Gateway,那么所有这些机器上的共享通用文件夹必须使用相同的安装点和目录结构。
- 在选择了希望的安装路径后,当进行浏览以选择目录时,请在输入文件名字段中输入“.”。如果没有输入“.” ,则选择目录窗口不会返回到启动它的窗口。
- 该向导会显示一个窗口(请参阅图 23),在其中您可以选择“数据库装入器”是只创建 SQL 文件,还是创建 SQL 文件然后为您运行这些文件。
如果“数据库装入器”运行 SQL 文件时,它完成下列工作:
- 创建表空间
- 创建模式
- 创建表、视图、序列、过程和函数,然后用元数据填充它们
- 分配对表的许可权
- 创建存储过程
因为“数据库装入器”会重新启动作为其例程一部分的 DB2 实例,所以当您在设置 WebSphere Partner Gateway 数据库时,请断开正在使用 DB2 实例的任何应用程序。
如果您希望“数据库装入器”为您运行这些文件,请选中运行 SQL 文件复选框。单击下一步。
- 确认“数据库装入器”的安装位置。单击下一步。
- “完成”按钮启用时,请单击完成。
- 如果您正在手工运行 SQL,则请参阅 bcgdbloader/scripts 子目录(由“数据库装入器”安装)中的 Instructions.txt 文件,以获取更多信息。
设置好 WebSphere Partner Gateway 数据库后,您已经为安装 WebSphere Partner Gateway 组件准备就绪。
使用安装向导安装组件
WebSphere Partner Gateway 包含三个主要组件:社区控制台、接收器和文档管理器。所有三个组件都共享公共的内容。您可以将组件和公共内容安装在一台服务器上,或者将每个组件安装单独的服务器上。至少
必须在一台服务器上安装每个组件的一个实例。请参阅环境规划和拓扑以获取有关如何规划将各种组件放置在不同服务器上的信息。
注:
如果在多台机器上安装 WebSphere
Partner Gateway,则共享的 common 文件夹必须在所有的机器上使用相同的盘符和目录结构。
开始之前,请确保已经安装了必备软件,并且这些软件已经正确配置。请查阅平台,硬件,和软件需求中所有 WebSphere Partner Gateway 服务器的需求表以了解软件先决条件,并请查阅验证和配置已安装的必备软件以了解有关如何配置该软件的信息。
您还必须设置了 WebSphere Partner Gateway 数据库。有关这方面的信息,请参阅创建数据库。最后,您的数据库服务器和 WebSphere MQ 必须都在运行,包括队列管理器和侦听器。
下面的步骤描述了如何使用 InstallShield 向导 GUI 安装组件。
注:
也可以使用命令行安装组件。请参阅
使用命令行安装组件以获取详细信息。
要安装 WebSphere Partner Gateway,请遵循这些步骤:
- 以具有管理员特权的用户身份登录。
中心安装程序需要管理员特权以正确创建 Windows 服务。
- 运行位于 WebSphere Partner Gateway 系统产品 CD 上的 CD-MediaDir\hub\setup.exe 文件。
向导会启动和显示“欢迎”窗口。单击下一步。
- 阅读“软件许可证协议”窗口中的许可证协议。如果同意其条款,请单击我接受许可证协议中的条款。单击下一步。
- 在“目录名”窗口中,输入安装 WebSphere Partner Gateway 目录的路径和目录名。IBM 建议您创建一个新目录位置,或选择一个空目录。单击下一步。
注:
在选择了希望的安装路径后,当进行浏览以选择目录时,请在输入文件名字段中输入“.”。如果没有输入“.” ,则选择目录窗口不会返回到启动它的窗口。
- 在“组件选择”窗口(图 24)中,选择您想要安装在服务器上的组件。可以选择多个组件。
单击下一步。
本步骤的余下部分假定您将在该组件上安装所有组件。如果不安装所有组件,则本步骤的余下部分中描述的某些窗口将不会出现。
- 请为您正在其上安装的机器指定标准主机名称。单击下一步。
- 选择用于主管 WebSphere Partner Gateway 的以下 WebSphere Application Server 的其中之一,然后单击下一步。
请参阅图 7。
- 在“数据库服务器选择”窗口中,图 26,选择您要使用的数据库服务器。
您可以选择 DB2 8.2 或更高版本或者 Oracle 9i.9.2.0.4 或更高版本。
单击下一步。
- 这样会出现“数据库信息”窗口。如果选择了 DB2 作为您的数据库,则遵循本步骤中特定于 DB2 的指示信息。
如果选择了 Oracle 作为您的数据库,则遵循本步骤中特定于 Oracle 的指示信息。
DB2
如果您选择了 DB2,则会出现“DB2 数据库信息”窗口。请参阅图 27。
如果 DB2 不在当前系统上,则在主机名字段中,将 localhost 替换为包含 DB2 的系统的名称。
在端口字段中,输入 DB2 实例正在使用的端口。要了解 DB2 实例正在使用哪个端口,请使用 DB2 控制中心(GUI)来确定属性,或者在命令行上输入以下命令:db2 get dbm cfg。“数据库装入器”还将该信息(DB2 配置)保存在 "system temp"/bcgdbloader/logs 目录中。
缺省端口为 50000。
在所有者名、所有者密码、数据库名和模式名字段中,输入需要的信息。
这些名称是“数据库装入器”安装中用于定义数据库的名称。请参阅创建数据库。
单击下一步。
Oracle
如果您选择 Oracle,则出现“Oracle 数据库信息”窗口。图 28。
输入有关 Oracle 数据库的必需信息。缺省端口为 1521。
注:
JDBC 驱动程序的全路径和名称必须指向本计算机上驱动程序的正确版本。该驱动程序可在 Oracle 安装目录树中找到。也可以从 http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html 下载该驱动程序。
在“JDBC 驱动程序下载”部分中,单击 Oracle xx Rx 驱动程序。
请确保选择与您正在运行的 Oracle 版本匹配的驱动程序版本。
注:
在选择了希望的安装路径后,当进行浏览以选择目录时,请在输入文件名字段中输入“.”。如果没有输入“.” ,则选择目录窗口不会返回到启动它的窗口。
这样会出现“数据库连接确认”窗口。请参阅图 29。
如果连接成功,则请记录并确认表、视图、函数和过程的计数信息。如果连接失败,请查看信息窗口以获取指导,或者参考数据库文档以解决错误代码。
- 在“公共信息目录”窗口中,输入公共共享组件的位置。该值必须与“数据库装入器”安装中使用的目录位置匹配。
注:
在选择了希望的安装路径后,当进行浏览以选择目录时,请在输入文件名字段中输入“.”。如果没有输入“.” ,则选择目录窗口不会返回到启动它的窗口。
- 在“WebSphere MQ 服务器”窗口中,输入有关 WebSphere MQ 服务器的必需信息。请参阅图 30。
如果 WebSphere MQ 不是位于当前机器上,则在主机名字段中将 localhost 替换为包含 WebSphere MQ 的系统的名称。
在队列管理器字段中,将缺省名替换为配置 WebSphere MQ 时使用的名称(请参阅配置 WebSphere MQ。)
在侦听器端口字段中,输入侦听器正在使用的端口(请参阅配置 WebSphere MQ。)缺省端口是 9999。
单击下一步。
图 30. “WebSphere MQ 服务器”窗口
- 这样会出现“Windows 服务安装”窗口。如果您希望将 WebSphere Partner Gateway 功能注册为 Windows 服务,
请选中作为 Windows 服务安装复选框。
请参阅图 31。
单击下一步。
- 如果您选择安装“社区控制台”,则请使用“社区控制台”配置窗口配置它。请参阅图 32。
在用户名字段中,输入“社区控制台”组件用于登录到数据库的用户标识。
在密码字段中,输入与用户名相关的密码。请务必输入正确的密码,因为如果密码错误,则“社区控制台”将无法运行。
在 HTTP 端口字段中,输入组件进行侦听以获取消息的端口号。社区控制台、接收器和文档管理器必须拥有各自唯一的端口号,而且这些端口号在本计算机上必须可用。缺省端口为 58080。
在 HTTPS 端口字段中,输入组件进行侦听以获取消息的安全端口号。社区控制台、接收器和文档管理器必须拥有各自唯一的端口号,而且这些端口号在本计算机上必须可用。缺省端口为 58443。
在帮助系统主机名字段中,输入“帮助系统”将驻留在的服务器的地址。
在帮助系统端口号字段中,输入供访问“帮助系统”用的端口号。
单击下一步。
注:
如果数据库连接失败,则将出现“数据库信息”窗口。请查看信息窗口以获取指导,或者请参考数据库文档以解决错误代码。
- 如果您选择了接收器或文档管理器组件,则请使用它们各自的配置窗口配置它们。这些窗口与“社区控制台配置”窗口具有相同的字段。所有这三个组件(社区控制台、接收器和文档管理器)都必须具有不同的 HTTP 和 HTTPS 端口。
请参阅图 33和图 34。
注:
如果在不同的机器上安装接收器和文档管理器,则接收器机器必须含有能被文档管理器机器解析的主机名。
完成时单击下一步。
- 在“RosettaNet 配置”窗口(图 35)中,输入 RosettaNet 消息的联系人信息。必须在这些文本字段中输入值。如果不知道正确的值,则使用缺省值。如果您在使用 RosettaNet,则该信息是必需的,对于所有安装都建议输入该信息。
在姓名字段中,输入在出现 RosettaNet 问题时应当联系的人员的姓名。
在电话号码和传真号码字段中,输入 RosettaNet 联系人的电话号码和传真号码。
在电子邮件地址字段中,输入 RosettaNet 联系人的电子邮件地址。
单击下一步。
- 在“警报通知”字段(图 36)中,配置 WebSphere Partner Gateway 以便它可以通过电子邮件发送警报。这些值是必需的。如果不知道正确的值,则使用缺省值。
在 SMTP 中继字段中,输入 SMTP 服务器的位置。
在发件人地址字段中,输入 WebSphere Partner Gateway 用来发送电子邮件的电子邮件地址。
在收件人地址字段中,输入目的电子邮件地址,该地址是用户响应“警报通知”时用于发送响应电子邮件的地址。
单击下一步。
- 在“摘要”窗口上,查看该面板上的信息,该信息标识了将安装的组件。如果该信息中有任何不正确的内容,则请单击上一步以返回到前面的窗口。如果摘要窗口上的所有信息都正确,请单击下一步。
- WebSphere Partner Gateway 安装程序安装和配置选定的组件。当该任务完成时,安装程序将激活完成按钮。单击完成。
- 检验下列要设置的值:
DB2:
- 打开 console\lib\config\bcg_console.properties 文件。验证设置了以下值:bcg.co.db.schema=DB2ADMIN。
- 打开 receiver\lib\config\bcg_receiver.properties 文件。验证设置了以下值:bcg.co.db.schema=DB2ADMIN。
- 打开 router\lib\config\bcg.properties 文件。验证设置了以下值:bcg.co.db.schema=DB2ADMIN。
Oracle:
- 打开 console\lib\config\bcg_console.properties 文件。验证设置了以下值:bcg.co.db.schema=BCGAPPS。
- 打开 receiver\lib\config\bcg_receiver.properties 文件。验证设置了以下值:bcg.co.db.schema=BCGAPPS。
- 打开 router\lib\config\bcg.properties 文件。验证设置了以下值:bcg.co.db.schema=BCGAPPS。
- 在您希望安装 WebSphere Partner Gateway 组件的每台服务器上重复上述步骤。公共内容只需安装一次,因为通过共享的文件系统可将它用于所有计算机。
安装完所有 WebSphere Partner Gateway 组件后,请参阅使用命令行安装组件。
