更改历史纪录:
GA:2004 年 7 月 23 日
(C) Copyright IBM Corporation 2004. All rights reserved.
本文件包含您在 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(WSADIE)V5.1 时才可以安装 Message Brokers Toolkit V5.1。如果具有先前级别的 WSADIE,则不要安装 Message Brokers Toolkit V5.1,对于先前级别的 WSADIE,您必须使用 Message Brokers
Toolkit V5.0,它与 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker V5.0 一起提供。
Migrating
If you are migrating, read Before you start.
Installing Message Brokers Toolkit Version 5.1 in a team environment
WSADIE Version 5.1 is not a prerequisite for every installation
of the Message Brokers Toolkit Version 5.1. However, if at least
one of your Message Broker Toolkit installations integrates with
WSADIE Version 5.1, all your Message Broker Toolkit
installations must be at Version 5.1 to ensure data sharing
and integrity.
If you are not using WSADIE Version 5.1 on any system, or you are using WSADIE Version 5.0, you must install Message Brokers Toolkit Version 5.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/
WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker 的独立信息中心可供下载。您可以从以下地址下载 zip 归档:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/wbimb_help.zip
阅读 installing_and_managing.htm 文件,该文件包括在 wbimb_help.zip 文件中。
内容
要获取 Message Brokers Toolkit V5.1 支持的操作系统的特定版本的最新状态,请查看位于以下地址的 WebSphere MQ Family Supported Software 页面:
http://www-3.ibm.com/software/integration/wbimessagebroker/requirements/
(用于 WebSphere Business Integration Message Broker)或
http://www-3.ibm.com/software/integration/wbieventbroker/requirements/(用于 WebSphere Business Integration Event Broker)
在这些环境中支持 Message Brokers Toolkit V5.1:
它在 Windows 2003 上不受支持。
You might have to complete some actions before you install Message Brokers Toolkit Version 5.1:
The Version 5.0 installation instructions are also on the main product CD in \installdocs\<locale>\install.html.
After you have installed, refer to the online information center for further information about migration.
当您安装 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
启动 Windows 安装程序,它位于当前控制台窗口中 E 驱动器的根目录中。
使用这些提示符浏览安装:
1 移动到下一个面板
2 返回到前一个面板
3 取消并终止安装程序
4 重新显示当前屏幕
在方括号内始终显示缺省选项,例如 [1]。
如果这是正确的选项,则按 Enter 键继续。
安装的静默方式可以由响应文件管理,也可以使用安装程序的缺省设置管理。
根据上面交互方式中可用的选项,安装向导的缺省设置执行下列操作:
要使用缺省设置,在命令行上输入下列命令:
path setup.exe -silent
其中 path 是安装设置的当前位置。例如:
E:\setup.exe -silent
启动 Windows 安装程序,它位于 E 驱动器的根目录中。
响应文件给予您对静默安装一定程度的控制权。您可以用两种方法生成响应文件:
path setup.exe -options-record responsefile
其中 responsefile 是您所选响应文件的完整路径和名称。建议您在产品安装目录外的单独目录中创建它。
path setup.exe -options -template responsefile
其中 responsefile 是您所选响应文件的完整路径和名称。模板响应文件包含有关如何输入您的特定选项的全部指示信息。
WARNING
You must make the following correction in the template response file to
indicate whether the toolkit is to link to WSADIE.
在静默方式中,如果您要将此 toolkit 与 WSADIE 集成,则必须使用响应文件。请参阅 WebSphere Studio Application Developer Integration Edition 以获取进一步的信息。
安装自变量使安装能以四种不同的方式运行:GUI 方式、控制台方式、辅助功能选项方式和静默方式。 安装自变量还允许您记录和使用响应文件。
GUI 方式(也称为 AWT(抽象窗口工具箱)方式)是安装的缺省方式,不带安装自变量。在命令行中输入以下命令:
setup.exe [-awt]
其中,awt 是可选的,且只有当 GUI 方式不是缺省安装方式时才是必需的。
当 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 目录中提供了一个样本响应文件。
You must correct an error in the response file before you use it. For details, see the Warning under Silent mode in the Install instructions.
要将安装期间所选的已记录选项提供到静默安装中,在命令行中输入以下命令:
setup.exe -options responsefile -silent
其中,responsefile 是响应文件的完整路径和文件名。
响应文件模板不包含预置安装选项,且生成允许您编辑的响应文件以供以后使用。 无需运行完整安装就可生成此文件。要这样做,在命令行中输入以下命令:
setup.exe -options-template responsefile
其中,responsefile 是响应文件的完整路径和文件名。
方案:当启动或使用 Message Brokers Toolkit 时,您会获得下列消息。 “许可证未找到或已到期。将禁用没有有效许可证的功能部件。”
解决方案:Message Brokers Toolkit 的部件需要登记许可证。许可证通常是自动登记的,但是在这种情况下您必须手工运行 enroll.exe。 使用以下其中一个命令来执行此操作。您还必须确保您的系统日期是正确的。
解决方案:您必须检查安装日志(mqsi5.log)来获取每次完成静默安装时的错误,以确保它完成时没有错误。
mqsi5.log 是安装日志文件。其缺省位置通常为 C:\Documents and Settings\user_login_name。
WARNING!
You can integrate Message Brokers Toolkit Version 5.1 only with the supported GA
of WSADIE Version 5.1.
If you do not have the supported GA version of WSADIE installed, or you are unsure which version you have, contact your IBM Service representative for further information.
When you are ready to apply WSADIE fixes, you must complete these tasks in the order shown below.
如果您要用此产品扩展 WebSphere Studio Application Developer Integration Edition(WSADIE)工作台,则必须将 WSADIE 升级到相应的支持级别。 可扩展的 WSADIE 工作台的版本是带“临时修订 002 - 一般修订 2.0.0”的 WSADIE V5.1 GA。您还必须应用修订“WebSphere Business Integration Message Broker V5.1.0 临时修订 001 - 先决条件修订 1.0.0.1”。
在安装了 WebSphere Business Integration Message Broker 或 WebSphere Business Integration Event Broker 后还必须应用这些修订,并且您必须选择启用到 WSADIE 的链接的安装选项(请参阅安装指示信息)。
要获取更多信息,请参阅 WSADIE 支持下载站点,您可以在以下地址查找:http://www.ibm.com/software/awdtools/studiointegration/support/
此处的信息假设在您安装 Message Brokers Toolkit V5.1 时已经安装了 WSADIE。如果您在 Message Brokers Toolkit 之后安装 WSADIE,则请参阅联机信息中心以获取指示信息。您必须使用位于 install_location\_uninst\studio\uninstaller.exe 的卸载向导,以除去 Message Brokers Toolkit V5.1。
警告:运行卸载向导前,您必须停止所有运行中的进程。
这些指示信息描述如何卸载 Message Brokers Toolkit V5.1。与安装向导一样,卸载向导可用 3 种不同的方式运行:
GUI 界面是卸载向导的缺省方式,即没有命令行选项。
在卸载进度面板出现之前,如果您单击取消,就会退出卸载向导并使您的系统返回到它的原始状态。
您还可以从添加/删除程序来启动 Windows 卸载程序。 例如,从开始 > 设置 > 控制面板 > 添加/删除程序。
为 WebSphere Studio V5.1 选择 IBM Message Brokers Toolkit。
单击更改/删除。
选择您运行卸载向导的语言。单击确定。
控制台方式是控制台窗口中基于文本的界面。您可从命令行输入以下命令来启动控制台方式:
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)形式提供,也称为修订包。 修订包是累积的,因此,例如在可以安装 Fix Pack 2 之前不需要安装 Fix Pack 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 进程都已停止。您必须执行下列任务:
将目录更改为您下载修订包文件(Unnnnnn.tar.Z)的目录。 在 Windows 资源管理器中,右键单击文件名并选择打开。 或者,在命令提示符下输入以下命令:
FixPackLauncher [-s] -a install_arguments
其中 FixPackLauncher 是到修订包可执行文件(例如 U200208.exe)的完整路径。
-s 是可选的且它表示静默地解压缩修订包启动程序。如果您忽略此选项,则显示解压缩进度面板。
-a 表示“读入下列安装自变量”
install_arguments 是确定安装程序如何运行的自变量。请参阅安装命令行选项。
本信息是为在美国提供的产品和服务编写的。
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 在美国和/或其他国家或地区的商标。
其他公司、产品或服务名称可能是其他公司的商标或服务标记。