Switching from an integration node listener to embedded listeners

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

  1. Check that the integration node is running.
  2. 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.

  3. 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.
  4. 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.