Cocoon OSGi
===========


Status
------

This far only the servlet service framework works under OSGi.

Installation
-----------

* Checkout and build Cocoon trunk with Spring 2.1 (the current version of spring-osgi uses Spring 2.1).

* Build:
  $ mvn clean install -Pspring-2.1

* Create the Cocoon OSGi run time environment:
  $ cd cocoon-osgi-main
  $ mvn clean assembly:directory

Run
---

* Start the framework
  $ cd target/cocoon-osgi-main-main
  $ java -jar bin/felix.jar

If everything goes right you should get the message "Welcome to
Felix." and a number of log messages about started services. Write
"help" in the Felix console window to see what commands there are. "ps"
is used for listing the bundles. All bundles should be in active
state.

* Check that all bundles are active with

  -> ps

* Check that the demo servlet service bundles provides servlet
  services with

  -> services

  and use services with

  -> services -u

  more detailed info about the services from a bundle can be gotten by
  using the "services" command with the bundle number as argument.

* Point your browser to the servlet services:

  http://localhost:8080/test2            -> "Demo2"
  http://localhost:8080/test1/test1      -> "Demo1.1 baz"
  http://localhost:8080/test1/test2      -> "Demo2"
  http://localhost:8080/test1/test3      -> "Demo1.1 baz"
  http://localhost:8080/test1/test4      -> "Demo2"

* Stop the framework with

  -> shutdown

Observe that the felix framework persists it state in a cache
directory named ".felix" that is created in the current directory. If
you start Felix again it will use the bundles from the cache rather
than the bundles from the bundle directory. To update to the current
version the update command must be given for the bundle number in the
console. After having updated bundles a "refresh" command miight be
needed to resolve changed packages globaly.

Remove the .felix directory to make sure that you have a clean state.