Ajay Pratap Singh Pundhir Version

1.0
Setting Up OpenIMS Core for Your Network
Note:
This Document will help you in setting up OpenIMSCore for
your network. On top of which you can add an application
server and setup your IMS application.
Follow the steps given on OpenIMSCore Installation guide
(http://www. openimscore.org/installation_guide). This tutorial is
to help you with additional information you may need.
These steps are tested on Fedora Core-10 Architecture.

Prerequisites:
Hardware: Intel Pentium-4/ Dual Core and at least 1Gb RAM.
Install Fedora Core-10 on a System.
Update it with latest packages.
o Open a terminal.
o Become super user using su command.
o If you are behind proxy, just add HTTP_ PROXY settings
in yum.conf file( /etc/yum.conf).
o Use yum update command to update your system.
After update reboot your system.
Download latest jdk.
(http://java.sun.com/javase/downloads/index.jsp)
Install jdk. By default it uses path /usr/java/<your jdk >
Set java path in .bash_profile.
Reboot your system. Check java path using echo $
JAVA_HOME command. It will display path of jdk directory.
Install apache ant using yum install ant command.

Ajay Pratap Singh Pundhir Version

1.0
Install mysql using yum install mysql* command.
Install bison and flex packages, using yum install <package
name> command.
Getting required Packages and Tools:
Till now your basic system is ready and working. If you have
any error in above steps, check for the dependencies. you are
connected with Internet.
Download the Following Packages/Distributions and save them
in a directory.
DNS ( I have used bind9, you can download latest bind9
package from https://www.isc.org/downloadables/11)
Make a directory:
o cd /opt
o mkdir OpenIMSCore
o cd OpenIMSCore
Get OpenIMSCore from http://svn.berlios.de/svnroot/repos/openimscore
using SVN and save them in current directory i.e. /opt/OpenIMSCore

o CDiameterPeer
o FHoSS
o JavaDiameterPeer
o Ser_ims
Untar all the four packages in the current directory i.e.
/opt/OpenIMSCore
Download X-Lite from (http://www.counterpath.com/xlite.html&active=4), untar it in /opt/xlite directory.
Install wireshark using the following command:
o yum install wireshark*

Ajay Pratap Singh Pundhir Version

1.0
Now you have following tools/packages:
bind9
OpenIMSCore components at /opt/OpenIMSCore/
Wireshark
X-Lite at /opt/xlite/
Settings your own network for OpenIMSCore:
In this step you will configure your network according to your
domain name.
There are four Files in fedora which needs to be configured:
1. /etc/hosts
2. /etc/sysconfig/network
3. /etc/sysconfig/network-script/ifcfg-eth0
4. /etc/resolve.conf
Before proceding further this is advisable to deactivate your
NetworkManager, because it takes control of the network and
changes the network settings dynamically, so if you restart your
network or reboots your system, your network settings will get
changed automatically.
You can disable NetworkManager temporarily using service
NetworkManager stop command. Stop NetworkManager before
moving ahead.
Following are settings for my network, you can replace this with
your requirements.
Domain Name: group3-imslab09.in

Ajay Pratap Singh Pundhir Version

1.0
IP Address:

192.168.1.105

Subnet: 255.255.0.0

Make the following Changes:

1. vi /etc/sysconfig/network

2. vi /etc/syscinfig/network-script/ifcfg-eth0

Ajay Pratap Singh Pundhir Version

1.0

3. vi /etc/resolve.conf

4. vi /etc/hosts

Ajay Pratap Singh Pundhir Version

1.0

After configuring above four files restart network using service

network restart command.
Now you should be able to ping localhost, ws1, hss, pcscf, Still You
have to configure DNS because till now your system is using
localhost to locate hss, pcscf,..etc.

DNS Installation and configuration:

1. Open a terminal, go to the directory where you have saved
bind9 package.
2. Install it with admin privilege.
a. rpm ivh <package name.rpm>
3. Open DNS Configuration File:
a. vi /etc/named.conf
b. Add a zone for forward lookup and another zone for
reverse lookup. ( for more info about how to configure
DNS read the reference given at the end of this document)

Ajay Pratap Singh Pundhir Version

1.0

4. Copy the open-ims.dnszone file to the following location:

a. cd /var/named/chroot/var/named/
b. cp fr /opt/OpenIMSCore/ser_ims/cfg/open-ims.dnszone .

Ajay Pratap Singh Pundhir Version

1.0

5. Define your domain in this file and add your systems /

workstations:
6. Make a similar file for reverse lookup with following entries: I
have named this file as open-ims-rev.dnszone

Ajay Pratap Singh Pundhir Version

1.0

Steps To Install and Configure OpenIMSCore

Till Now you should be ready with the following things working:
1. Mysql ( check using service mysqld status command)
2. DNS ( check using service named status command)
3. DNS Properly configured for both forward and reverse lookup
( check using nslookup <your hostname> for forward lookup
and nslookup <your ipaddress> for reverse lookup)
4. You should have OpenIMSCore packages on your opt directory.

StepsNow you are at /opt/OpenIMSCore/

1. Go inside ser_ims/cfg directory ( cd /ser_ims/cfg/ )

Ajay Pratap Singh Pundhir Version

1.0
2. Run configurator.sh ( sh configurator.sh )
3. Enter Domain Name: < your domain name>
4. Enter IP Address: < Your IP Address>
(in our case we entered group3-imslab09.in and ip
192.168.1.100)
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 in userdata.sql to your domain.
8. Change to the following directory
( cd /opt/OpenIMSCore/FHoSS/config/ )
9. Change Domain name in Diameter PeerHSS.xml to your domain
name.
10. Move to the following directory:
Cd /opt/OpenIMSCore/ser_ims
make install-libs all
11. cd /opt/OpenIMSCore/FHoSS
ant compile deploy
12. Now make Database as:
You are at /opt/OpenIMSCore
mysql u root p h <your ipaddress> < ser_ims/cfg/icscf.sql
mysql
u
root
p
h
<your
ipaddress>
<
FHoSS/scripts/hss_db.sql
mysql
u
root
p
h
<your
ipaddress>
<
FHoSS/scripts/userdata.sql

Ajay Pratap Singh Pundhir Version

1.0
13. Copy the following files into /opt/OpenIMSCore
cp ser_ims/cfg/*.cfg .
cp ser_ims/cfg/*.xml .
cp ser_ims/cfg/*.sh .
14. Start OpenIMSCore:
./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. Now you are ready with your IMS Core for the experiments.