Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

COSMOS DG Constructing a Data Manager

Revision as of 16:20, 28 April 2008 by Dlwhiteman.us.ibm.com (Talk | contribs) (Creating a data manager or MDR project)

COSMOS Wiki > COSMOS Document Plan > COSMOS Manual Guide

COSMOS Development Guide Constructing a Data Manager

Category: Development Guide

Owner Hubert Leung and David Whiteman
Bug # 219141
Due dates Schedule

Outline

Creating a Data Manager

Preparing the development environment

Installing COSMOS SDK and pre-requisites

For the following instructions, eclipse-home refers to the directory where Eclipse is installed (i.e. the parent of the "eclipse" directory).

  1. Download the wtp-sdk package of Webtools 3.0 from http://www.eclipse.org/webtools and unzip into eclipse-home.
  2. Download EMF and GEF prerequisites linked from the above Webtools download page, and unzip into eclipse-home.
  3. Download SDK zip from the desired stable COSMOS build at http://www.eclipse.org/cosmos, and unzip into eclipse-home.
  4. Ensure Tomcat 5.5 or greater is installed, per the instructions in the COSMOS Install Guide.
  5. Ensure Axis2 1.3 or greater is installed, per the instructions in the COSMOS Install Guide.

Creating a data manager or MDR project

The COSMOS SDK provides Eclipse-based tooling for creating data manager and MDR projects. These tools make use of capabilities provided by the Eclipse Webtools project to configure your project with the necessary components to deploy your MDR in J2EE. When you are finished, the new project will contain new configuration files (e.g. services.xml) and stub classes for you to implement, and also the necessary prerequisite .jar libraries in the WebContent/WEB-INF/lib directory.

To create a new data manager project, complete the following steps:

  1. Open the J2EE perspective in Eclipse.
  2. Select File -> New -> Project... from the Eclipse menu bar. The New Project wizard starts.
  3. From the New Project wizard, select Web -> Dynamic Web Project and press the Next button. The New Dynamic Web Project wizard starts.
  4. Follow the project wizard prompts, and set the values as suggested below.

Wizard fields

Target Runtime
In the Target Runtime field, select the Apache Tomcat server where you want to deploy the data manager project. If a Tomcat server is not already defined, click New... to select a server runtime environment.
Configuration
After you define and select a target runtime for Apache Tomcat, the configuration "Default Configuration for Apache Tomcat v5.5" will be available for selection. Follow these steps to configure the project in order to implement an MDR:
  1. Select the configuration and click the Modify... button. The Project Facets dialog will open.
  2. Select the "Axis2 Web Services" facet category. Axis2 is the web services implementation used by COSMOS to deploy MDRs to a J2EE container.
  3. Under the "Systems management" category, Select "CMDBf query service" to implement an MDR with a query service.
  4. Select "CMDBf registration service" to optionally implement a registration service.
  5. Press OK to complete the configuration.

Package name
On the "Data manager configuration" or "MDR configuration" page, enter the name of the package that will contain the generated classes representing the web services implemented by this MDR.
Name
Enter the name of the data manager or MDR. This name will be used in the generation of web services code.
Resource id
Enter a unique identifier for the data manager or MDR.
Display name
Enter a human readable name for the data manager or MDR. This is the name displayed in the COSMOS Web UI for this data manager or MDR.
Description
Enter a description of the data manager or MDR.
URI
On the Domain EPR wizard page, enter the URI used for the Endpoint Reference (EPR) used for testing.
Reference parameters
Enter any optional reference parameters for the EPR.
CMDBf services to implement
If you selected "Management Data Repository" as the Systems Management facet of the project, you can select whether you want to implement just a query service, or both a query and registration service.

Customizing MDR parameters

Providing CMDBf Query Processing Handlers

Providing Custom Capabilities

Writing Client Proxies

Class Diagram

Running the MDR within Eclipse

Deploying the MDR on Tomcat

Content

Back to the top