Jump to: navigation, search

Difference between revisions of "COSMOS SDK Installation"

(Download COSMOS Demo and Prerequisites)
(Configuring the COSMOS SDK)
 
(17 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 toolkitIBM 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:
=== Installing COSMOS Web applications and Web Services ===
+
### Select "General > Web Browser" from the preferences dialog box
COSMOS comes with a program that helps install and configure the web applications and web services required for the demonstrationThe install program is located at <cosmos-demo>\bin. Run configDemo.bat or configDemo.sh to start the install program on Windows and Linux respectivelyThe install program assumes your <cosmos-demo> directory and the tomcat installation are on the same host.
+
### Select the "Use external Web browser" radio button
 
+
### Check the "Firefox" entry as the external web browser
The configDemo program accepts 5 parameters.  They are:
+
## 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 appearsThis can be resolved one of two ways:
# tomcatDir: Apache Tomcat install directory <tomcat_install_dir>
+
### 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.
# cosmosDir: COSMOS Demo install directory <cosmos-demo>
+
### Launch Eclipse from command line with: <code>eclipse -vmargs -Xbootclasspath/p:<Path of xerces.jar></code>
# birt: path to BIRT Runtime zip file (download from step 4 above)
+
# dojo: path to dojo zip file (download from step 5 above)
+
# axis2war: (optional) Path to the axis2.war file (downloaded from step 3 above)
+
 
+
You will see something like the following in a successful execution of the config program.   
+
<pre>
+
Unzipping c:\Program Files\apache-tomcat-5.5.26\webapps_backup4\axis2.war to c:\
+
Program Files\apache-tomcat-5.5.26\webapps\axis2...
+
Installed axis2 on Apache Tomcat server.
+
Installed web application: COSMOSReportViewer
+
Installed web application: COSMOSUI
+
Unzipping c:\dev\birt-runtime-2.3.zip to c:\Program Files\apache-tomcat-5.5.26
+
\webapps/COSMOSReportViewer...
+
Unzipped BIRT to COSMOSReportViewer
+
Copied BIRT web viewer example to COSMOSReportViewer
+
Unzipping c:\dev\dojo-release-1.1.0.zip to c:\Program Files\apache-tomcat-5.5.26
+
\webapps/COSMOSUI...
+
Unzipped dojo to COSMOSUI.
+
Installed web service: AperiMdr
+
Installed web service: Broker
+
Installed web service: ExampleMdr
+
Installed web service: LoggingDataManager
+
Installed web service: ServiceFinder
+
Installed web service: SMLMDR
+
Installed web service: StatDataManager
+
Installed web service: TestFederatingCMDB
+
Copied axis jar files to COSMOSUI.
+
Copied axis jar files to COSMOSReportViewer.
+
Copied axis jar files to cosmos client.
+
Updated axis2.xml.
+
Updated services.xml for SML MDR.
+
Updated services.xml for statistical MDR.
+
Installed broker database to c:\Program Files\apache-tomcat-5.5.26\webapps\axis2
+
\WEB-INF\database/brokerdb.xml
+
</pre>
+
  
 +
=== Configuring the COSMOS SDK ===
 +
Before creating a MDR, you must set some configuration options in the preferences page. 
 +
# Start up Eclipse.
 +
# 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.
 +
# Next, select "Server > Runtime Environments" in the preference dialog box.  Here you will specify the web server runtime.
 +
# Click the "Add..." button.  Select a runtime environment and click "Next".
 +
# 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 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.
 
   
 
   
 
[[Category: COSMOS]]
 
[[Category: COSMOS]]

Latest revision as of 14: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.