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 "Corona/Installation"
(→Installation Steps) |
|||
Line 1: | Line 1: | ||
− | = | + | =Manual Installation= |
− | + | Corona consists of two parts - server and client. To try Corona you will usually need both parts installed. But if you already have server running somewhere then you don't need to install server. Both server and client can be installed at the same computer, but you will need two separate Eclipse installations for this. The steps are described below. | |
− | * WebTools Platform all-in-one SDK distribution | + | |
− | + | ==Download Corona Requirements== | |
+ | * WebTools Platform v. 1.5 all-in-one SDK distribution for [http://www.eclipse.org/downloads/download.php?file=/webtools/downloads/drops/R1.5/R-1.5.2-200610261841/wtp-all-in-one-sdk-R-1.5.2-200610261841-win32.zip Windows], [http://www.eclipse.org/downloads/download.php?file=/webtools/downloads/drops/R1.5/R-1.5.2-200610261841/wtp-all-in-one-sdk-R-1.5.2-200610261841-linux-gtk.tar.gz Linux] or [http://www.eclipse.org/downloads/download.php?file=/webtools/downloads/drops/R1.5/R-1.5.2-200610261841/wtp-all-in-one-sdk-R-1.5.2-200610261841-macosx-carbon.tar.gz Mac OS X] (contains a complete Eclipse 3.2.1 application with WTP, EMF, GEF and JEM frameworks) | ||
+ | * [http://www.eclipse.org/downloads/download.php?file=/technology/ecf/org.eclipse.ecf.sdk-0.9.1.S20060906.zip Eclipse Communication Framework SDK, v 0.9.1] (full SDK distribution required) | ||
* Add-on equionox bundles [http://download.eclipse.org/eclipse/equinox/ download Equinox add-on bundles]: | * Add-on equionox bundles [http://download.eclipse.org/eclipse/equinox/ download Equinox add-on bundles]: | ||
− | ** org.eclipse.equinox.log | + | ** [http://download.eclipse.org/eclipse/equinox/drops/R-3.2.1-200609210945/download.php?dropFile=org.eclipse.equinox.log_1.0.1.R32x_v20060717.jar org.eclipse.equinox.log] |
− | ** org.eclipse.equinox.event | + | ** [http://download.eclipse.org/eclipse/equinox/drops/R-3.2.1-200609210945/download.php?dropFile=org.eclipse.equinox.event_1.0.0.v20060601a.jar org.eclipse.equinox.event] |
− | ** org.eclipse.equinox.http | + | ** [http://download.eclipse.org/eclipse/equinox/drops/R-3.2.1-200609210945/download.php?dropFile=org.eclipse.equinox.http_1.0.1.R32x_v20060717.jar org.eclipse.equinox.http] |
− | ** org.eclipse.equinox.servlet.api ( normally included in Web Tools Platform All-In-One distribution) | + | <!--** org.eclipse.equinox.servlet.api ( normally included in Web Tools Platform All-In-One distribution) --> |
− | * Apache Axis2 jars [http://people.apache.org/~jhawkins/Corona_M5 Axis2 jars for Corona] | + | * Apache Axis2 jars [http://people.apache.org/~jhawkins/Corona_M5 Axis2 jars for Corona] (referred later as ''plugins.zip'') |
*: A number of libraries used by Corona are not yet supplied with the binary distribution because of on-going IP approval process by Eclipse Committee. | *: A number of libraries used by Corona are not yet supplied with the binary distribution because of on-going IP approval process by Eclipse Committee. | ||
− | |||
− | |||
− | |||
==Download Corona== | ==Download Corona== | ||
Line 18: | Line 17: | ||
# Corona Server - enables collaboration between distributed components, handles event routing and web service calls, | # Corona Server - enables collaboration between distributed components, handles event routing and web service calls, | ||
# Corona Client - adds collaboration capabilities to Eclipse IDE tool. | # Corona Client - adds collaboration capabilities to Eclipse IDE tool. | ||
− | |||
− | |||
− | |||
Download the 3<sup>rd</sup> party libraries in a [http://people.apache.org/~jhawkins/Corona_M5/plugins.zip single package], or download them [[Corona Development Environment#Stub Projects|separately]] on your own. The later description assumes you are downloaded the single package, referred as ''plugins.zip''. | Download the 3<sup>rd</sup> party libraries in a [http://people.apache.org/~jhawkins/Corona_M5/plugins.zip single package], or download them [[Corona Development Environment#Stub Projects|separately]] on your own. The later description assumes you are downloaded the single package, referred as ''plugins.zip''. | ||
− | == | + | ==Installation of Platform== |
− | You need to install two Eclipse instances, one for Corona Server and one for Corona Client. Let the installation directory be called ''<install>'' | + | You need to install two Eclipse instances, one for Corona Server and one for Corona Client. Let the installation directory be called ''<install>'', but you need to take the procedure twice, once with ''<installClient>'' second with ''<installServer>'': |
#Unzip Web Tools Eclipse application to ''<install>'' | #Unzip Web Tools Eclipse application to ''<install>'' | ||
#Unzip ECF to ''<install>'' | #Unzip ECF to ''<install>'' | ||
#Copy add-on Equinox bundles to ''<install>''/plugins | #Copy add-on Equinox bundles to ''<install>''/plugins | ||
+ | #Unzip Apache2 libraries file (plugins.zip) to ''<install>'' folder | ||
− | == | + | ==Installation of Corona Server== |
− | + | ||
In order to install Corona server use a preprepared ''<install>'' from previous step, which is now called ''<installServer>'' | In order to install Corona server use a preprepared ''<install>'' from previous step, which is now called ''<installServer>'' | ||
*Unzip org.eclipse.corona.server-''{version}''.zip to ''<installServer>'' | *Unzip org.eclipse.corona.server-''{version}''.zip to ''<installServer>'' | ||
− | * | + | *Edit ECF server configuration ''<installServer>''/plugins/org.eclipse.ecf.server_0.9.1/conf/server.xml that it takes fallowing form: |
+ | <server> | ||
+ | <connector protocol="ecftcp" hostname="localhost" port="3282" timeout="30000"> | ||
+ | <group name="server"/> | ||
+ | <group name="corona"/> | ||
+ | </connector> | ||
+ | </server> | ||
− | == | + | ==Installation of Corona Client== |
In order to install Corona client use a preprepared ''<install>'' from previous step, which is now called ''<installServer>''. It must be a different location than ''<installServer>''. | In order to install Corona client use a preprepared ''<install>'' from previous step, which is now called ''<installServer>''. It must be a different location than ''<installServer>''. | ||
*Unzip org.eclipse.corona.client-''{version}''.zip to ''<installClient>'' | *Unzip org.eclipse.corona.client-''{version}''.zip to ''<installClient>'' | ||
− | |||
=Running Corona= | =Running Corona= |
Revision as of 09:04, 14 November 2006
Contents
Manual Installation
Corona consists of two parts - server and client. To try Corona you will usually need both parts installed. But if you already have server running somewhere then you don't need to install server. Both server and client can be installed at the same computer, but you will need two separate Eclipse installations for this. The steps are described below.
Download Corona Requirements
- WebTools Platform v. 1.5 all-in-one SDK distribution for Windows, Linux or Mac OS X (contains a complete Eclipse 3.2.1 application with WTP, EMF, GEF and JEM frameworks)
- Eclipse Communication Framework SDK, v 0.9.1 (full SDK distribution required)
- Add-on equionox bundles download Equinox add-on bundles:
- Apache Axis2 jars Axis2 jars for Corona (referred later as plugins.zip)
- A number of libraries used by Corona are not yet supplied with the binary distribution because of on-going IP approval process by Eclipse Committee.
Download Corona
The latest Corona distribution can be downloaded from download Corona. The distribution consists of two parts:
- Corona Server - enables collaboration between distributed components, handles event routing and web service calls,
- Corona Client - adds collaboration capabilities to Eclipse IDE tool.
Download the 3rd party libraries in a single package, or download them separately on your own. The later description assumes you are downloaded the single package, referred as plugins.zip.
Installation of Platform
You need to install two Eclipse instances, one for Corona Server and one for Corona Client. Let the installation directory be called <install>, but you need to take the procedure twice, once with <installClient> second with <installServer>:
- Unzip Web Tools Eclipse application to <install>
- Unzip ECF to <install>
- Copy add-on Equinox bundles to <install>/plugins
- Unzip Apache2 libraries file (plugins.zip) to <install> folder
Installation of Corona Server
In order to install Corona server use a preprepared <install> from previous step, which is now called <installServer>
- Unzip org.eclipse.corona.server-{version}.zip to <installServer>
- Edit ECF server configuration <installServer>/plugins/org.eclipse.ecf.server_0.9.1/conf/server.xml that it takes fallowing form:
<server> <connector protocol="ecftcp" hostname="localhost" port="3282" timeout="30000"> <group name="server"/> <group name="corona"/> </connector> </server>
Installation of Corona Client
In order to install Corona client use a preprepared <install> from previous step, which is now called <installServer>. It must be a different location than <installServer>.
- Unzip org.eclipse.corona.client-{version}.zip to <installClient>
Running Corona
In order to run a full Corona client-server collaboration with default collaboration context, you need to:
- Set CORONA_CONFIG_HOME system variable to the absolute path, in which initial project container definitions are located:
- <installServer>/plugins/org.eclipse.corona.container.config_{version}/examples
- The plugin with container definitions is supplied with both client and server distribution.
- Run Corona server:
- cd to <installServer>
- execute eclipse -console
- Run Corona client:
- cd to <installClient>
- execute eclipse -console -clean
Multi-User Collaboration
In multi-user collaboration, it is assumed that a Corona server is up and running on a host, (let the server that host Corona is called serverHost).
To enable multi-user collaboration:
- Install Corona clients on machines expected for collaboration
- Select Corona server
- Choose Window -> Preferences -> Corona -> Server settings
- Enter Corona Server URL
- Configure ECF settings as described in
Configuration Basics
In order to run Corona server it is required to set container configuration directory:
- the directory pointed by CORONA_CONFIG_HOME system variable. It contains project containers, project containers's properties and team member repositories. An exemplary configuration is located in plugin org.eclipse.corona.container.config/data
In order to run Corona client it is required to set two parameters:
- Corona server settings, which enables to communicate with the server either locally or remotely, default settings are localhost:1080
- CORONA_CONFIG_HOME, which enables to read team member repository from an XML file, the configuration will be changed in future versions concerning a general mechanism of authorisation and user verification.
The settings can be changed in Eclipse IDE by calling Window->Preferencec->Corona
Demo Configuration
Project container definition Team member repository