IBM DataPower Operations Dashboard v1.0.12.0
A newer version of this product documentation is available.
You are viewing an older version. View latest at IBM DPOD Documentation.
IDG WS-M Payload Capture Support
- shachar greenberg (Unlicensed)
- Amit Munwes
- Hanan Kenan
Web Services Management (WS-M) payload capture is supported by IDG for the following services:
- Web Service Proxy starting firmware version 6.1.x .
- Multi-Protocol Gateway starting firmware version 7.5.2.1 and DPOD version 1.0.2 for payload formats XML and JSON.
In order for the IDG to capture payload via WS-M the following IDG configuration is needed:
- Web Service Proxy – Can be fully configured via DPOD since there is no need to change service configuration.
- Multi-Protocol Gateway – The following configuration needs to be done in the service configuration:
- Enable the WS-M agent configuration in the Multi-Protocol Gateway service
- Enter the service -> advanced tab -> turn “Monitor via Web Services Management Agent” to “on”.
- Choose “All” in the “Message capture via Web Services Management Agent” filed.
- Enable XML / JSON parsing
The WS-M agent capture only parsed XML and JSON formats. In order for the service to parse the payload the following service configuration are needed.- Option one - Change the “Request Type” and the “Response Type” to XML, JSON or SOAP.
Note – If only one of the service direction (request or response) is configured with the supported payload formats then only payload from that direction will be captured.
- Option one - Change the “Request Type” and the “Response Type” to XML, JSON or SOAP.
- Option two – If you must configure the request and response type as “non-xml” you can add “transform” action to the processing policy that will cause payload parse.
- In every processing rule add “Transform with processing control file” action.
- Choose the input=INPUT, output=NULL, “Input language”=XML or JSON according to the service design.
- Option two – If you must configure the request and response type as “non-xml” you can add “transform” action to the processing policy that will cause payload parse.
Due to IDG limitation the client request may not be captured.
Web services management agent
For each domain you would like to capture payload, you will need to manually enable the web services management agent (if it's disabled)
However, if you will try to configure WS-M subscriptions to all domain from DPOD and at least one of the domains is in disabled state, than you will get an error message ".. Subscription Manager reached maximum number od subscriptions". In that case you should configure each domain speratley or enable Web Service Management Agent for all domains.