Jump to: navigation, search

Difference between revisions of "COSMOS SDK Installation"

(Configuring the COSMOS SDK)
(Configuring the COSMOS SDK)
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This page provides instructions on how to install and run the COSMOS demo for i12.   
+
This page provides instructions on how to install and run the COSMOS SDK.   
  
 
== Objective of the SDK ==
 
== Objective of the SDK ==
The COSMOS SDK provides the eclipse-based tooling to construct a Management Data Repository (MDR).
+
The COSMOS SDK provides the Eclipse-based tooling to develop and test a Management Data Repository (MDR).
  
 
== Installation ==  
 
== Installation ==  
  
=== Download COSMOS Demo and Prerequisites ===
+
=== Download COSMOS Build and Prerequisites ===
This section provides instructions for installing and running the demo program that is provided in the COSMOS i12 build.   
+
This section provides instructions for installing and running the SDK provided by COSMOS.   
# Install [http://archive.apache.org/dist/tomcat/tomcat-5/v5.5.26/bin/ Tomcat 5.5.26]. The directory where the Tomcat server is installed will be referred to as the <tomcat_install_dir> in this document.  
+
# Install your favorite web server supporting Java Server Pages (JSP) and servlet technology.  
# From the [http://www.eclipse.org/cosmos/downloads/ COSMOS download page], click on the link of the latest candidate build for i13.  Download the zip file under the "COSMOS SDK" section.   
+
# From the [http://www.eclipse.org/cosmos/downloads/ COSMOS download page], click on the link of the stable build of your choice.  Download the zip file under the "COSMOS SDK" section.   
# Download the prerequisites for the SDK as specified on the download page (i.e.. Dojo, tomcat, axis2, wtp, eclipse, emf, xsd, and gef)
+
# Download the prerequisites for the SDK as specified in the Requirements section of the download page, including the Eclipse-hosted package for Dojo.
# Unzip Eclipse SDK to a directory along with wtp, emf, xsd, gef and the COSMOS SDK.
+
# Unzip Eclipse SDK to a directory along with WTP, EMF, XSD, GEF and the COSMOS SDK.
# Unzip Tomcat to a separate directory.
+
# Unzip the Dojo zip file to a separate directory.
# Unzip Dojo to a separate directory.
+
# Download IBM Java SDK 5.0 or the Sun Java JDK 1.5* to use with the COSMOS toolkit. IBM Java 5.0 can be found at http://www.ibm.com/developerworks/java/jdk/ .  Known issues with the Sun JRE:
 +
## You will need to do the following to configure Eclipse to avoid crashing the workspace with the internal web browser:
 +
### Select "General > Web Browser" from the preferences dialog box
 +
### Select the "Use external Web browser" radio button
 +
### Check the "Firefox" entry as the external web browser
 +
## When using the SML-IF Validator with the Sun JRE, you need to ensure the Xerces libraries appear in the boot classpath *before* the JVM's core libraries; otherwise, an internal validation error appears.  This can be resolved one of two ways:
 +
### Add the entry -Xbootclasspath/p:<Path of org.apache.xerces_2.9.0.v200805270400.jar in your machine> into eclipse.ini in the Eclipse folder.
 +
### Launch Eclipse from command line with: <code>eclipse -vmargs -Xbootclasspath/p:<Path of xerces.jar></code>
  
