A short guide to installing the WSDM tooling and WSDM extension for the TPTP Managed Agent Explorer
A short guide to installing the WSDM tooling and WSDM extension for the TPTP Managed Agent Explorer

Important: This user guide is assumed to be used with TPTP 4.4 Release Build
The following document provides the steps required to be executed before using the WSDM related tech preview plugins.

Table of Contents:
1. Introduction - Description and Purpose
2. Installation Sequence
3. Building Apache Axis2 based endpoints

Current limitations and workarounds are documented at the Eclipse TPTP Wiki Build to Manage limitations page


1 Introduction - Description and Purpose

Web Services Distributed Management is an important open standard that enables abstracted, holistic, standardized remote management of IT resources. The following tech previews, used in conjunction with TPTP, allows developers to build WSDM based resource endpoints for managing resources:

The Apache Muse runtime provides an open source implementation of WSDM and related specifications. The above plugins use the runtime to build new endpoints, to add the required runtime JARs to the built endpoints, and to connect with WSDM endpoints both custom built and existing. The WSDM tech preview for TPTP 4.4 now includes the Apache Muse 2.2 runtime, the latest release of Apache Muse at this time, which implements the WSDM 1.1 specifications. More details of Apache Muse can be found here.


2. Installation Sequence
  1. Make sure you have Java 5 / JDK 1.5 installed on your machine. The Web Tools Project which is used by the WSDM tooling has this dependency.
  2. Install TPTP, its prerequisites and WSDM tech preview plugins downloaded from the release build at TPTP 4.4 download page. Download the following and extract them into a folder say c:/tptp.Do not use the all-in-one download as it contains EMF 2.2 and we need EMF 2.3 to generate WSDM endpoints that run on a J2EE container.
  3. Then install the latest stable build of the Eclipse WTP (Web Tools Platform) and its dependencies found on the WTP download page. Download and extract the following files to the install folder (c:\tptp). Choose to overwrite any existing files and folders when you extract the following.
  4. Download and extract the Eclipse Equinox framework: eclipse-equinox-3.3.zip in the same folder (c:\tptp)
  5. Start eclipse with the -clean option and the -vm option if needed. See this help section on starting Eclipse. Typically if you have installed your JDK 1.5 at c:\jdk1.5 you'd use the eclipse -clean -vm C:\jdk1.5\jre\bin\java.exe
3. Building Apache Axis2 based endpoints

The WSDM tooling download above includes Apache Axis2 1.1. Hence Apache Axis2 based endpoints you build using the tooling will already have all the Apache Muse and Apache Axis2 JARs as part of the deployable Web Archive (WAR). However if you wish to use a different version of Apache Axis2 then you must separately download and extract it. The endpoints generated with the tooling have currently been tested with Apache Axis2 1.1 and 1.1.1. You can download Apache Axis2 from here. Download the standard binary distribution and extract it to a folder on your machine.

Once you start the tooling you have tell it the location of Apache Axis2. You can do this by opening the Preferences dialog (Window > Preferences) and choosing Axis2 Server Location under Web services distributed management in the tree on the left. Browse to the Axis2 location. In the dialog page, uncheck the option to use the default built-in Apache Axis2 (version 1.1) and provide the location of your Apache Axis2 install. The tooling will check if the location contains a valid Apache Axis2 install before accepting your choice. You can also change the Apache Axis2 location whenever you do code generation in the tooling.