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

Difference between revisions of "COSMOS DG Constructing a Data Manager"

(Creating a data manager or MDR project)
(Replacing page with 'COSMOS Wiki > COSMOS Document Plan > COSMOS Manual Guide The most current content for this documentation is f...')
 
(26 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[[COSMOS|COSMOS Wiki]] > [[COSMOS_Documentation_Plan|COSMOS Document Plan]] > [[COSMOS_Manual_Guide |COSMOS Manual Guide]]
 
[[COSMOS|COSMOS Wiki]] > [[COSMOS_Documentation_Plan|COSMOS Document Plan]] > [[COSMOS_Manual_Guide |COSMOS Manual Guide]]
  
== COSMOS Development Guide Constructing a Data Manager ==
+
The most current content for this documentation is found here: http://www.eclipse.org/cosmos/documents/v1.0/devguide/cosmosdevguide04.htm#HDRDQX1CREATINGADATAMANAGER
 
+
Category: [http://wiki.eclipse.org/Category:COSMOS_Development_Guide Development Guide]
+
+
{| border="1" cellpadding="2"
+
|-
+
|'''Owner'''
+
|Hubert Leung and David Whiteman
+
 
+
|-
+
|'''Bug #'''
+
|[https://bugs.eclipse.org/bugs/show_bug.cgi?id=219141 219141]
+
 
+
|-
+
|'''Due dates'''
+
| [[COSMOS_Document_Schedule#COSMOS Development Guide| Schedule]]
+
|}
+
 
+
== Outline ==
+
== Creating a Data Manager ==
+
=== Preparing the development environment ===
+
'''Installing COSMOS SDK and pre-requisites'''
+
 
+
For the following instructions, <code>eclipse-home</code> refers to the directory where Eclipse is installed (i.e. the parent of the "eclipse" directory).
+
 
+
# Download the <code>wtp-sdk</code> package of Webtools 3.0 from http://www.eclipse.org/webtools and unzip into <code>eclipse-home</code>.
+
# Download EMF and GEF prerequisites linked from the above Webtools download page, and unzip into <code>eclipse-home</code>.
+
# Download SDK zip from the desired stable COSMOS build at http://www.eclipse.org/cosmos, and unzip into <code>eclipse-home</code>.
+
# Ensure Tomcat 5.5 or greater is installed, per the instructions in the [[COSMOS InstallGuide10|COSMOS Install Guide]].<font color="red">
+
# Ensure Axis2 1.3 or greater is installed, per the instructions in the [[COSMOS InstallGuide10|COSMOS Install Guide]].</font>
+
 
+
=== 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 (<code>config.properties</code> and <code>domainEPR.xml</code>) and stub classes for you to implement, and also the necessary prerequisite .jar libraries in the <code>WebContent/WEB-INF/lib</code> directory.
+
 
+
To create a new data manager project, complete the following steps:
+
 
+
# Open the J2EE perspective in Eclipse.
+
# Select <b>File -> New -> Project...</b> from the Eclipse menu bar.  The New Project wizard starts.
+
# From the New Project wizard, select <b>Web -> Dynamic Web Project</b> and press the <b>Next</b> button.  The New Dynamic Web Project wizard starts.
+
# Follow the project wizard prompts, and set the values as suggested below.
+
 
+
<b>Wizard fields</b>
+
 
+
<dl>
+
<dt>Target Runtime
+
<dd>
+
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.
+
<dt>Configuration
+
<dd>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.  <font color="red">Follow these steps to configure the project in order to implement an MDR:
+
<ol>
+
<li>Select the configuration and click the '''Modify...''' button.  The Project Facets dialog will open.
+
<li>Select the "Axis2 Web Services" facet category.  Axis2 is the web services implementation used by COSMOS to deploy MDRs to a J2EE container.
+
<li>Under the "Systems management" category, Select "CMDBf query service" to implement an MDR with a query service.
+
<li>Select "CMDBf registration service" to optionally implement a registration service.
+
<li>Press '''OK''' to complete the configuration.
+
</ol></font>
+
<dt>Package name
+
<dd>On the "Data manager configuration" or "MDR configuration" page, enter the name of the package that will contain the generated class representing the data manager or MDR.
+
<dt>Generated class name
+
<dd>Enter the name of the class to be generated that represents the data manager or MDR.<s><del>
+
<dt>Resource id
+
<dd>Enter a unique identifier for the data manager or MDR.
+
<dt>Display name
+
<dd>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.
+
<dt>Description
+
<dd>Enter a description of the data manager or MDR.
+
<dt>URI
+
<dd>On the Domain EPR wizard page, enter the URI used for the Endpoint Reference (EPR) used for testing.
+
<dt>Reference parameters
+
<dd>Enter any optional reference parameters for the EPR.
+
<dt>CMDBf services to implement
+
<dd>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.</del></s>
+
</dl>
+
 
+
=== 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 ==
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
  
 
[[Category:COSMOS_Development_Guide]]
 
[[Category:COSMOS_Development_Guide]]

Latest revision as of 16:26, 14 November 2008

COSMOS Wiki > COSMOS Document Plan > COSMOS Manual Guide

The most current content for this documentation is found here: http://www.eclipse.org/cosmos/documents/v1.0/devguide/cosmosdevguide04.htm#HDRDQX1CREATINGADATAMANAGER

Back to the top