Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "COSMOS SDK Installation"
(→Download COSMOS Demo and Prerequisites) |
(→Configuring the COSMOS SDK) |
||
(7 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | This page provides instructions on how to install and run the COSMOS SDK | + | 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 | + | The COSMOS SDK provides the Eclipse-based tooling to develop and test a Management Data Repository (MDR). |
== Installation == | == Installation == | ||
Line 8: | Line 8: | ||
=== Download COSMOS Build and Prerequisites === | === Download COSMOS Build and Prerequisites === | ||
This section provides instructions for installing and running the SDK provided by COSMOS. | This section provides instructions for installing and running the SDK provided by COSMOS. | ||
− | # Install | + | # 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 stable build of your choice. 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 in the Requirements section of the download page | + | # 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, | + | # Unzip Eclipse SDK to a directory along with WTP, EMF, XSD, GEF and the COSMOS SDK. |
− | # Unzip | + | # Unzip the Dojo zip file 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: | |
− | # 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/ . | + | ## 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 "General > Web Browser" from the preferences dialog box |
− | ## Select the "Use external Web browser" radio button | + | ### Select the "Use external Web browser" radio button |
− | ## Check the "Firefox" entry as the external web browser | + | ### 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 === | ||
Line 24: | Line 27: | ||
# Open the preference page by selecting Windows>Preferences. In the preferences 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 | + | # Next, select "Server > Runtime Environments" in the preference dialog box. Here you will specify the web server runtime. |
− | # Click the "Add..." button. Select | + | # Click the "Add..." button. Select a runtime environment and click "Next". |
− | # Enter the location of the | + | # 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 | + | # 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 | + | 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.
Contents
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.
- Install your favorite web server supporting Java Server Pages (JSP) and servlet technology.
- 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.
- 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 the Dojo zip file 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:
eclipse -vmargs -Xbootclasspath/p:<Path of xerces.jar>
- You will need to do the following to configure Eclipse to avoid crashing the workspace with the internal web browser:
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.