Cipango can either be installed from a [#binary release] or [built from the trunk source code|#Build from Source Code]. h2. Binary Release h3. 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 {link-window:href=http://code.google.com/p/cipango/downloads/list}google code{link-window}. h3. 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|http://wiki.eclipse.org/Jetty/Starting/Downloads]. 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: {code:bash} $ 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 {code} h2. Build from Source Code h3. 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}}: {code}svn checkout http://cipango.googlecode.com/svn/trunk/ cipango{code} h3. Building Cipango uses [Maven|http://maven.apache.org] (v2.2.0 or later) as its build system. To build just go to the cipango top source directory and type: {code}mvn install{code} 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. |