Mobicents procédures d'installation Version 1.0 Rédigé par : Nom : ABDENNOR Visa : Vérifié par : Nom : Visa : Validé par : Nom : Visa : SUIVI DES VERSIONS Version Date V1.0 Nom du rédacteur Nature de la modification 15/05/12 ABDENNOR Création Table des matières Introduction .......................................................................................................................................... 4 Pré-requis ............................................................................................................................................. 5 Pré-requis Hardware ............................................................................................................................ 5 Pré-requis Software .............................................................................................................................. 5 Installation ............................................................................................................................................ 6 installation de la JDK ........................................................................................................................... 6 Installation de Mobicents JAIN SLEE ................................................................................................. 7 Déploiement de service ........................................................................................................................ 9 Mobicents et Eclipse .......................................................................................................................... 11 plugin avec lien http ........................................................................................................................... 11 plugin manuellement .......................................................................................................................... 11 Introduction Mobicents JAIN SLEE fait partie de la plateforme Mobicents qui est une plateforme open source destinée au monde des télécommunications. Mobicents JAIN SLEE permet de développer des services qui touche de la voix, de la video et du web. Cette plateforme est 100% java. Mobicents JAIN SLEE contient plusieurs adaptateurs qui lui permette de s'interfacer avec d'autres technologies tels que : SIP Asterisk Parlay/X Google Talk/Xmpp et d'autres ressources encore. Pour la plupart des ressources vous avez des exemples de mise en œuvre. Pré-requis Pour pouvoir installer Mobicents JAIN SLEE, il y a certains prérequis dont il faut tenir compte, c'est des prérequis à la fois hardware et software. Pré-requis Hardware une machine avec 2GB de RAM et un peu plus de 300 MB d'espace de stockage avec un système d'exploitation UNIX. Pré-requis Software il vous faut installer une jdk6 si vous ne l'avez pas sur votre système. Lien de téléchargement : http://www.oracle.com/technetwork/java/javase/downloads/java-se-jdk-7-download432154.html Installation installation de la JDK lorsque vous allez télécharger votre jdk, vous allez télécharger le fichier avec un format .tar.gz (compressed binary ou ce qu'on appelle une archive), une fois ce fichier à votre disposition, mettez le dans le répertoire de votre choix, pour ma part, il est dans /usr/java. voici les étapes à suivre après: tout d'abord dézippez le fichier, gzip -d jdk-7-linux-i586.tar.gz une fois cela fait, vous aurez un fichier avec extension .tar, faites ensuite, tar -xvf jdk-7-linux-i586.tar cela va nous permettre d'extraire les fichiers, suite à cela un répertoire est crée du nom de jdk1.7.0, maintenant nous allons déplacer le répertoire dans le répertoire où se trouve les jvm. mv ./jdk1.7.0/ /usr/lib/jvm/jdk1.7.0 On aurait pu faire cela en une seule commande Tar xvfz jdk-7-linux-i586.tar.gz maintenant exécuté la commande suivante pour voir les configurations sudo update-alternatives --config java vous aurez un écran avec cet affichage, en tout cas plus ou moins --------------------------------------------------------------------------------------------------------Selection Path Priority Status ———————————————————— * 0 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 auto mode 1 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 manual mode 2 /usr/lib/jvm/java-6-sun/jre/bin/java 63 manual mode Press enter to keep the current choice[*], or type selection number: ---------------------------------------------------------------------------------------------------------retenez le dernier numéro (ici c'est le numéro 2), cela nous permettre par la suite de mettre notre jdk juste après, maintenant nous allons rajouter notre ligne pour référencer notre jdk, voici la commande à taper update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk1.7.0/jre/bin/java 3 le numéro 3 en fin de commande, c'est juste pour placer la ligne à la fin, rappelez vous le numéro retenu c'est 2, donc pour placer la ligne juste après il faut mettre trois. maintenant si nous retapons la commande de tout à l'heure sudo update-alternatives --config java On verra notre ligne à la fin des configurations de java --------------------------------------------------------------------------------------------Selection Path Priority Status ———————————————————— * 0 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 auto mode 1 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 manual mode 2 /usr/lib/jvm/java-6-sun/jre/bin/java 63 manual mode 3 /usr/lib/jvm/jdk1.7.0/jre/bin/java 3 manual mode ----------------------------------------------------------------------------------------------- le travail est terminé, maintenant pour vérifier la version de votre jdk 7, voilà ce qu'il faut faire (aperçu de la console) root@debianMob:/usr/java# java -version java version "1.7.0" Java(TM) SE Runtime Environment (build 1.7.0-b147) Java HotSpot(TM) Client VM (build 21.0-b17, mixed mode) root@debianMob:/usr/java# javac -version javac 1.6.0_18 À présent nous pouvons passer à l'installation de "mobicents JAIN SLEE". Installation de Mobicents JAIN SLEE l'installation de cette plateforme n'est pas très compliquée, d'ailleurs vous le constaterai vous même. Dans un répertoire de votre choix (suggestion /usr/mobicents), tapez svn co http://mobicents.googlecode.com/svn/tags/servers/jain-slee/2.x.y/ core/2.6.0.FINAL mobicents-slee-core-2.6.0.FINAL Attention si par erreur vous ne tapez que svn co http://mobicents.googlecode.com/svn/tags/servers/jain-slee/2.x.y/ il vous installera toutes les versions. Il existe d'autres moyens pour avoir les fichiers sources, par exemple à l'aide de wget et c'est ce que nous utiliserons. wget http://downloads.sourceforge.net/project/mobicents/Mobicents%20JAIN%20SLEE%20Server/2.6.0.FINAL /mobicents-jainslee-2.6.0.FINAL-jboss-5.1.0.GA.zip dezipper le fichier à l'aide de unzip unzip mobicents-jainslee-2.6.0.FINAL-jboss-5.1.0.GA.zip une fois cela étant fait, allez dans jboss-5.1.0.GA.zip/bin, vous pouvez à présent lancer le mobicents à l'aide de ./run.sh Votre mobicents JAIN SLEE est installé. Vous pouvez donner au fichier certains paramètres, comme l'adresse ip, sur laquelle vous souhaitez démarrer votre serveur jain slee, cela se fait à l'aide du -b ./run.sh -b xx.xx.xx.xx Le jain slee eut être démerrer selon un profil, il en existe trois : all, default et sleeproduction, cela se fait à l'aide de l'option -c ./run.sh -c 'profil' Sachez que lorsque vous exécutez seulement le fichier sans spécifier les paramètres, ce dernier démarre en mode par défaut (default) et sur l'adresse de la boucle locale (127.0.0.1). Interface de management manager mobicents en ligne de commande peut s'avérer lourd pour certains, pour cela, il existe une console de management qui vous permettra de faire l'administration. Pour y accéder http://localhost:8080/slee-management-console/ Déploiement de service Dans votre répertoire mobicents, vous avez plusieurs sous répertoires, parmi eux, il y a le dossier examples, il contient un ensemble d'exemples qu'on peut tester et le dossier ressources où se trouve l'ensemble des ressources (c'est des « ressources adaptator » ) qu'on peut déployer. Exemple : Allez dans le répertoire des examples, ensuite dans sip-uas, vous trouverez un ensemble de fichier xml et quelques autres fichiers, ce qui nous intéresse pour le moment c'est le fichier build.xml qui permet de construire et de déployer le service au sein du mobicents jain slee, pour ce faire il vous faut installer ant, donc apt-get install ant ensuite il suffit de taper ant dans le répertoire sip-uas, normalement si tout se passe bien le service devrait bien se déployer, maintenant nous sommes presque capable d'exécuter les exemples, pour cela allons dans le répertoire sipp qui est dans sip-uas aussi, vous trouverez deux fichiers exécutables run.sh et run-ha.sh, si vous essayez de les exécuter ça ne va pas marcher parce qu'ils ne connaissent pas la commande sipp, en fait sipp est un module qui permet de générer des paquets sip. Donc il vous faudra installer sipp. Note : ant va construire et déployer le fichier build.xml Voici le lien du téléchargement : http://sourceforge.net/projects/sipp/files/sipp/3.2/sipp.svn.tar.gz/ une fois l'archive téléchargée, mettez-la dans /usr/src, ensuite il va falloir décompresser et extraire le contenu tar xvzf sipp.svn.tar.gz allez maintenant dans sipp.svn et faites un make, il se peut que vous auriez une erreur due à la libncurses5-dev qui n'est pas installée apt-get install libncurses5-dev après cela le make devrait marcher. maintenant on a toujours un problème, la commande sipp n'est toujours pas reconnue, si nous voulons exécuter la commande sipp -h nous devrions taper ceci /usr/src/sipp.svn/sip -h pour que la commande sipp soit exécutable dans tous les répertoires il faut rajouter le répertoire où nous l'avons installé dans le PATH, pour cela export PATH=$PATH:/usr/src/sipp.svn/ le problème qu'on aura, c'est que si on ferme la console et on réouvre un autre terminal on n'aura le même problème, la commande ne sera pas compréhensible, donc pour avoir la commande de façon permanente, il faut aller la mettre dans .bashrc et rajouter le chemin, ou seulement taper la commande suivante echo 'export PATH=$PATH:/usr/src/sipp.svn' >> /home/abdennor/.bashrc À travers la console de management vous pouvez voir les services déployés. Mobicents et Eclipse pour pouvoir utiliser Eclipse avec Mobicents JAIN SLEE, il faut installer un plugin, il existe différentes manières de faire, soit vous utilisez un lien http qui pointe vers le plugin ou vous téléchargez le plugin et vous le mettez dans le répertoire plugins de votre Eclipse plugin avec lien http -ouvrir eclipse -allez dans Help->Install New Software... -Click Add et entrer Name EclipSLEE et URL http://mobicents.googlecode.com/svn/downloads/eclipse-update-site/ -selectionnez votre version d'EclipSLEE, cliquez sur Next et suivez les instructions -redémarrez eclipse plugin manuellement soit vous téléchargez le fichier jar disponible à cette adresse : http://mobicents.googlecode.com/svn/downloads/eclipse-update-site/plugins/ sinon vous l'avez dans le répertoire tools->plugins->eclipsee de votre dossier mobicents, vous le récupérez et vous le mettez dans le répertoire plugins de votre Eclipse, ensuite redémarrez eclipse pour pouvoir installer ce plugin, d'après la documentation officielle il faut une version d'eclipse 3.7 et plus. (voir ici : http://docs.jboss.org/mobicents/jainslee/2.5.0.FINAL/tools/eclipslee/user-guide/en-US/html/install.html) à venir -fonctionnement de jain slee -création de sbb, ra, et service -installation de la mms (mobicents media server) -installation de la mss (mobicents servlet sip)