Running a custom bundle in Open Day light controller

I have copied one of the sample application int the opendaylight controller and named it as userinfo by changing artifact id in pom file. In this post i will show you how can i add my application while controller is running.

First of all build the bundle by command "mvn install". If everything is well go to command line of controller. But before that let me shed some light on how OSGi works. Life cycle of any app is 1. install 2. resolve 3.uninstall. First and last is self explanatory. A bundle will be in resolved state when all the dependencies are resolved and that's when you can start a service. 

osgi> install file:/home/ubuntu/workspace/controller/opendaylight/samples/userinfo

Bundle id is 150

< output omitted>

Version              0.0.1.SNAPSHOT

BundleDescription    org.opendaylight.controller.samples.userinfo_0.0.1.SNAPSHOT

Framework            org.eclipse.osgi.framework.internal.core.Framework@164e955

ResolutionFailureException org.osgi.framework.BundleException: The state indicates the bundle is resolved

Revisions            [org.opendaylight.controller.samples.userinfo_0.0.1.SNAPSHOT]

BundleContext        null

BundleId             150

StartLevel           1

SymbolicName         org.opendaylight.controller.samples.userinfo

BundleData           org.opendaylight.controller.samples.userinfo_0.0.1.SNAPSHOT

KeyHashCode          150

StateChanging        null

as you can see once installed osgi gives you a bundle id. now you can start or stop this bundle with this id.

To check currently installed bundle and its id/state say 'ss'

osgi> ss

"Framework is launched."

id      State       Bundle

0       ACTIVE      org.eclipse.osgi_3.8.1.v20120830-144521

<OUTPUT ommited>

150     RESOLVED    org.opendaylight.controller.samples.userinfo_0.0.1.SNAPSHOT

As you can see state is resolved. Good now let you can start the bundle by giving command 'start 150'. But it will give you error as the controller don't have binaries. For that you need to copy your binary (i.e. jar) to
/home/ubuntu/workspace/controller/opendaylight/distribution/opendaylight/target/distribution.opendaylight-0.1.0-SNAPSHOT-osgipackage/opendaylight/plugins

ok. Now say start 150 and njoy your code !

To create a simple application click here

How to install Open IMS Core in ubuntu

Open IMS Core is an open source implementation of IMS call session control function and a lightweight Home Subscriber Server. In this document I have discussed how to install it on Ubuntu.

Prerequisite:

Before installing Open IMS Core you need programs listed below installed and running.

• an SVN client running
• A mysql server. Install it by entering following command sudo apt-get mysql*
• A DNS server. I have used bind9. I have installed it using synaptic Package Manger.
• GCC3/4, make, JDK1.5, ant
• bison and flex
• libxml2, libmysql 

Getting the Source Code:

Create a directory /opt/OpenIMSCore and go in that directory by command

mkdir /opt/OpenIMSCore
cd /opt/OpenIMSCore

Download the latest version from the repository of Open IMS Core. But before downloading make two folders FHoSS for HSS functionalities and ser_ims for CSCF functionalities.

mkdir FHoSS
mkdir ser_ims

svn checkout http://svn.berlios.de/svnroot/repos/openimscore/ser_ims/trunk ser_ims
svn checkout http://svn.berlios.de/svnroot/repos/openimscore/FHoSS/trunk FHoSS

You can checkout at different path but after that you have to change configuration files.

Configuring DNS server:

As we want to make our own network we need DNS server for IP and domain name binding.
Next discussion will be based on following configuration:

Domain name: group1-imslab11.in
IP address: 192.168.1.100
Subnet : 255.255.0.0

Following steps will tell you how to configure your own DNS server. Before proceeding further you have to stop Network Manager, as it does automatic changes to files needed. To stop network manager run,

sudo service network-manager stop

Setup your ethernet; my ethernet is running on eth0 please check your ethernet ports name.

sudo ifconfig eth0 192.168.1.100/16 up

make the necessary changes in your interface file. Open interface file with command

sudo gedit /etc/networking/interfaces

copy the configuration of snapshot

resolv.conf file is used for client side configuration of DNS server.

open it with

sudo gedit /etc/resolv.conf

nameserver - IP address of DNS server
search - Search list for hostname lookup
domain - name of the local domain

Open hosts file with command

sudo gedit /etc/host

host file has the static lookup table for hostname
Ex. IP_ADDR cannonical_host_name aliases

This file joints ip addresses with there names and alias name.

Restart the network by command

/etc/init.d/networking restart

Configuring Bind:

DNS configuration files are stored in /etc/bind directory. Primary configuration file is /etc/bind/named.conf.
Here we will insert forward lookup zone and reverse lookup zone.

Here I have added a zone by giving it a name group1-imslab11.in and file for that forward zone declaring as /etc/bind/open-ims.dnszone. Similarly reverse zone and reverse zone file at location /etc/open-ims-rev.dnszone

copy open-ims.dnszone to /opt/OpenIMSCore/ser_ims/cfg/

restart bind9 server with

sudo /etc/init.d/bind9 restart

check whether DNS has configured properly or not from nslookup command.

OK all done. Now let us install Open IMS Core !!!

Make sure that mysql and bind9 are running.

1. Go inside ser_ims/cfg directory ( cd /ser_ims/cfg/ )
2. Run “configurator.sh” ( sh configurator.sh )
3. Enter Domain Name: < your domain name>
4. Enter IP Address: < Your IP Address>
   (We have given group1-imslab11.in as domain name and 192.168.1.100 as IP)
5. Apply changes to all.
   (This step will change domain name and ip address in the following files: icscf.cfg,        icscf_pg.sql, icscf.sql, icscf.thig.cfg, icscf.xml, pcscf.cfg, pcscf.xml, persist_my.sql,        persist_pg.sql, scscf.cfg, scscf.xml)
6. Change to the following directory:
   cd /opt/OpenIMSCore/FHoSS/scripts
7. Change domain name and ip in userdata.sql to your domain and IP address.
8. Change to the following directory
   cd /opt/OpenIMSCore/FHoSS/config/
9. Change Domain name and IP in DiameterPeerHSS.xml to your domain name and IP.
10. Move to the following directory and make by given command:
    cd /opt/OpenIMSCore/ser_ims
    make install-libs all
11. After that write given command in prompt
    cd /opt/OpenIMSCore/FHoSS
    ant compile deploy
12. Now make Database by command:
    cd /opt/OpenIMSCore
    mysql –u root –p < ser_ims/cfg/icscf.sql
    mysql –u root –p < FHoSS/scripts/hss_db.sql
    mysql –u root –p <FHoSS/scripts/userdata.sql
13. To copy the following files into /opt/OpenIMSCore give commands
    cp ser_ims/cfg/*.cfg .
    cp ser_ims/cfg/*.xml .
    cp ser_ims/cfg/*.sh .
14. Start OpenIMSCore in four parellel terminals by giving each command in different terminal:
    ./pcscf.sh
    ./scscf.sh
    ./icscf.sh
    cd FHoSS/deploy/
    ./startup.sh
15. Open FHoSS web Console
    http://localhost:8080/hss.web.console/
    User Name: hssAdmin
    password: hss
16. Go to user identities -> Public User Identities -> search
17. Click on search, you will see two default users:   Alice and bob
18. Go and do various experiments with Open IMS Core !!!!!