BestInfoSite / Linux
HylaFax is a fax server that can run on Linux operating system. It is developed and maintained by HylaFax.org. It runs fine on debian as well as ubuntu distro of linux. Ubuntu is basically Debian with some added features to make it easy and more user friendly as well as more up-to-date. However the core base is still debian.
If you are a ubuntu user, you can use Synaptic Package Manager to download and install hylafax. Since it is not part of the core ubuntu package, you will need to add "Universe" to the list of sources where to download packages from. In Linux a package basically means a program. Just like in windows when you buy a program you may get multiple files as well as installation program, that is same for a Linux Package.
Remember, HylaFax is only a Fax Server. It neither has a fax client as I know of or gui (Graphical User Interface) for setup or alteration of setup. Thus carefully follow the setup instructions.
You can use apt to download and install HylaFax from the command prompt but in ubuntu, the universe has to be added to the sources.list file. At command prompt type: "apt-get install hylafax" without the quotes. Once installed you will need to run faxaddmodem program from command prompt to add one or more modems that you want hylafax to use. You will also need to add users, at least one, so you can get/view/delete the faxes that hylafax will receive. It however, does create a default user called faxmaster.
To send faxes from Windows you have several options. One of the ways is to use the program WHFC. This program will enable to "Print To Fax". First install WHFC. Then add/install a postscript printer (e.g., Apple LaserWriter 12/640 PS) in windows. Then change the port of that printer to WHFC. Now whenever you print to that printer, the printout will be capture by WHFC ready to be forwarded to HylaFax Server. After installation, run the WHFC program. If asks for password then keep cancelling it. Go to user preference and add username that should be identical to the username in HylaFax server already created previously as well as same password. Then go to system preferences and enter the hostname (Computer Name) running HylFax Server like ubuntu. Play around with other preferences.
To view Sending queue click S, for Receive queue, R and from Done queue D. You can delete faxes by clicking the trash can but only those items can be deleted that belongs to the active user!
WHFC is offer OLE for faxing programmatically from your own application. To use cover page you can use the faxcover.ps file in HylaFax computer. Simply copy it to a location of your preference and map that path in WHFC. It can reside on client computer or any other file server.
HylaFax can forward all received faxes to a designated email address. HylaFAX
can also automatically print all received faxes to an lpr printer (LAN
Servers). The printer would have to have PostScript capability.
Setting Up The Server
First install a modem. Then at command prompt type: Remember to activate universe in Ubuntu.
Next type following at command prompt:
You'll then be asked to confirm the values that you entered and then the utility will query to modem to determine the fax classes that it supports.
- Country code (1 for US)
- Area code
- Phone number of fax modem (Without the area code)
- Local identification string (this should be something like 'My Fax Server' as it is printed on the tag line of outgoing faxes)
- Long distance dialing prefix (1 in US)
- International dialing prefix (011 in US)
- Dial string rules file (accept the default)
- Tracing during normal server operation (accept the default)
- Tracing during send and receive operations (accept the default)
- Protection mode for received fax - enter 0644 (Otherwise you will have difficulty opening and deleting fax files)
- Protection mode for session logs - enter 0644
- Protection mode for ttySx - enter 0666
- Rings to wait before answer
Note: The default is 1 but setting it to 0 establishes your server as a "Send Only" fax system
- Modem speaker volume (valid values are OFF QUIET LOW MEDIUM HIGH (you may want to set it to HIGH for testing purposes as you can change it to OFF later)
- Command line arguments for getty (accept the default)
- Pathname of TSI ACL file (accept the default)
- Pathname of Caller-ID ACL file (accept the default)
- Tag line font file (accept the default)
- Tag line format string (accept the default)
- Time before purging UUCP lock (accept the default)
- Hold UUCP lockfile during data calls (accept the default)
- Hold UUCP lockfile during voice calls (accept the default)
- Percent good lines to accept (accept the default)
- Max consecutive bad lines to accept (you may want to reduce the default 5 to 3)
- Max number of pages to accept in a received fax (you may want to increase the default value of 25)
- Syslog facility name for ServerTracing messages (the default is 'daemon' but you could change it to 'local7' if you're logging to a remote syslog server)
- Set UID to 0 (accept default)
- Use priority job scheduling (accept default)
Remember ee is a linux console text editor (easy editor). Linux is cAsE sEnSiTiVe.
You have to run the faxaddmodem utility to create this file first though.
Next we'll set up HylaFAX to run automatically when you boot the system. Check the configuration file:
The ASCII file etc/hosts.hfaxd in the HylaFAX spooling area specifies the hosts and users that are permitted to access services through the hfaxd(1m) process. This file must exist for client access; if it is not present then hfaxd will deny all requests for service. Note also that this file must be readable only by the ``fax'' user; i.e. it should have mode 600 and be owned by ``fax''.
You can enter as "wide" of a network address or multiple narrower
address entries as you'd like. If you'd like to restrict access to specific
users you can enter their individual IP addresses. When done, save the file and
exit the editor.
NOTE: You will see the paths /var/spool/hylafax and /var/spool/hylafax/etc specified in HylaFAX documentation and utilities. Do NOT edit the files in these directories. The files are duplicated in the /etc/hylafax directory. If you ever want to manually edit the configuration files, only edit the files in the /etc/hylafax directory.Reboot the system by pressing Ctrl-Alt-Del and you'll have yourself a fax server! Once you're back at a shell prompt, type in the command:
HylaFAX scheduler on localhost: RunningThe first line indicates that the HylaFAX daemon is running. The second line indicates that the fax-modem is initialized and ready.
Modem ttyS0 (+1.111.555.1212): Running and idle
COMMUNICATION WITH HYLAFAX SERVER WITH TELNET
Connect to Telnet from Windows client by typing following at Command Prompt
telnet 192.168.0.33 4559
where the ip address of the server computer is 192.168.0.33
Hylafax answers on port 4559
Now login like this where faxuser is a user already created in the system with password being "mypassword":
Usernames are case sensitive
To delete a fax file from received faxes type:
This will delete the fax file named fax000000048.tif from recvq directory which is the default directory for received faxes. If you do not have proper permissions to delete the file, you will not be able to delete the file. Permission is OS (operating system) level and not just in HylaFax users file.
To End the connection type: