更改历史纪录：
GA：2004 年 7 月 23 日
修订包 5：2005 年 2 月 9 日
本文件包含您在 Microsoft(R) Windows(R) 2000 和 Windows XP 上安装 IBM WebSphere Business Integration Message Brokers Toolkit for WebSphere Studio V5.1 以及执行安装后配置步骤所需的信息。
它仅适用于 Message Brokers Toolkit V5.1 的安装以及 Message Brokers Toolkit V5.1 与 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker V5.0 的一起使用。要获取有关所有其它组件的信息，请参阅 V5.0 自述文件和安装指示信息。
警告！
只有当您已安装了 WebSphere Studio Application Developer Integration Edition V5.1 时，才安装 Message Brokers Toolkit V5.1。如果具有先前版本的 WebSphere Studio
Application Developer Integration Edition，那么请不要安装 Message Brokers Toolkit V5.1，因为先前版本的 WebSphere Studio Application Developer Integration Edition 必须使用 Message Brokers Toolkit V5.0，它是与 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker V5.0 一起提供的。
迁移
如果您要进行迁移，请阅读开始之前。
在团队环境下安装 Message Brokers Toolkit V5.1
WebSphere Studio Application Developer Integration Edition V5.1 不是每次安装 Message Brokers Toolkit V5.1 的必备软件。然而，如果至少一个 Message Broker Toolkit 安装与 WebSphere Studio Application Developer Integration Edition V5.1 集成，则所有 Message Broker Toolkit 安装必须是 V5.1 以确保数据共享和完整性。
如果您没有在任何系统上使用 WebSphere Studio Application Developer Integration Edition V5.1，或者您正在使用 WebSphere Studio Application Developer Integration Edition V5.0，则必须安装 Message Brokers Toolkit V5.0。
文档
您必须通过在线方式查看这些安装指示信息的最新版本。在以下地址可以找到最新版本（仅英语版本）：
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/
这些指示信息的翻译版本将在适当的时候在以下地址提供：
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/
包括在 Message Brokers Toolkit V5.1 中的信息中心不包括译文。 信息中心中的所有本地语言字段都为空，而且所有信息都用英语显示。如果您要用支持的语言而不是美国英语显示信息中心，则必须在已安装修订包之后下载合适的 Eclipse 功能。在修订包可用时或在它可用之后，译文才可用。在自述文件中提供有关如何下载这些更新的指示信息。
WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker 的独立信息中心可供下载。您可以从以下地址下载压缩文件：
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/wbimb_help.zip
请阅读包含在 wbimb_help.zip 文件中的 installing_and_managing.htm 文件。
内容
要获取 Message Brokers Toolkit V5.1 支持的操作系统的特定版本的最新状态，请查看位于以下地址的 WebSphere MQ Family Supported Software 页面：
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
（用于 WebSphere Business Integration Message Broker）或
http://www.ibm.com/software/integration/wbieventbroker/requirements/
（用于 WebSphere Business Integration Event Broker）
这些环境支持 Message Brokers Toolkit V5.1：
它在 Windows 2003 上不受支持。
在您安装 Message Brokers Toolkit V5.1 之前，可能需要完成某些操作：
V5.0 安装指示信息还在主要产品 CD 的 \installdocs\<locale>\install.html 中。
V5.0 修订包 5 信息中心包括 V5.1 Toolkit 和 V5.0 Toolkit 的信息。
如果您要在尚未安装任何其他 Message Brokers 组件的系统上安装 Message Brokers Toolkit V5.1，则安装之前您没有必要执行任何操作。
当您安装 CD 时，安装向导自动启动。您还可以通过在 Windows 资源管理器中双击 setup.exe 或在命令行上调用它来运行安装程序。
这些安装指示信息描述了安装 Message Brokers Toolkit V5.1 必须执行的步骤。
如果您从命令行运行安装程序，则可以指定表明如何执行安装的选项。安装命令行选项中描述了这些选项。
下面显示了命令的格式：
setup.exe [-options-...]
如果没有包括任何选项，安装向导将会启动。
如果 CD 在远程系统上，则您可以映射它的网络驱动器。您不能使用 UNC 路径（\\server\drive）来访问安装程序；必须映射驱动器，否则 JavaTM 进程将超时。 如果您无法映射驱动器，或选择不映射驱动器，可把 CD 的内容复制到本地驱动器并从该驱动器安装。
这些指示信息描述如何进行 Message Brokers Toolkit V5.1 的安装设置。您可以用三种不同的方式来运行安装向导：
在开始前，确保您具有管理员特权。
GUI 界面是安装向导的缺省方式，即没有命令行选项。
如果在安装进度面板出现之前单击取消，就会退出安装并使系统返回到它的原始状态。
然而，如果在“安装进度”条出现之后取消安装向导，那么系统便不会复原到它的先前状态。请参阅卸载指示信息来除去 Message Brokers Toolkit。
当您使用向导时，单击下一步 > 按钮后可能要等待几秒钟才能移动到下一面板。如果您单击下一步 > 两次，则您可能会跳过整个面板。要确保安装正在进行中，您可以监控 CPU 使用情况；安装期间 CPU 的使用会大幅度增加。
安装的控制台方式在控制台窗口中有一个基于文本的界面。您可以通过输入以下命令从命令行启动它：
path setup.exe -console -is:javaconsole其中，path 是安装程序的当前位置。 例如：
E:\setup.exe -console -is:javaconsole在当前控制台窗口中启动 E 驱动器根目录中的 Windows 安装程序。
使用这些提示符浏览安装：
1 移动到后一个面板
2 返回到前一个面板
3 取消并终止安装程序
4 重新显示当前屏幕
在方括号内始终显示缺省选项，例如 [1]。
如果这是正确的选项，则按 Enter 键继续。
安装的静默方式可以由响应文件管理，也可以通过使用安装程序的缺省设置管理。
根据上面交互方式中可用的选项，安装向导的缺省设置导致执行以下操作：
要使用缺省设置，在命令行中输入以下命令：
path setup.exe -silent其中，path 是安装程序的当前位置。 例如：
E:\setup.exe -silent启动位于 E 驱动器根目录的 Windows 安装程序。
响应文件给予您对静默安装一定程度的控制权。您可以用两种方法生成响应文件：
path setup.exe -options-record responsefile
其中 responsefile 是您所选响应文件的完整路径和名称。建议您在产品的安装目录外的单独目录中创建它。
path setup.exe -options -template responsefile
其中 responsefile 是您所选响应文件的完整路径和名称。模板响应文件包含有关如何输入您的特定选项的全部指示信息。
警告
如果您要将 toolkit 链接到 WebSphere Studio Application
Developer Integration Edition 工作台，则您必须对响应文件（生成的或模板）作出以下修改。
在静默方式下，如果您要将此 toolkit 与 WebSphere Studio Application Developer Integration Edition 集成，则必须使用响应文件。请参阅 WebSphere Studio Application Developer Integration Edition 以获取进一步的信息。
安装实参使安装程序能够以四种不同的方式运行：GUI 方式、控制台方式、辅助功能选项方式和静默方式。安装实参还允许您记录和使用响应文件。
GUI 方式（也称为 AWT（抽象窗口工具箱）方式）是安装的缺省方式，不带安装实参。在命令行中输入以下命令：
setup.exe [-awt]其中，awt 是可选的，并且只有当 GUI 不是缺省安装方式时才是必需的。
当 GUI 不可用时通常使用控制台方式，但是只要您需要，可以在任何时候使用此方式。在命令行中输入以下命令：
setup.exe -console -is:javaconsole辅助功能选项方式为弱视用户提供了可听得见的附加信息，并可用作运行在控制台方式下运行的备用命令行。在命令行中输入以下命令：
setup.exe -accessibility在静默方式中，除了使用响应文件之外，没有用户输入。建议在对大量相同系统执行自动安装时使用静默安装。在命令行中输入以下命令：
setup.exe -silent响应文件用于将交互式 GUI 安装或控制台安装期间所选的选项运用到静默安装的运行中。要记录控制台安装中的响应，在命令行中输入以下命令：
setup.exe -options-record responsefile -console -is:javaconsole其中，responsefile 是响应文件的完整路径和文件名。
要记录 GUI 安装中的响应，在命令行中输入以下命令：
setup.exe -options-record responsefile其中，responsefile 是响应文件的完整路径和文件名。
在根 CD 映像目录的 sample-scripts 目录中提供了一个样本响应文件。
使用响应文件之前，您必须改正此文件中的错误。要获取详细信息，请参阅安装指示信息中静默方式下的警告。
要将安装期间所记录的选项运用到静默安装中，在命令行中输入以下命令：
setup.exe -options responsefile -silent其中，responsefile 是响应文件的完整路径和文件名。
响应文件模板不包含预置安装选项，且生成后允许您编辑来供以后使用。 无需运行完整安装就可生成此文件。要执行此操作，在命令行中输入以下命令：
setup.exe -options-template responsefile其中，responsefile 是响应文件的完整路径和文件名。
解决方案：Message Brokers Toolkit 的部件需要登记许可证。许可证通常是自动登记的，但是在这种情况下您必须手工运行 enroll.exe。 使用以下命令中的其中一个来执行此操作。您还必须确保您的系统日期是正确的。
解决方案：您必须检查安装日志（mqsi5.log）以获取每次完成静默安装时的错误以确保它完成时没有错误。
mqsi5.log 是安装日志文件。其缺省位置通常为 C:\Documents and Settings\user_login_name。
警告！
如果您要通过此产品扩展 WebSphere Studio Application Developer Integration Edition 工作台，则必须安装 WebSphere Studio Application Developer Integration Edition V5.1 GA；前一版本不受支持。
如果您没有安装支持的 GA 版本的 WebSphere Studio Application Developer Integration Edition 或者您不确定您拥有的是哪一个版本，请与 IBM 服务代表联系以获取更多信息。
您还必须将 WebSphere Studio Application Developer Integration Edition 升级到相应的支持级别；您必须应用“临时修订 002 － 一般修订 2.0.0”和“WebSphere Business Integration Message Broker v5.1.5 临时修订 001 － 必备修订 1.0.0.1”。
当您准备应用 WebSphere Studio Application Developer Integration Edition 修订时，必须按下面显示的顺序完成这些任务。
在安装了 WebSphere Business Integration Message Broker 或 WebSphere Business Integration Event Broker 后必须应用这些修订，并且您必须选择安装选项以启用到 WebSphere Studio Application Developer Integration Edition 的链接（请参阅安装指示信息）。
要获取更多信息，请参阅 WebSphere Studio Application Developer Integration Edition 支持下载站点，您可以在以下地址找到： http://www.ibm.com/software/awdtools/studiointegration/support/
此处的信息假设在您安装 Message Brokers Toolkit V5.1 时已经安装了 WebSphere Studio Application Developer Integration Edition。如果您在安装 Message Brokers Toolkit 之后安装 WebSphere Studio Application Developer Integration Edition，则请参阅在线信息中心以获取指示信息。除去 Message Brokers Toolkit V5.1 时必须使用位于 install_location\_uninst\studio\uninstaller.exe 的卸载向导。
警告：运行卸载向导前，您必须停止所有运行中的进程。
这些指示信息描述如何卸载 Message Brokers Toolkit V5.1。与安装向导类似，您可以按三种不同的方式调用卸载向导：
GUI 界面是卸载向导的缺省方式，即没有命令行选项。
在卸载进度面板出现之前，如果您单击取消，就会退出卸载向导并使您的系统返回到它的原始状态。
您还可以从添加／删除程序来启动 Windows 卸载程序。 例如，从开始 > 设置 > 控制面板 > 添加／删除程序。
控制台方式是控制台窗口中基于文本的界面。要从命令行启动控制台方式，输入以下命令：
path uninstaller -console -is:javaconsole其中 path 是卸载程序的当前位置，而 uninstaller 是卸载程序的名称。例如：
install_location\_uninst\studio\uninstaller.exe -console -is:javaconsole静默方式使用卸载向导的缺省设置。根据上面交互方式中可用的选项，这些设置卸载所有可选的功能部件。
在命令行中输入以下命令：
path uninstaller -silent其中 path 是卸载程序的当前位置，而 uninstaller 是卸载程序的名称。例如：
install_location\_uninst\studio\uninstaller.exe -silent
维护更新可从 Web 站点下载，它以程序临时性修订（PTF）形式提供，也称为修订包。 修订包是累积的，因此，例如在可以安装修订包 2 之前不需要安装修订包 1。但是，必须首先已安装了 GA 代码以激活许可需求。您可以在因特网上查找关于可用修订包的最新信息： http://www.ibm.com/software/integration/mqfamily/support/summary
WebSphere Business Integration Message Brokers Toolkit 的修订包是使用与 GA 发行版相同的技术安装的。 这意味着始终对产品文件进行跟踪和适当的更新。
在未卸载整个产品的情况下您就无法除去个别的修订包。强烈建议您使备份 GA 映像和先前的修订包保持立即可用的状态，以防您在安装服务后遇到问题。 如果要将系统复原到先前的服务级别，则您必须卸载整个产品、重新安装产品的 GA 级别，然后安装期望的修订包级别。
如果您将任何临时修订应用于您现有的安装，则与您的 IBM 服务代表联系以获取有关您正在安装的修订包级别的指示信息以及可能已更新的临时修订。
注：在安装了 Message Brokers Toolkit V5.1 后，如果您安装 V5.0 运行时组件的修订包，则选择定制安装并清除 Message Brokers Toolkit
组件的复选框。V5.0 修订包中提供的工具修订与 V5.1 toolkit 不兼容；如果您不清除该复选框，则安装程序会报告错误（因为它无法将 V5.0 修订安装到 V5.1 组件上）。它会为所有其它组件成功地安装修订。
（如果您正在使用控制台安装或静默安装，则确保您选择相应的选项。）
您可以从以下地址下载最新修订包
http://www.ibm.com/software/integration/mqfamily/support/summary/wbib.html
将 WebSphere Business Integration Brokers 支持 Web 页面向下滚动到 Message Brokers Toolkit V5.1。
您必须读备忘录。要访问备忘录，单击查看备忘录列中的详细信息链接。
要开始下载过程，转至下载 PTF／修订包列并单击链接（它具有形式为 Fix Pack XX Unnnnnn 的名称，其中 XX 是修订包的号码，而 Unnnnnn 是修订包文件名）。
按照 IBM 下载 Web 站点上的指示信息执行，它将指导您完成配置、注册和下载三个阶段的过程。选择适当的目的地作为下载的目标。
确保登录所用的标识是本地安全性域中 Windows Administrators 组的成员。 建议您使用安装 WebSphere Business Intergration Message Broker Toolkit 时使用的同一标识。
确保所有的 WebSphere Business Intergration Event Broker 或 WebSphere Business Integration Message Broker 进程都已停止。您必须执行以下任务：
其中 FixPackLauncher 是到修订包可执行文件（例如 U200208.exe）的完整路径。
-s 是可选的，表示静默地解压缩修订包启动程序。如果您忽略此选项，则显示解压缩进度面板。
-a 表示读入以下安装实参
installation_arguments 是确定安装程序如何运行的实参。请参阅安装命令行选项。
成功解压缩后，安装程序根据所选的实参自动运行。按照安装面板上的指示信息安装。 要获取安装面板的详细描述，请参阅安装指示信息。
完成安装后，查看 readme 目录中提供的多平台的 memo 文件并完成所需的任何手工安装后任务。
本信息是为在美国提供的产品和服务编写的。
IBM 可能在其他国家或地区不提供本信息中讨论的产品、服务或功能特性。有关您当前所在区域的产品和服务的信息，请向您当地的 IBM 代表咨询。任何对 IBM 产品、程序或服务的引用并非意在明示或暗示只能使用 IBM 的产品、程序或服务。只要不侵犯 IBM 的知识产权，任何同等功能的产品、程序或服务，都可以代替 IBM 产品、程序或服务。但是，评估和验证任何非 IBM 产品、程序或服务，则由用户自行负责。
IBM 公司可能已拥有或正在申请与本信息内容有关的各项专利。提供本信息并未授予用户使用这些专利的任何许可。您可以用书面方式将许可查询寄往：
有关双字节（DBCS）信息的许可查询，请与您所在国家或地区的 IBM 知识产权部门联系，或用书面方式将查询寄往：
本条款不适用英国或任何这样的条款与当地法律不一致的国家或地区：
International Business Machines Corporation“按现状”提供本出版物，不附有任何种类的（无论是明示的还是暗含的）保证，包括但不限于暗含的有关非侵权、适销和适用于某种特定用途的保证。某些国家或地区在某些交易中不允许免除明示或暗含的保证。因此本条款可能不适用于您。
本信息中可能包含技术方面不够准确的地方或印刷错误。此处的信息将定期更改；这些更改将编入本资料的新版本中。IBM 可以随时对本资料中描述的产品和／或程序进行改进和／或更改，而不另行通知。
本信息中对非 IBM Web 站点的任何引用都只是为了方便起见才提供的，不以任何方式充当对那些 Web 站点的保证。那些 Web 站点中的资料不是 IBM 产品资料的一部分，使用那些 Web 站点带来的风险将由您自行承担。
IBM 可以按它认为适当的任何方式使用或分发您所提供的任何信息而无须对您承担任何责任。
本程序的被许可方如果要了解有关程序的信息以达到如下目的：（i）允许在独立创建的程序和其他程序（包括本程序）之间进行信息交换，以及（ii）允许对已经交换的信息进行相互使用，请与以下地址联系：
只要遵守适当的条件和条款，包括某些情形下的一定数量的付费，都可获得这方面的信息。
本信息中描述的许可程序及其所有可用的许可资料均由 IBM 依据 IBM 客户协议、IBM 国际软件许可协议或任何同等协议中的条款提供。
涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其他可公开获得的资料中获取。IBM 没有对这些产品进行测试，也无法确认其性能的精确性、兼容性或任何其他关于非 IBM 产品的声明。有关非 IBM 产品性能的问题应当向这些产品的供应商提出。
本信息包括在日常业务操作中使用的数据和报告示例。为了尽可能完整地阐述它们，这些示例包括个人姓名、公司名称、品牌名称和产品名称。所有这些名称都是虚构的，对于现实中使用类似于此名称和地址的企业都纯属巧合。
版权许可：
本信息包含源语言形式的样本应用程序，这些样本说明不同操作平台上的编程方法。如果是为按照在编写样本程序的操作平台上的应用程序编程接口（API）进行应用程序的开发、使用、经销或分发为目的，您可以任何形式对这些样本程序进行复制、修改、分发，而无须向 IBM 付费。这些示例并未在所有条件下作全面测试。因此，IBM 不能担保或暗示这些程序的可靠性、可维护性或功能。 用户如果是为了按照 IBM 应用程序编程接口开发、使用、经销或分发应用程序，则可以任何形式复制、修改和分发这些样本程序，而无须向 IBM 付费。
以下术语是 International Business Machines Corporation 在美国和／或其他国家或地区的商标：
IBM 和 WebSphere
Java 和所有基于 Java 的商标是 Sun Microsystems, Inc. 在美国和／或其他国家或地区的商标。
Microsoft 和 Windows 是 Microsoft Corporation 在美国和／或其他国家或地区的商标。
其他公司、产品或服务名称可能是其他公司的商标或服务标记。