Avencall - Installation de XiVO Depuis Une Source ISO Ed2

Installation de XiVO depuis une source ISO

Date : 23/06/2013 Référence : Avencall - Installation de XiVO depuis une source ISO Ed1

Le 09/07/2013 – Réf : Avencall - Installation de XiVO depuis une source ISO Ed2 2

Historique des versions de document

Version Auteur date Commentaire

1.0 Michel DIAS 23/06/2013 Création

2.0 Michel DIAS 08/07/2013 Ajout des copies d’écran BIOS SB


Sommaire 1 Introduction 4 2 Téléchargement des sources d’installation du logiciel XIVO 5 3 Préparation des clés USB 7

3.1 Clé USB bootable (UNetbootin) ............................................................................. 7 3.1.1 URL de téléchargement 7 3.1.2 Exécution de UNetbootin 7

3.2 Clé USB drivers (Office) ......................................................................................... 9 4 Préparation 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

5 Préparation des environnements virtuels 13 5.1 Exemple d’environnement virtuel (VirtualBOX)......................................................13

5.1.1 Mémoire du système 14 5.1.2 Disque dur du système 14 5.1.3 Nombre de processeur 16 5.1.4 Nombre de cartes réseaux 17 5.1.5 Démarrez la machine virtuelle 17

6 Installation de XiVO 19 6.1 Ecrans spécifiques lors de l’installation des serveurs physiques ...........................19 6.2 Ecrans communs ..................................................................................................20 6.3 Installation du clavier français ...............................................................................25 6.4 Première connexion au serveur XiVO ...................................................................27 6.5 Wizard de XiVO (5 étapes) ...................................................................................27

6.5.1 Etapes 1 : Ecran de bienvenue et langue par défaut du système 27 6.5.2 Etapes 2 : Contrat de licence de XiVO (GPLv3) 28 6.5.3 Etapes 3 : Configuration de base du système 28 6.5.4 Etapes 4 : Entité et contextes 29 6.5.5 Etapes 5 : validation des configurations 29

7 Post-installation 30 7.1 Compléter l’installation de XiVO ............................................................................30 7.2 Installation d’application tiers ................................................................................30

7.2.1 Outil d’analyse réseau : 30


1 I n t roduc t ion

Le présent document est une procédure technique décrivant le processus d’installation de la solution de téléphonie XiVO depuis une image ISO. Deux environnements sont abordés :

1. Installation vers un environnement matériel 2. Installation vers un environnement virtuel

A noter que pour l’installation sur un environnement virtuel, une autre documentation est disponible sur le site partenaire d’Avencall. Cette seconde procédure précise notamment les prérequis d’installation et indique les bonnes pratiques d’installation qui ne sont pas documentées dans le présent document.


2 Té lé chargement des sources d ’ i n s t a l l a t i on du l og i c i e l X IVO

Avant toute chose, il vous faut vous munir de l’ISO d’installation de XiVO. Celle-ci est disponible sur le site Internet d’Avencall à l’adresse suivante : http://documentation.xivo.fr

Depuis la page principale, sélectionnez le lien

Puis le lien

Puis

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

http://documentation.xivo.fr/


A l’avenir, vous pourrez accéder directement au téléchargement en tapant l’adresse suivante : http://mirror.xivo.fr/iso/xivo-current/.

http://mirror.xivo.fr/iso/xivo-current/


3 Prépar a t ion de s c l é s USB

A noter qu’en fonction des environnements à configurer, vous devrez disposer d’une ou deux clés USB :

La première sera utilisée pour descendre la version de XiVO depuis la source ISO.

La seconde sera utilisée pour l’’enregistrement des drivers des cartes réseaux non-disponibles dans l’environnement de base Debian (serveur Office uniquement).

3 . 1 C l é USB boo t a b l e (UNe t boo t i n )

