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"
< Corona
| Line 1: | Line 1: | ||
| + | =Automatic Installation= | ||
| + | TBD | ||
| + | |||
=Manual Installation= | =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. | 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. | ||
| Line 54: | Line 57: | ||
##execute eclipse -console -clean | ##execute eclipse -console -clean | ||
| − | = | + | =Configuration Basics= |
| − | + | Corona should be ready with default settings just out of the box if you run everything locally. But you may want to change some parameters. Here are some described. | |
| − | + | ==Client Configuration== | |
| − | + | Client currently has only one configuration parameter - Corona server address. By default it is ''http://localhost:1080/''. You can modify it in your Eclipse workbench in ''Window -> Preferences ... -> Server settings''. Enter address of Corona server and press OK. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | =Configuration | + | |
| − | + | ||
| − | + | ||
| − | + | ==Server Configuration== | |
| − | * | + | * Server needs a location where project containers are located. By default ''<installServer>''/plugins/org.eclipse.corona.container.config_''{version}''/examples is taken. If you want to keep your containers somewhere else, set system variable ''CORONA_CONFIG_HOME'' with a directory of the same structure as the one in ''<installServer>''/plugins/org.eclipse.corona.container.config_''{version}''/examples. |
| − | + | * By default most of the default repositories points to ''localhost'' or ''127.0.0.1''. If you want to use Corona not only at a single host, you must modify the addresses with address of your computer. NOTE: the server must be turned off when you modify containers, otherwise your changes may be overwritten. | |
| − | + | * If you want to add your resources, repositories or even project containers, you currently must base on existing project containers. Copy one and modify to meet your needs. If you do this, you MUST modify ''container-uri'' parameter, because it is used as container identifier. | |
| − | = | + | =See also= |
| − | + | * Next step - demo | |
| − | + | * [[Corona User Guide|User Guide]] | |
Revision as of 12:20, 14 November 2006
Contents
Automatic Installation
TBD
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
Configuration Basics
Corona should be ready with default settings just out of the box if you run everything locally. But you may want to change some parameters. Here are some described.
Client Configuration
Client currently has only one configuration parameter - Corona server address. By default it is http://localhost:1080/. You can modify it in your Eclipse workbench in Window -> Preferences ... -> Server settings. Enter address of Corona server and press OK.
Server Configuration
- Server needs a location where project containers are located. By default <installServer>/plugins/org.eclipse.corona.container.config_{version}/examples is taken. If you want to keep your containers somewhere else, set system variable CORONA_CONFIG_HOME with a directory of the same structure as the one in <installServer>/plugins/org.eclipse.corona.container.config_{version}/examples.
- By default most of the default repositories points to localhost or 127.0.0.1. If you want to use Corona not only at a single host, you must modify the addresses with address of your computer. NOTE: the server must be turned off when you modify containers, otherwise your changes may be overwritten.
- If you want to add your resources, repositories or even project containers, you currently must base on existing project containers. Copy one and modify to meet your needs. If you do this, you MUST modify container-uri parameter, because it is used as container identifier.
See also
- Next step - demo
- User Guide