%
% asterisk.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel Asterisc %%%%%%%%%%%%%%%%%%%%%%%%%%%%
\chapter{Das Asterisk-Paket}


\section{Einleitung}

Asterisk ist eine Software-Telefonanlage mit Funktionen wie Voicebox- oder
Voice over IP-Unterst"utzung (SIP, IAX). Des weiteren kann sie mit Hilfe
einer HFC-S-ISDN-Karte (Siehe \jump{hfcscard}{Die HFC-S-ISDN-Karte}) einen
internen S$_{0}$-Bus bereitstellen.

Dadurch ist es ohne Weiteres m"oglich, Asterisk in vorhandene ISDN-Strukturen
zu integrieren.

Eine kleinere TK-Anlage (z.B. Eumex, FritzX) kann hinter den Asterisk-Server
geschaltet werden. Damit besteht die M"oglichkeit, auch mit analogen
Telefonen, VoIP-Telefonie zu betreiben. So ist es z.B. m"oglich mit einen
analogen schnurlosen Telefon "uber das Internet zu telefonieren, ohne dass
man etwas davon bemerkt.

Im ersten Teil dieses Dokuments wird auf die Konfiguration von Asterisk f"ur
\eisfair eingegangen. Sie wird auf der Konsole in einem speziellen Editor
(ECE, Eisfair Configuration Editor) durchgef"uhrt.

\newpage

\section{Konfigurationsvariablen}

\begin{description}
\config{START\_ASTERISK}
{START\_ASTERISK}
{STARTASTERISK}
{
    Soll Asterisk beim Booten von \eisfair gestartet werden?

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{START\_ASTERISK='no'}
}


\config{ASTERISK\_CONFIG\_USE}
{ASTERISK\_CONFIG\_USE}
{ASTERISKCONFIGUSE}
{
    "Uber diesen Parameter wird das schreiben der configs
    beeinflusst.


    \begin{tabular}{ll}
   \texttt{'yes'} & \texttt{die Asterisk configs werden nach den Angaben aus dieser} \\
                  & \texttt{Konfig erstellt.} \\
   \texttt{'no'}  & \texttt{die Asterisk configs werden von Hand erstellt, die Angaben} \\
                  & \texttt{in dieser Konfig werden nicht beachtet.} \\
    \end{tabular}


    Ausser: \texttt{ASTERISK\_LOAD\_CAPI, ASTERISK\_LOAD\_DAHDI,
            ASTERISK\_LOG\_INTO\_FILE}

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{ASTERISK\_CONFIG\_USE='yes'}
}


\config{ASTERISK\_LOAD\_CAPI}
{ASTERISK\_LOAD\_CAPI}
{ASTERISKLOADCAPI}
{
    Wenn Asterisk auch Anrufe von der CAPI entgegen nehmen soll, muss hier
    'yes' eingetragen werden.

    Dazu ist nat"urlich neben der HFC-S-ISDN-Karte noch eine weitere
    ISDN-Karte n"otig, die "uber eine CAPI angesprochen wird. Momentan
    sind dies alle Karten die vom CAPI-Paket f"ur \eisfair unterst"utzt
    werden.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{ASTERISK\_LOAD\_CAPI='no'}
}


\config{ASTERISK\_LOAD\_DAHDI}
{ASTERISK\_LOAD\_DAHDI}
{ASTERISKLOADDAHDI}
{
    Wenn Telefonie Karten benutzt werden sollen, muss diese Variable
    auf 'yes' gesetzt sein.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{ASTERISK\_LOAD\_DAHDI='no'}
}


\config{ASTERISK\_LOG\_INTO\_FILE}
{ASTERISK\_LOG\_INTO\_FILE}
{ASTERISKLOGINTOFILE}
{
    Schreibt alle Ausgaben von der Debug-Konsole und zus"atzlich die
    Verbose-Meldungen in eine Logdatei. Es ist dringend davon abzuraten
    diese Einstellung im Produktivbetrieb zu aktivieren, da die Logdatei
    sehr schnell sehr gro"s werden kann.

    Die Meldungen werden in die Datei /var/log/asterisk/full geschrieben.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{ASTERISK\_LOG\_INTO\_FILE='no'}
}


\config{ASTERISK\_LANGUAGE}
{ASTERISK\_LANGUAGE}
{ASTERISKLANGUAGE}
{
    Hier wird angegeben in welcher Sprache die Ansagen am Telefon abgespielt
    werden sollen. Z.B. im Voicebox-Men"u oder wenn eine ung"ultige Rufnummer
    gew"ahlt wurde.

    G"ultige Werte: de, en, fr

    Standardeinstellung: \texttt{ASTERISK\_LANGUAGE='de'}
}


\config{ASTERISK\_CODECS}
{ASTERISK\_CODECS}
{ASTERISKCODECS}
{
    Die Auswahl der Codecs ist entscheidend f"ur die Sprachqualit"at und die
    ben"otigte Bandbreite f"ur ein Gespr"ach.

    Der Codec 'ulaw' "ubertr"agt die Daten unkomprimiert und ben"otigt eine
    Bruttodatenrate von ca. 11KB/Sek. pro Richtung. Er wird au"serdem beim
    herk"ommlichen ISDN verwendet. Aufgrund der Daten rate ist dieser Codec
    nur DSL-Benutzern zu empfehlen.

    Der Codec 'gsm' bietet eine niedrigere Sprachqualit"at als 'ulaw' und
    l"asst sich deshalb auch mit einem Einwahlzugang wie ISDN oder Modem
    verwenden.

    Es k"onnen auch alle zusammen ausgew"ahlt werden, mit jeweils einem
    'space'

    G"ultige Werte: ulaw, alaw, gsm

    Standardeinstellung: \texttt{ASTERISK\_CODECS='ulaw'}
}


\config{ASTERISK\_ADVANCED\_ERROR\_MSG}
{ASTERISK\_ADVANCED\_ERROR\_MSG}
{ASTERISKADVANCEDERRORMSG}
{
    Wenn eine ung"ultige Nummer gew"ahlt wurde und diese Variable auf yes
    gesetzt ist, wird eine gef"uhlsbetonte Fehler ansage ausgegeben.
}


\config{ASTERISK\_AREA\_CODE}
{ASTERISK\_AREA\_CODE}
{ASTERISKAREACODE}
{
    Diese Variable ist optional. Wenn hier die Ortsvorwahl eingetragen ist,
    braucht bei SIP-Gespr"achen im selben Ort keine Vorwahl mehr angegeben
    zu werden.

    Sie wird verwendet, wenn bei ausgehenden Anrufen "uber SIP keine
    Vorwahl (f"uhrende 0) vorgew"ahlt wird. Asterisk geht in diesem Fall
    davon aus, dass sich diese Nummer im selben Ort befindet und w"ahlt
    die hier angegebene Vorwahl vor die Rufnummer.

    Ist diese Variable gesetzt, k"onnen nat"urlich keine Nummern mehr im
    Netz des eigenen SIP-Providers angew"ahlt werden, da Asterisk davon
    ausgeht, die gew"ahlte Rufnummer sei eine Nummer im eigenen Ort und
    w"ahlt die Ortsvorwahl vor.

    Ein praktisches Beispiel, welches nicht mehr funktioniert, ist die
    blo"se Eingabe der Sipgate Kundennummer eines anderen Teilnehmers.
    Hier muss dann die Festnetznummer des SIP-Accounts des Gespr"achspartners
    gew"ahlt werden. Das Gespr"ach ist dann immer noch kostenlos.)
}


\config{ASTERISK\_RECORD\_CONVERSATION}
{ASTERISK\_RECORD\_CONVERSATION}
{ASTERISKRECORDCONVERSATION}
{
    Nimmt alle gef"uhrten Gespr"ache in einer WAV-Datei auf.

    In vielen L"andern (darunter auch Deutschland) ist das Mitschneiden
    von Telefongespr"achen ohne das Einverst"andnis des entfernten
    Teilnehmers nicht erlaubt. Diese Variable darf in EU-L"andern auf
    keinen Fall auf 'yes' gesetzt werden!

    Die Dateien werden in /var/spool/asterisk/monitor im WAV-Format
    gespeichert.
}
\end{description}


\subsection{HFC-S Karten}

\begin{description}
\config{ASTERISK\_HFCS\_GROUP\_x\_TYPE}{ASTERISK\_HFCS\_GROUP\_x\_TYPE}{ASTERISKHFCSGROUPNTYPE}
{
Hier wird der Typ der HFC-S-Karte angegeben. Es wird zwischen Karten mit
einem RJ45-Port (zaphfc) und mit mehreren RJ45-Ports (multi) unterschieden.

M"ogliche Werte: 'zaphfc', 'multi'
}

\config{ASTERISK\_HFCS\_GROUP\_x\_PROVIDE\_S0\_BUS}{ASTERISK\_HFCS\_GROUP\_x\_PROVIDE\_S0\_BUS}{ASTERISKHFCSGROUPNPROVIDES0BUS}
{
Sollen an die Ports in dieser Gruppe Endger"ate (ISDN-Telefone, d/a-Wandler)
angeschlossen werden, so muss diese Variable auf 'yes' gesetzt werden.

Sollen die Ports in dieser Gruppe mit dem Telefonanschluss zur
Telefongesellschaft verbunden werden, muss diese Variable auf 'no' gesetzt
werden. Hierzu z"ahlt auch, wenn man den genannten Port an den internen
S0-Bus einer weiteren TK-Anlage anschlie"sen m"ochte.
}

\config{ASTERISK\_HFCS\_GROUP\_x\_PTP}{ASTERISK\_HFCS\_GROUP\_x\_PTP}{ASTERISKHFCSGROUPXPTP}
{
Ist der Anschlusstyp zur Telefongesellschaft ein Anlagenanschluss (2SM,
Point-to-Point, Prim"armultiplexanschluss, (meistens 30 B-Kan"ale) und kein
Mehrger"ateanschluss (Point-to-Multi-Point, 2 B-Kan"ale) muss hier 'yes'
angegeben werden.

"aquivalent dazu gilt, wenn ASTERISK\_HFCS\_GROUP\_x\_PROVIDE\_S0\_BUS auf
'yes' gesetzt ist, ob der generierte S0-Bus an dieser Portgruppe ein
Anlagenanschluss oder einen Mehrger"ateanschluss bereitstellen soll .

\hinweis{An einen Anlagenanschluss k"onnen keine Telefone direkt
angeschlossen werden. Hierf"ur ist eine extra TK-Anlage (oder eben ein
Asterisk) n"otig, an die (dem) die Telefone angeschlossen werden.}
}

\config{ASTERISK\_HFCS\_GROUP\_x\_PORTS}{ASTERISK\_HFCS\_GROUP\_x\_PORTS}{ASTERISKHFCSGROUPNPORTS}
{
Hier wird angegeben, wie viel Ports dieser Portgruppe umfassen soll.

Eine Portgruppe kann sich "uber mehrere HFC-S-Karten erstrecken oder nur einen
Port umfassen. In welcher Reihenfolge der Treiber die Karten/Ports
konfiguriert, ist unterschiedlich und muss ausprobiert werden.
}
\end{description}

\subsection{FXO- und FXS-Karten}

