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
- Download Equinox framework (implementation in a standalone package as a jar).
- 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
- 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
- Start equinox
java -jar org.eclipse.osgi_3.7.2.v20120110-1415.jar -console
- 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
- 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
- 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.
- Compile
cipango-example-sipapp
cd ${cipango.src.home}/modules/examples/cipango-example-sipapp mvn install cp target/*.war ${equinox.home}/bundle/
- Start equinox
java -jar org.eclipse.osgi_3.7.2.v20120110-1415.jar -console
- deploy and start the application in exquinox
install war:file:bundle/cipango-example-sipapp.war start org.cipano.example-sipapp
- The
cipango-example-sipapp
is now deployed, you could test it.