启动和停止 MQIPT

您可以从命令行启动 MQIPT ，也可以使其在系统启动时自动启动。 您可以使用 mqiptAdmin 命令来停止 MQIPT 。

从命令行启动 MQIPT

MQIPT 安装到安装目录中，例如:
  • [Windows]C:\MQIPT 系统上的 Windows C:\MQIPT\bin 中的可执行脚本
  • [AIX][Linux]/opt/mqipt 在 AIX® and Linux® 系统上，可执行脚本在 /opt/mqipt/bin 中
MQIPT 还使用主目录，其中包含配置文件 mqipt.conf 以及 MQIPT 运行时输出的任何文件。 首次调用 MQIPT 时，将自动创建 MQIPT 主目录的以下子目录:
  • 写入任何 First Failure Support Technology (FFST) 和跟踪文件的 errors 目录
  • logs 目录，将在此目录中保存连接日志

运行 MQIPT 的用户标识必须有权创建这些目录，或者这些目录必须已存在，并且该用户标识必须有权在这些目录中创建，读取和写入文件。 此外，如果您正在使用 Java security manager 策略，那么安全策略必须授予这些目录所需的许可权。 有关安全管理器策略设置的更多信息，请参阅 "Java security manager。

您可以将安装目录用作主目录。 如果使用此目录，那么必须确保运行 MQIPT 的用户标识具有相应的许可权，并且正确配置了任何 Security Manager 策略。

要启动 MQIPT，请使用 mqipt 命令，该命令位于 MQIPT 安装目录的 bin 目录中。 例如，以下命令启动使用目录 C:\mqiptHome 作为主目录的 MQIPT 实例:
mqipt C:\mqiptHome
有关 mqipt 命令的更多信息，请参阅 mqipt (启动 MQIPT)。

您可以使用 mqipt 命令来指定要对正在启动的 MQIPT 实例指定的名称。 MQIPT 实例的名称用于使用 mqiptAdmin 命令管理 MQIPT 的本地实例，而无需使用命令端口。 如果未指定此参数，那么 MQIPT 主目录的名称将用作 MQIPT 实例的名称。

控制台消息显示 MQIPT的状态。 如果发生错误，请参阅 故障诊断 IBM® MQ Internet Pass-Thru。 以下消息是 MQIPT 成功启动时的输出示例:
5724-H72 (C) Copyright IBM Corp. 2000, 2026. All Rights Reserved
MQCPI001 IBM MQ Internet Pass-Thru 9.4.0.0 starting
MQCPI004 Reading configuration information from mqipt.conf
MQCPI152 MQIPT name is C:\mqiptHome
MQCPI021 Password checking has been enabled on the command port
MQCPI144 MQ Advanced capabilities not enabled
MQCPI011 The path C:\mqiptHome\logs will be used to store the log files
MQCPI006 Route 1414 is starting and will forward messages to :
MQCPI034 ....examplehost(1414)
MQCPI035 ....using MQ protocols
MQCPI057 ....trace level 5 enabled
MQCPI078 Route 1414 ready for connection requests

自动启动 MQIPT

您可以将 MQIPT 安装为在系统启动时自动启动的系统服务。 使用 mqiptService 命令来安装和卸载 MQIPT 服务。
  • [Windows] 在 Windows 系统上，mqiptService 命令将 MQIPT 安装为 Windows 服务。
  • [AIX][Linux] 在 AIX and Linux 系统中，mqiptService 命令将 MQIPT 安装为 System V init 服务，在系统启动时启动。
    [Linux]请注意：
    1. [不推荐] Linux 上的 服务已被弃用。 MQIPT Linux上的服务使用 System V init，而Linux 的某些最新版本不支持 System V init。
    2. 下列不支持 System V init 的 Linux 版本不支持 MQIPT 服务：
      • Red Hat® Enterprise Linux 9.
      • SUSE Linux Enterprise Server 15.
      在 Linux 的这些版本中，请使用另一种方法（如 systemd）将 MQIPT 作为服务进行管理。
启动 MQIPT 服务时，将启动所有活动 MQIPT 路由。 停止该服务时，将立即关闭所有路径。

即使系统上存在多个 MQIPT 安装，也只能在系统上安装一个 MQIPT 服务。

有关 mqiptService 命令的更多信息，请参阅 mqiptService (管理 MQIPT 服务)。

正在停止 MQIPT

您可以使用带有 -stop 参数的 mqiptAdmin 命令来停止 MQIPT 。

例如，以下命令停止名称为 mqipt1 的 MQIPT 实例，该实例在本地以与 mqiptAdmin 命令相同的用户标识运行:
mqiptAdmin -stop -n ipt1
mqiptAdmin 命令使用下列其中一种方法连接到要管理的 MQIPT 活动实例:
  • 在不使用命令端口的情况下连接到 MQIPT 的本地实例。
  • 通过建立与命令端口的网络连接。

必须先通过将 RemoteShutDown 属性设置为 true 来启用远程关闭，然后才能使用 mqiptAdmin 命令通过向命令端口发送命令来停止 MQIPT 。

有关使用MQIPT命令管理mqiptAdmin的更多信息，请参阅使用命令行管理 MQIPT。