Sonora Communications, Inc.

Hylafax for SME 7

Documentation

http://hylafax.org

More info here and here.

Recommended Fax Modems

• MultiTech MT2834ZDXB configured as Class 2 (recommended)
• MultiTech MT5634ZBA-V92 configured as Class 1
• USR Courier V.Everything (not other USR models!)
  • dip switch settings for V.Everything - 3, 5, 8 DOWN (ON) and all others UP (OFF)

Installation

This cut and paste example assumes your modem is on ttyS0 (COM1:). Adjust for your application.

wget ftp://ftp.hylafax.org/binary/linux/redhat/\
RPMS/i386/hylafax-4.4.2-1rhel4.i386.rpm
yum -y --enablerepo=base --enablerepo=updates \
localinstall hylafax-4.4.2-1rhel4.i386.rpm
mv /etc/cron.daily/hylafax /etc/cron.weekly/
ln -s /etc/rc.d/init.d/hylafax /etc/rc.d/rc7.d/S92hylafax
faxsetup

During faxsetup, in general, if you don't know the answer to a configuration question, just use the default setting that is provided. For example, you can accept the defaults for all but the following fields when running “faxsetup”.

Serial port that modem is connected to [ ]? ttyS0
Area code [123]?
Phone number of fax modem [123.1234]?
Local identification string (for TSI/CIG) ["Business Name"]?
Protection mode for received facsimile [0644]?
Protection mode for session logs [0644]?
Protection mode for ttyS0 [0666]?
Rings to wait before answering [2]?
Pathname of TSI access control list file...?  etc/tsi
Pathname of Caller-ID access control list file...? etc/cid

Faxsetup will automatically call faxaddmodem. If you make a mistake during faxaddmodem, just control-c to exit and restart the faxaddmodem script with the command 'faxaddmodem'.

Next, finish up the installation by configuring /etc/inittab to run the faxgetty process:

mkdir -p /etc/e-smith/templates-custom/etc/inittab
echo "fax:23457:respawn:/usr/sbin/faxgetty ttyS0" > \
/etc/e-smith/templates-custom/etc/inittab/S85hylafax
/sbin/e-smith/expand-template /etc/inittab
/sbin/init q

Configuration

Set the Destination and E-mail Attachment File Type for Received Faxes

Using the Server-Manager, create a new group called 'faxmaster'. Add one or more users to this group who will receive incoming faxes to their e-mail mailboxes.

Create (or edit) the /etc/hylafax/etc/FaxDispatch file and set the file type to 'ps', 'pdf' or 'tif'. If you'd like to edit or mark up the received faxes, you might find 'tif' most convenient.

View /etc/hylafax/etc/FaxDispatch first to see if any changes are necessary:

cat /etc/hylafax/etc/FaxDispatch

Create it like this if it doesn't exist:

echo "FILETYPE=tif;
SENDTO=FaxMaster;
FROMADDR= This e-mail address is being protected from spambots. You need JavaScript enabled to view it ;" > /etc/hylafax/etc/FaxDispatch

Set Sent Fax E-mail Attachment File Type

Create (or edit) the /etc/hylafax/etc/FaxNotify file and set the file type to 'ps', 'pdf' or 'tif'.

echo "RETURNFILETYPE=tif;" > /etc/hylafax/etc/FaxNotify

Allow Users to Fax

Control over who can fax is controlled by the /etc/hylafax/etc/hosts.hfaxd file. Permissions must be 600.

To allow users to fax, you have to use the faxadduser command. Older versions of HylaFAX allowed you to specify entire subnets, but that 'security weakness' has been 'fixed'.

faxadduser smeuser1 smeuser2 smeuser3 smeuser4 ...

Example Communications Settings

Fax number 888-4060
Fax sender's name admin
Volume of speaker off
Speed of modem/fax 19200
Serial port /dev/ttyS0
Country code 01
Area dial code 520
Long distance dial 1
International dial 011
Call prefix
Number of rings 1
Flow control rtscts
Type of modem/fax Class2
Dialling mode TONE
User's name faxmaster
SAMBA name fax
Paper size letter
Resolution 196
Notify Always
Date format MDY

Testing

Test Outbound Faxing From the Command Line

Locate a postscript file for testing:

locate .ps

Send the fax:

sendfax -n -D -d /path/to/file.ps

or

sendfax -n -h 'localhost' -x 'Destination Company' -c 'Comments' \
-d 'user'@'faxnumber' '/path/to/file.ps'

Tail the log file to see what's going on:

tail -f /var/log/messages

Restart HylaFAX like this:

service hylafax restart

If You Have Problems

• try defining the modem as Class1 even if it is capable of Class2 or 2.0
• try an external modem
• only use modems known to work well with Hylafax
  • external modems are often easier to deal with and can be reset without a reboot
  • internal modems are OK, but only if they are REAL modems (no winmodems)
    • winmodems may work when running Hylafax in a VMware guest!
      • still not recommended