Cette étape est nécessaire pour effectuer l’installation de XiVO sur un serveur physique. Un CDROM peut également être utilisé, mais par souci d’écologie, nous utiliserons une clé USB bootable afin de lancer l’installation de l’application XiVO.

3.1.1 URL de téléchargement

Afin de rendre bootable la clé, nous vous proposons d’utiliser l’application UNetbootin. Cette application est disponible pour les plateformes Microsoft, Linux et Mac OS X. Vous pouvez la télécharger depuis l’adresse : http://unetbootin.sourceforge.net/

3.1.2 Exécution de UNetbootin

Lancez l’application UNetbootin, choisissez l’option DisqueImage puis sélectionnez l’image ISO que vous souhaitez installer sur la clé (1).

http://unetbootin.sourceforge.net/


Sélectionnez le type de lecteur sur lequel vous souhaitez installer l’image ISO (2) et la lettre de lecteur (3). Pour terminer la procédure de création 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 l’opération, cliquez sur le bouton Quitter.


3 . 2 C l é USB d r i v e r s (O f f i c e )

Comme indiqué plus haut, les drivers des cartes réseaux 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 l’URL suivante dans la barre d’adresse http://packages.debian.org/squeeze/all/firmware-realtek/download

Téléchargez et copiez le driver Realtek sur la deuxième clé USB.

http://packages.debian.org/squeeze/all/firmware-realtek/download


4 Prépara t ion de s env i ronnement s phys ique s

4 . 1 Opt i on d e b oo t s u r USB

Dans les paramètres du BIOS du serveur, n’oubliez pas d’activer les ports USB et priorisez le boot sur les supports USB externes.

4.1.1 Plateforme XiVO Office

Entrez dans le BIOS du système touches Ctrl + Alt + Suppr, puis connectez votre clé USB, afin qu’elle soit visible dans les menus du BIOS. Depuis le menu Advanced | USB Configuration, vérifiez que le support USB est activé.

Depuis le menu Boot | Boot Device priority, sélectionnez vérifiez l’ordre de boot des périphériques USB. Votre clé USB doit impérativement être positionnée avant le boot réseau.

Depuis le menu Boot | Hard Disk Drives, sélectionnez vérifiez l’ordre de boot des périphériques USB. Votre clé USB doit impérativement être positionnée avant le disque dur.

Depuis le menu Exit sélectionnez l’option Save Changes and Exit, pour enregistrez vos modifications.


4.1.2 Plateforme XiVO Small et Large Business.

Entrez dans le BIOS du système touches Ctrl + Alt + Suppr, puis connectez votre clé USB, afin qu’elle soit visible dans les menus du BIOS. Entrez dans le menu Integrated Peripherals

Vérifiez que le support USB est activé.

Vérifiez la présence de votre clé

Changez Auto mode par HDD mode


Puis dans le menu Hard Disk Boot, changez l’ordre de boot et mettre votre clé USB en priorité.


5 Prépara t ion de s env i ronnement s v i r tue l s

Le chapitre ci-dessous traite l’installation de l’application de téléphonie XiVO pour un environnement virtuel Virtual BOX. D’autres environnements peuvent être utilisés. A le date de création du document, il est à noter que seuls les environnements virtuels VMWare, KVM sont supportés en tant qu’environnement de production.

5 . 1 Ex emp l e d ’ e n v i r onn emen t v i r t u e l (V i r t u a l BOX ) .

Depuis la console VirtualBox, créez un nouvel environnement.

Définissez le nom de l’environnement, le type et la version du système. A noter que la version du système Debian est une version 32 bits.


5.1.1 Mémoire du système

Définissez la taille mémoire à installer pour le système. En fonction des environnements et du nombre d’utilisateurs la mémoire peut varier de 1 à 4 Go. L’ensemble des prérequis sont disponibles auprès d’Avencall dans une documentation dédiée aux infrastructures virtuelles. Ce document est référencé : XXXXXXXXXXXX

