mqsicreatebroker 命令

使用 mqsicreatebroker 命令可创建集成节点。

用途

使用 mqsicreatebroker 命令时,将完成以下操作:
  1. 在分布式系统上,如果指定了可选的 -q 参数,那么指定的本地队列管理器将与集成节点相关联。 如果没有在 MQ 节点上显式指定队列管理器,那么缺省情况下,此队列管理器在消息流中用于 MQ 处理。
    对于使用系统队列来存储消息状态信息的消息流节点(例如用于聚集流和超时流、消息集合以及消息序列的事件驱动处理节点)而言,对集成节点指定的队列管理器也为必需。 以下 IBM App Connect Enterprise 功能需要为集成节点指定队列管理器,同时还需创建一组系统队列:
    • 事件驱动处理节点
    • 发布/订阅(若您使用的是 IBM MQ 而非MQTT)
    • 集成节点侦听器
    • SAP 节点(针对高可用性)
    • 记录和回放
    • 通过网页用户界面进行会计和统计(若您使用的是 IBM MQ 网页界面而非MQTT协议)
    • FTEInputFTEOutput 节点
    • CDInputCDOutput 节点

    有关创建所需队列的信息, 参阅在 IBM MQ 队列管理器上创建默认系统队列

    对事件驱动处理节点指定的队列将在该流部署时自动创建,但前提是集成节点具有创建这些队列所需的许可权。 如果队列未自动创建,您可以手动创建;请参阅在 IBM MQ 队列管理器上创建默认系统队列

    如果指定的队列管理器不存在,那么您必须先创建该队列管理器,然后才能部署流。

    如果未指定该 -q 参数,则某些需要访问该参数的功能 IBM MQ 将不可用。 有关使用 IBM App Connect Enterprise 与 IBM MQIBM MQ 的交互信息,请参阅《与 IBM App Connect Enterprise 的交互》及《 安装 IBM MQ 》。

  2. Windows 平台仅在 Windows 上,该命令会安装运行集成节点的服务。
  3. 此命令将以其中一个可用操作 方式创建集成节点。 如果安装了完整软件包,那么缺省 方式advanced如果已安装 Developer Edition ,那么缺省 方式developer 有关更多信息,请参阅 操作方式
  4. 此命令将在注册表中为组件创建记录。
  5. Linux 平台Windows 平台UNIX 平台Windows 系统 AIXLinux ,该命令允许您指定集成节点是否可作为服务 IBM MQ 启动和停止。

    若指定此设置,后续可通过命令 mqsichangeproperties 进行修改。 有关更多信息,请参阅 mqsichangeproperties 命令中的示例。

  6. 创建集成节点时,用于第一个集成节点的缺省端口是 4414。 您可以使用 mqsichangeproperties 命令来禁用 Web 用户界面或更改运行该界面的端口。 如果未启用管理安全性,那么 Web 用户可以采用对数据和集成节点资源具有不受限访问权的缺省用户身份来访问 Web 用户界面。
  7. 如果设置了 --node-conf-yaml 参数,那么该命令会将集成节点的 node.conf.yaml 配置文件复制到 workdir/components/integrationNodeName 目录。 如果未指定 --node-conf-yaml 参数,那么将复制缺省 node.conf.yaml 文件。
  8. 如果在命令上指定了 --vault-key--vaultrc-location 参数,那么将创建 App Connect Enterprise 保险库文件以保存集成节点在访问安全资源时使用的凭证。

响应

如果运行 mqsicreatebroker 命令失败,请解决导致失败的问题:
  • 检查响应;参见对命令的响应
  • 检查错误日志;请参阅本地错误日志
  • 检查错误日志中的错误消息;您可以在产品文档中搜索与错误消息有关的更多信息。
如果再次运行同一命令,您可能会接收到一系列消息,这些消息将指出无法创建的项。 接收这些消息并不表示 mqsicreatebroker 命令本身存在问题。