ibm.com/redbooks
Redpaper
Front cover
IBM WebSphere DataPower
SOA Appliances
Part I: Overview and Getting Started
Juan R. Rodriguez
Somesh Adiraju
Joel Gauci
Markus Grohmann
Davin Holmes
Tamika Moody
Srinivasan Muralidharan
Christian Ramirez
Adolfo Rodriguez
Understand and effectively deploy
DataPower SOA appliances
Parse and transform binary, flat
text, and XML messages
Learn how to extend your
SOA infrastructure
International Technical Support Organization
IBM WebSphere DataPower SOA Appliances
Part I: Overview and Getting Started
April 2008
REDP-4327-00
© Copyright International Business Machines Corporation 2008. All rights reserved.
Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule
Contract with IBM Corp.
First Edition (April 2008)
This edition applies to Version 3, Release 6, Modification 0 of IBM WebSphere DataPower Integration
Appliance.
This document created or updated on March 27, 2008.
Note: Before using this information and the product it supports, read the information in “Notices” on
page vii.
© Copyright IBM Corp. 2008. All rights reserved. iii
Contents
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
The team that wrote this paper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Become a published author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Chapter 1. Introduction to DataPower SOA appliances. . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.1 Overview of the DataPower appliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1.1 Challenges in service-oriented networking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1.2 Meeting SOA challenges with DataPower appliances . . . . . . . . . . . . . . . . . . . . . . 3
1.1.3 DataPower appliance models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2 DataPower deployment scenarios and use cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2.1 DataPower deployment scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2.2 DataPower use cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.3 Configuration and usage of DataPower appliances . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.4 SOA governance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Chapter 2. Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.1 Installing the device. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.1.1 IBM Enterprise Rack (Power Systems). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.1.2 Required tools and cables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.1.3 Rack mounting an IBM WebSphere DataPower XML Appliance . . . . . . . . . . . . . 18
2.2 Setting up the DataPower appliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.2.1 Connecting the DataPower appliance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.2.2 Initializing the appliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.3 Launching the WebGUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2.4 Example: XML Firewall Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
2.4.1 Creating an application domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
2.4.2 Creating the XML Firewall Service in the domain . . . . . . . . . . . . . . . . . . . . . . . . . 30
2.4.3 Testing the Hello_XMLFW firewall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
2.5 Example: Web Service Proxy Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
2.5.1 Creating a Web Service Proxy Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
2.5.2 Testing the HelloWSProxy service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
2.5.3 Troubleshooting the configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
2.6 Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Chapter 3. Enabling existing applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
3.1 The enterprise service bus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
3.1.1 Definition of an enterprise service bus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
3.1.2 Enterprise requirements for an enterprise service bus . . . . . . . . . . . . . . . . . . . . . 55
3.2 A sample scenario and components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
3.3 Transformations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
3.3.1 WebSphere Transformation Extender basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
3.3.2 Creating a type tree with Type Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
3.3.3 Mapping an input type tree to an output type tree by using Map Designer. . . . . . 65
3.4 Deployment of the XML to COBOL transformations . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
3.4.1 Creating the WebSphere MQ resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
