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:

• SVN for Corona Collaboration

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.