• real PCI modems will often be detected by the OS as ttyS4 or ttyS5
• dmesg | grep ttyS to determine
• If for whatever reason, you want to delete the old modem configurations and redo them, you can:
  • delete /var/spool/hylafax/etc/config.ttySx files
  • run 'faxaddmodem' from the command line

Blocking Fax Broadcasters (Fax Spammers)

You can block junk faxes in several ways. Here are two.

Keep in mind, these methods/files determine who is allowed to fax. You have to preface an entry with a bang (!) to indicate not allowed.

More info is here, here and here.

QualifyTSI - A Fax Blacklist of Sorts

The TSID of a received fax will be shown in the e-mail subject line:

Fax received from "Strategic Dip Tradin"

Edit the /etc/hylafax/etc/config.ttyS0 (substitute your modem device) file and add:

QualifyCID:                  etc/cid
QualifyTSI:                  etc/tsi

Create (edit) the /etc/hylafax/etc/tsi file and add these entries:

These entries will block incoming faxes with no TSID or a TSID with only a space, but will allow all others. Restart Hylafax if you just created the /etc/hylafax/etc/tsi file.

service hylafax restart

Now, above those entries, add your own entries to block your problem senders. Escape any spaces with a backslash. Your file will look something like this.

!^FBTECH.*$
!^0.*$
!^SATISFAX.*$
!^IOFAX.*$
!^IO_FAX.*$
!^PUREFAX.*$
!^Via\ Fax$
!^Strategic\ Dip\ Tradin$

!^Corp\ Travel\ Dept$
!^$
!^ $
^.*$

Windows HylaFAX Clients

Fax Cover Pages

Hylafax cover page design and customization is very complex. Visit http://www.hylafax.org/HylaFAQ/Q202.html for details.

HylaFSP

This client is for Windows 2000/XP and integrates the built in Windows fax client to Hylafax. It is simple and functional. It uses standard Windows cover pages and cover page editor...a major advantage for many. It is very simple and effective due to it's tight Windows integration. You may e-mail This e-mail address is being protected from spambots. You need JavaScript enabled to view it to order.

It is a commercial package that sells for :

No. of Licenses	Costs per License
1-9	$34
10-49	$29
50-249	$24
250+	$19
Site License	$5,000

Frog Fax

http://www.frogfax.com

HylaFAX-Client

http://www.swt-online.de/hylafax/index_eng.html

WinPrintHylaFax

This looks like a nice (free) choice if cover pages are not important or if they can be printed as part of your fax document.

http://winprinthylafax.sourceforge.net

WHFC

WHFC is a freely available client for the network fax server HylaFAX.

WHFC supports Windows 95/98/NT/2000 and supports:

• As many phonebooks as you like and ODBC support for the phonebooks
• Sending postscript files and sending a fax via a fax printer
• Supports sending to multiple fax addresses
• E-Mail notification on success and failure
• Removing faxes from the queue
• Dynamically update of the send queue status window
• Configurable per user
• Own Fax queue for using WHFC off-line
• Usable via OLE for macro processing
• Configurable Dial String/Separator for the Phonebooks
• Time zone selection
• Windows Setup program
• National language support

WHFC Installation/User Manual is included in HTML format in the zip file available for download.

The ability to use a fax cover page is supported in the WHFC. However it is currently not possible to send only a fax cover page. If you want to use cover pages, try HylaFSP.

You will find a generic cover page titled faxcover.ps in the WHFC subdirectory of the downloaded zip file. Copy this file into a directory of your choice, the phonebook directory for instance, and set the WHFC client

Fax > User Preferences > Faxcover

settings as appropriate.

RelayFax

RelayFax has been used by others. Licensing: unknown. Here is a howto.

Hylafax Command Line Tools

How to Delete a Fax Job From the Command Line

If you have created the administrative users you can delete fax jobs. First find out which fax jobs are not completed:

faxstat -s -l
faxrm -a

Which Faxjobs Have Been Submitted Today?

xferfaxstats -since '03/26/02 00:00'

Who Is Allowed To Fax With Hylafax?

Who is allowed to fax to our faxserver is configured in hosts.hfaxd. Note: allowing entire subnets is apparently deprecated.

man hosts.hfaxd

Administrative Access to Hylafax

Administrative users are allowed to remove faxjobs (faxrm), view all faxjobs (faxstat -s), etc. An administrative user is anyone who accesses Hylafax with command line programs as an administrative user. You don't have to be root.

Administrator users are listed in the file hosts.hfaxd. You can insert users like this:

faxadduser -a admin-password username

cat /etc/hylafax/etc/hosts.hfaxd

Restart Hylafax

service hylafax restart

< Prev		Next >