\begin{description}
\config{ASTERISK\_FX\_GROUP\_x\_TYPE}{ASTERISK\_FX\_GROUP\_x\_TYPE}{ASTERISKFXGROUPNTYPE}
{
Hier wird der Typ der Gegenstelle angegeben, an welche die Portgruppe
angeschlossen ist.

\begin{itemize}
\item fxs: An die Portgruppe sind ein oder mehrere Telefone angeschlossen
\item fxo: Die Portgruppe ist mit einem oder mehreren Telefonanschl"usse
verbunden
\item none: Auf dem entsprechenden Slot steckt kein Modul (Nur bei
Interface-Karten n"otig, auf die die FXS-/FXO-Module aufgesteckt werden)
\end{itemize}
}

\config{ASTERISK\_FX\_GROUP\_x\_PORTS}{ASTERISK\_FX\_GROUP\_x\_PORTS}{ASTERISKFXGROUNPORTS}
{
Die Anzahl der RJ11-Buchsen welche zu dieser Portgruppe geh"oren.
}
\end{description}


\subsection{Webinterface}

Dieses Webinterface dient nicht zur Konfiguration von Asterisk.


\begin{description}

\config{ASTERISK\_WEBINTERFACE\_START}
{ASTERISK\_WEBINTERFACE\_START}
{ASTERISKWEBINTERFACESTART}
{
    Schaltet das Webinterface ein oder aus.

    Wird hier 'yes' eingetragen, wird der asterisk\_httpd gestartet.

    \hinweis{Der Zugriff auf das Webinterface erfolgt "uber Port 3002.
             Bei SSL Verschl"usselung ist zu beachten, dass ein 's' hinter
             der Angabe des Protokolls stehen muss: https://eis:3002}

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{ASTERISK\_WEBINTERFACE\_START='no'}
}


\config{ASTERISK\_WEBINTERFACE\_FORCE\_SSL}
{ASTERISK\_WEBINTERFACE\_FORCE\_SSL}
{ASTERISKWEBINTERFACEFORCESSL}
{
    Hier wird angeben, ob das Asterik Webinterface "uber eine SSL Vebindung
    erreicht werden soll oder nicht.

    Bei der Einstellung:


    \begin{tabular}{ll}
   \texttt{'yes'} & \texttt{werden die Asterisk Seiten mit SSL Verschl"usselung} \\
                  & \texttt{ausgeliefert, dass ist die Standardeinstellung und} \\
                  & \texttt{sehr empfohlen.} \\
                  & \texttt{Beispiel: https://eis:3002} \\
   \texttt{'no'}  & \texttt{werden die Asterisk Seiten 'ohne' SSL Verschl"uselung} \\
                  & \texttt{ausgeliefert. Dieses Vorgehen ist m"oglich wird aber nicht} \\
                  & \texttt{empfohlen, da das Passwort und der Username im Klartext} \\
                  & \texttt{"ubertragen werden.} \\
                  & \texttt{Beispiel: http://eis:3002} \\
    \end{tabular}


    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{ASTERISK\_WEBINTERFACE\_FORCE\_SSL='yes'}
}


\config{ASTERISK\_WEBINTERFACE\_CERTIFICATE}
{ASTERISK\_WEBINTERFACE\_CERTIFICATE}
{ASTERISKWEBINTERFACECERTIFICATE}
{
    Hier wird der Name des SSL Server Zertifikats angegeben.

    Asterisk legt f"ur die SSL Verbindung einen link 'asterisk.pem'
    an. Asterisk benutzt daf"ur auch das Standard Zertifikat des Servers.
    Es kann hier auch ein Zertifikat einer anderen 'CA', das f"ur Asterisk
    ausgestellt wurde, angegeben werden.

    G"ultige Werte: Zertifikat Name

    Standardeinstellung: \texttt{ASTERISK\_WEBINTERFACE\_CERTIFICATE=''}
}


\config{ASTERISK\_WEBINTERFACE\_N}
{ASTERISK\_WEBINTERFACE\_N}
{ASTERISKWEBINTERFACEN}
{
    "Uber diesen Parameter wird eingestellt, wieviele Benutzer
    angelegt werden sollen.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{ASTERISK\_WEBINTERFACE\_N'='0'}
}


\config{ASTERISK\_WEBINTERFACE\_x\_USER}
{ASTERISK\_WEBINTERFACE\_x\_USER}
{ASTERISKWEBINTERFACENUSER}
{
    Der Benutzername f"ur die HTTP-Authentifizierung wird hier angegeben.

    G"ultige Werte: Benutzer Name

    Standardeinstellung: \texttt{ASTERISK\_WEBINTERFACE\_x\_USER=''}
}


\config{ASTERISK\_WEBINTERFACE\_x\_PASSWD}
{ASTERISK\_WEBINTERFACE\_x\_PASSWD}
{ASTERISKWEBINTERFACENPASSWD}
{
    Das Passwort f"ur die HTTP-Authentifizierung wird hier angegeben.

    G"ultige Werte: Benutzer Passwort

    Standardeinstellung: \texttt{ASTERISK\_WEBINTERFACE\_x\_PASSWD=''}
}
\end{description}


\subsection{Netzwerkeinstellungen}

\begin{description}
\config{ASTERISK\_RTP\_PORTS}{ASTERISK\_RTP\_PORTS}{ASTERISKRTPPORTS}
{
Hier werden die Ports angegeben, die n"otig sind, um "uber SIP telefonieren zu
k"onnen.

Der komplette Portbereich muss per Portforwarding vom Router weitergeleitet
werden.

Die Variable muss dem Format 'startport-endport' entsprechen.

Standardeinstellung: ASTERISK\_RTP\_PORTS='10000-20000'
}

\config{ASTERISK\_LOCALNET}{ASTERISK\_LOCALNET}{ASTERISKLOCALNET}
{
Hier wird angegeben, welche Netze f"ur das NAT maskiert werden sollen.

Standardeinstellung: ASTERISK\_LOCALNET='192.168.0.0/24'
}

\config{ASTERISK\_LISTEN\_ADDR}{ASTERISK\_LISTEN\_ADDR}{ASTERISKLISTENADDR}
{
Diese Variable wird nur f"ur Cisco und Nortel IP phones ben"otigt und
beinhaltet die IP-Adresse des \eisfair.
}

\config{ASTERISK\_EXTERNIP}{ASTERISK\_EXTERNIP}{ASTERISKEXTERNIP}
{
Bei manchen Anbietern ist es n"otig, dass keine privaten IP-Adressen im
SIP-Header auftauchen (z.B. GMX und 1\&1).

Deshalb muss hier entweder ein Domainname (z.B. Dyndns bei dynamischer
IP-Adresse) oder eine IP-Adresse bei statischer Adressierung der
Internetverbindung angegeben werden.

Standardeinstellung: ASTERISK\_EXTERNIP='mysubdomain.eisfair.net'
}
\end{description}

\subsection{Wahlpr"afixe}

\begin{description}
\config{ASTERISK\_DIALPREFIX\_SIP}{ASTERISK\_DIALPREFIX\_SIP}{ASTERISKDIALPREFIXSIP}
{
Siehe \jump{DIALPREFIX}{ASTERISK\_DIALPRFIX\_xxx-Variablen}.

Beispiel: ASTERISK\_DIALPREFIX\_SIP='\#*999'

Standardeinstellung: ASTERISK\_DIALPREFIX\_SIP=''
}


\config{ASTERISK\_DIALPREFIX\_IAX}{ASTERISK\_DIALPREFIX\_IAX}{ASTERISKDIALPREFIXIAX}
{
Siehe \jump{DIALPREFIX}{ASTERISK\_DIALPRFIX\_xxx-Variablen}.

Beispiel: ASTERISK\_DIALPREFIX\_IAX='\#*888'

Standardeinstellung: ASTERISK\_DIALPREFIX\_IAX=''
}


\config{ASTERISK\_DIALPREFIX\_CAPI}{ASTERISK\_DIALPREFIX\_CAPI}{ASTERISKDIALPREFIXCAPI}
{
Siehe \jump{DIALPREFIX}{ASTERISK\_DIALPRFIX\_xxx-Variablen}.

Standardeinstellung: ASTERISK\_DIALPREFIX\_CAPI='000'
}

\config{ASTERISK\_DIALPREFIX\_INTERNAL}{ASTERISK\_DIALPREFIX\_INTERNAL}{ASTERISKDIALPREFIXINTERNAL}
{
Siehe \jump{DIALPREFIX}{ASTERISK\_DIALPRFIX\_xxx-Variablen} und
\jump{INTERNAL}{Interne Gespr"ache}.

Standardeinstellung: ASTERISK\_DIALPREFIX\_INTERNAL='*'
}

\config{ASTERISK\_DIALPREFIX\_VBOX}{ASTERISK\_DIALPREFIX\_VBOX}{ASTERISKDIALPREFIXVBOX}
{
Siehe \jump{DIALPREFIX}{ASTERISK\_DIALPRFIX\_xxx-Variablen} und
\jump{VBOX}{Die Voicebox}.

Standardeinstellung: ASTERISK\_DIALPREFIX\_VBOX='\#9'
}

\config{ASTERISK\_DIALPREFIX\_DISA}{ASTERISK\_DIALPREFIX\_DISA}{ASTERISKDIALPREFIXDISA}
{
Siehe \jump{DIALPREFIX}{ASTERISK\_DIALPRFIX\_xxx-Variablen} und
\jump{DISA}{Asterisk ohne HFC-S-ISDN-Karte}.

Standardeinstellung: ASTERISK\_DIALPREFIX\_DISA='\#9'
}

\config{ASTERISK\_DIALPREFIX\_SHOW\_CAPI}{ASTERISK\_DIALPREFIX\_SHOW\_CAPI}{ASTERISKDIALPREFIXSHOWCAPI}
{
Ist diese Variable auf \glqq{}yes\grqq gesetzt, wird bei eingehenden Anrufen
vor die Caller ID des Anrufers, der Dialprefix aus
ASTERISK\_DIALPREFIX\_CAPI geh"angt.

Dadurch kann man auf dem Display des Telefons erkennen, ob der Anruf "uber
CAPI oder SIP ankommt. Der Vorteil ist, dass man bei verpassten Anrufen
einfach die Nummer in der Anrufer liste ausw"ahlen kann und der Dialprefix um
"uber CAPI zur"uck zurufen wird automatisch vorgew"ahlt.

Nat"urlich kann es auch sein, dass der Anruf "uber CAPI eingetroffen ist, aber
man gerne die Nummer aus der Anrufer liste "uber SIP zur"uckrufen m"ochte. Dann
kann diese Variable auf \glqq{}no\grqq gesetzt werden.
}

\config{ASTERISK\_DIALPREFIX\_SHOW\_SIP}{ASTERISK\_DIALPREFIX\_SHOW\_SIP}{ASTERISKDIALPREFIXSHOWSIP}
{
Siehe \jump{ASTERISKDIALPREFIXSHOWCAPI}{ASTERISK\_DIALPREFIX\_SHOW\_CAPI}.
}

\config{ASTERISK\_DIALPREFIX\_SHOW\_IAX}{ASTERISK\_DIALPREFIX\_SHOW\_IAX}{ASTERISKDIALPREFIXSHOWIAX}
{
Siehe \jump{ASTERISKDIALPREFIXSHOWCAPI}{ASTERISK\_DIALPREFIX\_SHOW\_CAPI}.
}

\end{description}

\subsection{Allgemeine Konfiguration der Voiceboxen}

\begin{description}
\config{ASTERISK\_VMAIL\_FROM\_ADDR}{ASTERISK\_VMAIL\_FROM\_ADDR}{ASTERISKVMAILFROMADDR}
{
Alle aufgenommenen Voice-Nachrichten werden per Mail an die in \\
\jump{ASTERISKPHONESNVBOXMAIL}{ASTERISK\_PHONES\_x\_VBOX\_MAIL} angegebene
Mailadresse des Users geschickt. Welche Absender-Adresse diese Mails tragen
sollen, wird hier angegeben.

Standardeinstellung:
ASTERISK\_VMAIL\_FROM\_ADDR='asterisk-mailbox@fabian-wolter.de'
}

\config{ASTERISK\_VMAIL\_FROM\_NAME}{ASTERISK\_VMAIL\_FROM\_NAME}{ASTERISKVMAILFROMNAME}
{
Hier wird der Absender-Name angegeben, der im From-Feld stehen soll.

Standardeinstellung: ASTERISK\_VMAIL\_FROM\_NAME='Asterisk Voicemailbox'
}

\config{ASTERISK\_VBOX\_MAX\_MSG\_LENGTH}{ASTERISK\_VBOX\_MAX\_MSG\_LENGTH}{ASTERISKVBOXMAXMSGLENGTH}
{
Damit ein Anrufer nicht die komplette Festplatte voll quatscht (oder das
Auflegen des Anrufers nicht korrekt signalisiert wird), wird die Aufnahme
nach der hier angegebenen Zeit abgebrochen.

Der Wert wird in Sekunden angegeben.

Standardeinstellung: ASTERISK\_VBOX\_MAX\_MSG\_LENGTH='180'
}

\config{ASTERISK\_VBOX\_PLAY\_INSTRUCTIONS}{ASTERISK\_VBOX\_PLAY\_INSTRUCTIONS}{ASTERISKVBOXPLAYINSTRUCTIONS}
{
Ist diese Variable auf 'yes' gesetzt, wird an die Abwesenheitsansage noch
eine weitere Ansage geh"angt, in der der Anrufer dazu aufgefordert wird, eine
Nachricht zu hinterlassen.

Es ist sinnvoll dies auszustellen, wenn man seine eigene Ansage aufgenommen hat.
}
\end{description}

\subsection{Inverssuche}

\begin{description}

\config{ASTERISK\_RESOLVE\_NUMBERS}{ASTERISK\_RESOLVE\_NUMBERS}{ASTERISKRESOLVENUMBERS}
{
Ist diese Variable auf 'yes' gesetzt, versucht Asterisk bei jedem
eingehenden Anruf die Nummer des Anrufers in den Namen aufzul"osen. Dabei
wird zun"achst das lokale Telefonbuch in Form einer Textdatei oder einer MySQL-Datenbank abgefragt.
Wird die Nummer hier nicht gefunden, wird versucht die Nummer "uber
dasoertliche.de aufzul"osen.

\achtung{Es ist zu beachten, dass die Endger"ate erst anfangen zu klingeln,
nachdem die Antwort von dasoertliche.de erhalten wurde. Antwortet
dasoertliche.de aber nicht innerhalb von 2 Sekunden, wird die Anfrage
abgebrochen und der Anruf ohne Name durch gestellt.}

\achtung{Alle weiteren Parameter in diesem Abschnitt wurden in der Version 1.1.5 des Asterisk-Paketes
hinzugef"ugt!}
}

\config{ASTERISK\_RESOLVE\_NUMBERS\_REMOTE}{ASTERISK\_RESOLVE\_NUMBERS\_REMOTE}{ASTERISKRESOLVENUMBERSREMOTE}
{
Mit dieser Variable ist es m"oglich die automatische Abfrage bei
dasoertliche.de zu deaktivieren. In diesem Fall wird nur die Textdatei
bzw. die MySQL-Datenbank durchsucht.
}

\config{ASTERISK\_RESOLVE\_NUMBERS\_SOURCE}{ASTERISK\_RESOLVE\_NUMBERS\_SOURCE}{ASTERISKRESOLVENUMBERSSOURCE}
{
Diese Variable kann die Werte 'db' und 'file' annehmen.

Bei der Einstellung 'file' werden die Ergebnisse der Inverssuche in einer Datei gespeichert und bei Bedarf wieder abgerufen. Ebenso k"onnen per Hand Telefonnummern bzw. Namen nachgetragen werden.

Bei der Einstellung 'db' wird automatisch eine Datenbank mit der unten angegebenen Konfiguration angelegt und mit Daten von dasoertliche.de gef"ullt. Es ist nat"urlich ebenso m"oglich Telefonnummern bzw. Namen per Hand nachzutragen.
}

\config{ASTERISK\_RESOLVE\_NUMBERS\_PATH}{ASTERISK\_RESOLVE\_NUMBERS\_PATH}{ASTERISKRESOLVENUMBERSPATH}
{
Hier wird der Pfad zur Textdatei angegeben, welche mit den Ergebnissen aus der Inverssuche von das oertliche.de gef"ullt wird.

Diese Variable ist nur relevant, wenn ASTERISK\_RESOLVE\_NUMBERS\_SOURCE den Wert 'file' hat.
}

\config{ASTERISK\_RESOLVE\_NUMBERS\_DB\_HOST}{ASTERISK\_RESOLVE\_NUMBERS\_DB\_HOST}{ASTERISKRESOLVENUMBERSDBHOST}
{
Der Hostname des MySQL-Servers f"ur die Speicherung der Daten aus der Inverssuche.

Diese Variable ist nur relevant, wenn ASTERISK\_RESOLVE\_NUMBERS\_SOURCE den Wert 'db' hat.
}

\config{ASTERISK\_RESOLVE\_NUMBERS\_DB\_USER}{ASTERISK\_RESOLVE\_NUMBERS\_DB\_USER}{ASTERISKRESOLVENUMBERSDBUSER}
{
Der Datenbank-User ist hier anzugeben.

Diese Variable ist nur relevant, wenn ASTERISK\_RESOLVE\_NUMBERS\_SOURCE den Wert 'db' hat.
}

\config{ASTERISK\_RESOLVE\_NUMBERS\_DB\_PASS}{ASTERISK\_RESOLVE\_NUMBERS\_DB\_PASS}{ASTERISKRESOLVENUMBERSDBPASS}
{
Das Passwort f"ur den Datenbank-User ist hier anzugeben.

Diese Variable ist nur relevant, wenn ASTERISK\_RESOLVE\_NUMBERS\_SOURCE den Wert 'db' hat.
}

\config{ASTERISK\_RESOLVE\_NUMBERS\_DB\_NAME}{ASTERISK\_RESOLVE\_NUMBERS\_DB\_NAME}{ASTERISKRESOLVENUMBERSDBNAME}
{
In der hier angegebenen Datenbank werden die Daten gespeichert.

Diese Variable ist nur relevant, wenn ASTERISK\_RESOLVE\_NUMBERS\_SOURCE den Wert 'db' hat.
}

\config{ASTERISK\_RESOLVE\_NUMBERS\_DB\_TABLE}{ASTERISK\_RESOLVE\_NUMBERS\_DB\_TABLE}{ASTERISKRESOLVENUMBERSDBTABLE}
{
In der hier angegebenen Tabelle werden die Daten gespeichert.

Diese Variable ist nur relevant, wenn ASTERISK\_RESOLVE\_NUMBERS\_SOURCE den Wert 'db' hat.
}
\end{description}

\subsection{SIP-Provider}

\begin{description}
\config{ASTERISK\_SIP\_x\_NAME}{ASTERISK\_SIP\_x\_NAME}{ASTERISKSIPNNAME}
{
Hier wird der Name des SIP-Accounts angegeben. Er darf frei gew"ahlt werden,
muss aber einzigartig in der Konfiguration sein.

Erlaubt sind nur Zeichen a-Z sowie '-', '\_' und die Ziffern 0-9

Standardeinstellung: ASTERISK\_SIP\_x\_NAME='sipgate1'
}

\config{ASTERISK\_SIP\_x\_USER}{ASTERISK\_SIP\_x\_USER}{ASTERISKSIPNUSER}
{
Hier wird der Username angegeben, mit dem sich Asterisk am SIP-Server des
Providers authentifizieren soll.

Standardeinstellung: ASTERISK\_SIP\_x\_USER='87654321'
}

\config{ASTERISK\_SIP\_x\_PASSWORD}{ASTERISK\_SIP\_x\_PASSWORD}{ASTERISKSIPNPASSWORD}
{
Hier wird das Passwort angegeben, mit dem sich Asterisk am SIP-Server des
Providers authentifizieren soll.

Standardeinstellung: ASTERISK\_SIP\_x\_PASSWORD='not2knew4u'
}

\config{ASTERISK\_SIP\_x\_HOST}{ASTERISK\_SIP\_x\_HOST}{ASTERISKSIPNHOST}
{
Hier wird der Hostname des SIP-Server angegeben, an dem sich Asterisk
authentifizieren soll.

Standardeinstellung: ASTERISK\_SIP\_x\_HOST='sipgate.de'
}

\config{ASTERISK\_SIP\_x\_CALLERID}{ASTERISK\_SIP\_x\_CALLERID}{ASTERISKSIPNCALLERID}
{
Hier wird die \jump{callerid}{Caller ID} angegeben, welche mit jedem Anruf
an die Gegenstelle "ubermittelt wird und ggf. dort angezeigt wird.

Standardeinstellung: ASTERISK\_SIP\_x\_CALLERID='4951187654321'
}

\config{ASTERISK\_SIP\_x\_FALLBACK}{ASTERISK\_SIP\_x\_FALLBACK}{ASTERISKSIPNFALLBACK}
{
Diese Variable wird benutzt, falls der SIP-Account einmal nicht erreichbar
sein sollte. Dann wird auf die hier angegebenen weiteren SIP-Accounts bzw.
auf das Festnetz versucht raus zu w"ahlen.

Das Format entspricht folgendem Schema:

\begin{verbatim}
sip:[String aus ASTERISK_SIP_x_NAME] capi:[MSN, welche
fuer den ausgehenden Anruf benutzt werden soll]
hfcs[Portgruppen-Nummer aus ASTERISK_HFCS_GROUP_x_*]:[MSN,
welche fuer den ausgehenden Anruf benutzt werden soll
\end{verbatim}

Die Anzahl und Reihenfolge der sip:, hfcs[1-9]: und capi: Befehle sind beliebig.

Ein Beispiel:

\begin{verbatim}
sip:gmx sip:webde capi:123456 sip:sipgate hfcs1:123456
\end{verbatim}

Ist nun der entsprechende SIP-Account nicht verf"ugbar (z.B. SIP-Proxy nicht
erreichbar), wird versucht die Verbindung "uber den SIP-Account mit dem Namen
(ASTERISK\_SIP\_x\_NAME) \glqq{}gmx\grqq herzustellen. Ist dieser ebenfalls
nicht erreichbar (z.B. Verbindung zum Internet unterbrochen), wird versucht
die Rufnummer "uber ISDN (CAPI) zu erreichen. Ist die ISDN-Karte z.B. nicht
angeschlossen, wird versucht "uber die HFC-S-Portgruppe 1 die Verbindung
herzustellen.
}

\config{ASTERISK\_SIP\_x\_EXEC\_ON\_RING}{ASTERISK\_SIP\_x\_EXEC\_ON\_RING}{ASTERISKSIPNEXECONRING}
{
Wenn dieser SIP-Account angerufen wird, wird der hier angegebene Befehl
ausgef"uhrt. M"ogliche Szenarien sind z.B. das mitloggen der Anrufe in eine
Datei oder Datenbank.

Beispiel: ASTERISK\_SIP\_x\_EXEC\_ON\_RING='echo \grqq{}Call from
\$\{EXTEN\}\grqq{}'

Standardeinstellung: ASTERISK\_SIP\_x\_EXEC\_ON\_RING=''
}

\config{ASTERISK\_SIP\_x\_VBOX}{ASTERISK\_SIP\_x\_VBOX}{ASTERISKSIPNVBOX}
{
Schaltet die Voicebox des Accounts ein oder Aus. Diese Variable sollte auf
''no'' gesetzt sein, wenn ASTERISK\_SIP\_x\_REDIRECT\_SCHEME nicht leer ist.
Dann sollte das Verhalten der Voicebox in dem entsprechenden
Weiterleitungsschema definiert werden.

\achtung{Dieser Parameter wurde in der Version 1.1.0 des Asterisk-Paketes
hinzugef"ugt!}
}

\config{ASTERISK\_SIP\_x\_VBOX\_NUMBER}{ASTERISK\_SIP\_x\_VBOX\_NUMBER}{ASTERISKSIPNVBOXNUMBER}
{
Hier wird die Nummer der Voicebox angegeben, welche den Anruf entgegen
nehmen soll.

\hinweis{Die Nummer der Voicebox wird standardm"a"sig dem Anrufer angesagt. Es
ist also sinnvoll als Nummer der Voicebox, die Telefonnummer ohne Vorwahl
anzugeben.}

\achtung{Dieser Parameter wurde in der Version 1.1.0 des Asterisk-Paketes
hinzugef"ugt!}
}

\config{ASTERISK\_SIP\_x\_VBOX\_ANSWER\_AFTER}{ASTERISK\_SIP\_x\_VBOX\_ANSWER\_AFTER}{ASTERISKSIPNVBOXANSWERAFTER}
{
Hier wird angegeben, nach wie viel Sekunden klingeln die Voicebox das
Gespr"ach annehmen soll.

Befindet sich der User bereits im Gespr"ach, nimmt die Voicebox das Gespr"ach
sofort an.

Standardeinstellung: ASTERISK\_SIP\_x\_VBOX\_ANSWER\_AFTER='15'

\achtung{Dieser Parameter wurde in der Version 1.1.0 des Asterisk-Paketes
hinzugef"ugt!}
}

\config{ASTERISK\_SIP\_x\_REDIRECT\_SCHEME}{ASTERISK\_SIP\_x\_REDIRECT\_SCHEME}{ASTERISKSIPNREDIRECTSCHEME}
{
Der Index ''n'' aus einem Weiterleitungsschema kann hier angegeben werden.

Beispiel: Ist das gew"unschte Weiterleitungsschema in \\
ASTERISK\_REDIRECT\_2\_SCHEME\_1\_EXECUTE\_AFTER etc. definiert, so muss der
Variable ASTERISK\_SIP\_x\_REDIRECT\_SCHEME der Wert ''2'' zugewiesen werden.

\achtung{Dieser Parameter wurde in der Version 1.1.0 des Asterisk-Paketes
hinzugef"ugt!}
}

\config{ASTERISK\_SIP\_x\_REDIRECT}{ASTERISK\_SIP\_x\_REDIRECT}{ASTERISKSIPNREDIRECT}
{
Soll die Weiterleitung aktiviert werden?

M"ogliche Werte: yes, no

\achtung{Dieser Parameter ist mit der Version 1.1.0 des Asterisk-Paketes
entfernt worden!}
}

\config{ASTERISK\_SIP\_x\_REDIRECT\_TO}{ASTERISK\_SIP\_x\_REDIRECT\_TO}{ASTERISKSIPNREDIRECTTO}
{
Hier wird die Nummer angegeben zu der der Anruf weitergeleitet werden soll.
Es ist darauf zu achten, dass die Nummer mit einem Dialprefix (angegeben in
ASTERISK\_DIALPREFIX\_*) angegeben werden muss.

\achtung{Dieser Parameter ist mit der Version 1.1.0 des Asterisk-Paketes
entfernt worden!}
}

\config{ASTERISK\_SIP\_x\_REDIRECT\_AFTER}{ASTERISK\_SIP\_x\_REDIRECT\_AFTER}{ASTERISKSIPNREDIRECTAFTER}
{
Hier wird angeben, nach wie vielen Sekunden die Weiterleitung erfolgen soll.
Wird vorher auf dem eigentlich angerufenen Telefon abgenommen, verf"allt die
Zeit und es wird nicht weitergeleitet.

Nachdem die Weiterleitung erfolgt ist, h"ort das eigentlich angerufene
Telefon auf zu klingeln und die Nummer in ASTERISK\_REDIRECT\_TO wird angew"ahlt.

Soll keine Anrufweiterleitung erfolgen, muss diese Variable leer gelassen
werden.

\achtung{Dieser Parameter ist mit der Version 1.1.0 des Asterisk-Paketes
entfernt worden!}
}

\config{ASTERISK\_SIP\_x\_REDIRECT\_OUTGOING\_SIP}{ASTERISK\_SIP\_x\_REDIRECT\_OUTGOING\_SIP}{ASTERISKSIPNREDIRECTOUTGOINGSIP}
{
Falls als Dialprefix der SIP-Prefix angegeben wurde, wird "uber diesen
SIP-Account die Nummer in ASTERISK\_REDIRECT\_TO angew"ahlt.

\hinweis{Die Caller ID des Anrufers wird ebenfalls f"ur den ausgehenden bzw.
weitergeleiteten Anruf verwendet.}

\achtung{Dieser Parameter ist mit der Version 1.1.0 des Asterisk-Paketes
entfernt worden!}
}

\config{ASTERISK\_SIP\_x\_REDIRECT\_OUTGOING\_MSN}{ASTERISK\_SIP\_x\_REDIRECT\_OUTGOING\_MSN}{ASTERISKSIPNREDIRECTOUTGOINGMSN}
{
Falls als Dialprefix der CAPI-Prefix angegeben wurde, wird als Caller ID f"ur
den ausgehenden (weitergeleiteten) Anruf diese MSN verwendet.

\achtung{Dieser Parameter ist mit der Version 1.1.0 des Asterisk-Paketes
entfernt worden!}
}

\config{ASTERISK\_SIP\_x\_REDIRECT\_OUTGOING\_HFCS\_GROUP}{ASTERISK\_SIP\_x\_REDIRECT\_OUTGOING\_HFCS\_GROUP}{ASTERISKSIPNREDIRECTOUTGOINGHFCSGROUP}
{
Diese Variable ist nur von Bedeutung, wenn als Dialprefix der von CAPI
angegeben wurde.

Falls die Gespr"ache "uber die HFC-S-Karte weitergeleitet werden sollen, wird
die hier angegebene Portgruppen-Nummer (ASTERISK\_HFCS\_GROUP\_x\_*) verwendet.

Bleibt die Variable leer, wird die ISDN-Verbindung "uber CAPI (z.B.
Fritz!Card) aufgebaut

\achtung{Dieser Parameter ist mit der Version 1.1.0 des Asterisk-Paketes
entfernt worden!}
}

\end{description}

\subsection{IAX-Provider}

\hinweis{Dieser Variablen-Block wurde in der Version 1.1.0 des
Asterisk-Paketes eingef"uhrt}

\begin{description}
\config{ASTERISK\_IAX\_x\_NAME}{ASTERISK\_IAX\_x\_NAME}{ASTERISKIAXNNAME}
{
Hier wird der Name des IAX-Accounts angegeben. Er darf frei gew"ahlt werden,
muss aber einzigartig in der Konfiguration sein.

Erlaubt sind nur Zeichen a-Z sowie '-', '\_' und die Ziffern 0-9

Standardeinstellung: ASTERISK\_IAX\_x\_NAME='monduno'
}

\config{ASTERISK\_IAX\_x\_USER}{ASTERISK\_IAX\_x\_USER}{ASTERISKIAXNUSER}
{
Hier wird der Username angegeben, mit dem sich Asterisk am IAX-Server des
Providers authentifizieren soll.

Standardeinstellung: ASTERISK\_IAX\_x\_USER='87654321'
}

\config{ASTERISK\_IAX\_x\_PASSWORD}{ASTERISK\_IAX\_x\_PASSWORD}{ASTERISKIAXNPASSWORD}
{
Hier wird das Passwort angegeben, mit dem sich Asterisk am IAX-Server des
Providers authentifizieren soll.

Standardeinstellung: ASTERISK\_IAX\_x\_PASSWORD='not2knew4u'
}

\config{ASTERISK\_IAX\_x\_HOST}{ASTERISK\_IAX\_x\_HOST}{ASTERISKIAXNHOST}
{
Hier wird der Hostname des IAX-Server angegeben, an dem sich Asterisk
authentifizieren soll.

Standardeinstellung: ASTERISK\_IAX\_x\_HOST='iax.monduno.de'
}

\config{ASTERISK\_IAX\_x\_CALLERID}{ASTERISK\_IAX\_x\_CALLERID}{ASTERISKIAXNCALLERID}
{
Hier wird die \jump{callerid}{Caller ID} angegeben, welche mit jedem Anruf
an die Gegenstelle "Ubermittelt wird und ggf. dort angezeigt wird.

Standardeinstellung: ASTERISK\_IAX\_x\_CALLERID='4951187654321'
}

\config{ASTERISK\_IAX\_x\_FALLBACK}{ASTERISK\_IAX\_x\_FALLBACK}{ASTERISKIAXNFALLBACK}
{
Diese Variable wird benutzt, falls der IAX-Account einmal nicht erreichbar
sein sollte. Dann wird auf die hier angegebenen weiteren IAX-Accounts bzw.
auf das Festnetz versucht raus zu w"ahlen.

Das Format entspricht folgendem Schema:

\begin{verbatim}
sip:[String aus ASTERISK_IAX_x_NAME] capi:[MSN, welche fuer den ausgehenden
Anruf benutzt werden soll] hfcs[Portgruppen-Nummer aus
ASTERISK_HFCS_GROUP_x_*]:[MSN, welche fuer den ausgehenden
Anruf benutzt werden soll
\end{verbatim}

Die Anzahl und Reihenfolge der iax:, sip:, hfcs[1-9]:, capi: etc. Befehle
sind beliebig.

Ein Beispiel:

\begin{verbatim}
sip:gmx sip:webde capi:123456 sip:sipgate hfcs1:123456
\end{verbatim}

Ist nun der entsprechende IAX-Account nicht verf"ugbar (z.B. IAX-Proxy nicht
erreichbar), wird versucht die Verbindung "uber den IAX-Account mit dem Namen
(ASTERISK\_IAX\_x\_NAME) \glqq{}gmx\grqq herzustellen. Ist dieser ebenfalls
nicht erreichbar (z.B. Verbindung zum Internet unterbrochen), wird versucht
die Rufnummer "uber ISDN (CAPI) zu erreichen. Ist die ISDN-Karte z.B. nicht
angeschlossen, wird versucht "uber die HFC-S-Portgruppe 1 die Verbindung
herzustellen.
}

\config{ASTERISK\_IAX\_x\_EXEC\_ON\_RING}{ASTERISK\_IAX\_x\_EXEC\_ON\_RING}{ASTERISKIAXNEXECONRING}
{
Wenn dieser IAX-Account angerufen wird, wird der hier angegebene Befehl
ausgef"uhrt. M"ogliche Szenarien sind z.B. das mitloggen der Anrufe in eine
Datei oder Datenbank.

Beispiel: ASTERISK\_IAX\_x\_EXEC\_ON\_RING='echo \grqq{}Call from
\$\{EXTEN\}\grqq{}'

Standardeinstellung: ASTERISK\_IAX\_x\_EXEC\_ON\_RING=''
}

\config{ASTERISK\_IAX\_x\_VBOX}{ASTERISK\_IAX\_x\_VBOX}{ASTERISKIAXNVBOX}
{
Schaltet die Voicebox des Accounts ein oder Aus. Diese Variable sollte auf
''no'' gesetzt sein, wenn ASTERISK\_IAX\_x\_REDIRECT\_SCHEME nicht leer ist.
Dann sollte das Verhalten der Voicebox in dem entsprechenden
Weiterleitungsschema definiert werden.

\achtung{Dieser Parameter wurde in der Version 1.1.0 des Asterisk-Paketes
hinzugef"ugt!}
}


\config{ASTERISK\_IAX\_x\_VBOX\_NUMBER}{ASTERISK\_IAX\_x\_VBOX\_NUMBER}{ASTERISKIAXNVBOXNUMBER}
{
Hier wird die Nummer der Voicebox angegeben, welche den Anruf entgegen
nehmen soll. Die Nummer wird in ASTERISK\_VBOX\_x\_NUMBER definiert.

\hinweis{Die Nummer der Voicebox wird standardm"a"sig dem Anrufer angesagt. Es
ist also sinnvoll als Nummer der Voicebox, die Telefonnummer ohne Vorwahl
anzugeben.}

\achtung{Dieser Parameter wurde in der Version 1.1.0 des Asterisk-Paketes
hinzugef"ugt!}
}

\config{ASTERISK\_IAX\_x\_VBOX\_ANSWER\_AFTER}{ASTERISK\_IAX\_x\_VBOX\_ANSWER\_AFTER}{ASTERISKIAXNVBOXANSWERAFTER}
{
Hier wird angegeben, nach wie viel Sekunden klingeln die Voicebox das
Gespr"ach annehmen soll.

Befindet sich der User bereits im Gespr"ach, nimmt die Voicebox das Gespr"ach
sofort an.

Standardeinstellung: ASTERISK\_IAX\_x\_VBOX\_ANSWER\_AFTER=''

\achtung{Dieser Parameter wurde in der Version 1.1.0 des Asterisk-Paketes
hinzugef"ugt!}
}

\config{ASTERISK\_IAX\_x\_REDIRECT\_SCHEME}{ASTERISK\_IAX\_x\_REDIRECT\_SCHEME}{ASTERISKIAXNREDIRECTSCHEME}
{
Der Index ''n'' aus einem Weiterleitungsschema kann hier angegeben werden.

Beispiel: Ist das gew"unschte Weiterleitungsschema in
ASTERISK\_REDIRECT\_2\_SCHEME\_1\_EXECUTE\_AFTER etc. definiert, so muss der
Variable ASTERISK\_IAX\_x\_REDIRECT\_SCHEME der Wert ''2'' zugewiesen werden.

\achtung{Dieser Parameter wurde in der Version 1.1.0 des Asterisk-Paketes
hinzugef"ugt!}
}
\end{description}

\subsection{Interne Telefone}

\begin{description}
\config{ASTERISK\_PHONES\_x\_MSN}{ASTERISK\_PHONES\_x\_MSN}{ASTERISKPHONESNMSN}
{
Hier wird die MSN eingetragen, auf die das entsprechende Endger"at
konfiguriert ist.

Bei SIP-Telefonen ist diese Nummer auch gleichzeitig der Benutzername, mit
dem sich der SIP-Client beim Asterisk einloggt.

Standardeinstellung: ASTERISK\_PHONES\_x\_MSN='10'
}


\config{ASTERISK\_PHONES\_x\_TYPE}
{ASTERISK\_PHONES\_x\_TYPE}
{ASTERISKPHONESNTYPE}
{
    Hier wird angegeben, von welchem Typ das Endger"at ist. Zu Verf"ugung
    stehen folgende Werte:
    \begin{itemize}
    \item hfcs[1-9] - Ger"at ist an eine HFC-S-Karte angeschlossen.
                      [1-9] ist die Portgruppe.
    \item sip - Ger"at ist ein SIP-Client.
    \item skinny - Ger"at ist ein Cisco IP phone.
    \item sccp - Ger"at ist ein Cisco IP phone mit sccp-b als Modul.
    \item unistim - Ger"at ist ein Nortel IP phone.
    \item disa - Ger"at ist an eine TK-Anlage angeschlossen,
                 an dessen internen S0-Bus der Asterisk h"angt.
    \end{itemize}

\hinweis{Ein Parallelbetrieb von skinny und sccp ist nicht m"oglich.
        F"ur SCCP muss das Modul chan-sccp-b installiert sein.

        Bei Konfiguration eines sccp Telefons werden skinny Ger"ate
        ignoriert. Wenn chan-sccp-b nicht installiert ist, werden sccp
        Ger"ate ignoriert.

        Sind mehrere HFC-S-Portgruppen vorhanden (ASTERISK\_HFCS\_GROUP\_N
        > 1), so muss dem Typ ('hfcs') der Index (x) aus
        ASTERISK\_HFCS\_GROUP\_x\_* angeh"angt werden.

        Ist das Endger"at z.B. an der Portgruppe 2
        (ASTERISK\_HFCS\_GROUP\_2\_*) angeschlossen, muss als Typ
        ASTERISK\_PHONES\_x\_TYPE='hfcs2' angegeben werden.}
}


\config{ASTERISK\_PHONES\_x\_MAC\_ADDR}
{ASTERISK\_PHONES\_x\_MAC\_ADDR}
{ASTERISKPHONESNMACADDR}
{
Diese Variable wird nur bei Cisco und Nortel IP phones gebraucht. Es wird
die MAC-Adresse des Phones angegeben, \textbf{ohne} Trenner (Doppelpunkt,
Bindestrich, etc.).

Beispiel: ASTERISK\_PHONES\_x\_MAC\_ADDR='0011AABBCCDDEEFF'
}


\config{ASTERISK\_PHONES\_x\_PIN}
{ASTERISK\_PHONES\_x\_PIN}
{ASTERISKPHONESNPIN}
{
Hier wird die PIN eingetragen, die abgefragt wird, wenn man seine Voicebox
von einem anderen Telefon als das Eigene abrufen m"ochte.

Bei SIP-Telefonen ist diese PIN auch gleichzeitig das Passwort, mit dem sich
der SIP-Client beim Asterisk einloggt.

G"ultige Zeichen sind alle, die "uber das Tastenfeld des entsprechenden
Clients eingegeben werden k"onnen. Es sollten aber dennoch nur * und die
Ziffern 0-9 verwendet werden, damit z.B. die Voicebox eines SIP-Telefons
auch "uber ein normales Telefon abgerufen werden kann.

\hinweis{Das \#-Zeichen darf hier nicht verwendet werden, da dies zur
Best"atigung der Eingabe der PIN, vor dem Abh"oren der Voicebox benutzt wird}

Standardeinstellung: ASTERISK\_PHONES\_x\_PIN='7710'
}


\config{ASTERISK\_PHONES\_x\_RING\_ON\_SIP
}{ASTERISK\_PHONES\_x\_RING\_ON\_SIP}
{ASTERISKPHONESNRINGONSIP}
{
Wenn ein Anruf auf einem SIP-Account eingeht und dieses Telefon daraufhin
klingeln soll, muss der Wert aus
\jump{ASTERISKSIPNNAME}{ASTERISK\_SIP\_x\_NAME} des entsprechenden
SIP-Accounts hier eingetragen werden.

M"oglich ist auch die Angabe mehrerer SIP-Accounts. Diese m"ussen dann mit
Leerzeichen getrennt angegeben werden.

Standardeinstellung: ASTERISK\_PHONES\_x\_RING\_ON\_SIP='sipgate1 sipgate2'
}


\config{ASTERISK\_PHONES\_x\_RING\_ON\_IAX}
{ASTERISK\_PHONES\_x\_RING\_ON\_IAX}
{ASTERISKPHONESNRINGONIAX}
{
Wenn ein Anruf auf einem IAX-Account eingeht und dieses Telefon daraufhin
klingeln soll, muss der Wert aus
\jump{ASTERISKIAXNNAME}{ASTERISK\_IAX\_x\_NAME} des entsprechenden
IAX-Accounts hier eingetragen werden.

M"oglich ist auch die Angabe mehrerer IAX-Accounts. Diese m"ussen dann mit
Leerzeichen getrennt angegeben werden.

Standardeinstellung: ASTERISK\_PHONES\_x\_RING\_ON\_IAX=''
}

\config{ASTERISK\_PHONES\_x\_RING\_ON\_CAPI}{ASTERISK\_PHONES\_x\_RING\_ON\_CAPI}{ASTERISKPHONESNRINGONCAPI}
{
Wenn ein Anruf auf eine \textbf{externe} MSN eingeht, die hier
eingetragen ist, klingelt dieses Telefon.

M"oglich ist auch die Angabe mehrerer MSNs. Diese m"ussen dann mit Leerzeichen
getrennt eingegeben werden.

\hinweis{Diese Variable ist nur g"ultig, wenn
\jump{ASTERISKLOADCAPI}{ASTERISK\_LOAD\_CAPI} auf 'yes' steht.}

Standardeinstellung: ASTERISK\_PHONES\_x\_RING\_ON\_CAPI='11111 22222'
}

\config{ASTERISK\_PHONES\_x\_OUTGOING\_NAME}{ASTERISK\_PHONES\_x\_OUTGOING\_NAME}{ASTERISKPHONESNOUTGOINGNAME}
{
Hier wird der Name angegeben, der beim Angerufenen auf dem Display
erscheinen soll.

\hinweis{Die "ubermittlung des Namens funktioniert nur intern oder "uber SIP.}

Standardeinstellung: ASTERISK\_PHONES\_x\_OUTGOING\_NAME='Wolter Tel1'
}

\config{ASTERISK\_PHONES\_x\_OUTGOING\_SIP}{ASTERISK\_PHONES\_x\_OUTGOING\_SIP}{ASTERISKPHONESNOUTGOINGSIP}
{
Der hier angegebene SIP-Account wird benutzt, wenn ein ausgehender Anruf von
diesem Telefon "uber SIP get"atigt wird.

Standardeinstellung: ASTERISK\_PHONES\_x\_OUTGOING\_SIP='sipgate1'
}

\config{ASTERISK\_PHONES\_x\_OUTGOING\_IAX}{ASTERISK\_PHONES\_x\_OUTGOING\_IAX}{ASTERISKPHONESNOUTGOINGIAX}
{
Der hier angegebene IAX-Account wird benutzt, wenn ein ausgehender Anruf von
diesem Telefon "uber IAX get"atigt wird.

Standardeinstellung: ASTERISK\_PHONES\_x\_OUTGOING\_IAX='voipbuster'
}

\config{ASTERISK\_PHONES\_x\_OUTGOING\_MSN}{ASTERISK\_PHONES\_x\_OUTGOING\_MSN}{ASTERISKPHONESNOUTGOINGMSN}
{
Die hier angegebene MSN wird benutzt, wenn ein ausgehender Anruf von diesem
Telefon "uber Festnetz get"atigt wird.

Standardeinstellung: ASTERISK\_PHONES\_x\_OUTGOING\_MSN='11111'
}

\config{ASTERISK\_PHONES\_x\_OUTGOING\_HFCS\_GROUP}{ASTERISK\_PHONES\_x\_OUTGOING\_HFCS\_GROUP}{ASTERISKPHONESNOUTGOINGHFCSGROUP}
{
Hier wird der Index (x) aus ASTERISK\_HFCS\_GROUP\_x\_* angegeben. Diese
Variable muss gesetzt sein, wenn nicht die Fritz!Card, sondern eine
HFC-S-Karte, raus telefonieren benutzt werden soll. (Daf"ur muss die
HFC-S-Karte nat"urlich mit dem externen S0-Bus der Telefongesellschaft
verbunden sein und ASTERISK\_HFCS\_GROUP\_x\_PROVIDE\_S0\_BUS='no')

Soll "uber die Fritz!Card raus gew"ahlt werden, so muss diese Variable leer
bleiben.
}

\config{ASTERISK\_PHONES\_x\_EXEC\_ON\_RING}{ASTERISK\_PHONES\_x\_EXEC\_ON\_RING}{ASTERISKPHONESNEXECONRING}
{
Siehe auch \jump{EXEC}{xxx\_EXEC\_ON\_RING-Variablen}

Standardeinstellung: ASTERISK\_PHONES\_x\_EXEC\_ON\_RING=''
}

\config{ASTERISK\_PHONES\_x\_NETBIOS\_NAME}{ASTERISK\_PHONES\_x\_NETBIOS\_NAME}{ASTERISKPHONESNNETBIOSNAME}
{
Hier kann der Windowsname eines Rechners im Netzwerk angegeben werden. Geht ein Anruf auf der in diesem Abschnitt konfigurierten MSN ein, so wird per netsend-Befehl eine Nachricht an den Rechner geschickt. Auch ggf. mit der Caller ID des Anrufers.
}

\config{ASTERISK\_PHONES\_x\_LCR}{ASTERISK\_PHONES\_x\_LCR}{ASTERISKPHONESNLCR}
{
Ist das Least Cost Routing aktiviert so kann "uber diese Variable eine Ausnahme f"ur das entsprechende Endger"at bzw. MSN definiert werden. Dies kann z.B. sinnvoll f"ur Faxger"ate sein, welche immer "uber ISDN und nicht "uber SIP herausw"ahlen sollen.

Ist LCR global ausgeschaltet, (ASTERISK\_LCR auf 'no' gesetzt), so hat die Variable ASTERISK\_PHONES\_n\_LCR keine Auswirkung.
}

\config{ASTERISK\_PHONES\_x\_VBOX}{ASTERISK\_PHONES\_x\_VBOX}{ASTERISKPHONESNVBOX}
{
Wenn eine Voicebox f"ur dieses Telefon aktiviert werden soll, muss diese
Variable auf 'yes' stehen.

Standardeinstellung: ASTERISK\_PHONES\_x\_VBOX='no'

\achtung{Ab der Version 1.1.0 des Asterisk-Paketes haben die VBOX-Variablen
der internen Telefone eine andere Bedeutung bekommen!

Die Voicebox beantwortet nun nur noch Gespr"ache, welche von einem anderen
internen Telefon aus eingehen. Soll eine Voicebox eine ISDN-Rufnummer
beantworten, so muss diese in ASTERISK\_MSN\_x\_VBOX eingeschaltet werden.
Selbiges gilt f"ur einen SIP-Account f"ur ASTERISK\_SIP\_x\_VBOX und f"ur IAX
ebenso.

Wenn eine Weiterleitung "uber den Variablen-Block ASTERISK\_REDIRECT\_*
realisiert wird, kann die hier konfigurierte Voicebox auch externe Gespr"ache
z.B. "Uber eine ISDN-Rufnummer oder einen SIP-Account annehmen. Hierzu muss
als Voicebox-Nummer die interne MSN des Telefons in
ASTERISK\_REDIRECT\_x\_SCHEME\_y\_TARGET\_z\_ADDR angegeben werden.
}
}

\config{ASTERISK\_PHONES\_x\_VBOX\_MAIL}{ASTERISK\_PHONES\_x\_VBOX\_MAIL}{ASTERISKPHONESNVBOXMAIL}
{
An die hier angegebene Mailadresse werden die empfangenen Nachrichten der
Voicebox geschickt. Ist diese Variable leer, wird keine Mail versendet. Die
Nachrichten k"onnen aber weiterhin per Anwahl der Voicebox abgeh"ort werden.

Um dieses Feature nutzen zu k"onnen muss das \eisfair Mail-Paket installiert
und funktionsf"ahig sein.

Standardeinstellung: ASTERISK\_PHONES\_x\_VBOX\_MAIL='vbox10@fabian-wolter.de'
}

\config{ASTERISK\_PHONES\_x\_VBOX\_ANSWER\_AFTER}{ASTERISK\_PHONES\_x\_VBOX\_ANSWER\_AFTER}{ASTERISKPHONESNVBOXANSWERAFTER}
{
Hier wird angegeben, nach wie viel Sekunden klingeln die Voicebox das
Gespr"ach annehmen soll.

Befindet sich der User bereits im Gespr"ach, nimmt die Voicebox das Gespr"ach
sofort an.

Standardeinstellung: ASTERISK\_PHONES\_x\_VBOX\_ANSWER\_AFTER='15'
}
\end{description}

\subsection{Erweiterte Einstellungen f"ur externe MSNs}

\achtung{Der Variablen-Block wurde in der Version 1.1.0 des Asterisk-Paketes
von ASTERISK\_CAPI\_EXTRA nach ASTERISK\_MSN umbenannt. Die Grundfunktion
wurde nicht ver"andert.}

\begin{description}
\config{ASTERISK\_MSN\_x\_NUMBER}{ASTERISK\_MSN\_x\_NUMBER}{ASTERISKMSNNNUMBER}
{
Wird diese \textbf{externe} MSN angerufen, wird der Befehl in
ASTERISK\_MSN\_x\_EXEC\_ON\_RING ausgef"uhrt.

Siehe auch xxx\_EXEC\_ON\_RING-Variablen

\hinweis{Diese Variable ist nur g"ultig, wenn ASTERISK\_LOAD\_CAPI auf 'yes'
gesetzt ist.}

Standardeinstellung: ASTERISK\_MSN\_x\_NUMBER='12345678'
}

\config{ASTERISK\_MSN\_x\_EXEC\_ON\_RING}{ASTERISK\_MSN\_x\_EXEC\_ON\_RING}{ASTERISKMSNNEXECONRING}
{
Siehe \jump{ASTERISKMSNNNUMBER}{ASTERISK\_MSN\_x\_NUMBER}.

Standardeinstellung: ASTERISK\_MSN\_x\_EXEC\_ON\_RING=''
}

\config{ASTERISK\_MSN\_x\_VBOX}{ASTERISK\_MSN\_x\_VBOX}{ASTERISKMSNNVBOX}
{
Schaltet die Voicebox des Accounts ein oder Aus. Diese Variable sollte auf
''no'' gesetzt sein, wenn ASTERISK\_IAX\_x\_REDIRECT\_SCHEME nicht leer ist.
Dann sollte das Verhalten der Voicebox in dem entsprechenden
Weiterleitungsschema definiert werden.

\achtung{Dieser Parameter wurde in der Version 1.1.0 des Asterisk-Paketes
hinzugef"ugt!}
}

\config{ASTERISK\_MSN\_x\_VBOX\_NUMBER}{ASTERISK\_MSN\_x\_VBOX\_NUMBER}{ASTERISKMSNNVBOXNUMBER}
{
Hier wird die Nummer der Voicebox angegeben, welche den Anruf entgegen
nehmen soll. Die Nummer wird in ASTERISK\_VBOX\_x\_NUMBER definiert.

\hinweis{Die Nummer der Voicebox wird standardm"a"sig dem Anrufer angesagt. Es
ist also sinnvoll als Nummer der Voicebox, die Telefonnummer ohne Vorwahl
anzugeben.}

\achtung{Dieser Parameter wurde in der Version 1.1.0 des Asterisk-Paketes
hinzugef"ugt!}
}

\config{ASTERISK\_MSN\_x\_VBOX\_ANSWER\_AFTER}{ASTERISK\_MSN\_x\_VBOX\_ANSWER\_AFTER}{ASTERISKMSNNVBOXANSWERAFTER}
{
Hier wird angegeben, nach wie viel Sekunden klingeln die Voicebox das
Gespr"ach annehmen soll.

Befindet sich der User bereits im Gespr"ach, nimmt die Voicebox das Gespr"ach
sofort an.

Standardeinstellung: ASTERISK\_MSN\_x\_VBOX\_ANSWER\_AFTER='9'

\achtung{Dieser Parameter wurde in der Version 1.1.0 des Asterisk-Paketes
hinzugef"ugt!}
}

\config{ASTERISK\_MSN\_x\_REDIRECT\_SCHEME}{ASTERISK\_MSN\_x\_REDIRECT\_SCHEME}{ASTERISKMSNNREDIRECTSCHEME}
{
Der Index ''n'' aus einem Weiterleitungsschema kann hier angegeben werden.

Beispiel: Ist das gew"unschte Weiterleitungsschema in
ASTERISK\_REDIRECT\_2\_SCHEME\_1\_EXECUTE\_AFTER etc. definiert, so muss der
Variable ASTERISK\_MSN\_x\_REDIRECT\_SCHEME der Wert ''2'' zugewiesen werden.

\achtung{Dieser Parameter wurde in der Version 1.1.0 des Asterisk-Paketes
hinzugef"ugt!}
}

\config{ASTERISK\_MSN\_x\_REDIRECT\_TO}{ASTERISK\_MSN\_x\_REDIRECT\_TO}{ASTERISKMSNNREDIRECTTO}
{
Hier wird angegeben, zu welcher Nummer die Anrufweiterleitung erfolgen soll.
Es muss hier zun"achst der Dialprefix z.B. f"ur SIP, CAPI oder intern
eingegeben werden, drauf folgt die eigentliche Telefonnummer.

\achtung{Dieser Parameter ist mit der Version 1.1.0 des Asterisk-Paketes
entfernt worden!}
}

\config{ASTERISK\_MSN\_x\_REDIRECT\_AFTER}{ASTERISK\_MSN\_x\_REDIRECT\_AFTER}{ASTERISKMSNNREDIRECTAFTER}
{
Hier wird angeben, nach wie vielen Sekunden die Weiterleitung erfolgen soll.
Wird vorher auf dem eigentlich angerufenen Telefon abgenommen verf"allt die
Zeit und es wird nicht weitergeleitet.

Nachdem die Weiterleitung erfolgt ist, h"ort das eigentlich angerufene
Telefon auf zu klingeln und die Nummer in ASTERISK\_REDIRECT\_TO wird angew"ahlt.

\achtung{Dieser Parameter ist mit der Version 1.1.0 des Asterisk-Paketes
entfernt worden!}
}

\config{ASTERISK\_MSN\_x\_REDIRECT\_OUTGOING\_SIP}{ASTERISK\_MSN\_x\_REDIRECT\_OUTGOING\_SIP}{ASTERISKMSNNREDIRECTOUTGOINGSIP}
{
Falls als Dialprefix der SIP-Prefix angegeben wurde, wird "uber diesen
CAPI\_EXTRA-Account die Nummer in ASTERISK\_REDIRECT\_TO angew"ahlt.

\hinweis{Die Caller ID des Anrufers wird ebenfalls f"ur den ausgehenden bzw.
weitergeleiteten Anruf verwendet.}

\achtung{Dieser Parameter ist mit der Version 1.1.0 des Asterisk-Paketes
entfernt worden!}
}

\config{ASTERISK\_MSN\_x\_REDIRECT\_OUTGOING\_MSN}{ASTERISK\_MSN\_x\_REDIRECT\_OUTGOING\_MSN}{ASTERISKMSNNREDIRECTOUTGOINGMSN}
{
Falls als Dialprefix der CAPI-Prefix angegeben wurde, wird als Caller ID f"ur
den ausgehenden (weitergeleiteten) Anruf diese MSN verwendet.

\achtung{Dieser Parameter ist mit der Version 1.1.0 des Asterisk-Paketes
entfernt worden!}
}

\config{ASTERISK\_MSN\_x\_REDIRECT\_OUTGOING\_HFCS\_GROUP}{ASTERISK\_MSN\_x\_REDIRECT\_OUTGOING\_HFCS\_GROUP}{ASTERISKMSNNREDIRECTOUTGOINGHFCSGROUP}
{
Diese Variable ist nur von Bedeutung, wenn als Dialprefix der von CAPI
angegeben wurde.

Falls die Gespr"ache "uber die HFC-S-Karte weitergeleitet werden sollen, wird
die hier angegebene Portgruppen-Nummer (ASTERISK\_HFCS\_GROUP\_x\_*) verwendet.

Bleibt die Variable leer, wird die ISDN-Verbindung "uber CAPI (z.B.
Fritz!Card) aufgebaut

\achtung{Dieser Parameter ist mit der Version 1.1.0 des Asterisk-Paketes
entfernt worden!}
}
\end{description}

\subsection{Konfiguration der einzelnen Voiceboxen}

\hinweis{Dieser Variablen-Block wurde in der Version 1.1.0 des
Asterisk-Paketes eingef"uhrt}

\begin{description}
\config{ASTERISK\_VBOX\_x\_NUMBER}{ASTERISK\_VBOX\_x\_NUMBER}{ASTERISKVBOXNNUMBER}
{
Hier wird die Nummer der Voicebox angegeben, welche den Anruf entgegen
nehmen soll. Die Nummer wird in ASTERISK\_VBOX\_x\_NUMBER definiert.

\hinweis{Die Nummer der Voicebox wird standardm"a"sig dem Anrufer angesagt. Es
ist also sinnvoll als Nummer der Voicebox z.B. die Telefonnummer ohne
Vorwahl anzugeben.}
}

\config{ASTERISK\_VBOX\_x\_PIN}{ASTERISK\_VBOX\_x\_PIN}{ASTERISKVBOXNPIN}
{
Hier wird die PIN eingetragen, die abgefragt wird, wenn man seine Voicebox
per Telefon abrufen m"ochte.

G"ultige Zeichen sind alle, die "uber das Tastenfeld des entsprechenden
Clients eingegeben werden k"onnen. Es sollten aber dennoch nur * und die
Ziffern 0-9 verwendet werden, damit z.B. die Voicebox eines SIP-Telefons
auch "uber ein normales Telefon abgerufen werden kann.

\hinweis{Das \#-Zeichen darf hier nicht verwendet werden, da dies zur
Best"atigung der Eingabe der PIN, vor dem Abh"oren der Voicebox benutzt wird.}
}


\config{ASTERISK\_VBOX\_x\_OWNER\_NAME}{ASTERISK\_VBOX\_x\_OWNER\_NAME}{ASTERISKVBOXNOWNERNAME}
{
Der Name der Voicebox bzw. der Name des Besitzers wird hier angegeben.
}

\config{ASTERISK\_VBOX\_x\_MAIL}{ASTERISK\_VBOX\_x\_MAIL}{ASTERISKVBOXNMAIL}
{
Neue Voice-Nachrichten, werden automatisch an die hier angegebene
E-Mail-Adresse geschickt. Mehrere E-Mail-Adressen k"onnen durch Komma getrennt
eingegeben werden.
}


\config{ASTERISK\_VBOX\_x\_NOTIFY\_x\_PHONE}{ASTERISK\_VBOX\_x\_NOTIFY\_x\_PHONE}{ASTERISKVBOXNNOTIFYPHONE}
{
Hier wird die interne MSN (ASTERISK\_PHONES\_x\_MSN) eines Telefons
angegeben, welches mitgeteilt werden soll, dass neue Voice-Nachrichten
vorhanden sind. Dies geschieht entweder "uber die Funktion Message Waiting
Indicator (MWI) (oft bei SIP-Clients) oder durch ein stotterndes
Freizeichen, beim Abheben des H"orers.
}
\end{description}

\subsection{Konfiguration der Weiterleitungsschemata}

\hinweis{Dieser Variablen-Block wurde in der Version 1.1.0 des
Asterisk-Paketes eingef"uhrt}

\begin{description}
\config{ASTERISK\_REDIRECT\_x\_SCHEME\_x\_EXECUTE\_AFTER}{ASTERISK\_REDIRECT\_x\_SCHEME\_x\_EXECUTE\_AFTER}{ASTERISKREDIRECTNSCHEMENEXECUTEAFTER}
{
Hier wird die Zeit in Sekunden angegeben, wann zum n"achsten
Weiterleitungsschritt gesprungen werden soll, wenn keines der Telefone im
aktuellen Schritt abgenommen wurde.
}


\config{ASTERISK\_REDIRECT\_x\_SCHEME\_x\_EXECUTE\_BETWEEN\_x\_TIME}{ASTERISK\_REDIRECT\_x\_SCHEME\_x\_EXECUTE\_BETWEEN\_x\_TIME}{ASTERISKREDIRECTNSCHEMENEXECUTEBETWEENNTIME}
{
Dieser Weiterleitungsschritt wird nur durchlaufen, wenn die aktuelle Uhrzeit
zwischen den hier angegebenen Zeiten liegt.

Die Syntax lautet folgenderma"sen:

\begin{verbatim}
<time range>|<days of week>|<days of month>|<months>
\end{verbatim}

Beispiele f"ur die einzelnen Parameter:

\begin{itemize}
\item time range - 0:00-12:00
\item days of week - Sa-Su
\item days of month - 1-7
\item months - Apr-Oct
\end{itemize}

Anwendungsbeispiel:

\begin{itemize}
\item 9:00-17:00|mon-fri|*|* - Der Weiterleitungsschritt wird Montags bis
Freitags von 9:00Uhr bis 17:00Uhr ausgef"uhrt.
\item *|*|26-30|May - Der Weiterleitungsschritt wird zwischen dem 26. bis
30. Mai ausgef"uhrt.
\end{itemize}
}


\config{ASTERISK\_REDIRECT\_x\_SCHEME\_x\_TARGET\_x\_TYPE}{ASTERISK\_REDIRECT\_x\_SCHEME\_x\_TARGET\_x\_TYPE}{ASTERISKREDIRECTNSCHEMENTARGETNTYPE}
{
Hier wird der Typ des Weiterleitungsziels angegeben. M"ogliche Werte sind

\begin{itemize}
\item hfcs[1-9] - Anrufer soll an eine MSN weitergeleitet werden, welche
"uber eine HFC-S Karte erreichbar ist. "Ublicherweise ist dies der Fall, wenn
eine HFC-S Karte mit dem Telefonanschluss verbunden ist. ([1-9] ist die
Portgruppe)
\item capi - Der Anrufer soll an eine Nummer weitergeleitet werden, welche
"uber eine Fritz!Card erreichbar ist.
\item internal - Anrufer soll an ein internes Telefon weitergeleitet werden
\item sip - Anrufer soll an externe SIP-Adresse weitergeleitet werden
\item disa - Anrufer soll an ein Telefon weitergeleitet werden, welches
z.B. an einer TK-Anlage an einer ISDN-Karte h"angt
\item vbox - Anrufer soll auf eine Voicebox weitergeleitet werden
\end{itemize}
}


\config{ASTERISK\_REDIRECT\_x\_SCHEME\_x\_TARGET\_x\_ADDR}{ASTERISK\_REDIRECT\_x\_SCHEME\_x\_TARGET\_x\_ADDR}{ASTERISKREDIRECTNSCHEMENTARGETNADDR}
{
Hier muss die Adresse des Weiterleitungsziels angegeben werden. Dies ist
z.B. eine MSN, eine SIP-Adresse in der Form name@provider.tld oder die
Nummer einer Voicebox. (Der Anrufer kann sowohl auf eine Voicebox welche in
ASTERISK\_MSN\_x\_VBOX\_*, ASTERISK\_MSN\_x\_SIP\_*,
ASTERISK\_IAX\_x\_VBOX\_* oder ASTERISK\_VBOX\_x\_* konfiguriert wurde, als
auch auf eine interne Voicebox (konfiguriert in
ASTERISK\_PHONES\_x\_VBOX\_*) weitergeleitet werden.
}


\config{ASTERISK\_REDIRECT\_x\_SCHEME\_x\_TARGET\_x\_FROM}{ASTERISK\_REDIRECT\_x\_SCHEME\_x\_TARGET\_x\_FROM}{ASTERISKREDIRECTNSCHEMENTARGETNFROM}
{
Diese Variable braucht nur konfiguriert zu werden, wenn der Anrufer "uber
einen SIP- oder IAX-Provider weitergeleitet werden soll. In diesem Fall muss
hier der Inhalt aus ASTERISK\_SIP\_x\_NAME bzw. ASTERISK\_IAX\_x\_NAME
angegeben werden.
}
\end{description}

\subsection{Least-Cost-Routings}

\begin{description}
\config{ASTERISK\_LCR}{ASTERISK\_LCR}{ASTERISKLCR}
{
Wenn bei ausgehenden ISDN-Verbindungen immer der billigste Call-By-Call
Anbieter gew"ahlt werden soll, muss diese Variable auf 'yes' gesetzt werden.

N"aheres dazu im Abschnitt \jump{LCR}{LCR}.
}

\config{ASTERISK\_LCR\_CRON}{ASTERISK\_LCR\_CRON}{ASTERISKLCRCRON}
{
Hier wird angegeben, wann und wie oft die Routing-Tabelle der Call-By-Call
Anbieter aktualisiert werden soll.
}
\end{description}

\subsection{Interactive Voice Response Menu (IVR)}

\hinweis{Dieser Variablen-Block wurde in der Version 1.1.0 des
Asterisk-Paketes eingef"uhrt}

\achtung{Das Men"u befindet sich in einem sehr experimentellen Status.}

\begin{description}
\config{ASTERISK\_IVR\_x\_NUMBER}{ASTERISK\_IVR\_x\_NUMBER}{ASTERISKIVRNNUMBER}
{
Hier wird die interne(!) MSN angegeben, "uber welche das Men"u erreichbar sein
soll. Zur Zeit kann das Men"u von Extern nur "uber ein Weiterleitungsschema
oder Callthrough erreicht werden.
}


\config{ASTERISK\_IVR\_x\_INSTRUCTIONS}{ASTERISK\_IVR\_x\_INSTRUCTIONS}{ASTERISKIVRNINSTRUCTIONS}
{
Die hier angegebene Datei wird dem Anrufer zu beginn vorgespielt.

Sie muss im GSM-Format unterhalb des Verzeichnisses /var/lib/asterisk/sounds
liegen. Dateien k"onnen z.B. mit dem Programm ''sox'' in GSM-Dateien
konvertiert werden.
}


\config{ASTERISK\_IVR\_x\_ENTRY\_x\_NUMBER}{ASTERISK\_IVR\_x\_ENTRY\_x\_NUMBER}{ASTERISKIVRNENTRYNNUMBER}
{
Hier wird die Taste (bzw. Nummer) angegeben, welche der Anrufer bet"atigen
muss, um in diesen Unterpunkt zu gelangen.
}

\config{ASTERISK\_IVR\_x\_ENTRY\_x\_TYPE}{ASTERISK\_IVR\_x\_ENTRY\_x\_TYPE}{ASTERISKIVRNENTRYNTYPE}
{
Hier wird angegeben, welche Aktion ausgef"uhrt werden soll, wenn der Anrufer
in diesem Unterpunkt geleitet wird. M"ogliche Werte sind:

\begin{itemize}
\item exec - f"uhrt einen Befehl aus
\item dial - w"ahlt eine Nummer (Die Nummer muss mit Dialprefix angegeben
werden!)
\item vbox - leitet den Anrufer auf eine Voicebox weiter
\end{itemize}
}


\config{ASTERISK\_IVR\_x\_ENTRY\_x\_VALUE}{ASTERISK\_IVR\_x\_ENTRY\_x\_VALUE}{ASTERISKIVRNENTRYNVALUE}
{
In dieser Variable wird entweder der Befehl zum Ausf"uhren
(ASTERISK\_IVR\_x\_ENTRY\_x\_TYPE='exec'), die Telefonnummer mit Dialprefix
(ASTERISK\_IVR\_x\_ENTRY\_x\_TYPE='dial') oder die Nummer der Voicebox
(ASTERISK\_VBOX\_x\_NUMBER) (ASTERISK\_IVR\_x\_ENTRY\_x\_TYPE='vbox') angegeben.
}
\end{description}

\subsection{TAPI}

\begin{description}
\config{ASTERISK\_START\_TAPI}{ASTERISK\_START\_TAPI}{ASTERISKSTARTTAPI}
{
Wenn der TAPI-Dienst beim Start von Asterisk gestartet werden, muss hier
'yes' angegeben werden.
}

\config{ASTERISK\_TAPI\_PORT}{ASTERISK\_TAPI\_PORT}{ASTERISKTAPIPORT}
{
Hier wird angegeben, auf welchem Port der TAPI-Dienst auf eingehende
Verbindung warten soll.
}

\config{ASTERISK\_TAPI\_USER\_x\_NAME}{ASTERISK\_TAPI\_USER\_x\_NAME}{ASTERISKTAPIUSERNNAME}
{
Der Benutzername, mit dem sich der User am Asterisk-TAPI-Server anmelden
darf, wird hier angegeben.
}

\config{ASTERISK\_TAPI\_USER\_x\_PASS}{ASTERISK\_TAPI\_USER\_x\_PASS}{ASTERISKTAPIUSERNPASS}
{
Hier wird das Passwort des Benutzers angegeben.
}

\config{ASTERISK\_TAPI\_USER\_x\_ACCESS}{ASTERISK\_TAPI\_USER\_x\_ACCESS}{ASTERISKTAPIUSERNACCESS}
{
Hier wird angegeben, aus welchen Subnetzen sich der in
ASTERISK\_TAPI\_USER\_x\_NAME angegebene Benutzer aus am
Asterisk-TAPI-Server anmelden darf.

M"ogliche Varianten sind z.B.:

192.168.0.0/16 (192.168.0.1 -- 192.168.255.254)
0.0.0.0/0 (Alle IP-Adressen)
}
\end{description}

\subsection{Callthrough-Systems}

\begin{description}
\config{ASTERISK\_CALLTHROUGH\_x\_MSN}{ASTERISK\_CALLTHROUGH\_x\_MSN}{ASTERISKCALLTHROUGHNMSN}
{
Auf dieser MSN lauscht Asterisk nach eingehenden Anrufen, die per
Callthrough weiter verbunden werden.
}

\config{ASTERISK\_CALLTHROUGH\_x\_OUTGOING\_SIP}{ASTERISK\_CALLTHROUGH\_x\_OUTGOING\_SIP}{ASTERISKCALLTHROUGHNOUTGOINGSIP}
{
Hier wird der Name des SIP-Accounts angegeben, "uber den ein Anrufer wieder
raus w"ahlen kann.
}

\config{ASTERISK\_CALLTHROUGH\_x\_OUTGOING\_MSN}{ASTERISK\_CALLTHROUGH\_x\_OUTGOING\_MSN}{ASTERISKCALLTHROUGHNOUTGOINGMSN}
{
Hier wird die externe MSN angegeben, die als Caller ID benutzt wird, wenn
der Anrufer wieder raus w"ahlt.
}

\config{ASTERISK\_CALLTHROUGH\_x\_OUTGOING\_HFCS\_GROUP}{ASTERISK\_CALLTHROUGH\_x\_OUTGOING\_HFCS\_GROUP}{ASTERISKCALLTHROUGHNOUTGOINGHFCSGROUP}
{
Diese Variable ist nur von Bedeutung, wenn als Dialprefix der von CAPI
gew"ahlt wurde.

Falls die Gespr"ache "uber die HFC-S-Karte weitergeleitet werden sollen, wird
die hier angegebene Portgruppen-Nummer (ASTERISK\_HFCS\_GROUP\_x\_*) verwendet.

Bleibt die Variable leer, wird die ISDN-Verbindung "uber CAPI (z.B.
Fritz!Card) aufgebaut
}

\config{ASTERISK\_CALLTHROUGH\_x\_ALLOW\_SIP}{ASTERISK\_CALLTHROUGH\_x\_ALLOW\_SIP}{ASTERISKCALLTHROUGHNALLOWSIP}
{
Wenn der Anrufer sich "uber SIP weiter verbinden darf, muss diese Variable
auf 'yes' gesetzt werden. Es ist zu beachten, dass der Dialprefix aus
\jump{ASTERISKDIALPREFIXSIP}{ASTERISK\_DIALPREFIX\_SIP} vor die eigentliche
Nummer zu w"ahlen ist.
}

\config{ASTERISK\_CALLTHROUGH\_x\_ALLOW\_CAPI}{ASTERISK\_CALLTHROUGH\_x\_ALLOW\_CAPI}{ASTERISKCALLTHROUGHNALLOWCAPI}
{
Wenn der Anrufer sich "uber CAPI weiter verbinden darf, muss diese Variable
auf 'yes' gesetzt werden. Es ist zu beachten, dass der Dialprefix aus
\jump{ASTERISKDIALPREFIXCAPI}{ASTERISK\_DIALPREFIX\_CAPI} vor die
eigentliche Nummer zu w"ahlen ist.
}

\config{ASTERISK\_CALLTHROUGH\_x\_ALLOW\_x\_CALLERID}{ASTERISK\_CALLTHROUGH\_x\_ALLOW\_x\_CALLERID}{ASTERISKCALLTHROUGHNALLOWNCALLERID}
{
Die hier angegebene \jump{callerid}{Caller ID} bekommt Zugang zum
Callthrough-System von Asterisk.
}

\config{ASTERISK\_CALLTHROUGH\_x\_ALLOW\_x\_PIN}{ASTERISK\_CALLTHROUGH\_x\_ALLOW\_x\_PIN}{ASTERISKCALLTHROUGHNALLOWNPIN}
{
Optional kann eine PIN angegeben werden, welche "uber das Tastenfeld des
Telefons eingetippt werden muss, um Zugang zum Callthrough-System von
Asterisk zu bekommen.

Wird diese Variable frei gelassen, wird der Anrufer nicht aufgefordert eine
PIN einzugeben und kann direkt anfangen zu w"ahlen.
}

\config{ASTERISK\_CALLTHROUGH\_x\_ANONYMOUS\_ACCESS}{ASTERISK\_CALLTHROUGH\_x\_ANONYMOUS\_ACCESS}{ASTERISKCALLTHROUGHNANONYMOUSACCESS}
{
Es ist m"oglich, dass auch Anrufer Zugang zum Callthrough-System bekommen,
die nicht in
\jump{ASTERISKCALLTHROUGHNALLOWNCALLERID}{ASTERISK\_CALLTHROUGH\_x\_ALLOW\_x\_CALLERID}
gelistet sind. In diesem Fall muss hier 'yes' angegeben werden.
}

\config{ASTERISK\_CALLTHROUGH\_x\_ANONYMOUS\_PIN}{ASTERISK\_CALLTHROUGH\_x\_ANONYMOUS\_PIN}{ASTERISKCALLTHROUGHNANONYMOUSPIN}
{
Anrufer, dessen \jump{callerid}{Caller ID} nicht in
\jump{ASTERISKCALLTHROUGHNALLOWNCALLERID}{ASTERISK\_CALLTHROUGH\_x\_ALLOW\_x\_CALLERID}
gelistet ist, k"onnen trotzdem Zugriff auf das Callthrough-System von
Asterisk bekommen. Allerdings muss dazu eine PIN eingeben, die mit dieser
Variable definiert wird.

Diese Variable darf aus Sicherheitsgr"unden nicht leer sein. Vorausgesetzt,
der anonyme Zugriff ist erlaubt.

\hinweis{Die Eingabe der PIN muss mit \# best"atigt werden.}

\achtung{Die Callthrough-Funktion sollte mit Vorsicht behandelt werden! Bei
falscher Konfiguration kann es passieren, dass sich ein fremder Anrufer in
das Callthrough-System ein buchen kann, ohne eine PIN eingeben zu m"ussen,
was fatale Folgen haben kann: Z.B. Anwahl von teuren Service-Rufnummern o."a.
unter Ihrem Namen.

Diese Fehlkonfiguration sollte von der \eisfair Konfigurationsschicht
abgefangen werden. Allerdings befindet sich dieses Paket noch im
Unstable-Status, also sollte man trotzdem seine Einstellungen nochmals genau
"uberdenken und testen!}
}

\end{description}

\subsection{Callback-Systems}

\begin{description}

\config{ASTERISK\_CALLBACK\_LISTEN\_NUMBER}{ASTERISK\_CALLBACK\_LISTEN\_NUMBER}{ASTERISKCALLBACKLISTENNUMBER}
{
Auf dieser MSN bzw. SIP-/IAX-Caller ID lauscht Asterisk nach eingehenden Anrufen die einen R"uckruf ausl"osen werden.
}

\config{ASTERISK\_CALLBACK\_OUTGOING\_TYPE}{ASTERISK\_CALLBACK\_OUTGOING\_TYPE}{ASTERISKCALLBACKOUTGOINGTYPE}
{
Hier wird die Art des R"uckrufs festgelegt. M"ogliche Werte sind capi, sip oder iax.
}

\config{ASTERISK\_CALLBACK\_OUTGOING\_FROM}{ASTERISK\_CALLBACK\_OUTGOING\_FROM}{ASTERISKCALLBACKOUTGOINGFROM}
{
Die hier angegebene MSN bzw. SIP-/IAX-Account wird f"ur den R"uckruf verwendet.
}

\config{ASTERISK\_CALLBACK\_GLOBAL\_PIN}{ASTERISK\_CALLBACK\_GLOBAL\_PIN}{ASTERISKCALLBACKGLOBALPIN}
{
Wenn hier eine PIN definiert ist, k"onnen alle Anrufer, unabh"angig von der Caller ID, mit dieser PIN einen R"uckruf ausl"osen.
}

\config{ASTERISK\_CALLBACK\_ALLOW\_x\_CALLERID}{ASTERISK\_CALLBACK\_ALLOW\_x\_CALLERID}{ASTERISKCALLBACKALLOWNCALLERID}
{
Die hier angegebene \jump{callerid}{Caller ID} darf einen R"uckruf ausl"osen.
}

\config{ASTERISK\_CALLBACK\_ALLOW\_x\_PIN}{ASTERISK\_CALLBACK\_ALLOW\_x\_PIN}{ASTERISKCALLBACKALLOWNPIN}
{
Die hier definierte PIN muss nach der Ansage eingegeben werden um einen R"uckruf auszul"osen. Bleibt diese Variable leer, so braucht Asterisk lediglich 1 x angeklingelt zu werden um einen R"uckruf auszul"osen.

\hinweis{Die Eingabe der PIN muss mit \# best"atigt werden.}
}
\end{description}


\marklabel{DIALPREFIX}{\section{ASTERISK\_DIALPREFIX\_xxx-Variablen}}
Das \eisfair Asterisk-Paket bietet die M"oglichkeit ausgehende Anrufe entweder
"uber Voice over IP (SIP) oder "uber das Festnetz zu f"uhren (z.B. falls der
Internetzugang gerade nicht funktioniert). Um dies Asterisk "uber das Telefon
mitzuteilen ist es n"otig, dass vor die Rufnummer ein Prefix gew"ahlt wird.
Anhand dieses Pr"afixes bestimmt Asterisk, ob die Nummer "uber das Festnetz
oder "uber SIP angew"ahlt werden soll.

Ein Beispiel: Wenn ASTERISK\_DIALPREFIX\_SIP='\#000' und Apu
Nahasapeemapetilon in Indien "uber VoIP angerufen werden soll, dessen
eigentliche Telefonnummer 0091 1234 8765 ist, dann muss auf dem Telefon
\#000 0091 1234 8765 gew"ahlt werden.

Nat"urlich ist es auch m"oglich ASTERISK\_DIALPREFIX\_xxx leer zu lassen. Dann
muss gar kein Prefix eingeben werden. -- Es versteht sich, dass nur ein
einziges ASTERISK\_DIALPREFIX\_xxx leer gelassen werden darf, ansonsten kann
Asterisk nicht bestimmten, ob das Gespr"ach "uber Festnetz oder SIP
hergestellt werden soll. Ebenso d"urfen zwei
ASTERISK\_DIALPREFIX\_xxx-Variablen nicht die gleichen Werte haben.

M"ogliche Werte: 0-9, *, \#, A-D

Manche Telefone bieten zus"atzlich noch die Tasten A-D auf dem Tastenfeld.
Diese Buchstaben sind ebenfalls erlaubt.

\marklabel{EXEC}{\section{xxx\_EXEC\_ON\_RING-Variablen}}
Die xxx\_EXEC\_ON\_RING-Variablen dienen dazu Befehle auszuf"uhren, sobald
eine Nummer von Asterisk angerufen wurde.

Es sollten nur Befehle verwendet werden, die eine kurze Laufzeit haben, da
das entsprechende Telefon erst zu klingeln anf"angt, wenn der Befehl
vollst"andig abgearbeitet wurde.

Sind Befehle mit l"angerer Laufzeit unumg"anglich, kann man hier ein \& hinter
den Befehl setzen. Dies hat zur Folge, dass der Befehl im Hintergrund
abgearbeitet wird und das entsprechende Telefon sofort anf"angt zu klingeln.

\subsection{Anrufe protokollieren}
Wenn man eingehende Anrufe protokollieren m"ochte, kann man dies z.B. "Uber
die Variablen
\jump{ASTERISKSIPNEXECONRING}{ASTERISK\_SIP\_x\_EXEC\_ON\_RING},
\jump{ASTERISKPHONESNEXECONRING}{ASTERISK\_PHONES\_x\_EXEC\_ON\_RING} und
\jump{ASTERISKPHONESNEXECONRING}{ASTERISK\_CAPI\_EXEC\_x\_CMD} tun.

Eine EXEC-Variable k"onnte dann folgenderma"sen aussehen:

\begin{verbatim}
ASTERISK_PHONES_x_EXEC='echo "${DATETIME}: Recieved call from ${CALLERIDNAME}
(${CALLERID}) to ${EXTEN}" >/var/log/asterisk.phone10'
\end{verbatim}

(Alles in einer Zeile)

Eine Liste aller Asterisk-Variablen findet sich am Ende dieser Dokumentation.

\subsection{Liste aller Asterisk internen Variablen}


Folgende Asterisk-Variablen k"onnen in xxx\_EXEC\_ON\_RING-Variablen
verwendet werden:

\tablehead{\hline Variable & Bedeutung \\ \hline}
\begin{supertabular}{|l|p{9cm}|}
\$\{ACCOUNTCODE\} & Account code, if specified - see Asterisk billing \\
\$\{ANSWEREDTIME\} & Time when the call was answered. \\
\$\{CALLERID\} & The current Caller ID (name and number) \\
\$\{CALLERIDNAME\} & The current Caller ID name \\
\$\{CALLERIDNUM\} & The current Caller ID number \\
\$\{CALLINGPRES\} & PRI Call ID Presentation variable for incoming calls
(See callingpres ) \\
\$\{CHANNEL\} & Current channel name \\
\$\{CONTEXT\} & The name of the current context \\
\$\{DATETIME\} & Current date time in the format \& YYYY-MM-DD\_HH:MM:SS \\
\$\{DIALEDPEERNAME\} & Name of the called party. Broken for now, see
DIALEDPEERNAME \\
\$\{DIALEDPEERNUMBER\} & Number of the called party. Broken for now, see
DIALEDPEERNUMBER \\
\$\{DIALEDTIME\} & Time when the number was dialed. \\
\$\{DIALSTATUS\} & Status of the call. See DIALSTATUS \\
\$\{DNID\} & Dialed Number Identifier. Limitations apply, see DNID \\
\$\{EPOCH\} & The current UNIX-style epoch (number of seconds since 1 Jan
1970) \\
\$\{EXTEN\} & The current extension \\
\$\{HANGUPCAUSE\} & The last hangup return code on a Zap channel connected
to a PRI interface \\
\$\{INVALID\_EXTEN\} & The extension asked for when redirected to the i
(invalid) extension \\
\$\{CODECS\} & The current language setting. See Asterisk multi-language \\
\$\{MEETMESECS\} & Number of seconds a user participated in a MeetMe
conference \\
\$\{PRIORITY\} & The current priority \\
\$\{RDNIS\} & The current redirecting DNIS, Caller ID that redirected the
call. Limitations apply, see RDNIS \\
\$\{SIPDOMAIN\} & SIP destination domain of an inbound call (if appropriate) \\
\$\{SIP\_CODEC\} & Used to set the SIP codec for a call \\
\$\{SIPCALLID\} & The SIP dialog Call-ID \& header \\
\$\{SIPUSERAGENT\} & The SIP user agent header \\
\$\{PRIORITY\} & Current priority \\
\$\{TIMESTAMP\} & Current date time in the format \& YYYYMMDD-HHMMSS \\
\$\{TXTCIDNAME\} & Result of application TXTCIDName (see below) \\
\$\{UNIQUEID\} & Current call unique identifier \\ \hline
\end{supertabular}

Quelle: \link{http://www.voip-info.org/wiki-Asterisk+variables}{http://www.voip-info.org/wiki-Asterisk+variables}

\marklabel{hfcscard}{\section{Die HFC-S-ISDN-Karte}}
Um einen internen S$_{0}$-Bus bereitstellen zu k"onnen, bedarf es einer
speziellen ISDN-Karte mit HFC-S-Chipsatz. Diese Karten sind relativ selten,
sind aber durch ihren Billig-Chipsatz nicht wesentlich teurer als normale
ISDN-Karten.

Es gibt verschiedene Typen von HFC-S-Karten. Zum einen die Karte f"ur den
Otto-Normal-User mit nur einem RJ45 Port. Bezugsquellen von diesen
HFC-S-Karten sind u.A. Reichelt, Conrad oder eBay.

Welche Karten von Asterisk unterst"utzt werden findet man unter
\link{http://isdn.jolly.de/cards.html}{http://isdn.jolly.de/cards.html}

Die Firma junghanns.net GmbH bietet HFC-S-Karten f"ur Asterisk mit mehr als
einem Port an. Vom Asterisk-Pakete f"ur \eisfair werden folgende Junghanns
Karten unterst"utzt:


\newpage

\subsection{Verkabelung}

Bei dem Verbinden der HFC-S-ISDN-Karte mit den restlichen Telefonen, ist zu
beachten, dass der ISDN-Bus einmal gekreuzt werden muss. Hier eine Skizze
zur Veranschaulichung.

\begin{verbatim}
__
  |
  |--------------\/-----|----------------------|-----------|---...
  |--------------/\-----|----------------------|-----------|---...
  |--------------\/-----|----------------------|-----------|---...
  |--------------/\-----|----------------------|-----------|---...
  |                     |    interner S0-Bus   |           |
  |HFC-S-               |    der HFC-S-Karte   |           |
  |ISDN-              NTBA                    z.B.        z.B.
  |Karte          (zur Strom-              TK-Anlage      ISDN-
  |                versorgung)                           Telefon
  |
A |------------------------------------|-------------------|
S |------------------------------------|-------------------|----...
T |------------------------------------|-------------------|----...
E |------------------------------------|-------------------|
R |AVM         interner S0-Bus         |                   |
I |ISDN-      des Netzbetreibers       |                   |
S |Karte                              z.B.                NTBA
K |                                   ISDN-               zum
  |                                   Telefon         Netzbetreiber
  |
  |------------------------------------|-------------------|
  |------------------------------------|-------------------|
  |------------------------------------|-------------------|
  |------------------------------------|-------------------|
  |AVM         interner S0-Bus         |                   |
  |ISDN-        der TK-Anlage          |                   |
  |Karte                              z.B.              TK-Anlage
__|                                   ISDN-           mit internem
 |                                    Telefon            S0-Bus
 |
 |    _______
 |   |       |
 |___|  SIP- |
     | Phone |
     |_______|
\end{verbatim}


Alle oben gezeichneten Endger"ate sind optional. Aber nat"urlich w"are es
sinnvoll mindestens eines zu haben ;-)

\marklabel{INTERNAL}{\section{Interne Gespr"ache}}
M"ochte man ein Telefon anrufen, welches an die HFC-S-ISDN-Karte von Asterisk
angeschlossen oder ein SIP-Client ist, muss der Wert in
\jump{DIALPREFIX}{ASTERISK\_DIALPREFIX\_INTERNAL} plus die interne MSN des
entsprechenden Telefons gew"ahlt werden.

Ein Beispiel: Wenn ASTERISK\_DIALPREFIX\_INTERNAL='*' und das Telefon mit
der internen MSN 11 angerufen werden soll, muss als Telefonnummer *11
gew"ahlt werden.

\marklabel{VBOX}{\section{Die Voicebox}}
Jedes Telefon besitzt eine eigene Voicebox, wenn
ASTERISK\_PHONES\_x\_VBOX='yes'. Bei Bedarf k"onnen die empfangenen
Nachrichten auch per Mail weitergeleitet werden. (Siehe dazu
\jump{ASTERISKPHONESNVBOXMAIL}{ASTERISK\_PHONES\_x\_VBOX\_MAIL})

\subsection{Voicebox abh"oren}
Um die Voicebox abzuh"oren, muss der Prefix in
\jump{DIALPREFIX}{ASTERISK\_DIALPREFIX\_VBOX} definiert plus die interne MSN
des entsprechenden Telefons gew"ahlt werden.

Ein Beispiel: Wenn man die Voicebox des Telefons mit der internen MSN 11
abh"oren m"ochte und ASTERISK\_DIALPREFIX\_VBOX='\#9', muss die Telefonnummer
\#911 gew"ahlt werden.

Ist die Caller ID von dem Telefon, von dem die Voicebox angerufen wird,
nicht gleich der MSN der angerufenen Voicebox, so wird man aufgefordert, die
in \jump{ASTERISKPHONESNPIN}{ASTERISK\_PHONES\_x\_PIN} angegebene PIN
einzugeben. Um die Eingabe zu best"atigen, muss die \#-Taste gedr"uckt werden.

Die Voicebox kann "uber das \jump{Callthrough}{Callthrough-System} auch von
au"serhalb abgefragt werden.
\subsection{Das Men"u}
\begin{itemize}
\item 1 Nachrichten abrufen
\begin{itemize}
\item 3 Erweiterte Optionen
\begin{itemize}
\item 1 Antwort aufnehmen
\item 3 Weitere Informationen
\item * Zur"uck
\end{itemize}
\item 4 Vorherige Nachricht abspielen
\item 5 Aktuelle Nachricht wiederholen
\item 6 N"achste Nachricht abspielen
\item 7 Aktuelle Nachricht l"oschen
\item 8 Nachricht zu einer anderen Voicebox weiterleiten
\item 9 Nachricht in einen anderen Ordner speichern
\item * Hilfe
\item \# Beenden
\end{itemize}
\item 2 Ordner Wechseln
\item 0 Voicebox Optionen
\begin{itemize}
\item 1 Eigene Abwesenheits-Nachricht aufnehmen
\item 2 Eigene \glqq{}gerade besch"aftigt\grqq{} Nachricht aufnehmen
\item 3 Eigenen Namen aufnehmen
\item 4 Passwort "andern
\item * Zur"uck zum Hauptmen"u
\end{itemize}
\item * Hilfe
\item \# Beenden

\item Nachdem man eine seiner eigenen Nachrichten aufgenommen hat
\begin{itemize}
\item 1 - Akzeptieren
\item 2 - Nochmal anh"oren
\item 3 - Nochmal aufnehmen
\item 0 - Reach operator (not available when recording greetings/name)
\end{itemize}

\item Wenn eine Nachricht abgespielt wird
\begin{itemize}
\item * Vor spulen
\item \# Zur"uck spulen
\end{itemize}
\end{itemize}

Quelle:
http://www.voip-info.org/tiki-index.php?page=Asterisk\%20cmd\%20VoiceMailMain

\marklabel{DISA}{\section{Asterisk ohne HFC-S-ISDN-Karte}}
Es ist m"oglich Asterisk hinter einer TK-Anlage mit internem S$_{0}$-Bus zu
betreiben. In diesem Szenario ben"otigt man keine HFC-S-ISDN-Karte sondern
lediglich eine normale ISDN-Karte, die vom \eisfair CAPI-Paket unterst"utzt wird.

\hinweis{Diese Variante hat einen gro"sen Nachteil: Blockwahl funktioniert
nicht mehr. Dies braucht man z.B. bei Kurzwahl oder wenn man eine Nummer aus
der Anrufer liste direkt zur"uckrufen m"ochte. Deshalb muss man nach dem
Anrufen des Asterisk den H"orer abheben und kann dann die eigentliche Nummer
w"ahlen.}

\subsection{Konfiguration}
Um diese Feature nutzen zu k"onnen m"ussen in der \eisfair Konfiguration
folgende Einstellungen vorgenommen werden:

\begin{description}
\item[ASTERISK\_DIALPREFIX\_DISA]
Hier wird die MSN angegeben, die in der Konfiguration der TK-Anlage mit
internem S$_{0}$-Bus f"ur Asterisk vergeben wurde. Asterisk wird dann auf
dieser MSN f"ur eingehende Anrufe horchen.
\item[ASTERISK\_PHONES\_1\_TYPE]
Der Typ des Telefons muss 'disa' sein.
\item[ASTERISK\_PHONES\_1\_MSN]
Hier muss die Caller ID, also die Telefonnummer, des Endger"ates angegeben
werden, welches f"ur DISA benutzt werden soll.
Einige TK-Anlagen senden noch einen Prefix vor der Caller ID mit, damit
erkannt werden kann, dass der Anruf von intern kommt. In diesem Fall muss
dieser Prefix noch mit angegeben werden.
Wenn die Caller ID des Telefons z.B. 20 und der Prefix f"ur interne Gespr"ache
*, muss als MSN '*20' angegeben werden.
\item[ASTERISK\_PHONES\_1\_RING\_ON\_CAPI]
Diese Variable muss leer sein. Denn wenn man "uber das Festnetz angerufen
wird, managt das die TK-Anlage.
\end{description}

\subsection{Ablauf beim W"ahlen}
Um dann "uber VoIP ein Gespr"ach zu f"uhren, muss zuerst Asterisk angerufen
werden. -- Dies geschieht in diesem Fall mit Eingabe der 0 auf dem Telefon.
Danach w"ahlt man einen der Dialpr"afixe (ASTERISK\_DIALPREFIX\_SIP oder
ASTERISK\_DIALPREFIX\_CAPI), je nach dem auf welchen Weg man raus
telefonieren m"ochte. Und anschlie"send die normale Telefonnummer. (Nach
Eingabe der 0 muss der H"orer abgehoben werden, damit die Ziffern in
DTMF-T"onen und nicht "uber den D-Kanal "ubertragen werden.)

Beispiel: Wenn die ISDN-Karte im \eisfair die MSN 0 hat
(ASTERISK\_DIALPREFIX\_DISA='0'), der Dialprefix f"ur SIP *77 ist
(ASTERISK\_DIALPREFIX\_SIP='*77') und man Apu Nahasapeemapetilon in Indien
"uber VoIP anrufen m"ochte, dessen eigentliche Telefonnummer 0091 1234 8765
ist, dann muss auf dem Telefon folgende Nummer gew"ahlt werden: 0 [abheben]
*77 0091 1234 8765

\marklabel{Callthrough}{\section{Callthrough}}
Callthrough wird z.B. bei so genannten Callingcards verwendet. "Ublicherweise
ruft man eine kostenfreie Rufnummer an, man gibt seine PIN ein und kann
anschlie"send die eigentlich Nummer w"ahlen, mit der man verbunden werden m"ochte.

Dieses Feature unterst"utzt Asterisk ebenfalls. N"utzlich kann dies z.B. sein,
wenn man einen Telefontarif hat, bei dem man zu bestimmten Zeiten kostenlos
telefonieren kann.

So kann man von jedem Ort im Internet eine (kostenlose) Verbindung per SIP
zum heimischen Asterisk aufbauen und sich dann weiter "uber ISDN mit der
eigentlichen Nummer verbinden.

Ein weiteres Beispiel ist, wenn man von extern seine Voicebox abrufen
m"ochte. Ist z.B. folgende Konfiguration gegeben und man Apu
Nahasapeemapetilon in Indien "uber VoIP anrufen m"ochte, dessen eigentliche
Telefonnummer 0091 1234 8765 ist ...

\begin{verbatim}
ASTERISK_CALLTHROUGH_1_MSN='123456'
ASTERISK_CALLTHROUGH_1_ALLOW_1_PIN='1111'
ASTERISK_DIALPREFIX_SIP='000'
\end{verbatim}

... muss als Telefonnummer folgendes gew"ahlt werden:

\begin{verbatim}
123456 [abheben] 1111# 000 0091 1234 8765
\end{verbatim}

Die PIN muss mit \# best"atigt werden.

Siehe dazu auch die Beschreibung der
\jump{ASTERISKCALLTHROUGHNMSN}{ASTERISK\_CALLTHROUGH\_*} Variablen.

\marklabel{LCR}{\section{LCR - Least Cost Routing}}
Asterisk unterst"utzt das so genannte Least Cost Routing. Das bedeutet, dass
bei ausgehenden Gespr"achen "uber ISDN automatisch die g"unstigste Call-By-Call
Vorwahl vor die Nummer gew"ahlt wird.

Sollte ein Call-By-Call Anbieter "uberlastet sein, so wird automatisch der
n"achst teurere ausgew"ahlt.

Asterisk bekommt seine Routing-Daten von der Website telefon-sparbuch.de und
kann diese automatisiert auf den neusten Stand bringen.

Hierzu wird empfohlen sich eine neue Konfiguration zu erstellen, nach
welchen Kriterien Asterisk den Call-By-Call Anbieter ausw"ahlen soll. Auf der
folgenden Seite kann diese Konfiguration erstellt werden:

\link{http://www.telefonsparbuch.de/tmpl/calc/telephone/lcr/Asterisk/calc\_tk.htm?TKANLAGE\_BASE=Asterisk}{http://www.telefonsparbuch.de/tmpl/calc/telephone/lcr/Asterisk/calc\_tk.htm?TKANLAGE\_BASE=Asterisk}

Nachdem die gew"unschten Einstellungen vorgenommen wurden, klicken Sie auf
den Button 'Speichern' auf der Website (nicht auf 'LCR-Tabelle berechnen').
Es wird nun eine Datei zum Download angeboten, die Sie nach 'tsblcr.cfg'
umbenennen und unter folgendem Pfad auf dem \eisfair speichern:

/etc/asterisk/lcr/

Nach dem n"achsten Update der Routing-Tabelle (definiert in
ASTERISK\_LCR\_CRON) sollte die eben gespeicherte Konfiguration f"ur den
n"achsten Anruf verwendet werden.

M"ochte man nicht so lange warten, kann ein Update der Routing-Tabelle auch
manuell mit folgendem Befehl auf der \eisfair-Konsole angesto"sen werden:

/var/install/bin/asterisk-update-lcr

Die Einsparungen die mit LCR gemacht werden k"onnen, sind immens. Meist 25\%
ins Mobilfunknetz und bis zu 80\% ins Festnetz. Es w"are daher sehr l"oblich,
wenn ein Teil der Einsparungen als Spende in die Entwicklung des Asterisk
Pakets zur"uck flie"sen w"urde. So kann gesichert werden, dass der Umfang der
unterst"utzten Hardware stetig steigt. Spendeninformationen unter
\link{http://www.nettworks-ev.org/wie.htm}{http://www.nettworks-ev.org/wie.htm}

\section{Asterisk hinter einem Router}
Um Asterisk hinter einem Router betreiben zu k"onnen, m"ussen auf den
\eisfair folgende Ports forwardet werden:

\begin{verbatim}
10000 - 20000 (TCP, UDP)
5060 (TCP, UDP)
\end{verbatim}

\section{Asterisk als TAPI-Server}
\subsection{Was ist TAPI?}
Mit TAPI (Telephony Application Programming Interface) ist es u.A. m"oglich
eingehende Anrufe zu Clients zu signalisieren, die diese anhand einer
Datenbank einem Namen zuordnen k"onnen oder ein Fenster aufpoppen lassen, um
Notizen zum Gespr"ach ein zu tippen.

Es ist ebenfalls m"oglich, mit der entsprechenden Client-Software einen Namen
aus einer Datenbank auszuw"ahlen, welchen Sie anrufen m"ochten. Nun wird die
Nummer des Teilnehmers ermittelt und zum Asterisk "ubermittelt.

Nun besteht die M"oglichkeit, dass Asterisk ein Telefon anruft. Sobald man
abnimmt, wird man mit dem vorher ausgew"ahlten Teilnehmer verbunden, ohne
dass die Nummer auf dem Telefon gew"ahlt werden musste.

\subsection{Einrichtung der Treiber unter Windows}
Zun"achst l"adt man die Windowstreiber von
\link{http://sourceforge.net/projects/asttapi/} {http://sourceforge.net/projects/asttapi/} herunter und installiert diese.

Asttapi kann man nun in folgendem Men"u konfigurieren:

Systemsteuerung \pfeil Telefon- und Modemoptionen \pfeil Erweiterte Optionen
\pfeil Omniis TAPI-Driver for Asterisk \pfeil Konfigurieren

In dem nun folgenden Dialogfenster sollten folgende Einstellungen gemacht
werden:

\tablehead{\hline Bezeichnung & Wert \\ \hline}
\begin{supertabular}{|l|p{9cm}|}
Host: & [Hostname des \eisfair-Servers] \\
Port: & 5038 \\
User: & [Der in ASTERISK\_TAPI\_USER\_x\_NAME angegebene Benutzername] \\
Passwort: & [Das in ASTERISK\_TAPI\_USER\_x\_PASS angegebene Passwort] \\
User Channel: & Bei Telefonen, die an die HFC-S-Karte angeschlossen sind:
Zap/g1/[MSN*]; Bei SIP-Clients: SIP/[MSN*]; Bei DISA-Clients CAPI/[MSN*]:
(Man beachte den Doppelpunkt bei CAPI. \\
Inbound Channel: & ??? \\
\grqq Dial by 'Context'\grqq & \\
Context: & outgoing \\
Caller ID: & [MSN*] \\ \hline
\end{supertabular}

\begin{description}
\item[MSN*:]
Hier muss eine Nummer aus ASTERISK\_PHONES\_x\_MSN angegeben werden. Das
Telefon, bei welchem diese MSN einprogrammiert ist, wird klingeln, wenn auf
dem Client eine Nummer angew"ahlt wird.
\end{description}

\subsection{Konfiguration der Windows Wahlhilfe}
Text bitte an E-Mail

\section{Test-Rufnummer}
Um die Betriebsbereitschaft von Asterisk zu "uberpr"ufen, stehen folgende
Test-Rufnummer zur Verf"ugung:
\tablehead{\hline Nummer & Beschreibung \\ \hline}
\begin{supertabular}{|l|p{9cm}|}
\#100 & Spielt eine MP3 ab \\
\#101 & Gibt einen 1kHz Piep-Ton aus \\
\#102 & Nennt die Caller ID des Anrufers \\
\#103 & F"uhrt einen Echotest durch \\
\#104 & Zeit ansage \\ \hline
\end{supertabular}


\section{Hinweise zu SIP-Providern}
Alle nachfolgenden SIP-Anbieter werden von dem \eisfair Asterisk-Paket
unterst"utzt. Dies muss aber nicht hei"sen, dass anderen Anbieter nicht
funktionieren.

\subsection{Sipgate}
Als Benutzername ist hier der Teil vor dem @-Zeichen der SIP-Adresse
anzugeben. Lautet die SIP-Adresse z.B. 123456@sipgate.de, ist der
Benutzername 123456.

Als Passwort muss das SIP-Passwort eingegeben werden. (Nicht zu verwechseln
mit dem Passwort, mit dem sich beim Webinterface eingeloggt wird)

Der Hostname vom SIP-Proxy lautet sipgate.de


\subsection{GMX}
Als Benutzername muss hier die komplette Telefonnummer inkl. Landesvorwahl
ohne die beiden f"uhrenden Nullen angegeben werden. Ist die Festnetznummer
z.B. 051187654321 in Deutschland, lautet der Benutzername 4951187654321.

Als Passwort wird das normale GMX-Passwort angegeben, mit dem man sich auch
im Webinterface einloggt.

Der Hostname vom SIP-Proxy lautet sip.gmx.net.


\subsection{1\&1}
Als Benutzername muss hier die komplette Telefonnummer inkl. Landesvorwahl
ohne die beiden f"uhrenden Nullen angegeben werden. Ist die Festnetznummer
z.B. 051187654321 in Deutschland, lautet der Benutzername 4951187654321.

Als Passwort ist das f"ur die DSL-Telefonie anzugeben.

Der Hostname vom SIP-Proxy lautet sip.1und1.de.


\subsection{web.de}
Als Benutzername ist hier Userpart der E-Mail-Adresse anzugeben. Lautet die
E-Mail-Adresse z.B. mustermann@web.de, ist der Benutzername mustermann.

Als Passwort wird das normale web.de-Passwort angegeben, mit dem man sich
auch im Webinterface einloggt.

Der Hostname vom SIP-Proxy lautet sip.web.de.


\subsection{T-Online}
Als Benutzername ist hier die T-Online-Nummer und der Userpart der
E-Mail-Adresse, getrennt durch einen Doppelpunkt anzugeben. Lautet die
T-Online E-Mail-Adresse mustermann@t-online.de und die T-Online-Nummer
03299999999, muss als Benutzername 0329999999:mustermann angegeben werden.

Als Passwort ist das normale T-Online-Passwort anzugeben, welches auch bei
der Einwahl benutzt wird.

Der Hostname vom SIP-Proxy lautet tel.t-online.de.

\achtung{Der Name des SIP-Proxy (ASTERISK\_SIP\_x\_NAME) muss die
Zeichenkette \glqq{}t-online\grqq (Gro"s- und Kleinschreibung beachten)
enthalten, da T-Online eine Sonderbehandlung beim Schreiben der internen
Asterisk-Konfiguration ben"otigt.}

\subsection{Strato}
Als Username muss hier der Benutzername und das Passwort angegeben werden,
mit dem man sich auch beim Webinterface vom DSL-Login einloggt.
Der Hostname vom SIP-Proxy lautet strato-iphone.de.

\section{Beheben von Knacksern im Gespr"ach oder oder das Volllaufen des
Syslogs}
\subsection{Das Problem}
Im Syslog (/var/log/messages) treten folgende Fehlermeldungen auf:

\begin{verbatim}
Sep 14 17:43:33 eis kernel: zaphfc[0]: b channel buffer underrun: 1, 1
Sep 14 17:43:40 eis kernel: zaphfc[0]: b channel buffer overflow: 24, 24
[...]
Sep 14 17:37:51 eis kernel: zaphfc[0]: tx sync changed: 14, 8
Sep 14 17:37:51 eis kernel: zaphfc[0]: tx sync changed: 8, 8
Sep 14 17:37:52 eis kernel: zaphfc[0]: tx sync changed: 15, 9
Sep 14 17:37:52 eis kernel: zaphfc[0]: tx sync changed: 9, 9
\end{verbatim}

Oder es knackt, w"ahrend man "uber ein ISDN-Telefon an der HFC-S-Karte
telefoniert. -- Ein weiteres Symptom sind regelm"a"sige Aussetzer im
Freizeichen, wenn man den H"orer abnimmt.

Die HFC-S-Karte ben"otigt 8000 Interrupts/Sek., da der S0-Bus der vom
Asterisk bereitgestellt und somit auch synchronisiert wird mit 8kHz laufen muss.

F"ur einen PC ist dies relativ viel, aber wenn man Asterisk nicht auf dem
billigsten Mainboard laufen lassen m"ochte durchaus realisierbar.

Wenn es dennoch zu o.g. Logeintr"age, Knacksern im Gespr"ach oder Aussetzern
im Amtston (Freizeichen) kommt, helfen diese Tipps evtl. die Probleme zu
beseitigen.

\subsection{Wie viele Interrupts der HFC-S-Karte werden verworfen?}
Diese Frage kann mit dem Programm 'dahdi\_test' aus dem 'dahdi-tools'
Paket beantwortet werden.

Durch den Start des Programms werden Interrupts einer HFC-S-Karte simuliert.
Auf der Konsole wird in Prozentpunkten angezeigt, wie viele Interrupts
erfolgreich waren. Beenden kann man den Test durch die Tastenkombination Strg-C.

Eine Beispiel-Ausgabe sieht folgenderma"sen aus:

\begin{verbatim}
Opened pseudo zap interface, measuring accuracy...
99.987793% 100.000000% 100.000000% 99.987793% 99.987793% 100.000000% 100.000000%
100.000000% 100.000000% 100.000000% 100.000000% 100.000000% 100.000000%
100.000000%
99.987793% 100.000000% 100.000000% 100.000000% 100.000000% 99.987793%
100.000000%
100.000000% 100.000000% 100.000000% 100.000000% 99.987793% 100.000000%
100.000000%
100.000000% 100.000000% 100.000000% 100.000000% 100.000000% 100.000000%
100.000000%
100.000000% 100.000000% 100.000000% 100.000000% 100.000000% 100.000000%
99.987793%
--- Results after 47 passes ---
Best: 100.000000 -- Worst: 99.987793
\end{verbatim}

Bei Werten "uber 99,98\% sollten keine Aussetzer oder Knackser zu h"oren sein.
Falls doch, ist die Ursache an einer anderen Stelle zu suchen.

\subsection{Shared IRQ}
Die HFC-S-Karte sollte sich keinen IRQ mit einem anderen Ger"at im Rechner
teilen.
Eine "Ubersicht aller IRQs bekommt man auf der Konsole, indem folgender
Befehl eingegeben wird:

\begin{verbatim}
cat /proc/interrupts
\end{verbatim}

Eine Beispiel-Ausgabe k"onnte folgenderma"sen aussehen:

\begin{verbatim}
eis # cat /proc/interrupts
           CPU0       CPU1
  0:        166          0   IO-APIC-edge      timer
  1:          2          0   IO-APIC-edge      i8042
  8:       1232          0   IO-APIC-edge      rtc0
  9:          0          0   IO-APIC-fasteoi   acpi
 12:          4          0   IO-APIC-edge      i8042
 14:      16929          0   IO-APIC-edge      ide0
 16:      76563          0   IO-APIC-fasteoi   eth0
 18:       8401          0   IO-APIC-fasteoi   ide2, ide3, uhci_hcd:usb4
 21:          0          0   IO-APIC-fasteoi   ehci_hcd:usb1, uhci_hcd:usb2
 22:          0          0   IO-APIC-fasteoi   uhci_hcd:usb3
 23:          0          0   IO-APIC-fasteoi   uhci_hcd:usb5
NMI:          0          0   Non-maskable interrupts
LOC:    7939909    7940504   Local timer interrupts
SPU:          0          0   Spurious interrupts
PMI:          0          0   Performance monitoring interrupts
IWI:          0          0   IRQ work interrupts
RES:     180076     192827   Rescheduling interrupts
CAL:         32         45   Function call interrupts
TLB:      29961      29506   TLB shootdowns
TRM:          0          0   Thermal event interrupts
THR:          0          0   Threshold APIC interrupts
MCE:          0          0   Machine check exceptions
MCP:        106        106   Machine check polls
ERR:          0
MIS:          0
\end{verbatim}

Es ist zu sehen, dass sich die HFC-S-Karte (zaphfc) ihren IRQ mit dem
USB-Controller (usb-uhci, usb-uhci ) und der Netzwerkkarte (eth0) teilt.

Um das zu "andern, kann als erster Schritt versucht werden die HFC-S-Karte in
einen anderen PCI-Slot zu stecken. "Andert sich dadurch der IRQ nicht, muss
im BIOS der IRQ f"ur den entsprechenden PCI-Slot manuell vergeben werden.


\subsection{Interrupt-Verbrauch des Festplatten-Controllers drosseln}
In vielen F"allen tretend die o.g. Fehlermeldungen erst nach Zugriffen auf
die Festplatte(n) auf.

In diesem Fall ist es sinnvoll die HDDs im DMA-Modus zu betreiben (was
sowieso ratsam ist). Dies erreicht man mit folgendem Befehl:

\begin{verbatim}
hdparm -d 1 -X udma2 -c 3 /dev/hdx
\end{verbatim}

Tritt das Problem weiterhin auf, kann folgender Befehl angewendet werden,
welcher marginal die Performance der Festplatten negativ beeinflusst:

\begin{verbatim}
hdparm -u1 /dev/hdx
\end{verbatim}

Wie hoch dieser Performance unterschied ist, kann mit folgenden Befehlen
getestet werden:

\begin{verbatim}
hdparm -u0 /dev/hdx
hdparm -tT /dev/hdx
hdparm -u1 /dev/hdx
hdparm -tT /dev/hdx
\end{verbatim}

'x' steht f"ur die entsprechende Festplatte.


\subsection{IRQ der HFC-S-Karte auf einen h"oher priorisierten IRQ legen}
Tritt das Problem weiterhin auf, kann versucht werden den IRQ der
HFC-S-Karte auf einen h"oher priorisierten IRQ zu legen. Im Folgenden wird
zwischen APIC (Advanced Processor Interrupt Controller) und Non-APIC
Mainboards unterschieden. Generell ist es besser ein Board mit APIC zu
besitzen, da hier mehr IRQs zur Verf"ugung stehen und das Management dieser
besser funktioniert.

(APIC ist nicht zu verwechseln mit ACPI)


\subsubsection{Non-APIC Mainboards}
Die Reihenfolge der Priorisierung der IRQs ist folgende:

\begin{verbatim}
0 1 2 8 9 10 11 12 13 14 15 3 4 5 6 7
\end{verbatim}

Wobei 0 die h"ochste und 7 die niedrigste Priorit"at besitzt. Die IRQs 0, 1, 2
und 8 k"onnen nicht ge"andert werden. Es ist also empfehlenswert den IRQ der
HFC-S-Karte auf 9 zu legen.


\subsubsection{APIC Mainboards}
Ist man im Besitz eines Mainboards, welches APIC unterst"utzt (die meisten
modernen Boards k"onnen dies), hat man pro APIC-Controller 24 IRQs.

Welcher IRQ die h"ochste Priorit"at hat, kann durch Eingabe von

\begin{verbatim}
dmesg
\end{verbatim}

Es sollte eine Tabelle "ahnlich dieser ausgegeben werden.

\begin{verbatim}
NR Log Phy Mask Trig IRR Pol Stat Dest Deli Vect:
00 000 00 1 0 0 0 0 0 0 00
01 001 01 0 0 0 0 0 1 1 39
02 001 01 0 0 0 0 0 1 1 31
03 001 01 0 0 0 0 0 1 1 41
04 001 01 0 0 0 0 0 1 1 49
05 000 00 1 0 0 0 0 0 0 00
06 001 01 0 0 0 0 0 1 1 51
07 001 01 0 0 0 0 0 1 1 59
08 001 01 0 0 0 0 0 1 1 61
09 001 01 0 0 0 0 0 1 1 69
0a 001 01 0 0 0 0 0 1 1 71
0b 000 00 1 0 0 0 0 0 0 00
0c 001 01 0 0 0 0 0 1 1 79
0d 001 01 0 0 0 0 0 1 1 81
0e 001 01 0 0 0 0 0 1 1 89
0f 001 01 0 0 0 0 0 1 1 91
10 000 00 1 0 0 0 0 0 0 00
11 001 01 1 1 0 1 0 1 1 99
12 000 00 1 0 0 0 0 0 0 00
13 001 01 1 1 0 1 0 1 1 A1
14 001 01 1 1 0 1 0 1 1 A9
15 001 01 1 1 0 1 0 1 1 B1
16 000 00 1 0 0 0 0 0 0 00
17 001 01 1 1 0 1 0 1 1 B9
\end{verbatim}

Die erste Spalte gibt den IRQ in hexadezimaler Schreibweise an. Die letzte
die Priorit"at des IRQs, welche ebenfalls in hexadezimaler Schreibweise
angegeben ist.

Je h"oher die Priorit"at ist, desto besser f"ur die HFC-S-Karte.

In diesem Beispiel w"are der IRQ 23 (hex = 17) mit der Priorit"at 185 (hex =
B9) also die erste Wahl.

Quelle f"ur dieses Kapitel: \\
\link{http://www.asteriskguru.com/tutorials/pci\_irq\_apic\_tdm\_ticks\_te410p\_te405p\_noise.html}{http://www.asteriskguru.com/tutorials/pci\_irq\_apic\_tdm\_ticks\_te410p\_te405p\_noise.html}


\section{Glossar}
\begin{description}
\item[Interne MSN]
Intern bedeutet, dass diese MSN bei einem ISDN-Telefon eingetragen ist,
welches sich hinter dem Asterisk befindet. Z.B. an der HFC-S-ISDN-Karte.
Dieses Telefon kann erst einmal nicht von extern (also von au"serhalb) des
Asterisk angerufen werden, da diese MSN dort nicht g"ultig ist.

Damit das Telefon aber trotzdem klingelt, wenn jemand auf einer externen MSN
(s.u.) anruft, kann in
\jump{ASTERISKPHONESNRINGONCAPI}{ASTERISK\_PHONES\_x\_RING\_ON\_CAPI} eine
oder mehrere externe MSNs angegeben werden. Asterisk nimmt das Gespr"ach dann
auf der externen MSN entgegen und leitet es auf die interne MSN weiter.

\item[Externe MSN]
Eine externe MSN ist die Nummer, die dem Telefon-Anschluss, von der
Telefongesellschaft zugeteilt worden ist.
Bei der Telefonnummer aus Hannover (Vorwahl 0511) 0511 12345678 ist z.B. die
externe MSN 12345678.

\hinweis{MSNs werden grunds"atzlich ohne Vorwahl angegeben.}
\marklabel{callerid}{\item[Caller ID]}
Die Caller ID ist die komplette Telefonnummer. Sprich Vorwahl + MSN. Die
Caller ID von Apu Nahasapeemapetilon aus Indien ist z.B. 0091 1234 8765.
\end{description}