5.1.2 Disque dur du système

Définissez la taille du disque dur à installer pour le système. En fonction des environnements et du nombre d’utilisateur le stockage peut varier de 20 à 500 Go. L’ensemble des prérequis sont disponibles auprès d’Avencall dans une documentation dédiée aux infrastructures virtuelles. Ce document est référencé : XXXXXXXXXXXX


Précisez le format de stockage de l’image virtuelle. Dans le cas de VirtualBox, nous utiliserons le format natif de la solution.

Spécifier la manière dont l’hôte physique réserve l’espace disque alloué. Pour maintenir de bonnes performances pour le système, Avencall préconise d’utiliser des stockages alloués statiquement pour les environnements de production. Néanmoins, sur les environnements de type maquette, un disque dynamique peut tout à fait être utilisé.


Enfin, précisez la taille du disque.

5.1.3 Nombre de processeur

Définissez le nombre de processeur pour le système. En fonction des environnements et du nombre d’utilisateur la mémoire peut varier de 1 ou 4 processeurs. L’ensemble des prérequis sont disponibles auprès d’Avencall dans une documentation dédiée aux infrastructures virtuelles. Ce document est référencé : XXXXXXXXXXXX


5.1.4 Nombre de cartes réseaux

Définissez le nombre de cartes réseau pour le système. En fonction des environnements le nombre de carte peut varier de 1 à 3 cartes (LAN Data, LAN Voix, LAN DMZ). L’ensemble des prérequis sont disponibles auprès d’Avencall dans une documentation dédiée aux infrastructures virtuelles. Ce document est référencé : XXXXXXXXXXXX

5.1.5 Démarrez la machine virtuelle

Une fois l’ensemble des paramètres définis dans les paragraphes ci-dessus, vous pouvez procéder à l’installation du système. Sélectionnez la machine virtuelle (1) et lancez sont exécution (2).


Sélectionnez l’image ISO téléchargée sur Internet (1), puis démarrez l’installation (2).


6 I n s t a l l a t i on de X iVO

Selon le type d’environnement préparé, lancez le boot depuis la clé USB (physique) ou depuis l’ISO (virtuel). Dans les 2 cas, les configurations sont identiques et documentées dans les écrans de configuration ci-dessous.

6 . 1 Ec r an s sp é c i f i qu e s l o r s d e l ’ i n s t a l l a t i o n de s s e r v eu r s ph y s i que s

Mettre la clé USB générée avec UNetbootin dans le port USB du serveur XiVO démarrez la machine. Sélectionnez l’option Install.

Installation des drivers LAN (plateforme Office) Dans le cas d’une installation sur une plateforme Office, insérer dans un autre port USB la deuxième clé contenant les drivers Realtek. Puis choisissez la réponse <Oui>.

Poursuivre l’installation en effectuant les étapes de 2 à 7…. Durant l’installation, vient l’écran de partitionnement, sélectionnez l’option Assisté – Utiliser tout un disque avec LVM.


Puis précisez le disque dur à partitionner

Poursuivez ensuite l’installation en retournant à l’étape 8 du chapitre…

6 . 2 Ec r an s c ommuns

Etape 1 : Sélectionnez l’option Install


Etape 2 : Précisez la langue du système, ex : French

Etape 3 : Précisez la localisation géographique, ex : France

Etape 4 : Sélectionnez la langue du clavier, ex : Français (fr-latin9)


Etape 5 : Précisez le mot de passe du compte root

Etape 6 : Confirmez le mot de passe du compte root

Etape 7 : L’installation débute, laisser le système faire…


Etape 8 : Sélectionnez la localisation du pays où les paquets Debian seront téléchargés, ex : France.

Etape 9 : Sélectionnez le miroir Debian, ex : ftp.fr.debian.org

Etape 10 : Si le système est connecté sur un réseau utilisant un serveur proxy, précisez l’URL de votre serveur, sinon laissez le champ vide


