Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- heiko:tipps:fax-server:tipp_hylafax_02 [2018/08/07 22:00]
Heiko Teichmeier
+++ heiko:tipps:fax-server:tipp_hylafax_02 [2018/08/20 13:55]
@@ Zeile 1: / Zeile 1: @@
-~~META:
-date issued = 2008-01-01
-~~
-{{tag>[faxserver hylafax installation konfiguration linux heiko_teichmeier glauchau sachsen]}}
-===== Tipp HylaFAX (2) =====
-__letzte inhaltliche Überarbeitung:__ 01.01.2008
-===== 2. Installation und Konfiguration =====
-==== 2.1 Voraussetzungen =====
-Für die Funktion von Hylafax werden folgende Voraussetzungen benötigt:
-  * Modem oder CAPI 2.0-kompatible ISDN-Karte (ich verwende Fritz!Card PCI v.1)
-  * die <**//libtiff//**-Bibliothek zum Umwandeln der Fax-Dateien
-  * das Paket **//hylafax//** - der HylaFAX-Server
-  * das Paket **//hylafax-client//** - die Client-Programme f&uuml;r den HylaFAX-Server
-  * das Paket **//hylafax//** - der HylaFAX-Server
-  * die **//AVM CAPI-Treiber//** (in meinem Fall fcpci-kmp-0.1_2.6.22.17_0.1-0.x86_64.rpm)
-  * das Paket **//capi4linux//**
-  * das Paket **//capi4hylafax//**
-=== 2.1.1 Zusatzhinweise zur CAPI-Variante ====
-Wegen der selbst gemachten Erfahrungen hier einige Tipps bei der Umsetzung der CAPI-Variante:
-AVM bietet die quellcode-offenen Treiber und die Sourcen dazu nur noch in einer Version für SuSE 9.3 an. In OpenSuSE werden keine closed-Source-Treiber mehr in die Zusammenstellung aufgenommen um die GPL-Kompatibilität beizubehalten.
-Hat man also ein aktuelles (Open)SuSE-System muss man entweder selbst kompilieren oder man sucht sich im Internet ein vorkompiliertes Paket. Dabei muss das Kernelmodul mit den AVM Treibern zur Hardware **//UND//** zur Kernel-Version passen. Dank der fleißigen Mannen auf [[http://opensuse.foehr-it.de]] kann man dort die Kernelmodule für (bestimmt?) alle aktuellen AVM Produkte und für die neuesten OpenSuSE Kernelversionen herunterladen.
-**Dafür ein Riesen-DANKESCHÖÖÖÖÖN!!!**
-Ich bekam nun ein Problem, da ich die Fritz!CardDSL v.1.0 und einen 64-Bit Prozessor von AMD sowie den zugehörigen 64-bit Kernel im Rechner vereint hatte. Nach mehreren Versuchen der Installation und immer neuen Misserfolgen stellte ich fest, dass es für diese Hardware keine 64-bit-Treiber gibt.
-Daraufhin rüstete ich ab, da ich zum Glück inzwischen einen DSL-Router mein eigen nannte, und baute mir eine alte Fritz!Card PCI v.1 ein. Mit dieser und dem (Treiber) Kernelmodul **//fcpci-kmp-0.1_2.6.22.17_0.1-0.x86_64.rpm//** gelang es mir dann relativ einfach mein ISDN-System und den HylaFAX-Server zum Laufen zu bringen.
-==== 2.2 Installation und Konfiguration ====
-Durch die Verwendung der RPM-Pakete gestaltet sich die Installation der o.g. Pakete relativ einfach. Entweder man erledigt das auf der Kommandozeile [[heiko:tipps:linux-grundlagen:tipp_linuxgrundlagen_01#software-installation_-_RPM|(siehe Tipps zu RPM auf dieser HP)]] oder man verwendet die Softwareverwaltung von YAST.
-=== 2.2.1 ISDN und CAPI testen ===
-Hat man alle Pakete installiert und das ISDN-Paket mit ''<nowiki>rcisdn (re)start (OpenSuSE) bzw. /etc/init.d/isdn (re)start</nowiki>'' neu- bzw. gestartet, sollte man als erstes kontrollieren ob die CAPI-Treiber arbeiten.
-Dies kann man mit folgendem Befehl prüfen: ''<nowiki>capiinfo</nowiki>''.
-Daraufhin sollte einige Zeilen mit Informationen zu den von der CAPI unterstützten Funktionen angezeigt werden:
-<sxh bash; gutter: false;>
-linsrv2:/tmp # capiinfo
-Number of Controllers : 1
-Controller 1:
-Manufacturer: AVM GmbH
-CAPI Version: 2.0
-Manufacturer Version: 3.11-07  (49.23)
-Serial Number: 1000001
-BChannels: 2
-Global Options: 0x00000039
-   internal controller supported
-   DTMF supported
-   Supplementary Services supported
-   channel allocation supported (leased lines)
-B1 protocols support: 0x4000011f
-kbit/s with HDLC framing
-kbit/s bit-transparent operation
-   V.110 asynconous operation with start/stop byte framing
-   V.110 synconous operation with HDLC framing
-   T.30 modem for fax group 3
-   Modem asyncronous operation with start/stop byte framing
-B2 protocols support: 0x00000b1b
-   ISO 7776 (X.75 SLP)
-   Transparent
-   LAPD with Q.921 for D channel X.25 (SAPI 16)
-   T.30 for fax group 3
-   ISO 7776 (X.75 SLP) with V.42bis compression
-   V.120 asyncronous mode
-   V.120 bit-transparent mode
-B3 protocols support: 0x800000bf
-   Transparent
-   T.90NL, T.70NL, T.90
-   ISO 8208 (X.25 DTE-DTE)
-   X.25 DCE
-   T.30 for fax group 3
-   T.30 for fax group 3 with extensions
-   Modem
-  39000000
-f010040
-b0b0000
-  bf000080
-  00000000 00000000 00000000 00000000 00000000 00000000
-  01000001 00020000 00000000 00000000 00000000
-Supplementary services support: 0x000003ff
-   Hold / Retrieve
-   Terminal Portability
-   ECT
-PTY
-   Call Forwarding
-   Call Deflection
-   MCID
-   CCBS
-</sxh>
-Sollte es bei Dir auch so aussehen scheint alles geklappt zu haben und Du kannst mit der Konfiguration von HylaFAX weitermachen.
-== 2.2.2 Konfiguration des HylaFAX-Servers ==
-Bei OpenSuSE findet man die HylaFAX-Dateien im Pfad: ''<nowiki>/var/spool/fax</nowiki>''.
-Der Befehl ''<nowiki>faxsetup</nowiki>'' auf der Kommandozeile eingegeben, startet das Setup (die Konfiguration) des HylaFAX-Servers.
-Es werden auf der Kommandozeile in einem Frage-Antwort-Dialog (Vorgabe von empfohlenen oder Defaultwerten in eckigen Klammern ''<nowiki>[]</nowiki>'') alle notwendigen Angaben abgefragt. Nachfolgend habe ich die Dialoge dargestellt.
-<sxh bash; gutter: false>
-Setup program for HylaFAX (tm) 4.4.0.
-Created for x86_64-suse-linux-gnu on Sat Sep 22 00:29:04 UTC 2007.
-Found converter: /usr/bin/tiff2pdf
-Found uuencode encoder: /usr/bin/uuencode
-Found base64 encoder: /usr/bin/mimencode
-Found Quoted-Printable encoder: /usr/bin/mimencode -q
-Looks like /usr/bin/mimencode supports base64 encoding.
-Found mimencode for compatibilty: /usr/bin/mimencode
-Checking system for proper client configuration.
-Checking system for proper server configuration.
-Warning: /usr/sbin/mgetty does not exist or is not an executable
-program!
-The file:
-    /usr/sbin/mgetty
-does not exist or this file is not an executable program.  The
-HylaFAX software optionally uses this program and the fact that
-it does not exist on the system is not a fatal error.  If the
-program resides in a different location and you do not want to
-install a symbolic link for /usr/sbin/mgetty that points to your
-program then you must reconfigure and rebuild HylaFAX from source
-code.
-Warning: /usr/sbin/vgetty does not exist or is not an executable
-program!
-The file:
-    /usr/sbin/vgetty
-does not exist or this file is not an executable program.  The
-HylaFAX software optionally uses this program and the fact that
-it does not exist on the system is not a fatal error.  If the
-program resides in a different location and you do not want to
-install a symbolic link for /usr/sbin/vgetty that points to your
-program then you must reconfigure and rebuild HylaFAX from source
-code.
-Warning: /usr/sbin/egetty does not exist or is not an executable
-program!
-The file:
-    /usr/sbin/egetty
-does not exist or this file is not an executable program.  The
-HylaFAX software optionally uses this program and the fact that
-it does not exist on the system is not a fatal error.  If the
-program resides in a different location and you do not want to
-install a symbolic link for /usr/sbin/egetty that points to your
-program then you must reconfigure and rebuild HylaFAX from source
-code.
-Warning: /usr/share/ghostscript/Resource does not exist or is not
-a directory!
-The directory /usr/share/ghostscript/Resource does not exist or
-thisfile is not a directory.
-This is the directory where the HylaFAX client applications expect
-to locate font metric information to use in formatting ASCII text
-for submission as facsimile.  Without this information HylaFAX may
-generate illegible facsimile from ASCII text.
-Make /var/spool/fax/bin/ps2fax a link to
-/var/spool/fax/bin/ps2fax.gs.
-Make /var/spool/fax/bin/pdf2fax a link to
-/var/spool/fax/bin/pdf2fax.gs.
-Update /var/spool/fax/status/any.info.
-        HylaFAX configuration parameters are:
-        [1] Init script starts faxq:            yes
-        [2] Init script starts hfaxd            yes
-        [3] Start old protocol:                 no
-        [4] Start paging protocol:              no
-Are these ok [yes]?
-Modem support functions written to /var/spool/fax/etc/setup.modem.
-Configuration parameters written to /var/spool/fax/etc/setup.cache.
-No scheduler config file exists, creating one from scratch.
-Country code [1]? 49
-Area code []? 3763
-Long distance dialing prefix [1]? 0
-International dialing prefix [011]? 00
-Dial string rules file (relative to /var/spool/fax) ["etc/dialrules"]?
-Tracing during normal server operation [1]? 527
-Default tracing during send and receive sessions [0xffffffff]? 527
-Continuation cover page (relative to /var/spool/fax) []? etc/cover.templ
-Timeout when converting PostScript documents (secs) [180]?
-Maximum number of concurrent jobs to a destination [1]?
-Define a group of modems []?"any:."
-Time of day restrictions for outbound jobs ["Any"]?
-Pathname of destination controls file (relative to /var/spool/fax) []?
-Timeout before purging a stale UUCP lock file (secs) [30]?
-Max number of pages to permit in an outbound job [0xffffffff]? 30
-Syslog facility name for ServerTracing messages [daemon]?
-The non-default scheduler parameters are:
-CountryCode:            49
-AreaCode:               3763
-LongDistancePrefix:     0
-InternationalPrefix:    00
-ServerTracing:          527
-SessionTracing:         527
-ContCoverPage:          etc/cover.templ
-ModemGroup:             "any:."
-MaxSendPages:           30
-Are these ok [yes]?
-Creating new configuration file /var/spool/fax/etc/config...
-Restarting HylaFAX server processes.
-Should I restart the HylaFAX server processes [yes]?
-/etc/init.d/hylafax start
-Starting service HylaFAX                                          done
-You do not appear to be using faxgetty to notify the HylaFAX scheduler
-about new modems and/or their status.  This means that you must use the
-faxmodem program to inform the new faxq process about the modems you
-want to have scheduled by HylaFAX.  Beware that if you have modems that
-require non-default capabilities specified to faxmodem then you should
-read faxmodem(8C) manual page and do this work yourself (since this
-script is not intelligent enough to automatically figure out the modem
-capabilities and supply the appropriate arguments).
-Should I run faxmodem for each configured modem [yes]?
-/usr/sbin/faxmodem faxCAPI
-Done verifying system setup.
-</sxh>
-Ich verweise hierzu auf eine sehr gute und ausführliche Darstellung dieses Dialogs auf einer anderen Website => [[http://de.gentoo-wiki.com/FAX_Server]] sowie eine weitere mit einem sehr guten Überblick über die Konfigurationsparameter => [[http://www.linux-user.de/ausgabe/2001/08/035-sedlbauer/sedlbauer.html]]
-=== 2.2.3 "faxaddmodem" bei capi4hylafax ===
-Hat man <span class="bolditalic">capi4hylafax</span> installiert wird nach dem Start der Modemkonfiguration gefragt:
-<sxh bash; gutter: false;>
-linsrv2:/tmp # faxaddmodem
-Do you want setup a CAPI 2.0 based ISDN modem [no]?
-</sxk>
-Antwortet man hier mit <span class="bold">yes</span> startet ein einfaches Konfigurationsprogramm mit einfachen Boxen. Man wird freundlich darauf hingewiesen, dass dieses Programm nur die Einstellungen f&uuml;r "Cotroller 1" vornimmt. Sollte man mehr als einen Controller verwenden wollen wird man auf die Möglichkeit der händischen Bearbeitung der Datei **config.faxCAPI** hingewiesen.
-Im folgenden Dialog (mit den Pfeil- und der Eingabetaste navigier-/auswählbar) kann man folgende (sehr leicht verständliche) Einstellungen vornehmen:
-<sxh bash; gutter: false;>
-Outgoing MSN         50
-Incoming MSNs        -- is set --  (2. Setup)
-Accept Speech        Yes
-Accept Global Calls  No
-DDI Param            -- no DDI --
-Fax Number           +49.3763.xxxxxxx
-Fax Identifier       AVM CAPI4HylaFAX
-Number Prefix        [   empty   ]  (leer/ohne)
-Save & Exit
-</sxh>
-Beim Beenden des Setups mit "Save & Exit" wird man noch folgendermaßen informiert:
-<sxh bash; gutter: false;>
-Install was successfully!
-The Fax Receive Daemon c2faxrecv was added to /etc/inittab and will
-be started automatically on system start. You could start it
-manually now with telinit q.
-</sxh>
-dass alles erfolgreich war und was gemacht wurde.
-Eine Besonderheit hat hier die OpenSuSE 10.3 Distribution - die Setup-Datei ''<nowiki>config.faxCAPI</nowiki>'' wird einmal unter ''<nowiki>/etc</nowiki>'' mit dem vollen Inhalt abgelegt und dann noch eine abgespeckte Version im HylaFAX-Pfad (''<nowiki>/var/spool/fax/etc</nowiki>'') mit (bei mir) nur 3 Zeilen Inhalt:
-<sxh bash; gutter: false;>
-HylafaxDeviceName:        faxCAPI
-FAXNumber:                +49.3763.123456
-LocalIdentifier:          "AVM CAPI4HylaFAX"
-</sxh>
-Da die vollständige Datei im Verzeichnis ''<nowiki>/etc</nowiki>'' sehr gut kommentiert ist verzichte ich hier auf weitere Ausführungen.
-=== 2.2.4 Feineinstellung - es ist doch noch einiges machbar/notwendig ===
-An diesem Punkt ist man noch nicht ganz fertig - es warten noch ein paar Feinheiten auf ihre Einstellung:
-**__a) Zugriff erlauben__**\\
-In der Datei ''<nowiki>/var/spool/fax/etc/hfaxd</nowiki>'' müssen die erlaubten IP's oder Rechner-Namen eingegeben werden. Dabei kann man Muster mit dem Stern ''<nowiki>*</nowiki>'' als Platzhalter verwenden:
-<sxh bash; gutter: false;>
-localhost
-.0.0.0
-.168.*
-</sxh>
-**__b) Benachrichtigung Faxmaster, Dateiformat und Sprache__**\\
-In der Datei ''<nowiki>/var/spool/fax/bin/faxrcvd</nowiki>'' sollte man die dauerhafte Benachrichtigung des FaxMaster über jedes empfangene Fax abschalten. Dazu die Variable ''<nowiki>NOTIFY_FAXMASTER</nowiki>'' von ''<nowiki>always</nowiki>'' auf "never" ändern:
-<sxh sass; gutter: false;>
-NOTIFY_FAXMASTER=never
-</sxh>
-Mit der Variablen ''<nowiki>FILETYPE</nowiki>'' wird der Dateityp eingestellt, als der eingehende Faxe an Mailempfänger weitergeleitet werden. Als Standard ist hier mit ''<nowiki>ps</nowiki>'' Postscript eingestellt.
-Ich bevorzuge PDF und stelle dies deshalb ein:
-<sxh powershell; gutter: false;>
-FILETYPE=pdf
-SENDTO=
-</sxh>
-Durch Einfügen der Variablen ''<nowiki>LANG=de_MX</nowiki>'' wird die Sprache für die per Mail versendeten Meldungen des FaxServers eingestellt. Diese Option ist mir aber erst seit den 4.4.x-Versionen bekannt. (zusätzliches Verzeichnis ''<nowiki>./templates</nowiki>'' mit den unterschiedlichen Sprachdateien im ''<nowiki>fax-etc-Pfad</nowiki>'')
-<sxh powershell; gutter: false;>
-TEMPLATE=de
-</sxh>
-Diese Variable habe ich in alle Dateien geschrieben, die die Variable benutzen und laut der Manpage von ''<nowiki>faxrcvd</nowiki>'' in ''<nowiki>FaxDispatch</nowiki>'':
-<sxh bash; gutter: false;>
-/var/spool/fax/bin/FaxDispatch
-/var/spool/fax/bin/faxrcvd
-/var/spool/fax/bin/notify
-</sxh>
-In der Datei ''<nowiki>/var/spool/fax/bin/notify</nowiki>'' kann man einstellen, dass von jedem versendeten Fax in der Rückinfo-Mail an den Sender das versandte Dokument noch einmal als Datei-Anhang mitgesendet wird:
-<sxh powershell; gutter: false;>
-NOTIFY_FAXMASTER=never
-RETURNFILETYPE=pdf
-</sxh>
-Es sind noch andere Dateiformate möglich: **tif, pdf, ps, original (siehe "man notify")**.
-**__c) Empfängereinstellung Fax2Email__**\\
-Wenn man in die gleich anschließende Variable ''<nowiki>SENDTO</nowiki>'' einen Mailempfänger einträgt, erhält dieser alle eingehenden Faxe als Anhang per Mail zugesandt.
-Man kann aber auch die Empfänger entsprechend der einkommenden (angewählten) MSN differenzieren und so die Mails entsprechend zustellen. Dazu wird die Datei ''<nowiki>/var/spool/fax/etc/users</nowiki>'' verwendet. Wie im Beispiel dargestellt erst die Mailadresse des Empfängers und dann - mit Leerzeichen getrennt - die zugehörige MSN eintragen.
-<sxh bash; gutter: false;>
-user1@domain.com   50
-user2@domain.com   52
-</sxh>
-Ich denke, dass ihr nun erst einmal genügend zu tun habt.
-Nach dem Setup kann man mit: ''<nowiki>telinint q</nowiki>'' die geänderten Einträge in der ''<nowiki>/etc/inittab</nowiki>'' aktivieren.
-Dann sollte man mit: ''<nowiki>rchylafax restart</nowiki>'' (''<nowiki>/etc/init.d/hylafax restart</nowiki>'' - bei nicht-SuSE-Systemen) den Hylafax Server neu starten um alle Änderungen zu aktivieren.
-=== 2.2.5 Test zum Abschluss ===
-Mit: ''<nowiki>faxstat</nowiki>'' kann man den Status des Fax-Servers abrufen, was ungefähr folgendermaßen aussehen sollte:
-<sxh bash; gutter: false;>
-HylaFAX scheduler on linsrv2.teichmeier-gc.de: Running
-Modem faxCAPI (+49.3763.123456): Running and idle
-</sxh>
-Als Test kann man dann eine Tif-Datei als Fax versenden (z.B. Beispieldatei aus dem Verzeichnis ''<nowiki>/usr/share/doc/capi4hylafax</nowiki>''; in dieses Verzeichnis wechseln und) - folgenden Befehl auf der Kommandozeile/Shell eingeben:
-<sxh bash; gutter: false;>
-sendfax -n -d 03764123456 fritz_pic.tif
-</sxh>
-In der Log-Datei in ''<nowiki>/var/spool/fax/log/c000<Job-Nr></nowiki>'' kann man den Verlauf des Versandes nachvollziehen.
-Wenn man in der Datei ''<nowiki>(/var/spool/fax)/etc/config.faxCAPI</nowiki>'' den LogLevel durch Entfernen des Kommentarzeichens (''<nowiki>#</nowiki>'') aktiviert hat und den Wert möglichst hoch gesetzt hat (max. 4), kann man auch in der Datei ''<nowiki>/var/log/capifax.log</nowiki>'' alle Meldungen über Versand und Empfang nachlesen.

Heiko's Homepage

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge