IBM App Connect Enterprise, Version 11.0.0.2 Operating Systems: Windows, Linux


Modifying an integration node

You can configure an integration node by setting properties in the node.conf.yaml configuration file for the integration node.

Before you begin

You must have completed the following tasks:

About this task

When you create an integration node, a default node.conf.yaml configuration file is created automatically for the integration node and stored in the file system. You can then configure the integration node by modifying properties in the node.conf.yaml file.

You set properties in the node.conf.yaml file to configure the operation of your integration node and associated resources. For example, you can set a REST administration port and an HTTPS port, you can enable administration security, and you can configure the trace level, activity logging, JVM, and the reporting of statistics and accounting data.

When you create integration servers that are owned by the integration node, a default server.conf.yaml configuration file is created for each of the integration servers, and they are stored in the file system in subdirectories below the integration node directory. Any properties that you set for the integration node, in the node.conf.yaml file, are inherited by the integration servers that it owns. However, you can change any of the integration server properties by modifying them in the appropriate server.conf.yaml file.

Procedure

Change the properties of an integration node, by following these steps:

  1. Use a YAML editor to open the node.conf.yaml file for the integration node that you want to modify.

    If you do not have access to a YAML editor, you can edit the file by using a plain text editor; however, you must ensure that you do not include any tab characters, which are not accepted in YAML and will cause your integration node configuration to fail. If you choose to use a plain text editor, ensure that you use a YAML validation tool to validate the content of your file.

    For more information about working with YAML, see http://www.yaml.org/start.html.

  2. Modify the properties that you want to change:
    1. Set the administration REST API port for the App Connect Enterprise web user interface and the App Connect Enterprise Toolkit, by setting a value for the port property. You can leave this property set to the default value of 4414.
    2. Specify a value for the host property.
    3. Enable authentication for the integration node, by setting the basicAuth property to true:
      basicAuth: true
    4. Enable administration security and specify an authorization mode, by setting the adminSecurity and authMode properties. For example:
      adminSecurity: active 
      authMode: file 
    5. You can also modify properties to enable the integration node listener, to configure the MQTT server, and to specify a default queue manager.
  3. Specify the security credentials to be used by the integration node when connecting to a secured resource (such as a database) by using the mqsisetdbparms command. When you run this command, the user ID and password are stored securely in the IBM App Connect Enterprise credentials store. For more information about using this command, see mqsisetdbparms command.
  4. Restart the integration node. The properties that you set in the node.conf.yaml file take effect when the integration node is started. If you modify these properties again, you must start the integration node again for the latest changes to take effect. For more information, see Starting and stopping an integration node.

ae03310_.htm | Last updated 2018-11-02 14:45:49