[ad#vert-banner]

Nachdem alle Schritte aus der Installationsanleitung befolgt wurden, sind folgende Komponenten auf dem System installiert:

• perl (Skriptsprache)
• asterisk (Telefonieserver)
• openVXI (Open Source VoiceXML Interpreter)
• flite (engl. TTS Engine)
• voiceglue (IVR Software)

Um tatsächlich Anrufe über das Telefon- oder auch VoIP Netz entgegen nehmen zu können, muss der asterisk Server konfiguriert werden. Eine vollständige Beschreibung der asterisk Konfiguration würde allerdings den Rahmen dieses Tutorials sprengen. Aus diesem Grund wird lediglich die Konfiguration erklärt, mit er es möglich ist, mit Hilfe eines sogenannten Softphones an der Sprachanwendung anzurufen. Für vielschichtige asterisk Konfigurationen findet man in Asterisk: The Future if Telephony ausreichend Hilfe.

Als erstes benötigen wir für die Annahme von Anrufen via SIP einen eigenen Kontext in der Datei: /etc/asterisk/manager.conf. Die folgenden Zeilen sollte man am besten am Ende der Datei einfügen:

[phoneglue]
secret=phoneglue
read = system,call,log,verbose,command,agent,user
write = system,call,log,verbose,command,agent,user

Ausserdem muss der Manager noch aktiviert werden. Deswegen sollte man sicherstellen, dass in der gleichen Datei die Variable enabled=yes gesetzt ist.

Danach wird asterisk so konfiguriert, dass alle angenommenen Anrufe per AGI an den Voicebrowser weitergeleitet werden. Durch die Verwendung von AGI ist es möglich, den Voicebrowser auch auf einem anderen Server zu betreiben und die Verbindung via Netzwerk herzustellen. Dies nimmt bei vielen Anrufen die Last vom System. Die Konfiguration wird in der Datei /etc/asterisk/extensions.conf vorgenommen. Auch hier ist es wieder sinnvoll einen neuem Kontext am Ende der Datei einzufügen:

[phoneglue]
exten => 1,1,Agi(agi://localhost)
exten => 1,2,Hangup

Die Einträge für die Extensions beginnen mit einer 1. Dies ist die Durchwahl für die Sprachanwendung. Der Aufruf “Agi(agi://localhost) verbindet nun den Voicebrowser mit dem Anrufer.

Möchte man nun alle eingehenden Anrufe, welche mit SIP initiiert werden, an die Sprachanwendung leiten, ist noch eine Änderung in der Datei /etc/asterisk/sip.conf nötig. Der Standard Kontext muss von default auf phoneglue gesetzt werden.

[general]
context=phoneglue

Damit ist die Konfiguration von asterisk schon abgeschlossen. Nun kann es mit der Konfiguration der Sprachanwendung weitergehen.

VoiceXML basierte Sprachanwendungen benötigen einen HTTP Server, welcher die statischen oder dynamisch erzeugten *.vxml Dateien ausliefert. Auch hier haben die Entwickler von VoiceGlue mitgedacht, indem das System so konfigurierbar ist, dass der VoiceXML Server auf einer separaten Maschine laufen kann. Zu Demonstrationszwecken genügt es hier allerdings, dass alle Dienste auf einer Maschine laufen. Die Konfiguration wird in der Datei /etc/voiceglue.conf vorgenommen. Hier genügt ein Eintrag, der auf die Einstiegsseite der Sprachanwendung zeigt.

 * http://localhost/index.vxml

Diese Datei muss vom lokalen Apache ausgeliefert werden. Falls noch nicht geschehen, sollte der Apache jetzt gestartet werden:

sudo service httpd start

Standardmässig liegen die HTML für den Apache unter Fedora im Verzeichnis /var/www/html. Genau an dieser Stelle legen wir eine klassische Hello World Anwendung in Form einer VoiceXML Datei mit folgendem Inhalt ab:

      Hello World. This is my first voiceglue application.

Damit ist die Konfiguration abgeschlossen. Alle Dienste sind vollständig konfiguriert und sollten jetzt gestartet werden.

sudo service asterisk start
sudo service phoneglue start
sudo service voiceglue start

Als letztes wollen wir überprüfen, ob die Komfiguration erfolgreich war. Dazu benötigen wir ein Softphone. Eine freie Version findet man bei SJLabs. Das Telefon ist für Windows, Linux und OS X verfügbar. Nach dem herunterladen muss im Menupunkt Phone->Services das SIP Protolkoll gewählt werden. Anschließend wählen wir unseren lokalen asterisk Dienst mit der Durchwahl 1@localhost an.

Basierend auf der gezeigten Konfiguration lassen sich beliebige Sprachanwendungen erstellen. Wie jedoch schon im Beitrag VoiceGlue Installation – Interactive Voice Response leicht gemacht beschrieben, fehlt die Intergration einer ASR Engine. Somit beschränken sich Anrufereingaben auf DTMF.[/lang_de]

[ad#vert-banner]

Ein erster Blick auf die Installationsanleitung offenbart keine sehr ausführlichen Informationen. Lediglich ein paar Pakete installieren, und fertig. Nun, wir wollen sehen. Die Installation wurde mit Hilfe von Parallels Desktop 3.0 unter Mac OS X vorgenommen. Als Gastbetriebsystem haben wir, wie in der Anleitung empfohlen Fedora Core 8 verwendet.

Nach der Installation von Fedora Core 8 in der VM mit den Standard Optionen fehlen vor allem noch ein Compiler, ein paar Developer Pakete und jede Menge Perl Module. Der bereits installierte Paketmanager YUM wird also gleich bemüht, um alles Fehlende an den Start zu bringen.

sudo yum install perl gcc-c++ libstdc++-devel xerces-c-devel js-devel flite openssl-devel libxml2-devel expat-devel

Soweit noch nicht geschehen, sollte cpan installiert werden. Hiermit lassen sich benötigte Perl Pakete leicht installieren. Eine Anleitung findet man auf der cpan homepage. Es ist jedoch ratsam folgende Pakete gleich mit zu installieren: ncftp, wget

sudo yum install ncftp wget cpan

Nun fehlen noch folgende Perl Module: XML::LibXML, BSD::Resource, Module::Build. Während der Installation von cpan werden mehrere Fragen gestellt, die eigentlich alle, bis auf die Frage nach dem Ort und den Servern, mit “ENTER” bestätigt werden können. Aber genau lesen hat noch nie geschadet. Die Fragen, ob alle benötigten Pakete ebenfalls installiert werden sollen, kann man auch getrost mit “ja” beantworten. Aber man sollte gewarnt sein: Je nach dem, wie viel oder wenig Perl Module schon installiert sind, dauert es unter Umständen bis zu 10 Minuten. Wie sich allerdings herausstellt, gibt es für Module::Build zwei optionale Pakete, die zwar wichtig sind, aber nicht automatisch installiert werden. Aus diesem Grund wird ExtUtils::ParseXS und damit auch ExtUtils::CBuilder zusätzlich installiert.

cpan install Bundle::CPAN
cpan install XML::LibXML
cpan install BSD::Resource
cpan install ExtUtils::ParseXS
cpan install Module::Build

Wenn alle Module erfolgreich installiert wurden, fehlt nur noch der asterisk Dienst. Dieser ist jedoch nicht über das Fedora Repository erhältlich. Deswegen muss in die YUM Konfiguration ein weiteres Repository aufgenommen werden. Dazu wird die Datei /etc/yum.repos.d/atrpms.repo mit folgendem Inhalt angelegt:

[atrpms]
name=Fedora Core $releasever - $basearch - ATrpms
baseurl=http://dl.atrpms.net/f$releasever-$basearch/atrpms/stable
#enabled=1
gpgkey=http://ATrpms.net/RPM-GPG-KEY.atrpms
gpgcheck=1

Anschließend muss noch der GPG Schlüssel für das neue Repository importiert werden:

sudo rpm --import http://ATrpms.net/RPM-GPG-KEY.atrpms

Jetzt kann der asterisk Dienst installiert werden. YUM wird vorschlagen, alle fehlenden Pakete ebenfalls zu installieren:

sudo yum install asterisk

Nachdem nun endlich alle Vorbereitungen für die Installation abgeschlossen sind, sollte das Voiceglue Paket heruntergeladen werden. Nachdem Download einfach entpacken, und los geht der Spass.

tar xvfz voiceglue_0.6.tar.gz
cd voiceglue_0.6
perl doc/install-voiceglue

Sollte das Installationsskript wider Erwarten nicht korrekt durchlaufen, müssen die einzelnen Komponenten per Hand in der richtigen Reihenfolge installiert werden:

• Cam-Scom
• dynlog
• libvglue
• openvxi
• phoneglue
• Satc
• SRGSDTMF
• voiceglue
• Vxglue

In jedem Unterverzeichnis sollte entweder eine Build.pl Datei oder ein build Skript liegen, welches ausgeführt werden muss. Bei Problemen kann ich gerne versuchen zu helfen.

Fazit: Mit der Original Anleitung war die Installation sehr mühsam, weil nicht alle Pakete aufgeführt sind, die benötigt werden. Nach mehrmaligem Zurücksetzen der Virtuellen Maschine konnte ich alle Paketabhängigkeiten herausfinden und auflösen. Die hier beschriebene Lösung funktionierte für mich ohne Probleme. Wie immer ist Feedback sehr willkommen. Für Hinweise und bei Problemen einfach einen Kommentar hinterlassen.