Before you start
This section describes what to expect from this tutorial and how to get the most out of it.
Those of you who have been following IBM's support for the Web Services Distributed Management (WSDM) standard through delivery of WSDM run time and tooling are probably aware of the Autonomic Integrated Development Environment (AIDE) made available on IBM alphaWorks earlier this year. As a logical next step in the support of an open standard like WSDM, the run-time code was contributed to the Apache Muse project, and keeping in step, a new revamped version of the tooling for WSDM is now available as part of the Eclipse TPTP (Test and Performance Tools Platform). While the run time provides a stable reference implementation of the WSDM specifications and a programming model for building WSDM endpoints, the tooling lets you visually model a WSDM interface in an IDE, generate the endpoint code that follows the Muse programming model, and also test a sample deployment of the generated endpoint with your custom implementation added to it.
The tooling is available as part of the Build to Manage download in the Eclipse TPTP project. It is manifested as a set of plug-ins that provide editors for various WSDM-related constructs like capabilities, managed resource types, and so on, and Muse-specific artifacts like a run-time deployment descriptor. Also available in TPTP is a Managed Agent Explorer that lets you test the endpoints built using the tooling in addition to introspecting existing endpoints.
This saga started with the tutorial "Create a WSDM interface for an HTTP server using Apache Muse," which demonstrated how to use Apache Muse to create a WSDM-compliant interface for a manageable resource. That prompted the tutorial "Create a WSDM endpoint using the Eclipse TPTP Build to Manage tooling" so you could see an alternate way to build a WSDM interface for the Apache HTTP server without having to worry about Web services artifacts like Web Service Definition Language (WSDL) and schema files. There's also an article ("Why open source for the WSDM open standard?") to detail the tooling, explain why an interface should be built with open source, and show how you can affect the development of the run time and the tooling. Although not offered as a package, these resources fit nicely together to provide a more complete view of WSDM tooling.
This tutorial uses a hands-on approach to help you find, install, and configure Apache Muse, the stable release of the WSDM tooling in Eclipse TPTP 4.3, and the latest development builds of WSDM Tooling in TPTP 4.4. After all, you can pursue the other tutorials without them. This is meant to be an introductory tutorial; for more on effortlessly building WSDM endpoints, try the other tutorials mentioned (and keep an eye out for upcoming tutorials on developerWorks).
This tutorial is divided into three major sections:
- Obtaining and installing Apache Muse
- Obtaining and installing the WSDM tooling in Eclipse TPTP 4.3 (the stable release)
- Obtaining and installing the tooling development builds in TPTP 4.4
This tutorial is for developers who have an understanding of the installation process for software. Because you will be using this understanding as a basis for other tutorials, it is also a good idea to have a high level of understanding of WSDM concepts and a good grasp of Web services in general. The intent of the tooling is to hide the complexities of Web services development and Apache Muse artifacts while advocating a standard programming model. But, familiarity with Web services will help you follow the tasks closely. Java development experience using an IDE such as Eclipse is also greatly helpful.
Prerequisites for Eclipse TPTP can be found at http://www.eclipse.org/tptp/home/downloads/drops/TPTP-4.3.0-200611160100C.html#requirements.