This documentation relates to last stable version of Cipango.
visit the last unstable documentation home.
Installing Cipango
Cipango can either be installed from a binary release or built from the trunk source code.
Binary Release
Cipango releases
Cipango is distributed as a platform independent zip file containing a Jetty and Cipango bundle ready to start. The most recent distribution can be downloaded from
google code
.
Installing from the Cipango/Jetty bundle
All you need to do is to unzip the archive. The top level directory is a standard Jetty installation. The only difference is that there is a sipapps
directory in addition to webapps
. This directory is used to deploy SIP or converged application.
Your top-level directory, referred to as ${jetty.home
} in this documentation should then look like:
$ ls LICENSE-APACHE-2.0.txt etc LICENSE-ECLIPSE-1.0.html lib META-INF logs NOTICE-CIPANGO.txt notice.html README-CIPANGO.txt overlays README.txt resources VERSION-CIPANGO.txt sipapps VERSION.txt start-cipango.ini about.html start.ini bin start.jar contexts webapps contexts-available
Build from Source Code
Getting source code
Cipango source code is available at http://code.google.com/p/cipango/source/checkout. Use the following command to anonymously check out the latest project source code to a directory named cipango
:
svn checkout http://cipango.googlecode.com/svn/trunk/ cipango
Building
Cipango uses Maven (v2.2.0 or later) as its build system. To build just go to the cipango top source directory and type:
mvn install
The Cipango Maven Plugin needs svn
and patch
commands available on the path.
If these commands are not installed on your system, you may install them as follows:
- subversion: http://subversion.tigris.org/getting.html or
aptitude install subversion
on linux - patch:
- Windows: http://gnuwin32.sourceforge.net/packages/patch.htm
- Linux:
aptitude install patch
When the build is completed, you'll find binary release of cipango packaged as .zip
and .tar.gz
under the cipango-distribution/target
directory. You can now install the binary release as explained above.