Deploying Ceylon modules in OSGi containers

In order to be able to resolve and start Ceylon module archives (.car files) inside an OSGi container, you will first need to install, in the OSGi container, all the bundles of the Ceylon distribution and SDK.

Retrieving the Ceylon Distribution and SDK for OSGi

In order to be able to resolve and start Ceylon module archives (.car files) inside an OSGi container, you will first need to install, in the OSGi container, all the bundles of the Ceylon distribution and SDK.

These bundles are available in a dedicated place on the Ceylon language web site:

• as OBR bundle repositories:

  • Old-style OBR syntax (still used by Apache Felix):

    https://downloads.ceylon-lang.org/osgi/distribution/1.3.3/repository.xml

    https://downloads.ceylon-lang.org/osgi/sdk/1.3.3/repository.xml

  • New standard R5 OBR syntax:

    https://downloads.ceylon-lang.org/osgi/distribution/1.3.3/index.xml

    https://downloads.ceylon-lang.org/osgi/sdk/1.3.3/index.xml

• as P2 repositories for Eclipse development :

  https://downloads.ceylon-lang.org/osgi/distribution/1.3.3/

  https://downloads.ceylon-lang.org/osgi/sdk/1.3.3/

• as Zip archives for direct deployment inside containers :

  https://downloads.ceylon-lang.org/osgi/distribution/1.3.3/ceylon.distribution.osgi.bundles-1.3.3.zip

  https://downloads.ceylon-lang.org/osgi/sdk/1.3.3/ceylon.sdk.osgi.bundles-1.3.3.zip

• as Apache Karaf (aka JBoss Fuse) features:

  • ceylon.distribution.runtime, available in the following feature repository

    https://downloads.ceylon-lang.org/osgi/distribution/1.3.3/karaf-features.xml

  • ceylon.sdk, available in the following feature repository

    https://downloads.ceylon-lang.org/osgi/sdk/1.3.3/karaf-features.xml

Installing the Ceylon Distribution and SDK in an OSGi container

Apache Felix 5.4.0:

1. Let's assume we start with a fresh installation of Apache Felix v5.4.0 (org.apache.felix.main.distribution-5.4.0.zip)

2. In the conf/config.properties file of the Felix installation directory, add the following property:

   org.osgi.framework.executionenvironment=J2SE-1.7,JavaSE-1.7,J2SE-1.6,JavaSE-1.6,J2SE-1.5,JavaSE-1.5,J2SE-1.4,JavaSE-1.4,J2SE-1.3,JavaSE-1.3,J2SE-1.2,,JavaSE-1.2,CDC-1.1/Foundation-1.1,CDC-1.0/Foundation-1.0,J2ME,OSGi/Minimum-1.1,OSGi/Minimum-1.0

   This is necessary since by default the Felix OSGi container provided execution environments don't include J2SE-1.7, which is required by a transitive dependency of the ceylon.net module.

3. In the conf/config.properties file of the Felix installation directory, find the obr.repository.url property.

4. Uncomment this property if necessary

5. Add the 2 Ceylon following OBR urls at the end of this property (space-separated):

   https://downloads.ceylon-lang.org/osgi/distribution/1.3.3/repository.xml https://downloads.ceylon-lang.org/osgi/sdk/1.3.3/repository.xml

6. From the Felix installation directory, Start Felix with the following command:

   java -jar bin/felix.jar

7. From the Felix Gogo shell, deploy the Ceylon Distribution with:

   obr:deploy "Ceylon Distribution Bundle

8. Deploy any SDK module you need with the following command:

   obr:deploy ceylon.file

Glassfish v4.1:

Since Glassfish is based on Apache Felix, it can be configured to use the OBR. However the simplest way to install the Ceylon Distribution and SDK bundles is to copy then manually.

Let's assume we start with a fresh installation of Glassfish v4.1

1. Unzip the 2 zip archives mentioned earlier (distribution and sdk) into :

   ../glassfish4/glassfish/domains/domain1/autodeploy/bundles

2. start the glassfish server :

   ../glassfish4/bin/asadmin start-domain

3. verify that the various Ceylon bundles were deployed correctly in the following log file:

   ../glassfish4/glassfish/domains/domain1/logs

Apache Karaf 4.0.4 (Karaf is a part of JBoss Fuse) with Karaf features:

1. Let's assume we start with a fresh installation of Apache Karaf v4.0.4 (apache-karaf-4.0.4.zip)

2. In the karaf installation directory, start Karaf with the following command:

   ./bin/karaf

3. In the karaf shell, add the Ceylon distribution feature repository with the following command:

   feature:repo-add https://downloads.ceylon-lang.org/osgi/distribution/1.3.3/karaf-features.xml

4. In the karaf shell, add the Ceylon SDK feature repository with the following command:

   feature:repo-add https://downloads.ceylon-lang.org/osgi/sdk/1.3.3/karaf-features.xml

5. In the karaf shell, install the Ceylon distribution feature with the following command:

   feature:install ceylon.distribution.runtime

6. In the karaf shell, install the Ceylon SDK feature with the following command:

   feature:install ceylon.sdk