Cilia/Getting Started Tutorial/Installation
- Java SDK version 1.5 or later. If necessary, download and install the Java SE Development Kit (JDK) for your platform.
- The iPOJO component model.
- Apache Maven2 is also necessary to build your projects. If you don't already have it, install Apache Maven2, and follow the Maven in 5 minutes tutorial.
Download and Install Cilia Platform
- Get the latest stable distribution (set of Cilia bundles) from LIG Forge.
- Install the Cilia bundles into the OSGi distribution. For example, in Felix distribution you only have to put them into the bundle directory.
- Cilia is formed by the next bundles:
|cilia-core-1.1.0.jar||1.1.0||Cilia core bundle.|
|cilia-ipojo-runtime-1.1.0.jar||1.1.0||The Cilia runtime.|
|cilia-ipojo-compendium-1.1.0.jar||1.1.0||A library with basic schedulers and dispatchers.|
|cilia-deployer-1.0.0.jar||1.1.0||A extension to file install to ease Cilia applications deployment.*|
|gui-binding-1.0.0.jar||1.1.0||A simple GUI Adapter.|
|ea-binding-1.0.0.jar||1.1.0||A binding implementation using Event-Admin framework.|
You can also get the latest development release of Cilia and build it by yourself. Source code is available here.
Preconfigured Cilia Platform
A preconfigured Cilia distribution is also available, it is based in the Felix OSGi distribution. It includes the necessary bundles to run the Cilia framework. Simply download and unzip the Cilia Standard Distribution.
Distribution directory structure
The Cilia distribution is composed of the following directories and file:
bin: binary file that embed Apache Felix OSGi framework.
bundle: contains all the bundles of the distribution. They are automatically loaded and executed when lunching the platform.
load: this directory is used for the hot deployment of bundles and mediation chains (file with
conf: contains configuration file (config.properties). This is where you can configure the execution platform before running it.
Running Preconfigured Cilia distribution
Launch the platform using either
cilia.sh (within Linux) or
cilia.bat (within Windows). You can also launch it using the following command line
java -jar bin/cilia-distributions-launcher.1.0.0-SNAPSHOT.jar
When the platform is ready, type the following command
ps to show the installed bundles.