Page Comparison

...

The most straightforward way to start Cipango is to go to your Cipango installation directory and type:

java -jar start.jar --ini=start-cipango.ini

To stop, simply use Ctrl-C in the same terminal. You may also start Cipango so that it listens on a local port for stop commands:

java -DSTOP.PORT=8079 -DSTOP.KEY=secret -jar start.jar --ini=start-cipango.ini

The server can then be stopped using a different terminal window on the same machine:

java -DSTOP.PORT=8079 -DSTOP.KEY=secret -jar start.jar --stop

...

1. set in ${jetty.home}/etc/jetty.conf

   No Formatcode
   --ini=start-cipango.ini

   (The line --pre=etc/jetty-logging.xml must be removed)
2. go to ${jetty.home} and type:

   No Formatcode
   ./bin/jetty.sh start

This script allows also the commands stop, run, restart, check and supervise.

...

• /etc/default/jetty
• $HOME/.jettyrc

If it existsthey exist, these files are read at the start of script startup. It may perform any sequence of shell commands, like setting relevant environment variables

# Where Cipango is installed
JETTY_HOME=/home/user/cipango

JAVA_HOME=/usr/local/jdk1.6.0

# Set max heap sise to 512MB and initial size to 256MB 
JAVA_OPTIONS=="-Xmx512M -Xms256M -XX:+UseParNewGC -XX:+UseConcMarkSweepGC"

# Override the default SIP host
SIP_HOST=192.168.1.2

#Override the default SIP port
SIP_PORT=5060

#Override the default HTTP port
JETTY_PORT=8080

if [ ! -z "$SIP_PORT" ]
then
  JAVA_OPTIONS="${JAVA_OPTIONS} -Dsip.port=${SIP_PORT}"
fi

if [ ! -z "$SIP_HOST" ]
then
  JAVA_OPTIONS="${JAVA_OPTIONS} -Dsip.host=${SIP_HOST}"
fi

...

...

java -Dorg.cipango.dar.routeOutgoingRequests=false -jar start.jar etc/cipango.xml

...

<Set name="applicationRouter">
    <New class="org.cipango.ardar.DefaultApplicationRouter">
      <Set name="configuration"><SystemProperty default="." name="jetty.home"/>/etc/dar.properties</Set>
      <Set name="routeOutgoingRequests">false</Set>
    </New>
 </Set>

...

• remove the default application library: delete the file ${jetty.home}/lib/ext/cipango-dar-VERSION.jar
• or use the system property javax.servlet.sip.ar.spi.SipApplicationRouterProvider to define the custom SipApplicationRouterProvider
• or define the application router in ${jetty.home}/etc/cipango.xml, for instance

  Code Block
  xml xml
  <Set name="applicationRouter"> <New class="com.acme.MyApplicationRouter"> </New> </Set>

...

JNDI is not enabled by default in Cipango.

To add JNDI and SIP Servlet annotation support, Cipango should be started with cipango-plus.xml configuration file:

java -jar start.jar --ini=start-cipango.ini etc/cipango-plus.xml

JNDI support is similar to Jetty's one. Documentation on how to bind objects in JNDI tree is available here

SIP Connectors

TLS

To add TLS support, Cipango should be started with cipango-tls.xml configuration file:

java -jar start.jar --ini=start-cipango.ini etc/cipango-tls.xml

To manage the keys, see Jetty SSL plugin

System properties

In addition to system properties defined by Jetty, Cipango may use the following properties:

file:///${jetty.home}/etc/dar.properties

For instance to set the SIP port to 5070, use:

java -Dsip.port=5070 -jar start.jar  --ini=start-cipango.ini