Kamailio 4.x IMS – Installing HSS

This HSS implementation uses as its backend MySQL database, so we need install mysql server also on this host. This step of installing mysql server you need to accomplish before installation of HSS, because HSS package executes post-installation scripts that creates HSS database with tables and users and this step needs functional and running mysql server.

During mysql installation you will be asked for mysql root password, which will be needed in some next steps:

HSS installation:

install packages required for compilation and installing FHOSS

apt-get install debhelper cdbs lintian build-essential fakeroot devscripts pbuilder dh-make \
debootstrap dpatch flex libxml2-dev libmysqlclient15-dev sun-java6-jdk sun-java6-jre ant \
docbook-to-man subversion bison libcurl4-dev debhelper cdbs lintian build-essential fakeroot \
devscripts pbuilder dh-make debootstrap dpatch flex libxml2-dev libmysqlclient15-dev 

Get OpenIMScore sources

go to your preferred folder where the sources will be downloaded

cd /root
mkdir openimscore-fhoss 
svn checkout http://svn.berlios.de/svnroot/repos/openimscore/FHoSS/trunk openimscore-fhoss

Building packages for hss

cd openismcore-fhoss
dch -v $(svnversion) "..."
dpkg-buildpackage -rfakeroot

Install fhoss

cd ..
dpkg –i openimscore-fhoss*.deb

Post-installation scripts automatically runs configuration wizard in which you are asked to provide:

• java location directory to /usr/lib/jvm/java-6-sun/
• IMS domain name. In our case it's obligatory ims1.sip.uniza.sk
• Listen IP address (of installed HSS daemon). Type the global IP address through it's available to outside. (in our case 158.193.139.43)
• Public address of your DNS server. In our case it's 158.193.152.2. DNS server is the key komponent in IMS environment for correct SIP nodes discovery funcioning.
• you will be asked if you want to configure mysql server, select yes
• next you will be asked for the mysql root password defined during mysql server installation
• at last step, you have asked for typing usernames for IMS users that will be stored in HSS database (type names separated by spaces). users will have password defined as the same as usernames. so user ims-user will have password ims-user.

Create symlink

ln -s /usr/share/java/fhoss-0.2 /etc/fhoss

Set java home in /usr/sbin/fhoss.sh

JAVA_HOME="/usr/lib/jvm/java-6-sun/bin/java"

Add the java home folder at the end of /etc/bash.bashrc

export JAVA_HOME="/usr/lib/jvm/java-6-sun/"

Open the main diameter HSS configuration file /etc/fhoss/DiameterPeerHSS.xml:

• make sure that on all places in this file is correct IMS domain name that you've used (ims1.sip.uniza.sk)
• Beside this, you need to have following directives defined:
  • One Acceptor tag with global IP address: <Acceptor port="3868" bind="158.193.139.43" />
  • Two Peer tags:

<Peer FQDN="icscf.ims1.sip.uniza.sk" Realm=" ims1.sip.uniza.sk " port="3869" />
<Peer FQDN="scscf. ims1.sip.uniza.sk " Realm=" ims1.sip.uniza.sk ="3870" />

both lines defines connection through diameter Cx interface to respective SIP servers (icscf, scscf respectively) to correct ports (on other sides of Cx interfaces you must have running interfaces on defined ports!! – this port configuration is stored on SIP servers in xml files in/etc/kamailio/icscf.xml on I-CSCF or /etc/kamailio/scscf.xml on S-CSCF respectively).

Import files to mysql with following command:

cd /etc/fhoss/sql_files
mysql -uroot -p < hss_db.sql
mysql -uroot -p < userdata.sql

Open HSS management and edit Preferred S-CSCF Set, default_as in Application Server and Trigger Point according to your set up.

In the main HSS webserver configuration file /etc/fhoss/hss.properties, you can change:

• web server listen address
• changing default listen port from 8080 to something nicer
• other configuration options you can ignore for now

After making changes in configuration, you need to restart HSS daemon for applying changes in real:

/etc/init.d/openimscore-fhoss restart

  Afer completition of post-installation script you will have configured mysql server and fhoss will be running. HSS supports only simple administration through the command line:

• script /usr/sbin/fhoss-add-imscore-user.sh with which you can create new IMS users.

Complete administration interface is provided through web server which is automatically started with FHoSS daemon on port 8080. So you can connect with web browser and navigate to the following link for HSS management:

You will be asked for credentials for web interface. In default, you can provide this:

• username: hssAdmin, password: hss, for administrator access
• username: hss, password: hss, for user view access

You can change this access accounts in file /etc/fhoss/conf/tomcat-users.xml to your needs.