Mohit's Weblog

This entry demonstrates the procedure for installing OpenIMS and integrating Sailfin-CAFE with it. The attached sailfin-cafe application could then be used to establish a call between two clients registered with open-ims.

Overview

• Install OpenIMS core.
• Install Sailfin-CAFE, integrate it with OpenIMS.
  
• Register IMS clients with OpenIMS core.
• Deploy the cafe-app.
• Establish call between the clients.
  

Lets get started

Installing OpenIMS core

-- Install instructions can be found here.

Note: If you are running the DNS on the same machine as OpenIMS core, then while configuring the DNS server, edit the file /etc/dhcp3/dhclient.conf and uncomment this line: prepend domain_name_servers 127.0.0.1;

-- Start OpenIMS core components viz: pcscf, scscf, icsfc and FHoSS startup as given in the installation guide.

Setting up SailFin and SailFin-CAFE

-- Download and install SailFin from here.

-- Use SailFin CAFE promoted build 05 or latest. The download and install instructions are available here.

-- Register SailFin with OpenIMS core:

• Go to http://localhost:8080 and enter hssAdmin as username & hss as password. This will lead you to FHoSS - FOKUS Home Subscriber Server webpage.
  
• Click on create(Application Server) under the servcies tab.
  
• The server setting parameters will be: Server Name - sip:hostname:5060, DiameterFDQN - hostname, Default Handling - Session-continued.
• Attach the default_ifc to the newly created server.

IMSClient setup

-- UCT IMS Client can be dowloaded at http://uctimsclient.berlios.de/

-- OpenIMS Core has Alice and Bob as the users registered by default. Use two different IMS clients to login as Alice and Bob respectively.

Deploying test application and establishing the call

-- Download and deploy the sample application using sailfin asadmin deploy.

-- Call Establishing logic of the test App:

    public class NewServlet extends HttpServlet {      
         @Context CommunicationSession session;
                 ----------

         protected void processRequest(HttpServletRequest request, HttpServletResponse response) {

                 ----------

            Call call  = session.createCall(party1);
            call.addParticipant(party2);

                -----------

          }

    }

-- Access the url : http://localhost:8080/esswebv2

-- Enter user ids : Alice@open-ims.test  and Bob@open-ims.test

-- Click on the call button and listen the IMS Clients ringing !!

Screencast

The screencast for the complete setup can be viewed here !!