Skip to main content

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.

Jump to: navigation, search

Difference between revisions of "Corona/Installation"

(Automatic Installation)
 
(11 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
=Prerequisites=
 
=Prerequisites=
The Corona demo assume you have [http://java.sun.com/javase/downloads/index.jsp Java 5] (JDK 1.5) already installed.  
+
* The Corona demo assume you have [http://java.sun.com/javase/downloads/index.jsp Java 5] (JDK 1.5) already installed.
 +
* In order to use automatic installation script you need to have [http://ant.apache.org/ Ant] >= 1.6.5 installed.
  
 
=Installation=
 
=Installation=
Line 6: Line 7:
  
 
==Automatic Installation==
 
==Automatic Installation==
In order to use automatic installation script you need to have [http://ant.apache.org/ Ant] >= 1.6.5 installed.
 
  
 
The procedure:
 
The procedure:
# Download the automatic installation script (it is packed with zip) - link soon :)
+
# Download the [http://www.eclipse.org/downloads/download.php?file=/technology/corona/downloads/drops/S-S20070124-200701240815/setup-S20070124.zip Corona 1.0.0M7 Setup] script (it is packed with zip)
 
# Extract the archive.
 
# Extract the archive.
 
# You can [[#Installation Customization|customize installation procedure]]. (you can omit this step)
 
# You can [[#Installation Customization|customize installation procedure]]. (you can omit this step)
Line 21: Line 21:
 
The script downloads about 210MB of data. Most of it (~200MB) is Eclipse distribution with Web Tools Project (WTP) 1.5.1. All downloaded packages are listed in [[#Download Corona Requirements|requirements]] below. If you have some of them already downloaded, you can use your local copy instead of downloading it. Do the following:
 
The script downloads about 210MB of data. Most of it (~200MB) is Eclipse distribution with Web Tools Project (WTP) 1.5.1. All downloaded packages are listed in [[#Download Corona Requirements|requirements]] below. If you have some of them already downloaded, you can use your local copy instead of downloading it. Do the following:
  
 +
====Approach 1====
 
# Create ''download'' directory in the directory you have the setup script extracted.
 
# Create ''download'' directory in the directory you have the setup script extracted.
 
# Copy all packages that you have already installed into this directory.
 
# Copy all packages that you have already installed into this directory.
 
# Run setup script as in step 3. in previous procedure.
 
# Run setup script as in step 3. in previous procedure.
  
===If you have different version of WTP downloaded===
+
====Approach 2====
We have tested the distribution with WTP 1.5.1. If you have a different WTP 1.5.x version, it should work also. But still the script expects WTP 1.5.1. To use your WTP version, do:
+
# Uncomment '''eclipse.wtp.local.location''' property located in ''setupCorona.<system>.properties'' file, and point it to a local copy of WTP all in one installation file.
* edit ''setupCorona.<OS>.properties'', where ''<OS>'' is ''windows'', ''linux'' or ''mac'' according to your operating system
+
 
* modify property ''eclipse.wtp.location'', to point HTTP directory for your version of WTP
+
* modify property ''eclipse.wtp.name'' with archive file name
+
* go to the first step of [[#Limit download size|previous section]]
+
  
You can also modify versions of other components in ''setupCorona.properties'', but '''do not''' modify version of ECF. It require 0.9.1. Other ECF versions has different API, so Corona won't work.
 
  
 
===Partial Installation===
 
===Partial Installation===
Line 58: Line 55:
 
===Download Corona Requirements===
 
===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.1-200609230508/wtp-all-in-one-sdk-R-1.5.1-200609230508-win32.zip Windows], [http://www.eclipse.org/downloads/download.php?file=/webtools/downloads/drops/R1.5/R-1.5.1-200609230508/wtp-all-in-one-sdk-R-1.5.1-200609230508-linux-gtk.tar.gz Linux] or [http://www.eclipse.org/downloads/download.php?file=/webtools/downloads/drops/R1.5/R-1.5.1-200609230508/wtp-all-in-one-sdk-R-1.5.1-200609230508-macosx-carbon.tar.gz Mac OS X] (contains a complete Eclipse 3.2.1 application with WTP, EMF, GEF and JEM frameworks)
 
* 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.1-200609230508/wtp-all-in-one-sdk-R-1.5.1-200609230508-win32.zip Windows], [http://www.eclipse.org/downloads/download.php?file=/webtools/downloads/drops/R1.5/R-1.5.1-200609230508/wtp-all-in-one-sdk-R-1.5.1-200609230508-linux-gtk.tar.gz Linux] or [http://www.eclipse.org/downloads/download.php?file=/webtools/downloads/drops/R1.5/R-1.5.1-200609230508/wtp-all-in-one-sdk-R-1.5.1-200609230508-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)
+
* [http://www.eclipse.org/downloads/download.php?file=/technology/corona/org.eclipse.ecf.sdk-0.9.5.S20061222.zip Eclipse Communication Framework SDK, v 0.9.5] (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]:
 
** [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]
 
** [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]
Line 64: Line 61:
 
** [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]
 
** [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 jars [http://people.apache.org/~jhawkins/Corona_M5/plugins.zip Axis2 jars for Corona] (referred later as ''plugins.zip'')
+
* Apache jars [http://people.apache.org/~jhawkins/Corona_M7/plugins.zip 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. You can also download them [[Corona Development Environment#Stub Projects|separately]] on your own. The later description assumes you are downloaded the single package.
 
*: 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. You can also download them [[Corona Development Environment#Stub Projects|separately]] on your own. The later description assumes you are downloaded the single package.
  
Line 114: Line 111:
  
 
==Client Configuration==
 
==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.
+
Client currently has only one configuration parameter - Corona server address. By default it is ''http://localhost:3000/''. You can modify it in your Eclipse workbench in ''Window -> Preferences ... -> Server settings''. Enter address of Corona server and press OK.
 +
* Note: If you want to use the Corona Client to connect to the Corona Server running at Eclipse.org use this server address ''http://corona.eclipse.org:3000''
  
 
==Server Configuration==
 
==Server Configuration==

Latest revision as of 05:27, 13 December 2010

Prerequisites

  • The Corona demo assume you have Java 5 (JDK 1.5) already installed.
  • In order to use automatic installation script you need to have Ant >= 1.6.5 installed.

Installation

There are two installations possible - automatic (recommended) and manual one. Use only one of the methods.

Automatic Installation

The procedure:

  1. Download the Corona 1.0.0M7 Setup script (it is packed with zip)
  2. Extract the archive.
  3. You can customize installation procedure. (you can omit this step)
  4. Run ant -f setupCorona.xml ; it may take some time due to size of downloads - over 200MB in total; see next section how to limit it.
    NOTE: if you have to use proxy run it as
    ant -Dproxyhost=<proxyHost> -Dproxyport=<proxyPort> -Dproxyuser=<proxyUser> -Dproxypassword=<proxyPassword> -f setupCorona.xml
    The proxyuser and proxypassword can be removed if your proxy doesn't require authorization.
  5. You can now start running Corona procedure; for this procedure use following replacements: <installServer> = ./install_server/eclipse and <installClient> = ./install_client/eclipse.

Limit download size

The script downloads about 210MB of data. Most of it (~200MB) is Eclipse distribution with Web Tools Project (WTP) 1.5.1. All downloaded packages are listed in requirements below. If you have some of them already downloaded, you can use your local copy instead of downloading it. Do the following:

Approach 1

  1. Create download directory in the directory you have the setup script extracted.
  2. Copy all packages that you have already installed into this directory.
  3. Run setup script as in step 3. in previous procedure.

Approach 2

  1. Uncomment eclipse.wtp.local.location property located in setupCorona.<system>.properties file, and point it to a local copy of WTP all in one installation file.


Partial Installation

  • To install client only, run:
    ant -f setupCorona.xml install.client
  • To install server only, run:
    ant -f setupCorona.xml install.server

You still need to provide proxy settings if you need it, as it was described in step 3. of default automatic installation.

Installation Customization

You can customize installation procedure:

  • Customize download directory
    You can change installation download directory by modifying download.dest property located setupCorona.properties file. By default it's set to ./download directory.
  • Customize client installation directory
    You can change client installation location by modifying client.installation.location property located setupCorona.properties file. By default it's set to ./install_client directory.
  • Customize server installation directory
    You can change server installation location by modifying server.installation.location property located setupCorona.properties file. By default it's set to ./install_server directory.
  • Customize server address
    You should change your server address located in setopCorona.properties file in server.address property. By default it's set to localhost value.

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

Download Corona

The latest Corona distribution can be downloaded from download Corona. The distribution consists of two parts:

  1. Corona Server - enables collaboration between distributed components, handles event routing and web service calls,
  2. Corona Client - adds collaboration capabilities to Eclipse IDE tool.

Some of the plugins in both server and client are just place holders for Apache libraries. They should filled with jars from plugins.zip as described in the next section.

Installation of Platform

You need to install two Eclipse installations, 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>:

  1. Unzip Web Tools Eclipse application to <install>
  2. Unzip ECF to <install>
  3. Copy add-on Equinox bundles to <install>/plugins
  4. Unzip Apache libraries file (plugins.zip) to <install> folder

Installation of Corona Server

In order to install Corona server use a prepared <install> from previous step, which is now called <installServer>

  • Unzip org.eclipse.corona.server-{version}.zip to <installServer>
  • Replace ECF server configuration <installServer>/plugins/org.eclipse.ecf.server_0.9.1/conf/server.xml with following content:
<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 prepared <install> from previous step, which is now called <installClient>. 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:

  1. Run Corona server:
    1. cd to <installServer>
    2. execute ./eclipse -console -clean
      on Windows you should remove "./" part
  2. Run Corona client:
    1. cd to <installClient>
    2. execute ./eclipse -console -clean
      on Windows you should remove "./" part

Stopping Corona Server

To stop Corona server you must enter close command in server console. In windows the console is separate DOS window when you start server. On Linux it is in the same console you have started the server.

Basic Configuration

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:3000/. You can modify it in your Eclipse workbench in Window -> Preferences ... -> Server settings. Enter address of Corona server and press OK.

  • Note: If you want to use the Corona Client to connect to the Corona Server running at Eclipse.org use this server address http://corona.eclipse.org:3000

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

Back to the top