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 SDK Installation"

(Download COSMOS Demo and Prerequisites)
(Download COSMOS Demo and Prerequisites)
Line 9: Line 9:
 
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 demo program that is provided in the COSMOS i12 build.   
 
# 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 [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.  
# Download Axis2 war file for Tomcat from this page: http://ws.apache.org/axis2/download/1_3/download.cgi.  Download the zip file for "WAR (Web Archive) Distribution". 
+
# 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.   
# Download [http://download.dojotoolkit.org/release-1.1.0/dojo-release-1.1.0.zip DOJO 1.1.0].
+
# Download the prerequisites for the SDK as specified on the download page (i.e.. Dojo, tomcat, axis2, wtp, eclipse, emf, xsd, and gef)
# 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 Demo" section.   
+
# Unzip Eclipse SDK to a directory along with wtp, emf, xsd, gef and the COSMOS SDK.
# Unzip the demo zip file to a directory.  You will see a directory called "cosmos-demo". This directory will be referred to as <cosmos-demo> in this document.
+
# Unzip Tomcat to a separate directory.
# If you are using the Aperi MDR, you will need to install and setup Aperi as follows:
+
# Unzip Dojo to a separate directory.
## Download the Aperi Storage Resource Manager version 0.4.1 from [http://www.eclipse.org/aperi/ Aperi downloads]
+
## Follow the instructions at [http://www.eclipse.org/aperi/documentation/r4/install.php Aperi install instructions]. You MUST choose Derby as your database.
+
## After successfully installing Aperi, you may wish to run some Aperi probes to populate your database with storage information (refer to the "Aperi post-installation instructions" section of the install instructions).
+
## Alternatively you can use the sample Aperi database located at <cosmos-demo>\database\Aperi. To install the sample Aperi database, replace your <aperi-installation-folder>\db folder with the contents of the <cosmos-demo>\database\Aperi folder.
+
## Note that the Aperi MDR is preconfigured to access the default Aperi derby database (at localhost and port 1527). If you have chosen another location, you will need to modify the <tomcat>\webapps\axis2\WEB-INF\services\AperiMdr\META-INF\services.xml file to change the DERBY_HOST and DERBY_PORT parameters.
+
## Before using the Aperi MDR, start the Aperi derby database. For example: type "start derby" from the <Aperi install>\db directory.
+
  
 
=== Installing COSMOS Web applications and Web Services ===
 
=== Installing COSMOS Web applications and Web Services ===

Revision as of 13:50, 29 August 2008

This page provides instructions on how to install and run the COSMOS demo for i12.

Objective of the SDK

The COSMOS SDK provides the eclipse-based tooling to construct a Management Data Repository (MDR).

Installation

Download COSMOS Demo and Prerequisites

This section provides instructions for installing and running the demo program that is provided in the COSMOS i12 build.

  1. Install Tomcat 5.5.26. The directory where the Tomcat server is installed will be referred to as the <tomcat_install_dir> in this document.
  2. From the COSMOS download page, click on the link of the latest candidate build for i13. Download the zip file under the "COSMOS SDK" section.
  3. Download the prerequisites for the SDK as specified on the download page (i.e.. Dojo, tomcat, axis2, wtp, eclipse, emf, xsd, and gef)
  4. Unzip Eclipse SDK to a directory along with wtp, emf, xsd, gef and the COSMOS SDK.
  5. Unzip Tomcat to a separate directory.
  6. Unzip Dojo to a separate directory.

Installing COSMOS Web applications and Web Services

COSMOS comes with a program that helps install and configure the web applications and web services required for the demonstration. The install program is located at <cosmos-demo>\bin. Run configDemo.bat or configDemo.sh to start the install program on Windows and Linux respectively. The install program assumes your <cosmos-demo> directory and the tomcat installation are on the same host.

The configDemo program accepts 5 parameters. They are:

  1. tomcatDir: Apache Tomcat install directory <tomcat_install_dir>
  2. cosmosDir: COSMOS Demo install directory <cosmos-demo>
  3. birt: path to BIRT Runtime zip file (download from step 4 above)
  4. dojo: path to dojo zip file (download from step 5 above)
  5. 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.

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

Back to the top