DataPower Administration Tool (DPBuddy)

DataPower Buddy ("dpbuddy") is a free command-line tool for automating administration, management and deployment of IBM WebSphere DataPower appliances. The tool supports export/import, file transfer, backups and many other functions. DPBuddy provides numerous benefits over using DataPower command shell (which is lacking scripting capabilities), running SOMA commands from "curl" and other traditional methods of DataPower management.

Here are some of the dpbuddy's features:

  • Support for export, import, checkpoints, backups, remote file upload, domain reset, log analysis, device status and many other functions.
  • Response from the device is presented in a human-readable form as opposed to raw SOAP/XML messages. dpbuddy makes it easy to understand error and status messages.
  • Powerful remote "copy" command that automatically reproduces local directory tree on the device.
  • Tight integration with Ant. Ant variables can be used inside deployment policies and configuration files.
  • Easy-to-use alternative to deployment policies based on XPath.
  • Ability to remotely "tail" device logs. It is even possible to automatically get new log messages similarly to Unix "tail -f" command. "tail" task can also check for error patterns.
  • "Export" based on naming patterns. You don't need to know types ("classes") of DataPower objects; simply specify a regexp pattern and dpbuddy will export all objects matching this pattern.
  • Support for self-signed certificates. No need to add DataPower certificates to the JDK store.
  • Support for arbitrary SOMA requests. You can use Ant variables inside a request.
  • Validation of all commands on the client. In case of XML errors, DataPower returns cryptic "internal error" message. The actual error then has to be extracted from the device logs. dpbuddy on the other hand validates management XML commands on the client and displays error messages right away.

dpbuddy is implemented as a set of custom tasks for the popular build tool, Apache Ant.

This Ant build file provides a complete set of examples illustrating dpbuddy usage.

Please refer to the User Guide to get started.

dpbuddy is available free of charge under this freeware license.

It can be downloaded from this link.

MyArch, Inc. offers paid support for dpbuddy, including implementing custom enhancements. If you're interested, please contact us as info at myarch.com.

You can also post your question on DPBuddy Google group.