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.
Difference between revisions of "COSMOS SDK Installation"
(→Configuring the COSMOS SDK) |
(→Configuring the COSMOS SDK) |
||
| (8 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 == | ||
| − | === Download COSMOS | + | === Download COSMOS Build and Prerequisites === |
| − | This section provides instructions for installing and running the | + | 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 | + | # 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.