Jump to: navigation, search

Corona/GettingStarted/Platform

Corona's server-side environment is provide as an all-in-one platform distribution. Optional server applications are provided as features that can be installed into the server via Update Manager.

The Corona server-side platform requires Java 1.5 and has been verified on the following architectures:

  • Win32 (WinXP)
  • Linux (Redhat)
  • Mac OS (Leopord)

Step 1: Install the Corona Platform

  1. Download the Corona Server Platform
  2. Unzip the Platform to a folder on your machine
    1. This folder will be referred to as corona_home
  3. Change directory to the coron_home folder
  4. (linux/mac only) Change the file attributes for the Corona shell command
    1. chmod 755 corona.sh

Step 2: Configure Server Environment

  1. Edit 'config.ini to change any of the following configuration items
osgi.applications
secondary server applications to automatically start
osgi.instance.area.default
location of the platform's workspace
org.osgi.service.http.port
tcp/ip port used by the http service

Step 3: Start the Corona Server-side Platform

  1. Execute the corona shell script to run the Corona Server-side Platform
    1. (linux) ./corona.sh run
    2. (winew) corona run

Installing Additional Server Components

The Corona server-side platform uses OSGi Applications to manage the runtime lifecyle of a Server Components. These components are defined using the org.eclipse.core.runtime.application extension point.

For an example, please see the Corona Database Server Application:

Step 1: Create Server Component Application

  1. Create a plug-in to provide the Server Component Application
    1. Ensure that this plug-in does not contribute to the UI
  2. Create an extension to the org.eclipse.core.runtime.application extension point

Step 2: Create Server Component Feature

  1. Create a feature to package and distribute your Server Component

Step 3: Deploy Server Component to Corona Server-side Platform

  1. Install (copy or update manager) the Component Server to Corona's server-side platform
  2. Modify Corona's configuration
    1. Edit configuration/config.ini
    2. Append the name of your application to the osgi.applications property

Step 4: Start Corona


The Corona server-side platform should be running within an OSGi command console. You should be able to interact with Corona's web service via [1]. In addition, any additional component feature applications that were installed should also be running.