Difference between revisions of "Handbook:Server Operation:Sending Faxes"

One of the many reasons for using HylaFAX is for the ability to submit faxes from any networked computer, in any order, and in any quantity. HylaFAX will work away at them without anyone ever walking to a fax machine, and better yet, nobody will be wasting their time watching paper pass through it... page after page after boring page. If there's a busy signal or no answer, HylaFAX will try later, no need to remember in a few minutes. HylaFAX remembers its job well.

HylaFAX server must interact with a client program of some kind to receive its faxing instructions. These client programs may reside on another computer, on the same system as HylaFAX server, or (as in most cases) a combination of client programs both on the HylaFAX system and off work together for proper fax sending.

This section deals with several different approaches to this task. However, it is advisable to at least understand the basics of the HylaFAX client programs themselves, as sent-fax problem debugging and troubleshooting is best done at that level first. The essential HylaFAX client programs with which to be familiar are: faxcover(1), faxmail(1), faxrm(1), faxstat(1), and especially sendfax(1). A good reading would also include hylafax-client(1).

For another HylaFAX client list, see Client_Software

*NIX Clients

• HylaFAX itself, of course! Read sendfax(1). Typical usage would be something like:
  'sendfax -f "myname@mydomain.com" -R -r "faxsubject" -c "coverpage comments" -x "Recipient's company" -d "Recipient@1234567" tofax.ps' where myname@mydomain.com is a valid e-mail address for the sender, 1234567 is the number where to fax, and tofax.ps is the image file to be faxed. Standard HylaFAX-compatible file formats are ASCII, TIFF, PostScript, and PDF (in versions newer than 4.1beta2). Be aware that sendfax is capable of handling multiple -d options and that only the options that precede it apply to that instance of the -d. In most cases the -d option is the last option that should be used.
• SuSEFax - See the printed SuSE manual for SuSEFax information.
• tkhylafax is a popular Unix/X11 tcl/tk interface to HylaFAX. Get it at ftp://ftp.hylafax.org/contrib/tkhylafax. See a screen shot here.
• ksendfax - http://www.sad.it/~jug/ksendfax/. RPMs are available at RedHat's ftp, also.
• GFax - http://www.cowlug.org/gfax/. Front End Gnome Fax Software For Linux. Requires Gnome 1.2 or newer such as the Helix release.

Windows Clients

• WHFC - See http://www.uli-eckhardt.de/whfc/doku/index.shtml for documentation and installation information. See http://www.uli-eckhardt.de/whfc/download.shtml for downloading.
• RelayFax - RelayFax is a commercial product sold by Alt-N Technologies. It has its own fax-server software, but because it uses an email-to-fax method, the RelayFax client software may be used in conjunction with a HylaFAX server using sendmail and procmail. See http://www.hylafax.org/howto/clients/RelayFax.html for more information.
• Cypheus from Bodo Noering is for Windows. It is quite versatile, feature-rich, and has been well-supported. Cypheus serves well as a fax administrator utility. Get it from http://www.cypheus.de/
• HylaFSP - A simple, user-friendly client for faxing from Windows 2000/XP. HylaFSP plugs directly into Microsoft's own 'fax services' and includes support for coverpages (via Microsoft's coverpage editor), local and shared contacts, and generates high-quality TIFF output for great looking faxes. Homepage is at http://www.ifax.com/HylaFSP/.
• Respond and adiXein - Uses a Samba share on the HylaFAX server to send print jobs to the faxing scripts. See http://www.boerde.de/~horstf/ for Respond and http://www.adixein.com/fax for adiXein.
• w2hfax - w2hfax is a versatile HylaFAX client, allowing sending files directly or sending a fax via printer driver; view incoming and outgoing fax; cancel and delete fax from the incoming, outgoing or sent folder; viewing job details; and address books. See http://w2hfax.sourceforge.net/.
• Winprint HylaFAX is a GPL Windows print monitor designed to send its output directly to a HylaFAX Server. See: http://winprinthylafax.sourceforge.net/.

Mac Clients

• MacFlex - see http://homepage.mac.com/robthedude/MacFlex/
  Note: MacFlex requires the use of the "old" protocol/ports. /etc/init.d/hylafax (on some OSes) needs changes. See http://www.hylafax.org/archive/2000-08/msg00356.html and http://www.hylafax.org/archive/2000-08/msg00409.html. There may be security issues with this configuration, however. See http://www.hylafax.org/archive/2000-08/msg00421.html.
• SDFax - SDFax is a commercial print driver for the Macintosh computer. The print job is formatted in either PostScript or TIFF formats and is sent via e-mail to a fax server in the Internet TPC Fax Project. See http://www.sdesign.com/sdfax1x/mac_os/.

