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 (http://www.syncrosvnclient.com/download.html?os=Linux) 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 !!!!!