IBM Support

WebSphere DataPower - Best practice for specifying port values

Troubleshooting


Problem

A DataPower best practice when configuring services or protocol handlers is to specify a port with a value of less than 10000, or to consider use of the Ephemeral Port Starting Point setting available in DataPower version 5 firmware.

Symptom

A port conflict occurs when a service, protocol handler, domain, or the appliance is restarted or disabled and then enabled. If a port conflict occurs, you will see an error message in the logs such as:

[my_domain][mgmt][error] xxxx(handler_name): trans(ttt): Operation state transition to up failed
[
my_domain][mgmt][error] xxxx(handler_name): trans(ttt): Failed to install on port
[
my_domain][mgmt][error] xxxx(handler_name): trans(ttt): Protocol Handler failed to go active 

[{"Product":{"code":"SS9H2Y","label":"IBM DataPower Gateway"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":"General","Platform":[{"code":"PF009","label":"Firmware"}],"Version":"4.0.2;4.0.1;3.8.2;5.0.0","Edition":"Edition Independent","Line of Business":{"code":"LOB77","label":"Automation Platform"}}]

Log InLog in to view more of this document

This document has the abstract of a technical article that is available to authorized users once you have logged on. Please use Log in button above to access the full document. After log in, if you do not have the right authorization for this document, there will be instructions on what to do next.

Document Information

Modified date:
08 June 2021

UID

swg21427424