Configure your integration node and integration servers
that are associated with an integration node to use the integration
node listener for HTTP or SOAP nodes in one or more integration servers.
Before you begin
The integration node listener requires access to system queues on the queue
manager specified on the integration node, so you must install
IBM® MQ Server and ensure that a queue manager is specified.
About this task
You can change the configuration for integration servers that are associated with an
integration node so that HTTP or SOAP nodes use the integration node listener. HTTP nodes and SOAP
nodes use the integration server (embedded) listener by default, but you might want to switch to
using the integration node listener.The commands that are shown in the
examples here are split across multiple lines for ease of reading. When you enter the command, you
must use a single line.
Procedure
- Check that the integration node is running.
- If you disabled the integration node listener, run the mqsichangeproperties command
to restart it.
For example:
mqsichangeproperties integrationNodeName -b NodeHttpListener -o HTTPListener
-n startListener -v true
- To switch to using the integration node listener for a
specific integration server that is associated with the integration
node, use the mqsichangeproperties command to
change the integration server configuration.
-
The integration node must be stopped for the switch to
work. If the node is running, stop it by using the following command
mqsistop integrationNodeName
- To use the mqsichangeproperties
command, adapt one of the following examples:
mqsichangeproperties integrationNodeName -f -e server_name -o ExecutionGroup
-n httpNodesUseEmbeddedListener -v false
mqsichangeproperties integrationNodeName -f -e server_name -o ExecutionGroup
-n soapNodesUseEmbeddedListener -v false
- Optional:
If you want to use HTTP applications on multiple integration servers, you need to change the
HTTP/HTTPS ports to be unique for each integration server. By default the HTTP port is set to 7800
and the HTTPS port is set to 7843. Configure your integration servers by setting properties in the
server.conf.yaml file, as described in Configuring an integration server by modifying the server.conf.yaml file
- Restart the integration node to ensure that your changes
take effect.
Example
For more information about this command,
and examples of changing other properties that are associated with
an integration node or integration server, see the description of
the mqsichangeproperties command.