Written by Gene Cooper Monday, 30 October :01 - Last Updated Tuesday, 29 December :59

Transcription

1 Hylafax for SME 7 Documentation 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 rhel4.i386.rpm yum -y --enablerepo=base --enablerepo=updates localinstall hylafax rhel4.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]? 1 / 10

2 Phone number of fax modem [ ]? 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 You can also simply edit the /etc/inittab file, particularly if this is a reconfiguration or reinstallation. Configuration Set the Destination and 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 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 2 / 10

3 Create it like this if it doesn't exist: echo "FILETYPE=tif; SENDTO=FaxMaster; > /etc/hylafax/etc/faxdispatch Set Sent Fax 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 Fax sender's name admin Volume of speaker off Speed of modem/fax Serial port /dev/ttys0 Country code 01 Area dial code 520 Long distance dial 1 International dial / 10

4 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 4 / 10

5 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 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. 5 / 10

6 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 subject line: Fax received from "Strategic Dip Tradin" Edit the /etc/hylafax/etc/config.ttys0 (substitute your modem device) file and add: QualifyCID: QualifyTSI: etc/cid 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 6 / 10

7 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$!^$!^ $ ^.*$ QualifyCID I don't think my older fax modem knows about Caller-ID, so I don't use this. However, it works much the same way as QualifyTSI. Windows HylaFAX Clients Fax Cover Pages Hylafax cover page design and customization is very complex. Visit 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 sales@sonoracomm.com to order. 7 / 10

8 It is a commercial package that sells for : Frog Fax No. of Licenses Costs per License 1-9 $ $ $ $19 Site License $5,000 HylaFAX-Client 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. 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 - 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 8 / 10

9 - 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 9 / 10

10 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 10 / 10