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:
apt-get install mysql-server
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
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 18.104.22.168)
- Public address of your DNS server. In our case it's 22.214.171.124. 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.
ln -s /usr/share/java/fhoss-0.2 /etc/fhoss
Set java home in /usr/sbin/fhoss.sh
Add the java home folder at the end of /etc/bash.bashrc
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="126.96.36.199" />
- 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:
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.