IBM DataPower Operations Dashboard v1.0.16.0
A newer version of this product documentation is available.
You are viewing an older version. View latest at IBM DPOD Documentation.
Duplicate Transactions and Messages are Displayed
Symptoms
In DPOD dashboards, Transactions page and Raw Messages page, many transactions and log messages appear twice.
All transactions/messages usually belong to the same domain or device.
Cause
Option 1:
Due to a change in the DataPower gateway firmware log categories, duplicate messages might appear if the Syslog log targets configuration in the DataPower gateway is not up-to-date.
Option 2:
DPOD uses DataPower gateway Syslog log targets to get the transactional data from the DataPower gateways. Each domain in the DataPower gateway contains one or more log targets for DPOD.
Since it is possible to connect a single domain or a device to one or more DPOD instances (e.g. for HA), the log target names include the DPOD environment name (
DPOD-MSC-<env name>-<suffix>
).Duplicate transactions and messages happen when there are duplicate log targets, with different environment names, but with the same destination DPOD instance (host name / IP).
Consider the following scenario as an example of such a case:
DPOD
env1
is installed. A DataPower gateway is then added and set up to send transactional data to DPODenv1
. This will createDPOD-MSC-env1-<suffix>
log targets on all of its domains.DPOD
env1
is then uninstalled, without removing the DataPower gateway from DPOD Web Console, which leaves the log targets as is in the DataPower Gateway.DPOD
env2
is then installed on the same machine/IP address of the oldenv1
instance (for example, to change the deployment profile of DPOD from a Medium profile to a High profile to be able to process more TPS). The same DataPower gateway is then added and set up to send transactional data to DPODenv2
. This will create additionalDPOD-MSC-env2-<suffix>
log targets on all of its domains.Now, each log message will be sent twice - once from the
DPOD-MSC-env1-<suffix>
log target and once from theDPOD-MSC-env2-<suffix>
log target, both will be sent to the same DPOD instance and will be shown twice.
Resolution
Setup Syslog again on the device level and for all domains, for all gateways in DPOD Web Console (under Manage → Topology → Gateways).
Inspect the log targets in the domains of the DataPower gateway, find the duplicate log targets of DPOD with the wrong/old environment name, and delete them.
In the future, before DPOD uninstallation, make sure to remove all DataPower gateways from DPOD Web Console. This will provide you with the option to remove all log targets from the DataPower gateway as part of its removal from DPOD, and will prevent the duplication if this DataPower gateway will be added to another DPOD instance that will share the same machine/IP address.
Â