Troubleshoot communication problems between ITCAM Agent for WebSphere DataPower Appliance and the DataPower device
wangzhih 100000UW1P Visits (5667)
ITCAM Agent for WebSphere DataPower Appliance v7.1 uses multiple protocols to collect data from the DataPower appliance. How to troubleshoot the communication problems between the agent and the monitored device? Is there any tool to facilitate the troubleshooting?
SOMA (SOAP Configuration Management)
v7.1 agent collects status data by sending SOAP requests to the XML Management Interface of the DataPower device. The device must enable "SOAP Configuration Management" service on the "XML Management Interface" and the port must matches the DP_PORT property in the agent configure file. Following is a screenshot of an example of the "XML Management Interface" configuration of a device.
On the machine where the agent installed, uses cRUL to send SOAP request to the device to verify the configuration of the device and the network communication. For instance, create a cpu.xml file with following contents to request the CPU usage data from a device.
<?xml version="1.0" encoding="UTF-8" ?>
<dp:request domain="default" xmln
<dp:get-status class="CPUUsage" />
Assume the IP address of the device is 18.104.22.168, the port of XML Management Interface is 5550, and password of the 'admin' user ID on the device is 'password', run the following cRUL command to send the SOAP reuqest to the device.
# curl -k -u admin:password @cpu.xml http
If the SOAP response contains error, then check the configuration of the device and verify if there is any network communication problem (firewall, for instance) from the agent to the DataPower device.
All attribute groups of XC10 appliance are collected via SNMP. Use SNMP command line (either system provided or open-source like Net-SNMP) on the machine where the agent located to test communication to the monitored appliance. For instance, assume the IP address of the device is 22.214.171.124, the SNMP community defined on the DataPower appliance "COM1", then use the following command to request the firmware version of the appliance.
# snmpget -v 2c -c COM1 126.96.36.199 1.3.
If the connection failed, then the following should be returned.
Timeout: No Response from 188.8.131.52.
In this case, you will need to check the SNMP settings of the appliance and see if there is any firewall in between the agent and the monitored appliance.
The agent can be configured to listen to SNMP events sending from the DataPower appliance.
1. The machine where the agent installed must be defined as one of the "Trap and Notification Targets" of the device. For instance, if the IP address of the agent is 184.108.40.206 and the agent is configured to listen on UDP port 1620 for SNMP traps, then the "Trap and Notification Targets" of device should contain item like in the following screenshot.
2. Make sure that the expected events are subscribed on the DataPower device.
3. If the agent is still not able to receive any event, use SNMP trap receiver (either system provided or open-source like Net-SNMP) on the machine where the agent installed to verify the network communication to the DataPower device and the SNMP Settings configuration of the device. You will need to stop the agent first, then configure the snmptrapd daemon to listen on the port that the agent is listening.