Cross-Platform Clients

• Pyla is a GPL Python client similar to WHFC. See: http://www.teamsw.it/pyla/.
• Hermes is a web-enabled browser-driven client run from a web server. See: http://www.hermesfax.it/en/index.html.
• JHylaFax is a platform independent Java client licensed under the GPL featuring a Swing user interface. See http://jhylafax.sourceforge.net.
• gnu.hylafax - The gnu.hylafax package is a pure-Java implementation of the HylaFAX client protocol. The gnu.hylafax package can be used to implement a HylaFAX client that will run on any Java-supporting system. See http://www.net-foundry.com/java/gnu/hylafax/.
• Bernd's SendFax.java - See http://sourceforge.net/project/showfiles.php?group_id=5469.

Email-To-Fax Configuration

• faxmail - faxmail is a HylaFAX client program which takes an electronic mail message on standard input and converts it to PostScript in a form that is suitable for transmission as a facsimile. Read the man page: faxmail(1). In order to use faxmail as an email-to-fax gateway, typically some degree of "sendmail mangling" must be done. See http://www.hylafax.org/howto/clients/sendmail-faxmail-mangling.html and http://www.hylafax.org/howto/clients/faxmail-nonrandom-host.html for more information.
• email-to-fax with procmail - If procmail is your mail delivery agent (MDA), then you can easily configure it to handle outbound faxes by setting up a dedicated user account for faxing out and placing appropriate recipes in that user's $HOME/.procmailrc file. Outbound faxes are then e-mailed to this user account. This is how the above-mentioned RelayFax client works, which already has a simple generic email-to-fax capability built-in.

Faxing From Samba

It is possible to send a (Hyla)FAX by printing to a Samba-defined fax-printer using a Windows client. This is the recipe:

• Manual:
  1. Make up your document (text, pictures, whatever) on a Windows (-alike) client.
  2. ANYwhere in your text, specify the fax number you want to send the document to, i.e.:
     Fax-Nr : 012-345-6789
  3. Print, using a Postscript driver, to the printer on your HylaFAX server system.
  4. As soon as the fax has been sent, you will be notified by email. If a failure occurs, an email will be sent to you too.

• Prerequisites:
  1. We assume you have a "standard" *NIX and HylaFAX setup.
  2. You have a standard Windows-like client i.e., 95, 98, ME, NT, or 2000. OS/2 will also work fine, as long as it supports drive sharing.
  3. You use the Samba package to share system resources with the clients - and it is working fine already, meaning that you can log-on as a client. <P>
• To setup do the following:
  1. Put the following lines in /etc/printcap and delete (if applicable) any other faxprinters:

     faxlp:\
       :lp=/dev/null:\
       :sd=/usr/spool/lpd:\
       :if=/var/spool/hylafax/bin/sambafax:\
       :sh:sf:mx#0: 
  

  Note: due to some UNIX history the directories /var/spool/ and /usr/spool/

  contain the same information, so you use the one that is already present on your machine.
  
  2. Store <A HREF="clients/sambafax">this script</A> as /var/spool/hylafax/bin/sambafax, or in the /bin directory of your HylaFAX tree (but then adjust the path in printcap). Make sure the script is executable, using "chmod +x sambafax".
  
  3. restart lpd and samba
  

  
  4. On your client, install a new printer with a postscript driver (like an Apple Laserwriter) to print to \\YOURSERVER\faxlp
  
  5. Create a fax using your favorite wordchewer and take up a line like:
     Fax-Nr : 012-345-6789
  and print to your new faxprinter. <P>

• Note 1: The sambafax program will look for the following syntax in the printfile:
  

  ...text>FAX-NR<1 or 2 spaces>:<1 or 2 spaces><fax number><text...

  The search is case-insensitive. The first non-nummeric, non-dash in the fax number will terminate the number.

• Note 2: If you print with a Postscript driver, the output sent to the HylaFAX server is ASCII, a lot of control sequences, and your text in-between. Some printer drivers break up the lines in your text (because postscript does not care about CRLF's). If that happens, the faxnumber will not be located. If using the Windows Apple Laserwriter driver, use the EPS Postscript option.
• Note 3: for the same reason, the textual makeup must be the same for the complete FAX-NR line! </UL> If there are any difficulties or questions, do not hesitate to contact Ignace Suy <A HREF="mailto:ignace.suy@purpel3.nl">ignace.suy@purpel3.nl</A> He has provided a sambafax web-site at: http://www.purpel3.nl/sambafax/. Please refer to it for the most up-to-date information. If you are working with it, drop him a line. Sambafax is now suited to run under the printing systems lpd, LPRng and CUPS. For CUPS the installation is somewhat different. Refer to the website above. ==Faxing via IBM AS/400==