IBM DataPower (Cast Iron,API management) Error Report Tool

When you do some experimenting on DataPower you’ve probably come across the error report function. Those files filled to the brim with useful information, The problem with it is that they contain way to much information to be processed by our tiny brains. If only there was a tool that made these files way more useful … And now there is one, to be more specific now this tool became available to the public.

It’s a tool that focuses on the “tech” guys. Which basically means that it gives you a human readable report coming from an error report on DataPower. But not in the most eye pleasing form.

You can find the source of tool on the DataPower Github.
And with a little bit of ant you can get it running on windows within minutes. So lets build the latest version.

– JDK 1.7 or later
– a way to extract .gz archives (something like 7zip will do)

  1. First we download a zip of the master
  2. Secondly we grab ourselves a copy of the ANT windows binary (you can the zip on the ANT download page )
  3. I put them somewhere together in a directory.
  1. Now i we let ANT build the JAR file with the buildfile ant -buildfile build.xml
  1. Now we generate an error report to analyse.
  1. To dowload it from DataPower. Go to the DataPower file management there you’ll find, Under the temporary:/// dir the error report. one timestamped and one without timestamp (this last one is is always the latest version)
  1. Now we extract the the txt file from the archive. A beauty like this should come out
  1. Now we run the following command in java -cp ErrorReport.jar -gui  the dist dir which was created by ANT  (something like \ertool-master\framework\dist)
  1. Trough clicking the Error report button we select the previously extracted txt file, as output we select a new html file
  1. Then you press Run (at first it seems like the program just closed, give it some time and you’ll see the magic happen in the cmd prompt)
  2. When this process is finished you’ll see the out HTML page that you selected as save location. And if all goes well it should also open automatically.
  3. It now looks like this

Author: Tom V.O.

P.S.: For the people who are too lazy to build it with ANT here is my build (20-02-2016 W10 64-bit) It should work on windows.



Curious to know more about this topic?

Working at i8c

i8c is a system integrator that strives for an informal atmosphere between its employees, who have an average age of approx 30 years old. We invest a lot of effort in the professional development of each individual, through a direct connection between the consultants and the management (no multiple layers of middle management). We are based in Kontich, near Antwerp, but our customers are mainly located in the triangle Ghent-Antwerp-Brussels and belong to the top 500 companies in Belgium (Securex, Electrabel, UCB, etc…).

Quality Assurance

i8c is committed to delivering quality services and providing customer satisfaction. That’s why we invested in the introduction of a Quality Management System, which resulted in our ISO9001:2000 certification. This guarantees that we will meet your expectations, as a reliable, efficient and mature partner for your SOA & integration projects.

i8c - ISO9001-2015

Also worth reading

AWS AppFlow: Streamlining SaaS Integrations with AWS Services

In today’s digital world, organizations are constantly looking for ways to streamline their workflows and improve their data management processes. One of the key challenges that organizations face is integrating their various software as a service (SaaS) applications with their data management systems. This is

Read More »

Apigee Scope Validation using OpenAPI Specification

In API security and management, we often use a lot of different security mechanisms to protect the requested resource behind the API Gateway. One of these mechanisms is the validation of scopes to authorize a client on a specific sub-resource of the API. Most of

Read More »