Installation der Asterisk PBX und der Asterisk Web-basierten Bereitstellungs-GUI unter Linux

Ich habe von Asterisk gelesen und wollte es ausprobieren, da ich es bald bei der Arbeit verwalten/fehlerbeheben werde. Also dachte ich, ich lege los und sammle einige grundlegende Erfahrungen damit. Zuerst habe ich eine Box mit Linux RedHat ES4 eingerichtet, aber ich denke, jede Linux-Distribution würde funktionieren. Kubuntu/Ubuntu, Fedora oder Mandriva würden gut funktionieren.

Hier geht’s:

Installieren Sie Linux und notieren Sie sich die IP-Adresse der Box.
Wechseln Sie zu root, und laden Sie die aktuellen Tar-Dateien von http://downloads.digium.com/pub nach /usr/src herunter:

Asterisk nach /asterisk
Zaptel nach /zaptel
Libpri nach /libpri
asterisk-addons nach /asterisk-addons

Befolgen Sie die folgenden Befehle, um jedes Paket in /usr/src zu entpacken (in diesem Beispiel verwende ich Versionen, die aktuell waren; ändern Sie die Versionsnummern auf die Versionen, die Sie heruntergeladen haben):

tar -zxvf asterisk-1.4.4.tar.gz  
ln -s asterisk-1.4.4 asterisk  
tar -zxvf zaptel-1.4.2.1.tar.gz  
ln -s zaptel-1.4.2.1 zaptel  
tar -zxvf libpri-1.4.0.tar.gz  
mv libpri-1.4.0 libpri  
tar -zxvf asterisk-addons-1.4.1.tar.gz  
mv asterisk-addons-1.4.1 asterisk-addons

Beginnen Sie mit der Installation der verschiedenen Pakete, indem Sie diese Befehle als root ausführen:

Sollte vor dem Erstellen von Asterisk ausgeführt werden (HINWEIS: Möglicherweise müssen Sie neu starten, wenn Sie Fehler über fehlende Kernelquellen sehen.):

cd /usr/src/zaptel  
./configure  
make menuselect (stellen Sie sicher, dass Ihr Terminalfenster auf mindestens 80x21 eingestellt ist, da der Menüauswahlbefehl sonst einen Fehler ausgibt)  
make  
make config

Optional (ich habe es trotzdem gemacht): Wenn Sie Zaptel-Digitalkarten haben:

cd ../libpri  
make clean  
make install

Muss nach Zaptel und (falls benötigt) libpri installiert werden (ich habe das auch gemacht):

cd ../asterisk  
./configure  
make menuselect # für zusätzliche Konfiguration  
make  
make install  
make samples  
make config

Optional. Sollte nach der Installation von Asterisk ausgeführt werden:

cd ../asterisk-addons  
./configure  
make  
make install

Jetzt ist ein guter Zeitpunkt, um einige Dateien zu sichern. Sichern Sie sowohl sip.conf als auch extensions.conf, die sich im Ordner /etc/asterisk befinden, indem Sie diese Befehle ausführen:

cd /etc/asterisk  
cp sip.conf sip.backup  
cp extensions.conf extensions.backup

Jetzt, da alles installiert ist (es sei denn, Sie haben Fehler erhalten; wenn ja, gehen Sie zu linuxforums.org und posten Sie dort Nachrichten mit Ihren Problemen [BESTES LINUX-FORUM ÜBERHAUPT!]), ist es jetzt an der Zeit, Asterisk zum ersten Mal zu starten, indem Sie diesen Befehl eingeben:

cd /usr/sbin  
asterisk -vvvvgc (dies wird im Debug-Modus gestartet, was gut ist, um Fehler zu finden)

Es gibt mehrere Erweiterungen, die bereits in der Grundinstallation vorkonfiguriert sind, und hier sind sie:

Erweiterung: 1000 (die erste, die Sie ausprobieren sollten!)
Erweiterung: 1234 (ist eine Erweiterung. Rufen Sie vmail an und geben Sie dies als Erweiterung und das Passwort 4242 ein)
Erweiterung: 1235 (wählen Sie dies und hinterlassen Sie sich eine Nachricht)
Erweiterung: 1236 (eine weitere Erweiterung)
Haupt-Vmail: 8500
Externer Test für SIP-Anruf: 500
Echo-Test: 600

Rufen Sie diese mit einem SIP-Telefon wie X-Lite oder einem SIP-fähigen Tischtelefon wie dem Mitel 5212/5224 an. Um einen Anruf zu tätigen, geben Sie die Erweiterung # gefolgt vom @-Zeichen und der IP-Adresse der Box ein, die die Asterisk-Software ausführt. Stellen Sie sicher, dass die Firewall deaktiviert ist oder so konfiguriert ist, dass sie den Port 5060 eingehend/ausgehend zulässt.

HERZLICHEN GLÜCKWUNSCH! Sie haben es geschafft!

Asterisk-Manager

Es gibt auch einen Asterisk-Manager. Um dies zu aktivieren, müssen Sie die /etc/asterisk/manager.conf bearbeiten und die vier Zeilen unten durch Entfernen des ; aktivieren:

