配置集成服务器以连接到 IBM App Connect 仪表板

配置集成服务器以连接到 IBM® App Connect 仪表板。

关于此任务

如果启动集成节点，那么可以通过从仪表板创建指向集成节点的连接，在仪表板中实现受管集成服务器可视化。 在仪表板中直观呈现受管集成服务器的唯一方式是在仪表板中创建与集成节点的连接。

如果启动独立集成服务器，那么可以通过从仪表板中创建指向该服务器的连接，在仪表板中将其可视化。

如果使用交换机的 agentA 配置文件配置独立集成服务器，那么其将向交换机进行注册。 然后，您可以在仪表板中创建指向交换机的连接以可视化独立集成服务器。

如果使用 agentA 配置文件配置独立集成服务器，那么可以从交换机服务器下载 agentA 文件的其他用户可以从 IBM App Connect 仪表板在集成服务器上执行远程管理。 任何创建用于保护管理 REST API 的用户和角色都不适用于使用 agentA 文件进行远程管理。 有关更多信息，请参阅 使用管理 REST API 管理资源。

如图所示，如果多个集成服务器连接到单个交换机服务器，那么可以从 IBM App Connect 仪表板对已连接的集成服务器执行远程管理。 在此示例中，用户 A 和 B 的访问权分别通过各自集成服务器的管理 REST API 进行控制。 但是，用户 C 通过使用交换机服务器和 agentA 配置文件对这两个集成服务器执行远程管理。

此图显示了两台集成服务器和三个用户。 用户 A 有权访问其中一台集成服务器，而用户 B 有权访问另一台集成服务器。 用户 A 和用户 B 的访问权限是通过各自集成服务器的管理 REST API 分别控制的。 但是，用户 C 可以使用交换服务器和 agentA 配置文件对这两台集成服务器执行远程管理。

无法使用 agentA 配置文件来配置集成节点。 使用 agentA 配置文件只能配置独立服务器。

过程

如果集成服务器具有可公开访问的端点，那么可以从 IBM App Connect 仪表板直接连接到该端点，如步骤 1中所述。

如果集成服务器位于防火墙之后，那么必须使用 agentA 文件配置集成服务器，然后使用交换机服务器从 IBM App Connect 仪表板 连接到该集成服务器。 agentA 您可以使用托管服务或通过在 IBM Cloud Pak for Integration ，如步骤2 所述。

如果想要连接到正在容器上运行的集成服务器，那么还必须使用 agentA 文件对其进行配置。

  1. 直接连接到具有公共可访问端点的集成服务器，如 在 IBM App Connect 仪表板中创建连接中所述。

如果使用交换机的 agentA 配置文件配置独立集成服务器，那么其将向交换机进行注册。 然后，您可以在仪表板中创建指向交换机的连接以可视化独立集成服务器。

  1. 通过使用受管服务 (如子步骤 A.中所述) 或通过在 IBM App Connect 操作程序中创建 SwitchServer 操作数 (如子步骤 B中所述) ，使用 agentA 文件配置集成服务器。
    1. 通过完成以下步骤，使用受管服务使用 agentA 文件配置集成服务器:
      1. 通过完成以下步骤下载 agentA 文件：
        1. 如果尚未创建 App Connect Agent，请单击 App Connect中 专用网络连接 选项卡上的 新建 ，然后单击 App Connect Agent。
        2. 在 App Connect Agent 的操作菜单上，选择查看设置指示信息以打开显示指示信息的窗口。
        3. 通过单击设置指示信息的步骤 2 下的按钮来下载配置，这些指示信息显示在您在上一步中打开的窗口中。
      2. 将下载的 agenta.json 配置文件复制到目录 --work-dir/config/iibswitch/agenta，其中，--work-dir 是创建集成服务器时指定的工作目录。 您可能需要在与缺省情况下存在的 agentx 目录相同的级别创建 agenta 目录。 无法在相同集成服务器上配置 agenta 和 agentx。
    2. 创建 agentA 文件，如 App Connect Switch Server 参考中所述。 然后，通过运行以下命令，在 IBM App Connect Operator V 1.0.0 或更高版本 (操作数 11.0.0.10-r3-eus) 中创建 SwitchServer 操作数，以使用 agentA 文件配置集成服务器。 显示的参数值仅为示例。
      1. oc get Configuration my-switch-agenta -o=jsonpath={.spec.secretName} my-switch-agenta
      2. oc get secret my-switch-agenta -o=jsonpath={.data.configuration} eyJuYW1lIjoiYWdlbnRhIiwic3dpdGNoIjp7InVybCI6IndzczovL21hcnRpbi1zcy1zd2l0Y2gtYWNlLW1hcnRpb ... 0tLVxuIl0sInJlamVjdFVuYXV0aG9yaXplZCI6dHJ1ZX19fQ==
      3. oc get secret my-switch-agenta -o=jsonpath={.data.configuration} | base64 -d | jq
        运行命令的输出类似于以下示例：
        
{
  "name": "agenta",
  "switch": {
    "url": "wss://example.ibm.com:443",
    "certs": {
      "key": "-----BEGIN PRIVATE KEY-----\nMIIEvwIBADANBgk ... bNo12hvjjI2NJBwVIA==\n-----END PRIVATE KEY-----\n",
      "cert": "-----BEGIN CERTIFICATE-----\nMIID8jCCAtqgAwIB ... Zu/Ep+k/\n-----END CERTIFICATE-----\n",
      "ca": [
        "-----BEGIN CERTIFICATE-----\nMIIEXjCCA0agA ... HpL0V1+U7xrajhpjh+tbTmD6\n-----END CERTIFICATE-----\n"
      ],
      "rejectUnauthorized": true
    }
  }
}
      4. 将输出保存到本地文件，例如，/my/work/dir/config/iibswitch/agenta/agenta.json。
      5. 通过在与 name 字段相同的级别添加 agentID 字段来编辑 /my/work/dir/config/iibswitch/agenta/agenta.json 。

        或者，您可以在环境中为独立集成服务器设置 MQSI_AGENT_ID 环境变量。

        agentID 的值必须为 uuidv4 字符串。
        以下示例显示已编辑的 agenta.json 文件，以添加使用 uuidv4 字符串填充的 agentID 字段。
        
{
  "name": "agenta",
  "agentId": "7690095b-3db8-40d2-8584-d09335a0dab9"
  "switch": {
    "url": "wss://example.ibm.com:443",
    "certs": {
      "key": "-----BEGIN PRIVATE KEY-----\nMIIEvwIBADANBgk ... bNo12hvjjI2NJBwVIA==\n-----END PRIVATE KEY-----\n",
      "cert": "-----BEGIN CERTIFICATE-----\nMIID8jCCAtqgAwIB ... Zu/Ep+k/\n-----END CERTIFICATE-----\n",
      "ca": [
        "-----BEGIN CERTIFICATE-----\nMIIEXjCCA0agA ... HpL0V1+U7xrajhpjh+tbTmD6\n-----END CERTIFICATE-----\n"
      ],
      "rejectUnauthorized": true
    }
  }
}
      6. 将编辑的 agenta.json 配置文件复制到目录 --work-dir/config/iibswitch/agenta，其中，--work-dir 是创建集成服务器时指定的工作目录。 您可能需要在与缺省情况下存在的 agentx 目录相同的级别创建 agenta 目录。 无法在相同集成服务器上配置 agenta 和 agentx。

后续操作

在 IBM App Connect 仪表板中创建连接，如 在 IBM App Connect 仪表板中创建连接所述。