kaleo is an application framework which provides sample location (proxy/registrar) and presence services. Kaleo is compliant with the following specifications:

• RFC 3261 - SIP: Session Initiation Protocol
• RFC 3265 - Session Initiation Protocol (SIP)-Specific Event Notification
• RFC 3680 - A Session Initiation Protocol (SIP) Event Package for Registrations
• RFC 3856 - A Presence Event Package for the Session Initiation Protocol (SIP)
• RFC 3857 - A Watcher Information Event Template-Package for the Session Initiation Protocol (SIP)
• RFC 3858 - An Extensible Markup Language (XML) Based Format for Watcher Information
• RFC 3863 - Presence Information Data Format (PIDF)
• RFC 3903 - Session Initiation Protocol (SIP) Extension for Event State Publication
• RFC 4825 - The Extensible Markup Language (XML) Configuration Access Protocol (XCAP)
• RFC 5025 - Presence Authorization Rules

Running Kaleo

Build Kaleo

kaleo is located under the extras directory of your cipango sources directory. To build from the sources, follow these steps:

1. Open a command prompt window and navigate to your cipango root directory
2. Go to the kaleo framework directory and build it:

   Code Blocknoformat
   cd extras/kaleo mvn install

   Go to the kaleo sipapp directory and build it:

   Code Block
   cd ../kaleo-sipapp mvn install

Start Kaleo

To start kaleo, copy the generated sip application (located under the target directory of kaleo-sipapp) to your cipango application deployment directory or start directly the application from the kaleo-sipapp directory with the maven cipango plugin:

mvn cipango:run

Test kaleo

Integration tests

Integration tests can be run with the command:

cd extras/kaleo
mvn install -Ditest

Using Mercuro

Mercuro is a free IMS softphone available for download here.

Kaleo does not need any provisionning, the registrar allows every registrations (no authentication).

Mercuro should be configured to use XCAP:
In Open Tools > Options > Contacts, select "Store contacts on a Remote Server" and set in Base URL, the value:

• http://localhost:8080/cipango-kaleo/xcap if Kaleo is running with maven-plugin
• http://localhost:8080/cipango-kaleo-1.0-SNAPSHOT/xcap if Kaleo is running with cipango (replace 1.0-SNAPSHOT by the kaleo version)

Image Added

In Open Tools > Options > Presence, select "Enable Presence" and ensures that the options "Enable RLS Presence" and "Enable Partial Publication" are not checked

Image Added

To authorize a user to see the presence, in Contacts > Authorizations, click on the allow button.
Image Added

Then, the user see the presence.
Image Added