TP OPEN-IMS-CORE

Installation et mise en place d’un service VoD

Pr. Raiss Mohammed

Next Generation Networks (IRM)
 Installation d’OpenIMSCore

Étape 1 : Paquet subversion

Pour télécharger le code source, nous avons besoin du paquet subversion:

sudo apt-get install subversion

Étape 2: Récupération du code source d’OpenIMSCore (via SVN)

Répertoire d’installation : le code source est pré-configuré pour fonctionner selon un chemin
de fichier standard
Créer le dossier /opt/OpenIMSCore/ et s’y rendre :

mkdir /opt/OpenIMSCore
cd /opt/OpenIMSCore

Créer le dossier ser_ims et y placer les serveurs CSCF :

mkdir ser_ims
svn checkout https://svn.code.sf.net/p/openimscore/code/ser_ims/trunk ser_ims

Créer le dossier FHoSS et y placer le serveur HSS :

mkdir FHoSS
svn checkout https://svn.code.sf.net/p/openimscore/code/FHoSS/trunk FHoSS

Créer le dossier JavaDiameterPeer et y placer le serveur Diameter :

mkdir JavaDiameterPeer

svn checkout svn://svn.code.sf.net/p/openimscore/code/JavaDiameterPeer/trunk

javaDiameterPeer

Étape 3: Installation des librairies nécessaires à la compilation

Nous avons besoin d'un certain nombre de paquets à compiler. Exécutez la commande
suivante :

- Java :

sudo apt-get install default-jre

sudo apt-get install default-jdk
- mysql :

sudo apt-get install mysql-server libmysqlclient-dev

- bison :

sudo apt-get install libxml2 libxml2-dev bison

-Serveurs DNS:

sudo apt-get install flex bind9

-Curl et autres:

sudo apt-get install subversion curl libcurl3 libcurl3-dbg libcurl3-gnutls libcurl4-openssl-dev

libxml2 libxml2-dev

Étape 4: Compiler et deployer

- Se rendre à ser_ims

cd ser_ims
make install-libs all
cd ..

- Si vous ne disposez pas d'un JDK> = 1.5, en obtenir un avant de continuer

Assurez-vous que la version JDK que vous utilisez est> = 1.5

# java –version

Il est souvent le cas que les utilisateurs ont installé un JDK >1.5, mais ils sont toujours
entrain d’utiliser leur ancienne installation JDK! Si vous voyez des erreurs, revérifier

- Se rendre à FHoSS

cd FHoSS
ant compile
ant deploy
cd ..

Etape 5 : Configuration DNS et DHCP :

Copier le fichier open-ims.dnszone dans /etc/bind:

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

- Configuration du DNS :
 Editer le named.conf.local (toujours dans /etc/bind/) pour prendre en compte la nouvelle
zone:

gedit /etc/bind/named.conf.local

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

 Vérifier que le named.conf fasse bien appel à ce fichier. Pour cela, la ligne suivante
doit être présente dans le named.conf:

include « /etc/bind/named.conf.local »;

Ajoutez-la si ce n’est pas le cas.

 Editer le fichier /etc/resolv.conf, supprimer (ou commenter) le contenu existant et

ajouter les lignes suivantes :

search open-ims.test
domain open-ims.test
nameserver 127.0.0.1

Attention: A chaque redémarrage de l’OS, ce fichier va être écrasé par le Network

Manager. Ainsi, faites un backup de ce fichier (nous l’utiliserons dans un script
automatique de lancement des serveurs) :

sudo cp /etc/resolv.conf /etc/resolv.conf.ims

 Editer le fichier /etc/hosts et ajouter les lignes suivantes :

127.0.0.1 localhost
127.0.0.1 open-ims.test mobicents.open-ims.test ue.open-ims.test presence.ope
n-ims.test icscf.open-ims.test scscf.open-ims.test
pcscf.open-ims.test hss.open-ims.test

Attention: Comme précédemment, faites un backup de ce fichier :

sudo cp /etc/hosts /etc/hosts.ims

 Redémarrer le serveur DNS :

/etc/init.d/bind9 restart
  Vérifier que le changement de configuration a bien été pris en compte (via dig) :

dig open-ims.test

Etape 6 : Configuration MYSQL :

 Placez-vous dans le dossier d’openIMS et effectuer les 3 commandes suivantes :

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

 Le mot de passe demandé est le mot de passe super utilisateur de MySQL.

 Vérifier que la base est accessible et chargée :

mysql -u root -p
show databases ;

Vous devriez voir apparaître 2 tables supplémentaires : hss_db et icscf.

Etape 7 : Lancement des serveurs

- Serveurs x-cscf:
-
-
- Copy the following files to /opt/OpenIMSCore or another location comfortable for you:
-
- pcscf.cfg, pcscf.sh, icscf.cfg, icscf.xml, icscf.sh, scscf.cfg, scscf.xml, scscf.sh,
-
-
- cp ser_ims/cfg/*.cfg .
-
- cp ser_ims/cfg/*.xml .
-
- cp ser_ims/cfg/*.sh .

Lancer les fichiers :

./pcscf.sh, ./icscf.sh et ./scscf.sh

Ces trois serveurs doivent fonctionner en parallèles sur 3 terminaux différents. On pourra
observer tout le trafic entre ces serveurs.

- Serveur FHoSS :

Lancer le serveur via :

FHoSS/deploy/startup.sh
 S’il y a une erreur, il est fort probable que celle-ci soit liée à la variable d’environnement
JAVA_HOME. Vérifier que cette variable a été correctement exporté. (Le bon jdk dans la
variable JAVA_HOME).
Vérifier que le FHoSS est correctement lancée en accédant à l’interface
http://localhost:8080/.

Étape 8: Création d’un script de démarrage automatique (facultatif)

Il y a des configurations qui sont perdues une fois le système est redémarré.( Comme le
fichier /etc/resolv.conf ), il peut être utile de créer un script qui lance de manière automatique
les différents serveurs et qui s’occupe de faire les configurations nécessaire avant le
lancement des serveurs.

Voici un script qui fait le nécessaire pour une installation en root :

#!/bin/bash
read -p « Lancement du coeur IMS. Appuyer sur une touche pour continuer. »
export JAVA_HOME= « /usr/lib/jvm/java-1.6.0-openjdk/ » (à modifier selon la version et
l’arboressance)
cp /etc/resolv.conf.ims /etc/resolv.conf
cp /etc/hosts.ims /etc/hosts
cd /opt/OpenIMSCore/
gnome-terminal –geometry=70×20+100+350 -e ./pcscf.sh
read -p « PCSCF: OK! Appuyer sur une touche pour continuer.. »
gnome-terminal –geometry=70×20+200+350 -e ./icscf.sh
read -p « ICSCF: OK! Appuyer sur une touche pour continuer.. »
gnome-terminal –geometry=70×20+300+350 -e ./scscf.sh
read -p « SCSCF: OK! Appuyer sur une touche pour continuer.. »
cd FHoSS/deploy/
gnome-terminal –geometry=70×20+400+350 -e ./startup.sh
read -p « FHoSS: OK! Appuyer sur une touche pour continuer.. »

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

sudo cp /etc/resolv.conf /etc/resolv.conf.ims

sudo cp /etc/hosts /etc/hosts.ims

/etc/init.d/bind9 restart