Metainformationen zur Seite
Archivierter Artikel:
Dieser Artikel bezieht sich auf Version 4.x des UCware Servers und ist daher veraltet.
Den aktuellen Stand finden Sie hier.
[veraltet:] Faxen mit UCware
Die UCware bietet seit Version 4.2 in der Standardinstallation Softfax-Fähigkeiten. Die nötigen Einstellungen wurden gegenüber früheren Versionen vereinfacht, einige Schritte sind zur Inbetriebnahme aber dennoch nötig.
Grundlagen
Die UCware nutzt keine Faxtonerkennung, sondern stellt eingehende Faxe anhand eines frei wählbaren Prefixes zu. Alle Nutzer mit entsprechenden Rechten haben so automatisch eine persönliche Faxnummer. Soll dieses Prefix nicht nach außen kommuniziert werden oder liegt das Prefix außerhalb des Rufnummernblocks, müssen entsprechende Weiterleitungen oder Routen angelegt werden.
Beteiligte Softwarekomponenten
- asterisk
- t38modem
- hylafax-server
- postfix
Einstellungen auf der UCware
Für diese Anleitung wird eine fertig konfigurierte UCware mit Nutzern und einem funktionierenden Mailsetup vorausgesetzt.
Einstellungen in der ucware.php
Alle relevanten Optionen sind im Abschnitt FAX
zu finden. Folgende Variablen müssen gesetzt werden, damit das Faxen möglich ist.
- Faxfunktionalität aktivieren
$FAX_ENABLED = true;
- Das Prefix wählen, das signalisiert, dass der Anruf direkt zum Modem geroutet werden soll:
$FAX_PREFIX = '96';
- Um in Fehlerfällen von einer Konsole auf Hylafax zugreifen zu können, ist es sinnvoll, lokalen Zugriff ohne Passwort zu erlauben:
$FAX_NOAUTH_LOCALHOST = true;
Einstellungen in der Weboberfläche
- Alle Nutzer, die Faxe versenden und empfangen können sollen, brauchen das Recht
fax
. Je nach gewünschter Konfiguration muss entweder unter Administration - Gruppen der Gruppeusers
das Rechtfax
gegeben werden oder eine neue Gruppe mit dem Rechtfax
angelegt und die gewünschten Benutzer dieser Gruppe hinzuzufügt werden. - Nach der Rechtevergabe können die neuen Rechte mit
$ /opt/ucware/sbin/gs-hylafax-auth-update
direkt übernommen werden, ohne die UCware neuzustarten - Wenn dedizierte Faxnutzer angelegt werden, bietet es sich an, für jeden dieser Benutzer eine Weiterleitung von der Durchwahl des Benutzer auf
<Faxprefix><Durchwahl>
anzulegen. - Unter Administration - Fax müssen die Standardfaxnummer und eine Ausweichmailadresse festgelegt werden. Außerdem kann hier die Anzahl der Softmodems verändert werden. Nach dem Speichern ist die Erstkonfiguration auf der UCware abgeschlossen.
Einstellungen auf Patton-Gateways
Sind Patton-Gateways im Einsatz, muss hier T.38 aktiviert werden. Dazu muss das genutzte VoIP-Profil (Standardname default
für Smartware, DEFAULT
für Trinity) die folgenden Zeilen enthalten.
fax transmission 1 relay t38-udp fax bypass-method v150-vbd
Troubleshooting
- Überprüfen, ob die Softmodems laufen:
$ sudo service t38modem status
- Überprüfen, ob die Anzahl der Softmodems übernommen wurde:
$ ps aux | grep t38
- In der Ausgabe sollte die Befehlszeile pro konfiguriertem Softmodem ein
+/dev/ttyxN
enthalten, wobeiN
bei 0 beginnt und pro Modem inkrementiert wird - Beispiel mit zwei Softmodems:
/usr/bin/t38modem --trace --no-h323 --output /var/log/ucware/t38modem.log --username t38modem --route modem:.*=sip:<dn>@127.0.0.1:5060 --route sip:.*=modem:<dn> --no-gatekeeper --sip-listen udp$127.0.0.1:6060 --ptty +/dev/ttyx0,+/dev/ttyx1,+/dev/ttyx2
- In
/var/spool/hylafax/recvq/
werden empfangene Faxe zwischengespeichert, bevor sie per Mail versendet werden. - Die Mails, mit denen empfangene Faxe zugestellt werden, werden in
/var/log/mail.log
eingetragen. - Fehlerberichte werden in der Standardkonfiguration nicht versendet. Durch das Erstellen der Datei
/var/spool/hylafax/etc/FaxNotiy
mit dem Inhaltnotify: done+requeue
kann das Versenden an den jeweiligen Nutzer erzwungen werden. - Um alle Schritte von Hylafax nachvollziehen zu können, kann in der Datei
/etc/hylafax/config
die OptionServerTracing
auf0xFFF
gesetzt werden. Nach einem Neustart von Hylafax werden die Einzelschritte in/var/log/syslog
ausgegeben.