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 "Corona/Installation"
(→Requirements) |
(→Installation Steps) |
||
| Line 12: | Line 12: | ||
=Installation Steps= | =Installation Steps= | ||
| + | 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== | ==Download Corona== | ||
| Line 18: | Line 19: | ||
# Corona Client - adds collaboration capabilities to Eclipse IDE tool. | # Corona Client - adds collaboration capabilities to Eclipse IDE tool. | ||
| − | + | ==Download 3<sup>rd</sup> Party Libraries== | |
| − | ==Download | + | Corona requires some 3<sup>rd</sup> party libraries, which weren't approved yet. They are on [http://www.apache.org/licenses/LICENSE-2.0 Apache 2.0 license]. |
| − | + | 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''. | |
| − | + | ||
==Install Eclipse platform for Corona== | ==Install Eclipse platform for Corona== | ||
| Line 31: | Line 31: | ||
==Install Corona== | ==Install Corona== | ||
| − | In order to install Corona server | + | === 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>'' | *Unzip org.eclipse.corona.server-''{version}''.zip to ''<installServer>'' | ||
| − | In order to install Corona client | + | *Unzip 3rd party libraries file (plugins.zip) to ''<install>'' folder |
| + | |||
| + | === 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>'' | *Unzip org.eclipse.corona.client-''{version}''.zip to ''<installClient>'' | ||
| − | |||
*Unzip 3rd party libraries file (plugins.zip) to ''<install>'' folder | *Unzip 3rd party libraries file (plugins.zip) to ''<install>'' folder | ||
| − | + | =Running Corona= | |
In order to run a full Corona client-server collaboration with default collaboration context, you need to: | 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: | # Set CORONA_CONFIG_HOME system variable to the absolute path, in which initial project container definitions are located: | ||
Revision as of 06:54, 14 November 2006
Contents
Requirements
In order to install and run Corona it is necessary to have the following Eclipse components:
- WebTools Platform all-in-one SDK distribution of Eclipse, v 1.5 (contains a complete Eclipse application wiht WTP, EMF, GEF and JEM frameworks) download WebTools Platform
- Eclipse Communication Framework SDK, v 0.9 (full SDK distribution required) download ECF
- Add-on equionox bundles download Equinox add-on bundles:
- org.eclipse.equinox.log
- org.eclipse.equinox.event
- org.eclipse.equinox.http
- org.eclipse.equinox.servlet.api ( normally included in Web Tools Platform All-In-One distribution)
- Apache Axis2 jars Axis2 jars for Corona
- 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.
Installation Steps
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
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 3rd Party Libraries
Corona requires some 3rd party libraries, which weren't approved yet. They are on Apache 2.0 license.
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.
Install Eclipse platform for Corona
You need to install two Eclipse instances, one for Corona Server and one for Corona Client. Let the installation directory be called <install> (it is either <installClient> or <installServer>):
- Unzip Web Tools Eclipse application to <install>
- Unzip ECF to <install>
- Copy add-on Equinox bundles to <install>/plugins
Install Corona
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>
- Unzip 3rd party libraries file (plugins.zip) to <install> folder
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>
- Unzip 3rd party libraries file (plugins.zip) to <install> folder
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