[Windows]

在 Windows 上卸载 IBM MQ

您可以使用控制面板，命令行 ( msiexec ) ， MQParms或安装介质来卸载 Windows 系统上的 IBM® MQ MQI clients 和服务器，在这种情况下，您还可以选择除去队列管理器。

开始之前

[Windows]警告：
Windows 注册表包含关键信息，包括文件位置、驱动程序和启动进程。 IBM MQ 需要依赖这些特定的注册表设置才能正常运行。 在没有适当信息的情况下更改这些设置可能会导致 IBM MQ 应用程序无法使用或完全失效，因为不正确的更改会破坏其基本功能。
缺省情况下，未在 Windows上启用卸载日志记录。 要确保接收到卸载日志，请执行以下过程:
  1. 在命令提示符中，通过发出命令 regedit打开注册表编辑器。
  2. 创建或编辑相应的注册表键: HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\Installer
  3. 在此注册表键下，添加以下信息:
    名称
    记录
    数据类型
    REG_SZ
    值
    旁白热
  4. 保存更新后的注册表键。

过程

该过程的第一部分确保没有 IBM MQ 程序或进程在运行:

  1. 如果使用 Microsoft 集群服务 (MSCS) 运行 IBM MQ ，请在卸载 IBM MQ之前从 MSCS 控制中除去队列管理器。 对当前受 MSCS 控制的每个队列管理器执行以下步骤:
    1. 使队列管理器资源脱机。
    2. 销毁资源实例。
    3. 从共享驱动器重新迁移队列管理器文件。 此步骤在 从 MSCS 控件中除去队列管理器中显示为可选。 但是，在这种情况下，它是必需的。
  2. 停止与要卸载的安装关联的所有 IBM MQ 应用程序。
  3. 停止所有 Managed File Transfer 代理。
    如果 Managed File Transfer 代理正在运行，可以使用 fteStopAgent 命令以受控方式停止代理。 如有必要，也可使用 -i 参数立即停止代理；请参阅 fteStopAgent (stop a Managed File Transfer Agent)。
  4. 对于服务器安装，结束所有 IBM MQ 活动:
    1. 以组中的用户身份登录 mqm。
    2. 使用 IBM MQ Explorer 或输入以下命令来停止所有正在运行的队列管理器和侦听器:
      1. 通过输入以下命令，设置环境以处理要卸载的安装:
         MQ_INSTALLATION_PATH\bin\setmqenv -s
        其中 MQ_INSTALLATION_PATH 是 IBM MQ 的安装位置。
      2. 对于每个队列管理器，输入以下命令以停止队列管理器:
        endmqm queue_manager_name
      3. 对于每个队列管理器，输入以下命令以停止与队列管理器关联的任何侦听器:
        endmqlsr -m queue_manager_name
  5. 停止 IBM MQ。
    要执行此操作，请右键单击系统托盘中的 IBM MQ 图标，然后选择 停止 IBM MQ。
  6. 关闭所有 IBM MQ 窗口。
  7. 停止任何监视服务。

当与 IBM MQ 关联的所有进程不再运行时，您可以卸载 IBM MQ:

  1. 使用下列其中一种方法来卸载 IBM MQ :
    • 使用 Windows 控制面板。 此过程在使用控制面板卸载 IBM MQ。 此方法不会除去队列管理器数据。
    • 使用命令行运行 msiexec 命令，详见 "使用 msiexec 卸载 "： 使用 msiexec 卸载 IBM MQ。 此方法不会除去队列管理器数据。
    • 将相应的参数与 MQParms配合使用。 使用 MQParms 卸载 IBM MQ 中描述了这一过程。 此方法不会除去队列管理器数据。
    • 使用安装介质，方法是选择 "使用安装介质 "中所述的相应选项： 使用安装介质在 Windows 上卸载 IBM MQ。 用于除去队列管理器数据的选项将显示在 " 除去服务器功能部件 " 面板中 (如果适用)。
    如果必须在卸载过程完成之前将其取消，那么可能必须使用 "准备 IBM MQ " 向导重新配置 IBM MQ ，因为回滚删除 IBM MQ 服务无法设置服务的用户帐户密码。 使用以下命令来重新配置 IBM MQ:
    MQ_INSTALLATION_PATH\bin\amqmjpse.exe -r
    有关 Prepare IBM MQ Wizard 的更多信息，请参阅使用准备 IBM MQ 向导配置 IBM MQ。
  2. 检查 Windows 事件日志，必要时重新启动系统。
    如果将事件标识 10005 写入 Windows 事件日志，那么必须重新启动系统以完成卸载过程。
  3. 可选: 如果要卸载 IBM MQ的最后一个或唯一安装，那么可以除去有关系统上保留的先前安装的所有信息 (如果要)。 您应该将 ResetMQ.cmd 用于此目的; 请参阅 清除 IBM MQ 安装设置 以获取更多信息。
    卸载后，将保留以下注册表值:
    • My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere MQ\LogDefaultPath
    • My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere MQ\WorkPath
    • My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\IBM\WebSphere MQ\LogDefaultPath
    • My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\IBM\WebSphere MQ\WorkPath

    数据文件夹也将保留并位于 MQ_DATA_PATH\Config，其中 MQ_DATA_PATH 是 IBM MQ 数据目录的位置。 其余大部分文件包含文本，例如 INI 文件，错误日志和 FDC 文件。 可执行共享库 mqzsd.dll 也保留。

    如果客户机安装在先前服务器安装的 LogDefaultPath 注册表值保留的系统上，那么客户机安装将尝试创建此目录 (如果它尚不存在)。 如果不希望出现这种行为，请在安装客户端之前删除 LogDefaultPath 注册表值。