Installation de XiVO depuis une source ISO

Date : 23/06/2013 Rfrence : Avencall - Installation de XiVO depuis une source ISO Ed1

Historique des versions de document Version 1.0 2.0 Auteur Michel DIAS Michel DIAS date 23/06/2013 08/07/2013 Commentaire Cration Ajout des copies dcran BIOS SB

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

Sommaire
1 2 3 Introduction 4 Tlchargement des sources dinstallation du logiciel XIVO 5 Prparation des cls USB 7 3.1 Cl USB bootable (UNetbootin) ............................................................................. 7 3.1.1 URL de tlchargement 7 3.1.2 Excution de UNetbootin 7 3.2 Cl USB drivers (Office) ......................................................................................... 9 Prparation des environnements physiques 10 4.1 Option de boot sur USB ........................................................................................10 4.1.1 Plateforme XiVO Office 10 4.1.2 Plateforme XiVO Small et Large Business. 11 Prparation des environnements virtuels 13 5.1 Exemple denvironnement virtuel (VirtualBOX)......................................................13 5.1.1 Mmoire du systme 14 5.1.2 Disque dur du systme 14 5.1.3 Nombre de processeur 16 5.1.4 Nombre de cartes rseaux 17 5.1.5 Dmarrez la machine virtuelle 17 Installation de XiVO 19 6.1 Ecrans spcifiques lors de linstallation des serveurs physiques ...........................19 6.2 Ecrans communs ..................................................................................................20 6.3 Installation du clavier franais ...............................................................................25 6.4 Premire connexion au serveur XiVO ...................................................................27 6.5 Wizard de XiVO (5 tapes) ...................................................................................27 6.5.1 Etapes 1 : Ecran de bienvenue et langue par dfaut du systme 27 6.5.2 Etapes 2 : Contrat de licence de XiVO (GPLv3) 28 6.5.3 Etapes 3 : Configuration de base du systme 28 6.5.4 Etapes 4 : Entit et contextes 29 6.5.5 Etapes 5 : validation des configurations 29 Post-installation 30 7.1 Complter linstallation de XiVO ............................................................................30 7.2 Installation dapplication tiers ................................................................................30 7.2.1 Outil danalyse rseau : 30

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

1 Introduction
Le prsent document est une procdure technique dcrivant le processus dinstallation de la solution de tlphonie XiVO depuis une image ISO. Deux environnements sont abords : 1. Installation vers un environnement matriel 2. Installation vers un environnement virtuel A noter que pour linstallation sur un environnement virtuel, une autre documentation est disponible sur le site partenaire dAvencall. Cette seconde procdure prcise notamment les prrequis dinstallation et indique les bonnes pratiques dinstallation qui ne sont pas documentes dans le prsent document.

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

2 Tlchargement logiciel XIVO

des

sources

dinstallation

du

Avant toute chose, il vous faut vous munir de lISO dinstallation de XiVO. Celle-ci est disponible sur le site Internet dAvencall ladresse suivante : http://documentation.xivo.fr

Depuis la page principale, slectionnez le lien

Puis le lien

Puis

Pour finir, cliquez sur le fichier nomm squeeze-xivo-skaro-xx.xx.iso

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

A lavenir, vous pourrez accder directement au tlchargement en tapant ladresse suivante : http://mirror.xivo.fr/iso/xivo-current/.

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

3 Prparation des cls USB

A noter quen fonction des environnements configurer, vous devrez disposer dune ou deux cls USB : La premire sera utilise pour descendre la version de XiVO depuis la source ISO. La seconde sera utilise pour lenregistrement des drivers des cartes rseaux nondisponibles dans lenvironnement de base Debian (serveur Office uniquement).

3.1 Cl USB bootable (UNetbootin)

Cette tape est ncessaire pour effectuer linstallation de XiVO sur un serveur physique. Un CDROM peut galement tre utilis, mais par souci dcologie, nous utiliserons une cl USB bootable afin de lancer linstallation de lapplication XiVO.

