Thursday, July 16, 2009

OpenIMSCore Installation on Ubuntu 9.04

Lets try and keep it as simple as possible.

Please follow the steps below to configure OpenIMSCore on localhost, later steps will be listed to switch between localhost and a specific IP address:


a. libxml2 (with development)
b. libmysql (with development)
c. bind9
d. bison
e. flex
f. mysql-server
g. ant
h. make
i. jdk1.5
j. gcc3/4

1. Go to / directory through command prompt and

mkdir opt
cd opt
mkdir OpenIMSCore
cd OpenIMSCore
mkdir ser_ims
mkdir FHoSS

2. Change the permissions for opt folder created:

chmod 777 -R /opt

3. Check out the code for OpenIMSCore

cd /opt/OpenIMSCore/

ser_ims: sudo svn checkout ser_ims

FHoSS: sudo

4. Configure ser_ims

cd ser_ims
sudo make install-libs all

5. Install FHoSS

cd FHoSS
ant compile deploy
cd ..

6. Mysql dumps

mysql -u root -p < style="font-family: monospace;">
mysql -u root -p < FHoSS/scripts/userdata.sql
mysql -u root -p < ser_ims/cfg/icscf.sql

7. Copy and dump the following

cp ser_ims/cfg/*.cfg .
cp ser_ims/cfg/*.xml .
cp ser_ims/cfg/*.sh .

8. Make following configuration changes:

8.1 Edit /etc/bind/named.conf by adding following zone in it:

zone "open-ims.test" {
type master;
file "/etc/bind/open-ims.dnszone";

8.2 Copy open-ims.dnszone file to /etc/bind/

sudo cp ser_ims/cfg/open-ims.dnszone etc/bind/

8.3 Edit /etc/resolv.conf

# Generated by NetworkManager
search open-ims.test
domain open-ims.test

8.4 Edit etc/hosts localhost raziya-laptop open-ims.test ims.test

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
ff02::3 ip6-allhosts

8.5 Restart bind server:

sudo /etc/init.d/bind9 restart

9. Confirm your configuration changes by digging the domain:
dig open-ims.test (It must list in your answer sections)

10. Start all nodes and hss:

10.1 cd opt/OpenIMSCore
10.2 ./
10.3 ./
10.4 ./
10.5 cd FHoSS/deploy
10.6 sh

Thats about it.

Now switching from localhost to a specific IP edit all the undermentioned files, by replacing all to your specific IP say for eg:

1. edit /etc/resolv.conf

2. edit /etc/hosts

3. edit /etc/bind/open-ims.test

4. restart bind: sudo /edit/init.d/bind9 restart

5. check: dig open-ims.test

6. Change Nodes setting:

6.1 icscf.cfg & icscf.xml (opt/OpenIMSCore/)
6.2 pcscf.cfg & pcscf.xml
6.3 scscf.cfg & scscf.xml

7. Change FHoSS setting

7.1 DiameterPeerHSS.xml (FHoSS/deploy)
7.2 (FHoSS/deploy)

Please feel free to comment.