;[mark] (dies ist der Benutzername, der im astman verwendet werden soll)
;secret = mysecret (dies ist das Passwort, das im astman verwendet werden soll)
;read = system,call,log,verbose,command,agent,user,config
;write = system,call.log,verbose,command,agent,user,config

sodass es so aussieht:

[mark] (dies ist der Benutzername, der im astman verwendet werden soll)  
secret = mysecret (dies ist das Passwort, das im astman verwendet werden soll)  
read = system,call,log,verbose,command,agent,user,config  
write = system,call.log,verbose,command,agent,user,config

Speichern Sie die Datei.

Sie müssen auch Asterisk neu starten. Um dies zu tun, geben Sie an der CLI-Eingabeaufforderung ein:

restart

Jetzt.

Sobald Asterisk neu gestartet wurde, können Sie an der CLI-Eingabeaufforderung manager show users eingeben, um zu erfahren, welche Managerbenutzer konfiguriert sind; unser Benutzer ist also mark mit dem Passwort mysecret.

Öffnen Sie nun ein neues Terminalfenster, wechseln Sie zu root und geben Sie ein:

/usr/sbin/astman localhost

Benutzername = mark
Passwort = mysecret

Rufen Sie 1000 an, und Sie werden Ihren Anruf dort sehen.

Sie können auch die Webversion namens AJAM verwenden:

Asynchroner Javascript Asterisk-Manager (AJAM)

AJAM ist eine neue Technologie, die in Asterisk 1.4 verfügbar ist und es Webbrowsern oder anderen HTTP-fähigen Anwendungen und Webseiten ermöglicht, direkt über HTTP auf die Asterisk-Manager-Schnittstelle (AMI) zuzugreifen. Die Einrichtung Ihres Servers zur Verarbeitung von AJAM umfasst einige Schritte:

Richten Sie den Asterisk-HTTP-Server ein:

Kommentieren Sie die Zeile enabled=yes in /etc/asterisk/http.conf aus, um den integrierten Mikro-HTTP-Server von Asterisk zu aktivieren.
Wenn Sie möchten, dass Asterisk tatsächlich einfache HTML-Seiten, CSS, JavaScript usw. liefert, sollten Sie enablestatic=yes auskommentieren.
Passen Sie Ihre bindaddr- und bindport-Einstellungen entsprechend Ihrer gewünschten Zugänglichkeit an oder lassen Sie sie als Standard.
Passen Sie Ihr Präfix an, falls erforderlich, das am Anfang jeder URI auf dem Server übereinstimmen muss. Der Standardwert ist asterisk, und der Rest dieser Anweisungen geht von diesem Wert aus.

Managerzugriff über HTTP erlauben

Stellen Sie sicher, dass sowohl enabled = yes als auch webenabled = yes in /etc/asterisk/manager.conf eingerichtet sind.
Sie können auch httptimeout verwenden, um einen Standard-Timeout für HTTP-Verbindungen festzulegen.
Stellen Sie sicher, dass Sie einen Manager-Benutzernamen/Passwort haben.

Sobald diese Konfigurationsänderungen abgeschlossen sind, können Sie Asterisk neu laden oder neu starten, und Sie sollten in der Lage sein, Ihren Webbrowser auf bestimmte URIs zu richten, die Ihnen den Zugriff auf verschiedene Webfunktionen ermöglichen. Eine vollständige Liste finden Sie, indem Sie show http an der Asterisk-CLI eingeben.

Beispiele:

http://localhost:8088/asterisk/manager?action=login&username=mark&secret=mysecret

Dies meldet Sie in der “HTML”-Ansicht der Manageroberfläche an. Sobald Sie angemeldet sind, speichert Asterisk ein Cookie in Ihrem Browser (gültig für die Dauer von httptimeout), das verwendet wird, um sich mit derselben Sitzung zu verbinden.

http://localhost:8088/asterisk/rawman?action=status

Vorausgesetzt, Sie haben sich bereits beim Manager angemeldet, gibt Ihnen diese URI eine “raw”-Manager-Ausgabe für den “status”-Befehl.

http://localhost:8088/asterisk/mxml?action=status

Dies gibt Ihnen die gleiche Statusansicht, jedoch als AJAX-Daten dargestellt, theoretisch kompatibel mit RICO (http://www.openrico.org).

http://localhost:8088/asterisk/static/ajamdemo.html

Wenn Sie die Unterstützung für statische Inhalte aktiviert haben und make install durchgeführt haben, wird Asterisk eine Demoseite bereitstellen, die eine Live-, aber sehr einfache, “astman”-ähnliche Schnittstelle präsentiert. Sie können sich mit Ihrem Benutzernamen/Passwort für den Manager anmelden und eine grundlegende Ansicht von Kanälen sowie das Übertragen und Auflegen von Anrufen haben. Es wurde nur in Firefox getestet, könnte aber wahrscheinlich auch in anderen Browsern zum Laufen gebracht werden.

Eine Beispielbibliothek (astman.js) ist enthalten, um die Erstellung von Manager-HTML-Schnittstellen zu erleichtern.

Beachten Sie, dass für die Demo kein externer Webserver erforderlich ist.