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.
Corona/Platform
Contents
Corona Platform
The Corona platform is the Eclipse server-side runtime platform. It provides a non-UI environment to host OSGi bundles and Eclipse plugins. The Corona platform consists several types of components: Corona (core), Equinox/OSGi, Eclipse core runtime, and common 3rd party libraries.
Corona (core)
Corona's core platform plugins provide the functionality to needed to host an Eclipse server-side environment. The items provide by Corona's core are:
- Application
- An OSGi application used to start/stop the server-side enviornment
- Managability
- Management interfaces to monitor and control the environment (see COSMOS)
- Diagnostics
- A diagnostics framework used to collect data from the platform and its components to aid in problem analysis.
Equinox/OSGi
|
Eclipse Core Runtime
|
3rd Party Libraries
|
Applications
Beginning with Eclipse v3.3, a new application model was introduced.
- The platform runtime provides an application container for controlling and executing applications. The runtime application container implements the Application Admin service specification included in the OSGi R4 specification. The application container is responsible for discovering all available applications and registering an ApplicationDescriptor OSGi service for each application that is available. An ApplicationDescriptor service can be used to launch an application. When an application is launched an ApplicationHandle OSGi service is registered to represent the instance of the running application. An ApplicationHandle service can be used to shutdown an application. See the org.osgi.service.application package and the OSGi R4.1 specification for more information.
Corona's server-side environment supports the execution of multiple applications. The primary application, Corona, runs on the main thread. Additional applications are considered secondary and must be configured to run on any thread. To create an application to run within the Corona server-side environment, create an extension to org.eclipse.core.runtime.application.
Update Manager
Corona follows the Eclipse feature deployment model via Update Manager. It is possible to invoke the Eclipse Update Manager to install a feature into Corona's server-side environment. The Update Manager is started as a stand-alone OSGi application.
%jvm% -jar %launcher% -console -application org.eclipse.update.core.standaloneUpdate -command install -from %updateSite% -featureId %featureId% -version %featureVersion%
Configuration
Corona needs to be configured to start secondary applications. This is accomplished by defining the osgi.applications property. This can be set either as a jvm argument (i.e. -Dosgi.applications=...), or in config.ini. The osgi.applications can be defined to start multiple applications.
Syntax
osgi.applications=<appId>[,arg1][,arg2][,arg3];<appId>[,arg1][,arg2][,arg3]
- appId
- The id of the osgi application
- arg1
- The application's 1st argument (optional)
- arg2
- The application's 2nd argument (optional)
- arg3
- The application's 3rd argument (optional)