DataPower Administration Tool (DPBuddy)

DataPower Buddy ("DPBuddy") is a free command-line tool for automating administration, management, configuration and deployment of IBM WebSphere DataPower appliances.

The tool supports export/import, file transfer, domain backups and all the other functions needed by DataPower administrator and developers.

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 administration and management.

Key features include:

  • 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. Ant and, hence, DPBuddy, can be easily invoked from command line or integrated with other build frameworks and build servers, such as Maven, Gradle, Jenkins/Hudson.

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

Please refer to the User Guide to get started.

DPBuddy is available free of charge under this freeware license and can be downloaded from this link.

MyArch, Inc. offers paid support for DPBuddy, including implementing custom enhancements. If you're interested in obtaining support, please contact us using the form at the bottom of this page.

If you have a question or feedback please post it on DPBuddy Google group or submit it using the form below:

*(denotes required field)