3.1.1

URL de tlchargement

Afin de rendre bootable la cl, nous vous proposons dutiliser lapplication UNetbootin. Cette application est disponible pour les plateformes Microsoft, Linux et Mac OS X. Vous pouvez la tlcharger depuis ladresse : http://unetbootin.sourceforge.net/

3.1.2

Excution de UNetbootin

Lancez lapplication UNetbootin, choisissez loption DisqueImage puis slectionnez limage ISO que vous souhaitez installer sur la cl (1).

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

Slectionnez le type de lecteur sur lequel vous souhaitez installer limage ISO (2) et la lettre de lecteur (3). Pour terminer la procdure de cration de la cl, cliquez sur le bouton OK (4).

Confirmer la suppression du contenu de la cl USB en cliquant sur le bouton Yes to All.

Enfin pour finaliser lopration, cliquez sur le bouton Quitter.

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

3.2 Cl USB drivers (Office)

Comme indiqu plus haut, les drivers des cartes rseaux Realtek ne sont pas disponibles en standard dans le noyau de Debian squeeze. Pour les serveurs XiVO Office, vous devrez donc installer ces derniers depuis une source externe. Depuis un navigateur Internet, saisir lURL suivante dans http://packages.debian.org/squeeze/all/firmware-realtek/download la barre dadresse

Tlchargez et copiez le driver Realtek sur la deuxime cl USB.

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

4 Prparation des environnements physiques

4.1 Option de boot sur USB
Dans les paramtres du BIOS du serveur, noubliez pas dactiver les ports USB et priorisez le boot sur les supports USB externes.

4.1.1

Plateforme XiVO Office

Entrez dans le BIOS du systme touches Ctrl + Alt + Suppr, puis connectez votre cl USB, afin quelle soit visible dans les menus du BIOS. Depuis le menu Advanced | USB Configuration, vrifiez que le support USB est activ.

Depuis le menu Boot | Boot Device priority, slectionnez vrifiez lordre de boot des priphriques USB. Votre cl USB doit imprativement tre positionne avant le boot rseau.

Depuis le menu Boot | Hard Disk Drives, slectionnez vrifiez lordre de boot des priphriques USB. Votre cl USB doit imprativement tre positionne avant le disque dur.

Depuis le menu Exit slectionnez loption Save Changes and Exit, pour enregistrez vos modifications.

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

10

4.1.2

Plateforme XiVO Small et Large Business.

Entrez dans le BIOS du systme touches Ctrl + Alt + Suppr, puis connectez votre cl USB, afin quelle soit visible dans les menus du BIOS. Entrez dans le menu Integrated Peripherals

Vrifiez que le support USB est activ.

Vrifiez la prsence de votre cl

Changez Auto mode par HDD mode

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

11

Puis dans le menu Hard Disk Boot, changez lordre de boot et mettre votre cl USB en priorit.

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

12

5 Prparation des environnements virtuels

Le chapitre ci-dessous traite linstallation de lapplication de tlphonie XiVO pour un environnement virtuel Virtual BOX. Dautres environnements peuvent tre utiliss. A le date de cration du document, il est noter que seuls les environnements virtuels VMWare, KVM sont supports en tant quenvironnement de production.

5.1 Exemple denvironnement virtuel (VirtualBOX).

Depuis la console VirtualBox, crez un nouvel environnement.

Dfinissez le nom de lenvironnement, le type et la version du systme. A n oter que la version du systme Debian est une version 32 bits.

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

13

5.1.1

Mmoire du systme

Dfinissez la taille mmoire installer pour le systme. En fonction des environnements et du nombre dutilisateurs la mmoire peut varier de 1 4 Go. Lensemble des prrequis sont disponibles auprs dAvencall dans une documentation ddie aux infrastructures virtuelles. Ce document est rfrenc : XXXXXXXXXXXX

5.1.2

Disque dur du systme