Etape 11 : Laissez le système poursuivre l’installation des paquets…

Etape 12 : Une fois l’installation des paquets achevée, connectez-vous en tant que root.

Etape 13 : Si votre système a été installé sur un réseau exécutant un serveur DHCP, consulter l’adresse IP du serveur par via commande ifconfig


6 . 3 I n s t a l l a t i o n du c l a v i e r f r a n ça i s

Lors d’une installation depuis l’image ISO de XiVO, l’émulation du clavier est en mode console est QWERTY. Il est possible de changer cette configuration en suivants les procédures ci-dessous : A noter que pour faciliter les manipulations, il est conseillé de se connecter en SSH dont l’émulation est correcte si les paramètres de langues ont été respectés Copiez chaque ligne dans une console SSH (ou PuTTY) en les exécutant séquentiellement : apt-get install console-data apt-get install console-tools apt-get install console-setup A chaque fois, répondre par <O> ou <Y> lorsque le système vous pose la question.

Puis lancez la commande dpkg-reconfigure console-data

Sélectionnez l’option Choisir un codage clavier dans la liste complète


Puis sélectionnez l’option : 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 redémarrage du système en tapant la commande reboot


6 . 4 P r em i è r e c onn ex i on a u s e r v eu r X iVO

Depuis la barre d’adresse de votre navigateur, saisissez l’URL constituée de l’adresse IP relevée 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 sécurité s’affiche. N’en tenez pas compte et poursuivez avec le site web.

6 . 5 Wiza r d d e X iVO (5 é t ap e s )

Le wizard d’installation de XiVO permet de fixer les configurations de base du système dans un nombre d’étapes limité.

6.5.1 Etapes 1 : Ecran de bienvenue et langue par défaut du système

Sélectionnez la langue du système (1), puis passez à l’écran de configuration suivant (2).


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

Cochez l’accord de licence (1), puis passez à l’écran de configuration suivant (2).

6.5.3 Etapes 3 : Configuration de base du système

Précisez le nom d’hôte de la machine XiVO (1)

Précisez le nom du domaine dans lequel le serveur va être installé (2)

Définissez le mot de passe du compte root de l’interface web (3)

Indiquez l’adresse IP du serveur, le masque de sous-réseau et l’adresse de la passerelle(4)

Indiquez les adresses IP des serveurs DNS (5)

Passez à l’écran de configuration suivant (6)


6.5.4 Etapes 4 : Entité et contextes

Renseignez le nom l’entreprise (1)

Confirmez le nom du contexte des appels internes et renseignez la plage des numéros internes (2)

Confirmez le nom du contexte des appels entrants et renseignez la plage des numéros externes et le nombre de digits transmis par l’opérateur (3)

Confirmez le nom du contexte des appels sortants (4)

Passez à l’écran de configuration suivant (5)

6.5.5 Etapes 5 : validation des configurations

Vérifier l’ensemble des paramètres de configuration puis cliquez sur le bouton Valider


7 Pos t - in s t a l l a t i on

7 . 1 Comp l é t e r l ’ i n s t a l l a t i on d e X iVO

A l’issue de cette procédure d’installation, Avencall recommande de finaliser la procédure en appliquant les configurations disponibles à l’URL suivantes : http://documentation.xivo.fr/production/installation/postinstall.html

7 . 2 Mus i qu e d ’ a t t en t e

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

7 . 3 Ac t i v a t i on de s l o g s f u l l

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 I n s t a l l a t i o n d ’ app l i c a t i on t i e r s

7.4.1 Outils d’analyse réseau

Analyse de ports :

apt-get install nmap Analyse de trafic :

apt-get install mtr Analyseur de protocole :

apt-get install tshark

http://documentation.xivo.fr/production/installation/postinstall.html


FIN DU DOCUMENT

Documents

Avencall - Installation de XiVO Depuis Une Source ISO Ed2