Configuring an integration server by modifying the server.conf.yaml file
You can configure your IBM® App Connect Enterprise integration server by modifying properties in a server.conf.yaml configuration file. The location of the server.conf.yaml file that you need to modify depends on whether you are configuring an independent integration server or an integration server that is managed by an integration node.
Before you begin
Set up your command environment, as described in Setting up a command environment.
About this task
When you create an integration server, you set properties in the server.conf.yaml file to configure the operation of the integration server and associated resources. For example, you can set a REST administration port and an HTTPS port. Or you can configure the trace level, activity logging, JVM, and the reporting of statistics data for your integration server. You can also configure the integration server to record all messages that pass through a message flow, and then use these recorded messages to generate unit tests.
For an independent integration server, the server.conf.yaml
configuration file is created for you automatically when you use the mqsicreateworkdir command to create a work directory for the
integration server. The server.conf.yaml file is created in the root of the
specified work directory: <work directory>/server.conf.yaml
.
If you use any commands that modify the integration server, an overrides directory is created
under the working directory for the integration server. This overrides directory contains an extra
server.conf.yaml configuration file, which contains property values that are
set by commands; for example, <work directory>/overrides/server.conf.yaml
. The
values of properties in this overrides/server.conf.yaml file override any
values that you set in the integration server's server.conf.yaml file
(<work directory>/server.conf.yaml).
If a property is set in the integration server's server.conf.yaml file, and
also in the overrides directory (/overrides/server.conf.yaml
), the property value
that is set in the overrides directory is used. Therefore, if an integration server is not using the
expected settings, check whether the expected property value in the
server.conf.yaml file in the overrides directory is overridden by a command. To
manually override settings that result from commands, either edit the property in the
server.conf.yaml file in the overrides directory, or remove the entry from the
overrides directory and modify the base server.conf.yaml file.
For integration servers that are managed by an integration node, each server has its own server.conf.yaml configuration file that overrides common settings from the integration node's node.conf.yaml configuration file. When you create an integration node, the node.conf.yaml file is at $MQSI_WORKPATH/components/<Node name>/node.conf.yaml.
If you use commands to modify the integration node, the changes are saved in the integration node's override node.conf.yaml file. This file is at $MQSI_WORKPATH/components/<Node name>/overrides/node.conf.yaml, as described in Creating an integration node by using the command line. When you create a managed integration server for an integration node, server-specific settings are created for it in its own server.conf.yaml file. The server-specific file is at $MQSI_WORKPATH/components/<Node name>/servers/<Server name>/server.conf.yaml.
If you use commands to modify this integration server, the changes are saved in: $MQSI_WORKPATH/components/<Node name>/servers/<Server name>/overrides/server.conf.yaml. The values of properties in this overrides/server.conf.yaml file override any values that you set in the <Node name>/servers/<Server name>/server.conf.yaml file.