SuSE GmbH

SuSE Support Database

Title: HylaFAX: Troubleshooting

----------

Mainpage o Searchform o History o Versions o Categories o Contents
Deutsch

----------

HylaFAX: Troubleshooting

This article is for people having trouble using the fax server HylaFAX(tm). Since the fax server is a very complex piece of software, it is recommended to read the documentation (see e.g. /usr/doc/packages/hylafax/html/index.html or HylaFAX homepage) first !

First let me give the answer to a frequently asked question :
HylaFAX currently doesn't support the sending of faxes via ISDN !

If you have problems in conjunction with SuSEFax/HylaFAX, please enter the command faxstat -srv at the command line. This way you will get a detailed answer to the question, if HylaFAX was configured correctly and if all components were started.

The command ps -ax |grep fax should at least show the following processes :

The first one represents the 'queuing agent', the latter is the 'protocol server'. It is responsible for the communication of clients with the server. Both get started automatically in the runlevels 2 and 3 (via /sbin/init.d/hylafax).

However a necessary precondition for this is, that the variable START_HYLAFAX in /etc/rc.config is set to yes !

Please also note, that the entry for faxgetty must be activated in /etc/inittab, if you want to receive faxes. If you used faxsetup to configure another device for the modem than /dev/modem (e.g. /dev/ttyS1), then modem must be replaced by ttyS1 in the same line !

Symptoms for a misconfiguration :

  1. SuSEFax asks for a password

  2. SuSEFax shows an errormessage like

  3. faxstat -srv e.g. reports :

Solution:

  1. Read /usr/doc/packages/hylafax/README.SuSE

  2. and also /usr/doc/packages/hylafax/html/*

  3. Read /usr/doc/packages/susefax/*

  4. The file /var/spool/fax/etc/hosts must have the following permissions and ownerships :
    -rw-------   1 uucp     uucp           36 Jul 16 15:06 /var/spool/fax/etc/hosts
    
    This file is neither comparable with /etc/hosts nor with /etc/passwd. You can find further information about the syntax of this file in the corresponding man page (man 5f hosts).

  5. It is not possible to start mgetty and faxgetty at the same time. Please check, that there is a comment-sign in /etc/inittab either in front of the line with mgetty or the one with faxgetty.

  6. The following question is asked by faxsetup in the beginning of the configuration :
    [...]
    There is no entry for the hylafax service in /etc/inetd.conf.
    The HylaFAX client-server protocol process can be setup to run
    standalone or started by the inetd program.  A standalone setup
    is preferred for performance reasons, especially if hfaxd is to
    support multiple protocols (e.g. SNPP); however it may require
    manual setup if your operating system does not have a System-V
    style init program.
    
    Should an entry be added to /etc/inetd.conf [no]?
    [...]
    
    You must answer 'no' to this question ! If you have nethertheless answered with 'yes', then remove the entry
    hylafax stream  tcp     nowait  fax     /usr/lib/fax/hfaxd      hfaxd -I
    
    from /etc/inetd.conf!

    If SuSEFax or faxstat report something like

    Login failed: 550 Cannot set privileges.
    
    then it is likely that the above mentioned entry can be found in inetd.conf.

  7. You send a fax, the modem dials and a connection to the opposite side gets established. However short time thereafter the connection gets terminated. The same phenomenon occurs when receiving faxes. In /var/log/messages or in a mail to root (when the reception of a fax failed) the following message occurs :
    Sep 13 11:25:30.62: [17562]: RECV FAX: Permission denied (unacceptable client TSI)
    
    Remove the following entry from the configuration file specific to your modem (/var/spool/fax/etc/config.devicename):
    QualifyTSI:		etc/tsi
    
    You might also create and configure this file. Please read the man page (man tsi) for further information.

  8. Increase the tracing value (e.g. to 527) in the files /usr/lib/fax/hfaxd.conf, /var/spool/fax/etc/config and /var/spool/fax/etc/config.devicename. This way you get more debugging information in /var/log/messages. If these cannot be understood, you can send them (e.g. via Cut&Paste) to the S.u.S.E. support.

  9. ... and of course please check all hints above.

There is also a FAQ about HylaFAX, that is available from http://www.vix.com/hylafax/FAQ/

----------

See also:

----------

Keywords: HYLAFAX, FAX, SUSEFAX

----------

Categories: HylaFax

----------

Mainpage o Searchform o History o Versions o Categories o Contents
Deutsch

----------

SDB-choeger_hylafax-problems, Copyright SuSE GmbH, Nuremberg, Germany - Version: 15. Jun 1998
SuSE GmbH - Last generated: 07. Oct 1999 16:37:21 by maddin with sdb_gen 1.00.0