Dfinissez la taille du disque dur installer pour le systme. En fonction des environnements et du nombre dutilisateur le stockage peut varier de 20 500 Go. Lensemble des prrequis sont disponibles auprs dAvencall dans une documentation ddie aux infrastructures virtuelles. Ce document est rfrenc : XXXXXXXXXXXX

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

14

Prcisez le format de stockage de limage virtuelle. Dans le cas de VirtualBox, nous utiliserons le format natif de la solution.

Spcifier la manire dont lhte physique rserve lespace disque allou. Pour maintenir de bonnes performances pour le systme, Avencall prconise dutiliser des stockages allous statiquement pour les environnements de production. Nanmoins, sur les environnements de type maquette, un disque dynamique peut tout fait tre utilis.

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

15

Enfin, prcisez la taille du disque.

5.1.3

Nombre de processeur

Dfinissez le nombre de processeur pour le systme. En fonction des environnements et du nombre dutilisateur la mmoire peut varier de 1 ou 4 processeurs. Lensemble des prrequis sont disponibles auprs dAvencall dans une documentation ddie aux infrastructures virtuelles. Ce document est rfrenc : XXXXXXXXXXXX

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

16

5.1.4 Nombre de cartes rseaux

Dfinissez le nombre de cartes rseau pour le systme. En fonction des environnements le nombre de carte peut varier de 1 3 cartes (LAN Data, LAN Voix, LAN DMZ). Lensemble des prrequis sont disponibles auprs dAvencall dans une documentation ddie aux infrastructures virtuelles. Ce document est rfrenc : XXXXXXXXXXXX

5.1.5

Dmarrez la machine virtuelle

Une fois lensemble des paramtres dfinis dans les paragraphes ci-dessus, vous pouvez procder linstallation du systme. Slectionnez la machine virtuelle (1) et lancez sont excution (2).

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

17

Slectionnez limage ISO tlcharge sur Internet (1), puis dmarrez linstallation (2).

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

18

6 Installation de XiVO
Selon le type denvironnement prpar, lancez le boot depuis la cl USB (physique) ou depuis lISO (virtuel). Dans les 2 cas, les configurations sont identiques et documentes dans les crans de configuration ci-dessous.

6.1 Ecrans spcifiques lors de linstallation des serveurs physiques

Mettre la cl USB gnre avec UNetbootin dans le port USB du serveur XiVO dmarrez la machine. Slectionnez loption Install.

Installation des drivers LAN (plateforme Office) Dans le cas dune installation sur une plateforme Office, insrer dans un autre port USB la deuxime cl contenant les drivers Realtek. Puis choisissez la rponse <Oui>.

Poursuivre linstallation en effectuant les tapes de 2 7. Durant linstallation, vient lcran de partitionnement, slectionnez loption Assist Utiliser tout un disque avec LVM.

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

19

Puis prcisez le disque dur partitionner

Poursuivez ensuite linstallation en retournant ltape 8 du chapitre

6.2 Ecrans communs

Etape 1 : Slectionnez loption Install

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

20

Etape 2 : Prcisez la langue du systme, ex : French

Etape 3 : Prcisez la localisation gographique, ex : France

Etape 4 : Slectionnez la langue du clavier, ex : Franais (fr-latin9)

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

21

Etape 5 : Prcisez le mot de passe du compte root

Etape 6 : Confirmez le mot de passe du compte root

Etape 7 : Linstallation dbute, laisser le systme faire

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

22

Etape 8 : Slectionnez la localisation du pays o les paquets Debian seront tlchargs, ex : France.

Etape 9 : Slectionnez le miroir Debian, ex : ftp.fr.debian.org

Etape 10 : Si le systme est connect sur un rseau utilisant un serveur proxy, prcisez lURL de votre serveur, sinon laissez le champ vide

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

23

Etape 11 : Laissez le systme poursuivre linstallation des paquets

Etape 12 : Une fois linstallation des paquets acheve, connectez-vous en tant que root.

Etape 13 : Si votre systme a t install sur un rseau excutant un serveur DHCP, consulter ladresse IP du serveur par via commande ifconfig

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

