Thursday, 26 October 2017

IBM API Connect and IBM DataPower Gateway - The Fun Continues

As per previous posts, I'm continuing to enjoy the voyage of discovery that is IBM API Connect (APIC) and IBM DataPower Gateway (IDG).

This time it's me trying to understand (a) why things aren't properly working and (b) how APIC drives IDG

Thus far, I've discovered that API connects to the XML Management Interface on the IDG, and creates a new Domain ( with a semi-random name prefixed by APIMgmt_e.g. APIMgmt_BF8B3A8C34 ), and then creates a pair of Multiprotocol Gateways (MPG), named webapi-internal and webapi.

All seems fine but ….

I'm seeing this in the IDG logs: -

1,20171026T152710.907Z,APIMgmt_BF8B3A8C34,network,error,xmlmgr,webapi-wcc,36511,,,0xb30009,,,"Host connection could not be established"
1,20171026T152710.907Z,default,network,error,,,1759,,,0x80e00173,,,"TCP connection attempt refused from to port 2444"
1,20171026T152710.907Z,APIMgmt_BF8B3A8C34,network,error,xmlmgr,webapi-wcc,36511,,,0x80e00049,,,"Host connection failed to establish: : tcp port 2444"
1,20171026T152710.907Z,APIMgmt_BF8B3A8C34,network,error,,,36511,,,0x80e00627,,,"Error occurred (port error) when connecting to URL ''"
1,20171026T152710.907Z,APIMgmt_BF8B3A8C34,wcc,warn,wcc-service,webapi-wcc,36511,,,0x80e0053c,,,"Request for WebSphere Cell information failed: Empty result set"

which is weird because my IDG has a static IP address of

( How I got that address is a whole other blog post - ask me about VMware, Bridged networking and DHCP ! )

So I dug further into the configuration, via the IDG UI: -

and then searched for that particular IP address - - which occurred in three places: -

So I dug into the configuration further: -

and found this: -

I changed the address to the correct address of the IDG ( yes, and I've NO idea why APIC / IDG things that we have a WebSphere Application Server (WAS) cell in the mix )….

I'm not yet fully there … but I'm learning as I go.

For the record, I did some other tinkering to IDG: -

Add hostname aliases for the APIC Management and Developer Portal boxes

config; dns; static-host; static-host; static-host; exit; write mem; exit;

config; dns; show; exit; exit

Global configuration mode
Modify DNS Settings configuration

 admin-state enabled 
 name-server 53 53 3 
 static-host "" 
 static-host localhost "" 
 static-host "" 
 static-host "" 
 force-ip-preference off 
 load-balance round-robin 
 retries 2 
 timeout 5 Seconds

test tcp-connection 443

TCP connection successful

test tcp-connection 443

TCP connection successful

test tcp-connection 8443

TCP connection successful

Check the internal IDG load balancers

config; show domains

 Domain             Needs save File capture Debug log Probe enabled Diagnostics Command Quiesce state Interface state Failsafe mode 
 ------------------ ---------- ------------ --------- ------------- ----------- ------- ------------- --------------- ------------- 
 APIMgmt_BF8B3A8C34 off        off          off       off           off                               ok              none          
 default            off        off          off       off           off                               ok              none          

switch domain APIMgmt_BF8B3A8C34

show loadbalancer-st

 Group        Host          Port Operational state Weight Administrative state 
 ------------ ------------- ---- ----------------- ------ -------------------- 
 analytics-lb 9443 up                20     enabled              
 mgmt-lb 0    up                20     enabled              


Prudhvi Nallamothu said...

after making the changes in Datapower , how we can import the same to APIM (i.e how to add APIM DP domain into APIM CMC)

Dave Hay said...

Morning Prudhvi

Thanks for your comment. You can add the DataPower Service via the Cloud Manager, under the Services tab.

So, open a browser to the CM URL e.g. and then navigate to Services ( ).

This has an 'Add Server' button, where you can enter the details of the IBM DataPower Gateway (IDG), and also configure ( or delete ) any existing Gateway Service.

These URLs may be of some use: -

Cheers, Dave

Prudhvi Nallamothu said...

Dave - Thank you very much for your suggestion.
Just want to brief about my problem --
I am using APIM - and Data Power- , When i am trying to add Data power gateway service in APIM CMC, it was Errored.

When i look at the Datapower logs, observed that the same issues you have explained in the blog. I have modified as per your suggestion.

I tried to edit the added server but still errored. Since its errored i cant able to restart or reboot DP Servers. When i choose the delete server option it was deleting the Domain in DP it was created for APIM.

Please suggest me how to import the modified version of APIM DP domain into CMC portal / Add DP servers / or any other way to get rid off those errors and add servers successfully/

Appreciate your help.

Dave Hay said...

Hi Prudhvi

Thanks for the comment.

As far as I'm aware, configuring the DP server/service within the APIC Cloud Manager publishes the resulting DP domain to the DP appliance itself.

Therefore, if needed, you can remove the domain(s) from the appliance, using the DP admin UI, and then create a new server/domain within APIC.

Cheers, Dave