Micromedia International Etude technique Configuration d Alert pour SIP Auteur : Pierre Chevrier Société : Micromedia International Date : 26/08/2013 Nombre de pages : 19 Configuration du driver SIP dans ALERT. V2 Réf. : Guide Install SIP_fr.docx Ce document précise comment configurer ALERT pour utiliser le driver SIP pour VoIP. Le driver utilisé est le driver en version 2.0.0.0 et supérieures. Diffusion A CC Société Documents joints : 26/08/2013 ALERT et driver SIP v2.0 1/19
Parmi tous les média disponibles pour réaliser les appels avec ALERT, le driver VoIP offre la possibilité de s interfacer avec des équipements de téléphonie sur IP conformément au protocole SIP (Session Initiation Protocol). Ce document décrit la configuration du driver SIP d Alert et des opérateurs d astreinte utilisant ce média. Pré requis La VoIP (Voice Over IP), comme son nom l indique repose sur le protocole IP. Une interface réseau IP est donc nécessaire pour l utilisation de ce driver. Le driver VoIP d Alert est soumis à licence, les 2 premières licences sont gratuites. L utilisateur doit avoir acquis une licence en fonction du nombre d appels simultanés (via SIP) souhaités. Les équipements qu Alert peut contacter via VoIP doivent être compatibles avec le protocole SIP, ils peuvent être des téléphones, des PBX, des SoftPhone Ces équipements doivent respecter les caractéristiques suivantes : Spécifications techniques : Le protocole SIP supporté : RFC 3261 Les formats audio gérés : G711 Mu Law et G711 A Law Gestion des DTMF : RFC 2833, SIP INFO. 26/08/2013 ALERT et driver SIP v2.0 2/19
Configuration d ALERT Cette partie présente la boite de configuration du driver, puis la boite de configuration des opérateurs. Présentation du driver La configuration du driver se fait grâce à sa boite de propriétés. Menu «Configuration / Communication». Puis choisir l onglet «Drivers». Sélectionner le driver «VoIP Driver (SIP)» et presser «Propriétés». La boite de propriétés du driver s affiche alors. 26/08/2013 ALERT et driver SIP v2.0 3/19
Les différents onglets vont permettre d accéder aux différentes rubriques d options. Onglet SIP Comme le montre la capture d écran précédente, cet onglet présente les options de configuration pour s adapter à l architecture téléphonique. Suivant l installation téléphonique, trois types de configurations de détachent : - Configuration sans proxy - Configuration avec proxy sans enregistrement (Registar) - Configuration avec enregistrement Ces trois types de configuration seront décrits par la suite. Il est possible de renseigner deux adresses de proxy SIP. Les mêmes données d authentification seront utilisées sur les deux proxies. ALERT basculera sur le proxy secondaire lors d une perte de lien avec le proxy principal, dans le cas d une configuration avec enregistrement. Dans les autres modes de configuration, le basculement se fera si le proxy principal ne répond plus aux requêtes (408, request timeout). 26/08/2013 ALERT et driver SIP v2.0 4/19
26/08/2013 ALERT et driver SIP v2.0 5/19
Onglet Connexion Cet onglet permet de configurer la connexion IP utilisée pour les appels SIP. Il est possible de choisir le protocole de transport utilisé (TCP ou UDP) ainsi que le port IP à utiliser. Cet écran permet également de choisir la carte réseau qui servira pour les appels. 26/08/2013 ALERT et driver SIP v2.0 6/19
Onglet Alert Les options disponibles ici permettent de définir les interactions avec ALERT. - Le nombre d appels simultanés qu ALERT peut effectuer. (Cette valeur est également limitée par la licence SIP). Si le PBX limite les appels simultanés, il faudra utiliser ce champ. - Les traces dans le journal d Alert affichent les messages envoyés via le driver SIP. - Le temps maximum de communication permet de limiter l occupation du canal SIP par ALERT à un temps donné. - Il est possible de choisir le fonctionnement vocal du driver. Soit les opérateurs appelés sont connectés au serveur vocal d ALERT, soit le driver leur diffuse uniquement le message vocal : c est le Bip Vocal. Il est également possible de n envoyer aucun message vocal. Ceci peut être utilisé pour l envoi de messages texte en conjonction avec l option suivante. - L affichage texte permet d utiliser la présentation du nom (fonctionnalité de téléphone et/ou du PBX) pour afficher soit le numéro de l appelant (ALERT), soit le message de l alarme (Message long ou message court). Ne fonctionne pas en mode proxy avec enregistrement. - Il est possible de sélectionner une alarme interne d ALERT (à définir auparavant) si le lien avec le PBX est perdu. (Enregistrement coupé, appels impossibles ). 26/08/2013 ALERT et driver SIP v2.0 7/19
Onglet avancé Cet onglet permet de configurer les options avancées du driver. 26/08/2013 ALERT et driver SIP v2.0 8/19
Configuration du numéro d appel Au niveau de la fiche opérateur, les numéros d appel à fournir doivent être associés au driver VoIP. Voici un exemple de configuration de numéro sip. Ces numéros vont également être dépendants de l installation téléphonique. 26/08/2013 ALERT et driver SIP v2.0 9/19
Configurations en fonction de l architecture Cette partie montre plusieurs architectures téléphoniques type. Pour chacune, un exemple décrira les paramètres à utiliser. Les paramètres à modifier se trouvent dans l onglet SIP. Pour l onglet connexion, les valeurs à indiquer sont les valeurs par défaut du protocole. L adresse IP à choisir est celle qu à la machine sur le réseau où se trouvent les équipements à contacter. C est aussi l adresse qui sera utilisée par les équipements pour appeler ALERT. Ces paramètres ne changent pas selon l architecture. Configuration sans proxy Dans ce type de configuration, ALERT appelle directement les téléphones ou softphones SIP. Comme il n y a aucun intermédiaire (PBX ou proxy) pour assurer le routage des appels, ALERT doit connaitre les adresses IP de chaque équipement. Il est possible d utiliser la présentation du nom pour envoyer des messages textes dans ce mode. Téléphone SIP IP : 192.168.0.2 Téléphone SIP IP : 192.168.0.3 Appel de : Sip:alert@192.168.0.1 TCP/IP Appel de : Sip:username@192.168.0.2 Serveur ALERT IP : 192.168.0.1 Driver SIP Pour la configuration du driver, voici un exemple pour une installation sans proxy. 26/08/2013 ALERT et driver SIP v2.0 10/19
L uri de l utilisateur correspond au numéro d appel d ALERT depuis les téléphones SIP. L uri est dans sa forme générale du type : «Nom affiché»<sip:nom@domaine>. Fiche opérateur Concernant le paramétrage des opérateurs d astreinte : Pour le numéro à appeler, il faut indiquer l adresse sip complète (uri) du correspondant : Sip:username@ipaddress:port Le port est optionnel si on utilise le port sip par défaut : 5060. 26/08/2013 ALERT et driver SIP v2.0 11/19
Exemples d utilisation Ce type de configuration est utilisé pour de petites installations ou pour du test. Les équipements SIP ne sont pas gérés de façon centralisée. Ce type de configuration peut également permettre d avoir une softphone sur la même machine qu ALERT. Dans ce cas, il faudra fixer le port pour le transport sip en 5080 par exemple pour ALERT et 5060 pour le softphone. Les deux programmes pourront alors cohabiter. Alert appelera l adresse sip:username@192.168.0.1 Le softphone appelera ALERT au sip:alert@192.168.0.1:5080 26/08/2013 ALERT et driver SIP v2.0 12/19
Configuration avec proxy sans enregistrement Avec cette architecture, ALERT n a plus besoin de connaitre les adresses IP des téléphones. Le proxy s il est un IPBX gère en général la correspondance, numéro d appel vs adresse IP. La configuration au niveau des opérateurs est simplifiée : il suffit de renseigner leur numéro de téléphone. Avec ce type d installation, les uri sont toutes du type : sip:username@realm où le champ realm est le nom du domaine sip (en général l adresse du proxy ou le nom de la machine) et le champ username est un numéro de téléphone. Dans ce cas de figure, tous les établissements d appels passent par le proxy. Du point de vue du PBX, ALERT se comporte comme un trunk SIP. Il est possible d utiliser la présentation du nom pour envoyer des messages textes dans ce mode. Téléphone SIP IP : 192.168.0.2 N :1010 Téléphone SIP IP : 192.168.0.3 N :1011 Appel de : Sip:1001@192.168.0.10 TCP/IP Proxy SIP IP : 192.168.0.10 Appel de : Sip:1010@192.168.0.10 Serveur ALERT IP : 192.168.0.1 N : 1001 26/08/2013 ALERT et driver SIP v2.0 13/19
Driver SIP Il faut ici renseigner le champ concernant le proxy. L uri de l utilisateur peut, comme dans l exemple suivant, être un numéro de téléphone. L uri est dans sa forme générale du type : «Nom affiché»<sip:nom@domaine>. Fiche opérateur C est dans la fiche opérateur que la configuration est nettement simplifiée. Comme toutes les adresses ont le même proxy, ALERT offre la possibilité de renseigner l uri complète comme pour la configuration sans proxy ou seulement le numéro de téléphone. Dans notre cas : sip:1010@192.168.0.10 ou simplement 1010. 26/08/2013 ALERT et driver SIP v2.0 14/19
Exemple d utilisation C est le type de configuration à utiliser avec le Cisco CallManager. Le CallManager est le proxy. La table de correspondance entre numéros de téléphone et adresses IP est gérée par le proxy. ALERT doit également disposer d un numéro de téléphone si les opérateurs veulent contacter le serveur vocal de l application. Cette configuration correspond également à l utilisation de la passerelle MV-310 VoIP/GSM. Dans ce cas, le proxy est la passerelle, mais ALERT ne peut alors appeler que via cette passerelle. 26/08/2013 ALERT et driver SIP v2.0 15/19
Configuration avec enregistrement Ce type d installation autorise des adresses IP dynamiques. Chaque équipement (y compris ALERT) s enregistre au démarrage auprès du registar sip. Ce dernier est souvent le proxy. Le fonctionnement est le même qu avec le proxy seul La différence est que la correspondance IP/numéros de téléphone est faite dynamiquement. C est généralement le PBX qui décide dans du nom affiché dans ce cas de figure. Il sera donc souvent impossible d utiliser ce mode pour envoyer des messages textes via la présentation du nom. Téléphone SIP N :1010 Téléphone SIP N :1011 Appel de : Sip:1001@192.168.0.10 TCP/IP Proxy SIP / REGISTAR IP : 192.168.0.10 Appel de : Sip:1010@192.168.0.10 Serveur ALERT N : 1001 Driver SIP Dans ce cas, il faut renseigner les données d identifications fournies par le gestionnaire de la téléphonie. Dans notre cas, ALERT s enregistre avec son login et mot de passe pour le numéro d appel 1001. 26/08/2013 ALERT et driver SIP v2.0 16/19
Fiche opérateur La configuration de la fiche opérateur est identique à la configuration avec proxy. Les adresses d appel sont du type : sip:1010@192.168.0.10 ou simplement 1010. 26/08/2013 ALERT et driver SIP v2.0 17/19
Exemple d utilisation Avec un abonnement auprès d un fournisseur SIP. La configuration du driver dépend alors des données fournies par le provider. Avec Asterisk ou un autre IPBX. C est cette fois l administrateur du système téléphonique qui fournit les données à renseigner dans ALERT. 26/08/2013 ALERT et driver SIP v2.0 18/19
Résolution des problèmes Cette partie donne les informations nécessaires à la résolution des problèmes rencontrés les plus courants. Le driver n a pas pu être initialisé (code 1) : Le port IP utilisé par le driver peut être déjà utilisé par un autre logiciel. Dans l onglet Connexion, changer la valeur du port. Le téléphone sonne, mais aucun son n est joué : Vérifier que la carte réseau utilisée soit la bonne. Dans l écran Connexion, vérifier l adresse IP de la carte utilisée. Cette adresse doit pouvoir accéder au réseau de téléphonie IP. Le fichier X n a pas pu être joué (code 4) : Le format audio du fichier n est pas supporté par ALERT. Vérifier le format du fichier en question. Ce format doit être du PCM mono en 8 ou 16 bits. 26/08/2013 ALERT et driver SIP v2.0 19/19