通过修改 node.conf.yaml 文件配置集成节点

您可以通过在集成节点的 node.conf.yaml 配置文件中设置属性来配置集成节点。

准备工作

您必须已完成下列任务：

关于此任务

在创建集成节点时，将自动为集成节点创建缺省 node.conf.yaml 配置文件，并将其存储在集成节点的工作目录中；例如：C:\ProgramData\IBM\MQSI\components\acev11node\node.conf.yaml。 然后，您可以通过修改 node.conf.yaml 文件中的属性来配置集成节点和关联资源的操作。 例如，您可以设置 REST 管理端口和 HTTPS 端口，您可以启用管理安全性，并且可以配置跟踪级别、活动日志记录、JVM 以及统计信息和记帐数据的报告。

在创建集成节点时，还将在集成节点的工作目录下创建覆盖子目录。 此覆盖目录包含其他 node.conf.yaml 配置文件，其中包含由 IBM App Connect Enterprise 命令 (包括 mqsicreatebroker 命令) 设置的属性值。 这些值将覆盖为集成节点的基本 node.conf.yaml 文件中的相同属性设置的任何值。

在运行用于修改集成节点设置的命令时，这些修改过的设置将保存在 overrides 目录中的 node.conf.yaml 文件（例如，C:\ProgramData\IBM\MQSI\components\acev11node\overrides\node.conf.yaml）中。

如果在集成节点的基本 node.conf.yaml 文件以及 overrides 目录 (\overrides\node.conf.yaml) 中设置了属性，那么将使用 overrides 目录中设置的属性值。 因此，如果集成节点似乎未使用您期望的设置，请检查 overrides 目录中的 node.conf.yaml 文件，看看期望的属性值是否已被命令覆盖。 如果要手动覆盖命令生成的设置，那么可以编辑 overrides 目录下 node.conf.yaml 文件中的属性，也可以从 overrides 目录中除去该条目，改为修改基本 node.conf.yaml 文件。

创建集成节点所拥有的集成服务器时，将为每个集成服务器创建一个缺省 server.conf.yaml 配置文件，并且这些文件存储在集成节点目录下的子目录中的文件系统中。 在 node.conf.yaml 文件中为集成节点设置的任何属性都由它拥有的集成服务器继承。 但是，您可以通过在相应的 server.conf.yaml 文件中修改任何集成服务器属性来更改这些属性。 有关配置由集成节点管理的集成服务器的更多信息，请参阅 通过修改 server.conf.yaml 文件来配置集成服务器。

过程

通过完成以下步骤更改集成节点的属性：

  1. 使用 YAML 编辑器打开要修改的集成节点的 node.conf.yaml 文件。

    您可以使用 IBM App Connect Enterprise 工具箱中提供的内置 YAML 编辑器来编辑该文件，方法是在 "应用程序开发" 视图中双击该文件，或者右键单击该文件并选择 打开时使用 > YAML 编辑器。 如果选择使用纯文本编辑器来编辑文件，请确保不包含任何跳进字符 (在 YAML 中无效) ，并使用 YAML 验证工具来验证文件的内容。

    有关使用 YAML 的更多信息，请参阅 http://www.yaml.org/start.html。

  2. 修改要更改的属性：
    1. 通过设置 port 属性的值，为 App Connect Enterprise Web 用户界面和 App Connect Enterprise Toolkit 设置管理 REST API 端口。 您可以将此属性设置为缺省值 4414。
    2. 指定 host 属性的值。
    3. 通过将 basicAuth 属性设置为 true，为集成节点启用认证:
      basicAuth: true
    4. 通过设置 authorizationEnabled 和 authorizationMode 属性，启用管理安全性并指定授权方式。
      例如：
      
authorizationEnabled: true 
authorizationMode: 'file'
    5. 您还可以修改属性以启用集成节点侦听器、配置 MQTT 服务器以及指定缺省队列管理器。
  3. 使用 mqsisetdbparms 命令指定集成节点在连接到受保护资源 (例如数据库) 时要使用的安全凭证。 运行此命令时，用户标识和密码将安全地存储在 IBM App Connect Enterprise 凭证库中。 有关使用此命令的更多信息，请参阅 mqsisetdbparms 命令。
  4. 重新启动集成节点。
    在 node.conf.yaml 文件中设置的属性将在集成节点启动后生效。 如果您再次修改这些属性，那么必须再次启动集成节点，以使最新更改生效。 有关更多信息，请参阅 启动和停止集成节点。