24

6.3 Installation du clavier franais

Lors dune installation depuis limage ISO de XiVO, lmulation du clavier est en mode console est QWERTY. Il est possible de changer cette configuration en suivants les procdures ci-dessous : A noter que pour faciliter les manipulations, il est conseill de se connecter en SSH dont lmulation est correcte si les paramtres de langues ont t respects Copiez chaque ligne dans une console SSH (ou PuTTY) en les excutant squentiellement : apt-get install console-data apt-get install console-tools apt-get install console-setup A chaque fois, rpondre par <O> ou <Y> lorsque le systme vous pose la question.

Puis lancez la commande dpkg-reconfigure console-data

Slectionnez loption Choisir un codage clavier dans la liste complte

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

25

Puis slectionnez loption : pc / azerty / French / Same as X11 (latin 9) / Standard

Enfin sur la ligne de commande, saisir la commande echo "SCREEN_FONT=lat0-16" >> /etc/console-tools/config

Puis faire un redmarrage du systme en tapant la commande reboot

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

26

6.4 Premire connexion au serveur XiVO

Depuis la barre dadresse de votre navigateur, saisissez lURL constitue de ladresse IP releve dans la console XiVO, ex : https://192.168.56.101

Le certificat install de base sur le serveur WEB est un certificat non approuv par une autorit de certification publique. Un message de scurit saffiche. Nen tenez pas compte et poursuivez avec le site web.

6.5 Wizard de XiVO (5 tapes)

Le wizard dinstallation de XiVO permet de fixer les configurations de base du systme dans un nombre dtapes limit.

6.5.1 Etapes 1 : Ecran de bienvenue et langue par dfaut du systme

Slectionnez la langue du systme (1), puis passez lcran de configuration suivant (2).

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

27

6.5.2 Etapes 2 : Contrat de licence de XiVO (GPLv3)

Cochez laccord de licence (1), puis passez lcran de configuration suivant (2).

6.5.3 Etapes 3 : Configuration de base du systme

Prcisez le nom dhte de la machine XiVO (1) Prcisez le nom du domaine dans lequel le serveur va tre install (2) Dfinissez le mot de passe du compte root de linterface web (3) Indiquez ladresse IP du serveur, le masque de sous-rseau et ladresse de la passerelle(4) Indiquez les adresses IP des serveurs DNS (5) Passez lcran de configuration suivant (6)

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

28

6.5.4 Etapes 4 : Entit et contextes

Renseignez le nom lentreprise (1) Confirmez le nom du contexte des appels internes et renseignez la plage des numros internes (2) Confirmez le nom du contexte des appels entrants et renseignez la plage des numros externes et le nombre de digits transmis par loprateur (3) Confirmez le nom du contexte des appels sortants (4) Passez lcran de configuration suivant (5)

6.5.5 Etapes 5 : validation des configurations

Vrifier lensemble des paramtres de configuration puis cliquez sur le bouton Valider

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

29

7 Post-installation
7.1 Complter linstallation de XiVO
A lissue de cette procdure dinstallation, Avencall recommande de finaliser la procdure en appliquant les configurations disponibles lURL suivantes : http://documentation.xivo.fr/production/installation/postinstall.html

7.2 Musique dattente

Installer les musiques dattente libre de droit via la commande suivante : apt-get install asterisk-moh-opsound-wav asterisk-moh-opsound-g722 asterisk-mohopsound-gsm

7.3 Activation des logs full

Modifier le fichier /etc/asterisk/logger.conf, en activant les niveaux de logs suivants : console => notice,warning,error,dtmf full => notice,warning,error,debug,verbose,dtmf

7.4 Installation dapplication tiers

7.4.1 Outils danalyse rseau

Analyse de ports : apt-get install nmap

Analyse de trafic : apt-get install mtr

Analyseur de protocole : apt-get install tshark

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

30

FIN DU DOCUMENT

Le 09/07/2013 Rf : Avencall - Installation de XiVO depuis

une source ISO Ed2

31