This documentation relates to last stable version of Cipango.
visit the last unstable documentation home.

Cipango boostraping in OSGi

Introduction

Cipango could be started in an OSGi environment with the module cipango-osgi-boot based on jetty-osgi-boot.

Installation in equinox

  1. Download Equinox framework (implementation in a standalone package as a jar).
  2. Copy bundles in bundle directory
    mkdir ${equinox.home}/bundle
    cp ${jetty.home}/lib/*.jar ${equinox.home}/bundle/
    cp ${jetty.home}/lib/sip/*.jar ${equinox.home}/bundle/
    cp ${jetty.home}/lib/ext/cipango-dar*.jar ${equinox.home}/bundle/
    # Get OSGi specific dependencies
    cd ${equinox.home}/bundle/
    wget http://repo1.maven.org/maven2/org/eclipse/osgi/org.eclipse.osgi.services/3.2.100.v20100503/org.eclipse.osgi.services-3.2.100.v20100503.jar
    wget http://repo1.maven.org/maven2/org/eclipse/jetty/osgi/jetty-osgi-boot-warurl/7.6.7.v20120910/jetty-osgi-boot-warurl-7.6.7.v20120910.jar
    
  3. Compile Cipango-osgi-boot
    cd ${cipango.src.home}/cipango-osgi/cipango-osgi-boot
    mvn install
    cp target/*.jar ${equinox.home}/bundle/
    cp jettyhome ${equinox.home} -r
    
  4. Start equinox
    java -jar org.eclipse.osgi_3.7.2.v20120110-1415.jar -console
  5. Execute the following commands to install required bundles
    install file:bundle/cipango-dar-2.2-SNAPSHOT.jar
    install file:bundle/cipango-annotations-2.2-SNAPSHOT.jar
    install file:bundle/cipango-callflow-2.2-SNAPSHOT.jar
    install file:bundle/cipango-deploy-2.2-SNAPSHOT.jar
    install file:bundle/cipango-jmx-2.2-SNAPSHOT.jar
    install file:bundle/cipango-plus-2.2-SNAPSHOT.jar
    install file:bundle/cipango-server-2.2-SNAPSHOT.jar
    install file:bundle/jetty-ajp-7.6.7.v20120910.jar
    install file:bundle/jetty-annotations-7.6.7.v20120910.jar
    install file:bundle/jetty-client-7.6.7.v20120910.jar
    install file:bundle/jetty-continuation-7.6.7.v20120910.jar
    install file:bundle/jetty-deploy-7.6.7.v20120910.jar
    install file:bundle/jetty-http-7.6.7.v20120910.jar
    install file:bundle/jetty-io-7.6.7.v20120910.jar
    install file:bundle/jetty-jmx-7.6.7.v20120910.jar
    install file:bundle/jetty-jndi-7.6.7.v20120910.jar
    install file:bundle/jetty-plus-7.6.7.v20120910.jar
    install file:bundle/jetty-policy-7.6.7.v20120910.jar
    install file:bundle/jetty-rewrite-7.6.7.v20120910.jar
    install file:bundle/jetty-security-7.6.7.v20120910.jar
    install file:bundle/jetty-server-7.6.7.v20120910.jar
    install file:bundle/jetty-servlet-7.6.7.v20120910.jar
    install file:bundle/jetty-servlets-7.6.7.v20120910.jar
    install file:bundle/jetty-util-7.6.7.v20120910.jar
    install file:bundle/jetty-webapp-7.6.7.v20120910.jar
    install file:bundle/jetty-websocket-7.6.7.v20120910.jar
    install file:bundle/jetty-xml-7.6.7.v20120910.jar
    install file:bundle/org.eclipse.osgi.services-3.2.100.v20100503.jar
    install file:bundle/servlet-api-2.5.jar
    install file:bundle/sip-api-1.1.jar
    install file:bundle/jetty-osgi-boot-warurl-7.6.7.v20120910.jar
    install file:bundle/cipango-osgi-boot-2.2-SNAPSHOT.jar
    

Start

  1. Start equinox with the command:
    java -Djetty.etc.config.urls=etc/cipango-osgi.xml -Djetty.home=jettyhome -jar org.eclipse.osgi_3.7.2.v20120110-1415.jar  -console
    
  2. Start cipango-osgi-boot and jetty-osgi-boot-warurl
    start org.eclipse.jetty.osgi.boot
    start org.eclipse.jetty.osgi.boot.warurl
    

Demonstration

The application cipango-example-sipapp is used as it is a Sip application bundled like described in RFC66.

  1. Compile cipango-example-sipapp
    cd ${cipango.src.home}/modules/examples/cipango-example-sipapp
    mvn install
    cp target/*.war ${equinox.home}/bundle/
    
  2. Start equinox
    java -jar org.eclipse.osgi_3.7.2.v20120110-1415.jar -console
  3. deploy and start the application in exquinox
    install war:file:bundle/cipango-example-sipapp.war
    start org.cipano.example-sipapp
    
  4. The cipango-example-sipapp is now deployed, you could test it.