Configure your integration nodes and associated integration
servers so that some or all of the HTTP or SOAP nodes use an integration
server (embedded) listener. SOAP nodes use an embedded listener by
default. You might have changed them to use the integration node listener,
but now want to return to using embedded listeners.
About this task
You can change the configuration for one or more integration servers that are associated
with an integration node so that HTTP or SOAP nodes that are deployed in these integration servers
use the embedded listener.If you decide to return to using an integration node
listener, you must specify a default queue manager for the integration node. For more information,
see Interaction between IBM App Connect Enterprise and IBM MQ.
Procedure
- Check that the integration node is running.
- If you want all HTTP and SOAP nodes in all integration
servers on the integration node to use the embedded listener, you
can change the integration node configuration to disable the integration
node listener.
Run the
mqsichangeproperties command
to change the integration node configuration. Do not run this command
if you want to keep the integration node listener active for at least
one of your associated integration servers.
mqsichangeproperties INODE -b NodeHttpListener -o HTTPListener
-n startListener -v false
All integration servers on the
specified integration node detect this change of status, and use the
embedded listener when they are restarted, regardless of their own
specific configuration. Therefore, you can switch to using embedded
listeners for all associated integration servers by running this single
command.
If you disable the integration node listener in this way,
you can configure an associated integration server to use the same
port or ports that the integration node listener was using for HTTP,
HTTPS, or both. Reusing the port numbers means that you do not have
to change your client applications to send messages to a different
port number.
- To switch to using the embedded listener for a specific
integration server on an 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 INODE -f -e exgroup1 -o ExecutionGroup
-n soapNodesUseEmbeddedListener -v true
mqsichangeproperties INODE -f -e exgroup1 -o ExecutionGroup
-n httpNodesUseEmbeddedListener -v true
INODE is the name of
your integration node; exgroup1 is the name of
your integration server.
- Restart the integration node to implement your changes.
Example
For more information about this command, and examples of changing
other properties that are associated with integration nodes or integration servers, see the
description of the mqsichangeproperties command.