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


HTTP listeners

You can choose between integration node listeners and integration server (embedded) listeners to manage HTTP messages in your HTTP or SOAP flows. Learn about the two types of listener, how ports are assigned to them, and how you can switch from one to the other for individual integration servers.

Your choice of listener affects message flows that handle inbound web service requests and synchronous replies by using the following nodes: Message flows that do not handle inbound requests but that instigate outbound requests or asynchronous responses by using the following nodes are not affected:

The choice of listener also affects integration services and REST APIs. Integration services use a SOAPInput node, so they use the listener specified for SOAP nodes. REST APIs use an HTTPInput node, so they use the listener specified for HTTP nodes.

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 if you want to use an integration node listener. However, if you use HTTP nodes or SOAP nodes with the integration server embedded listener, IBM MQ is not required.

Integration server (embedded) listeners

Each integration server can run an embedded listener. You can configure the listener for HTTP and HTTPS configurations by defining, respectively, an HTTPConnector policy and HTTPSConnector policy. The policy definitions control the runtime properties that affect the handling of HTTP messages. The following examples assume that an integration server is associated with an integration node.
Run the following command to display the HTTPConnector properties for an integration server called default on integration node integrationNodeName:
mqsireportproperties integrationNodeName -e default -o HTTPConnector -r 
Run the following command to display the HTTPSConnector properties for an integration server called default on integration node integrationNodeName:
mqsireportproperties integrationNodeName -e default -o HTTPSConnector -r 
By default, SOAPInput, SOAPReply, and SOAPAsyncResponse nodes use the integration server listener. If integration server default on integration node integrationNodeName is using the embedded listener for SOAP nodes, the following command returns a value of true:
mqsireportproperties integrationNodeName -e default -o ExecutionGroup -n soapNodesUseEmbeddedListener
Conversely, the HTTPInput, HTTPReply, and HTTPAsyncResponse nodes use the integration node listener by default. If integration server default on integration node integrationNodeName is using the integration node listener for HTTP nodes, the following command returns a value of false:
mqsireportproperties integrationNodeName -e default -o ExecutionGroup -n httpNodesUseEmbeddedListener

Integration node listeners

You can configure the integration node listener for HTTP and HTTPS configurations by setting values in the node.conf.yaml file:
HTTPConnector:
   ListenerPort:  7080
HTTPSConnector:
   ListenerPort:  7083 
Run the following two commands to display the currently active settings for the integration node listener:
mqsireportproperties integrationNodeName -b NodeHttpListener -o HTTPConnector -r 
mqsireportproperties integrationNodeName -b NodeHttpListener -o HTTPSConnector -r 
Each connector has its own assigned port; default values are 7080 for HTTP and 7083 for HTTPS. You can change these port numbers by using the mqsichangeproperties command. For example, run the following command to change the port on which the integration node listener for integration node integrationNodeName listens for HTTP messages:
mqsichangeproperties integrationNodeName -b NodeHttpListener -o HTTPConnector 
   -n ListenerPort -v 8085 
Run the following command to change the port on which the integration node listener for integration node integrationNodeName listens for HTTPS messages:
mqsichangeproperties integrationNodeName -b NodeHttpListener -o HTTPSConnector 
   -n ListenerPort -v 8086 

You can configure one or more integration servers so that HTTP nodes that you deploy to those integration servers use the embedded listener, or so that SOAP nodes that you deploy to those integration servers use the integration node listener.

Using both integration node and embedded listeners

Because the option to use the embedded listener is at the integration server level, you can change your configuration such that some integration servers that are associated with an integration node use the integration node listener for HTTP nodes, SOAP nodes, or both, and other integration servers use the embedded listener for HTTP nodes, SOAP nodes, or both.

However, if you disable the integration node listener, the integration server listeners are used for all HTTP and SOAP nodes, even if you have not explicitly enabled support for them.

The HTTPRequest node always communicates directly through the HTTP transport, and is therefore unaffected by your choice.

If you change the listener and port that are processing your HTTP or HTTPS messages, you must ensure that you also update your applications to use the updated configuration.


bc43700_.htm | Last updated 2018-11-02 14:46:20