=== Configuring the COSMOS SDK ===
+
=== Configuring the COSMOS SDK ===
Before creating a MDR the you must set some configuration options in the preference page.   
+
Before creating a MDR, you must set some configuration options in the preferences page.   
# Start up eclipse.
+
# Start up Eclipse.
# Open the preference page by selecting Windows>Preferences.  In the preference dialog select "Web Services>Axis2 Preferences".
+
# Open the preference page by selecting Windows>Preferences.  In the preferences dialog, select "Web Services > Axis2 Preferences".
# Enter the axis 2 directory in the "Axis2 runtime location" text box.
+
# Enter the Axis 2 directory in the "Axis2 runtime location" text box.
# Next select "Server>Runtime Environments" in the preference dialog box.  Here you will specify the tomcat runtime.
+
# Next, select "Server > Runtime Environments" in the preference dialog box.  Here you will specify the web server runtime.
# Click the "Add..." button.  Select "Apache>Apache Tomcat v5.5" and click "Next".
+
# Click the "Add..." button.  Select a runtime environment and click "Next".
# Enter the location of the tomcat directory in the "Tomcat installation directory:" text box.
+
# Enter the location of the web server directory in the "<Web server name> installation directory:" text box.
# Next select "System Management>Web UI Viewer" in the preference dialog box.  Specify the location of the Dojo.js file in the "Dojo.xd.js URL Location" text box.  Set the location of the dojo.js file that you unzipped in a specific directory.  Or you can specify the AOL reference link http://o.aolcdn.com/dojo/1.1.0/dojo/dojo.xd.js.  Note that this will get the dojo javascript files from the web instead of the local computer.
+
# Next select "System Management > Web UI Viewer" in the preference dialog box.  Specify the host and port on which you want to run the web UI viewer for testing MDRs; the defaults should suffice for most users.
  
Once you have configured the SDK you can create a MDR by following the [http://wiki.eclipse.org/COSMOS_DG_Constructing_a_Data_Manager Constructing a Data Manager] section in the development guide.
+
Once you have configured the SDK, you can create a MDR by following the "Constructing a Data Manager" section in the COSMOS Developer's Guide.
 
   
 
   
 
[[Category: COSMOS]]
 
[[Category: COSMOS]]

Latest revision as of 15:41, 10 October 2008

This page provides instructions on how to install and run the COSMOS SDK.

Objective of the SDK

The COSMOS SDK provides the Eclipse-based tooling to develop and test a Management Data Repository (MDR).

Installation

Download COSMOS Build and Prerequisites

This section provides instructions for installing and running the SDK provided by COSMOS.

  1. Install your favorite web server supporting Java Server Pages (JSP) and servlet technology.
  2. From the COSMOS download page, click on the link of the stable build of your choice. Download the zip file under the "COSMOS SDK" section.
  3. Download the prerequisites for the SDK as specified in the Requirements section of the download page, including the Eclipse-hosted package for Dojo.
  4. Unzip Eclipse SDK to a directory along with WTP, EMF, XSD, GEF and the COSMOS SDK.
  5. Unzip the Dojo zip file to a separate directory.
  6. Download IBM Java SDK 5.0 or the Sun Java JDK 1.5* to use with the COSMOS toolkit. IBM Java 5.0 can be found at http://www.ibm.com/developerworks/java/jdk/ . Known issues with the Sun JRE:
    1. You will need to do the following to configure Eclipse to avoid crashing the workspace with the internal web browser:
      1. Select "General > Web Browser" from the preferences dialog box
      2. Select the "Use external Web browser" radio button
      3. Check the "Firefox" entry as the external web browser
    2. When using the SML-IF Validator with the Sun JRE, you need to ensure the Xerces libraries appear in the boot classpath *before* the JVM's core libraries; otherwise, an internal validation error appears. This can be resolved one of two ways:
      1. Add the entry -Xbootclasspath/p:<Path of org.apache.xerces_2.9.0.v200805270400.jar in your machine> into eclipse.ini in the Eclipse folder.
      2. Launch Eclipse from command line with: eclipse -vmargs -Xbootclasspath/p:<Path of xerces.jar>

Configuring the COSMOS SDK

Before creating a MDR, you must set some configuration options in the preferences page.

  1. Start up Eclipse.
  2. Open the preference page by selecting Windows>Preferences. In the preferences dialog, select "Web Services > Axis2 Preferences".
  3. Enter the Axis 2 directory in the "Axis2 runtime location" text box.
  4. Next, select "Server > Runtime Environments" in the preference dialog box. Here you will specify the web server runtime.
  5. Click the "Add..." button. Select a runtime environment and click "Next".
  6. Enter the location of the web server directory in the "<Web server name> installation directory:" text box.
  7. Next select "System Management > Web UI Viewer" in the preference dialog box. Specify the host and port on which you want to run the web UI viewer for testing MDRs; the defaults should suffice for most users.

Once you have configured the SDK, you can create a MDR by following the "Constructing a Data Manager" section in the COSMOS Developer's Guide.