1. Introduction

DataPower Buddy (“DPBuddy”) is a tool for automating administration and management of IBM WebSphere DataPower appliances. The tool supports configuration export, configuration import, file transfer, backups and many other functions, as described in this document.

Each of these functions is implemented as a command (a.k.a. command-line interface - CLI) that can be run directly from command line/shell and as a custom task for the Apache Ant build tool.

For example, to import a domain, you can run the following command:

dpbuddy import -file domain.zip -assertObjectsUp -save

This command will import the configuration and files contained in “domain.zip”, verify that all objects and services are up and running after the import and save the domain’s configuration.

To implement the same functionality in an Ant build script, you could create an Ant target containing the dp:import task (all DPBuddy tasks have dp: XML namespace prefix):

<target name="import.domain" >
   <dp:import file="domain.zip" assertObjectsUp="true" save="true"  />
</target>

You can find many more examples in your DPBuddy distribution under samples or online. The directories samples/cli-shell and samples/cli-win contain CLI examples for Linux and Windows respectively. The samples/ant-tasks folder contains examples of Ant tasks. You can also look at samples/ant-end-to-end and dp-build.deploy.xml, which implements an end-to-end build/deploy process using DPBuddy.

Internally DPBuddy uses the DataPower SOAP interface a.k.a. SOAP Configuration Management (“SOMA”) for all of its functions. You can find more details about SOMA in DataPower InfoCenter or in this redbook, however, no knowledge of SOMA is required to be able to use DPBuddy. Reliance on SOMA means that DPBuddy runs all of its commands remotely over HTTPS using the port dedicated to the XML management interface. You can find this port under Network/Management/XML Management Interface in DataPower WebGUI.