?Discussion

HylaFAX, an advanced open source fax server.

Based on http://lucasmanual.com/mywiki/FaxServer and http://www.aboutdebian.com/fax.htm

Contents

Installation

Install the hylafax-server package

apt-get install hylafax-server

Make sure your modem is connected. External modems may be connected via a serial port, or a USB port(when using a serial to USB converter.)

Xen / Virtualisation

Warning - It is possible that Hylafax may have problems running in a virtual environment. Fax sending and receiving is very time critical. There has been numerous cases where a setup is fine but the virtual environment causes failures that are hard to diagnose.

Initial Configuration

run the faxsetup utility to begin configuring hylafax.

faxsetup

When you press Enter, you'll see a lot of text fly by, as faxsetup checks system settings.
Assuming there were no errors, you will see a menu like the following:

        HylaFAX configuration parameters are:

        [1] Init script starts faxq:            yes
        [2] Init script starts hfaxd            yes
        [3] Start old protocol:                 no
        [4] Start paging protocol:              no
Are these ok [yes]?

press enter to answer yes
Next, faxsetup will write some configuration files, and ask you for permission to stop the faxq process, like the following.

Modem support functions written to /var/spool/hylafax/etc/setup.modem.
Configuration parameters written to /var/spool/hylafax/etc/setup.cache.

Restarting HylaFAX server processes.

You have a HylaFAX scheduler process running.  faxq will be
restarted shortly, as soon as some other work has been completed.
Can I terminate this faxq process (24932) [yes]?

Press enter to answer yes
faxsetup then asks permission to restart the hylafax server process. Press enter to answer yes
Since we have not set up a modem already, faxsetup will prompt you to run 'faxaddmodem'. Press enter to answer yes
- Enter the device name of the serial port your fax-modem is attached to(make sure your modem is connected to serial port not the parallel port). HINT: ttyS0 is for the first serial port (COM1 under windows/dos), and ttyUSB0 is the first usb-to-serial adapter.
- Next you'll be prompted for quite a few values. For most of them, you can accept the default values by pressing Enter. The values you'll want to enter are:

        * Country code (1 for US)
        * Area code (fill in with your area code)
        * Phone number of fax modem (in +1.xxx.xxx.xxxx format, for the US)
        * Local identification string (this should be something similar '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)

The next few values have to do with file system permissions for some created files. For a fax to email gateway, the defaults are acceptable, but if you want to share files directly out of the fax queue with a FTP or HTTP server, other permissions may be desirable.
Continue entering values:

        * Protection mode for received fax - enter 0644 if you want to share files directly, accept the default 0600 otherwise
        * Protection mode for session logs - enter 0644 if you want to share files directly, accept the default 0600 otherwise
        * Protection mode for ttySx - enter 0666 if sharing the modem, 0600 if you are using this modem only with hylafax
        * Rings to wait before answering - 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 to getty program (accept the default)
        * Pathname of TSI access control list file (accept the default)
        * Pathname of Caller-ID access control list file (accept the default)
        * Tag line font file (accept the default)
        * Tag line format string (accept the default)
        * Time before purging a stale UUCP lock file (accept the default)
        * Hold UUCP lockfile during inbound data calls (accept the default)
        * Hold UUCP lockfile during inbound voice calls (accept the default)
        * Percent good lines to accept during copy quality checking (accept the default)
        * Max consecutive bad lines to accept during copy quality checking (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, and want to separate fax logging from other log messages)
        * Set UID to 0 to manipulate CLOCAL (accept default)
        * Use available priority job scheduling mechanism (accept default)

You'll then be asked to confirm the values that you entered. Press Enter to accept them.
setupfaxmodem will now talk to the fax-modem to determine the best speed to talk to it, and the fax classes that it supports.
- If this step fails, there is a likely a communication problem with your modem. Examine possible remedies in the Common Errors Section.
Even if your modem supports both Class 1 and Class 2 you should set it to Class 1 to ensure compatibility with all fax machines.
You will then be asked for values specific to the modem. Just press Enter to accept the default values as they are a result of the modem query and the class you selected. You'll then be prompted to confirm these values by pressing Enter.
The non-default scheduler values will then be displayed followed by a confirmation prompt.
- Make sure all these values are correct. If they are not, answer No and correct any erroneous values.
- Note that you may want to increase the time value for "Timeout when converting ?PostScript documents" if you fax long documents.
- You can just press Enter to accept the default values.
assuming all of the above went smoothly, faxaddmodem will now return control to faxsetup, and you are done configuring your first modem.

If you are only configuring one fax-modem, answer no when asked if you want to configure another modem. Otherwise, answer yes, and perform the above faxaddmodem related steps again.
Next, accept the default yes answer to run faxmodem on your newly configured modem to verify settings.
You should now be returned to the shell prompt.
If you want to manually edit the files that contain these settings, use your favorite editor on the 'config' and 'config.MODEMDEVICE' files in /etc/hylafax (where MODEMDEVICE is the device the modem is attached to)
Next we'll set up HylaFAX to run automatically when you boot the system. Use your favorite text editor to examine the contents of the /etc/default/hylafax configuration file.
Make sure there's no # character at the beginning of the line containing RUN_HYLAFAX=1.

Assuming the above steps went well, running /etc/init.d/hylafax restart should result in hylafax listening to the modem for incoming faxes, and allowing local command line fax sending.

Sending a fax from the command line

To test our newly installed fax server, we're going to send a text file to a remote fax machine.

To send a fax from the command line, run the following command:

sendfax -n -d <PHONENO> /etc/issue.net

where <PHONENO> is the phone number of a fax machine you can receive a fax at (that is not on the same phone line as your hylafax server).

assuming all went well, you should now have a fax waiting on you at the phone number you entered.

Configuring Network Faxing

Now we're going to let HylaFAX know who on the local network is allowed to send faxes. If you are not allowing local network users to use this fax server, you can skip this section.

Access Controls

To allow users on the local network access to the fax server, you can use a subnet wide rule to let everyone use it, or select individual addresses.

Edit the /etc/hylafax/hosts.hfaxd file with your favorite text editor.
- For example, if your using a network has addresses in the range 192.168.10.0, and your subnet is 255.255.255.0, you would enter the following line into the hosts.hfaxd file:

192\.168\.10\.:::

Likewise, if your using a network containing addresses in the range 172.16.0.0, and your subnet is 255.255.0.0, your hosts.hfaxd file entry would be:

172\.16\.:::

You can enter as "wide" of a network address as you like, or multiple narrower address entries. 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.

After editing this file, it is necessary to re-start the hylafax server by issuing the command /etc/init.d/hylafax restart

Creating Users

For each user on the network you want to print to your fax server, you need a user on your system

adduser dept1

Fill in the username and password, etc
Then add user to hylafax. First find out what is your new user UID

cat /etc/group

Find your user. It should be something like dept1:x:1001: so this user UID is 1001
Now tell hylafax about it

faxadduser -p password -u 1001 username

Configuring Fax to Email

To route incoming faxes to a destination other than sitting in the recvq, we're going to create a FaxDispatch script in /etc/hylafax.

FaxDispatch

FaxDispatch is a custom script that one can create for Hylafax to specify nonstandard delivery options. Normally, incoming faxes are dropped into the /var/spool/hylafax/recvq/ directory.
A sample FaxDispatch file is available in /usr/share/doc/hylafax-server/examples/FaxDispatch.example
Use your favorite text editor to create a /etc/hylafax/FaxDispatch file containing the following:

## FaxDispatch file - routes all inbound faxes to myemail@emailaddy.com as TIFF files
##
## Consult the faxrcvd(8C) man page for more information
##

SENDTO=myemail@emailaddy.com;
FILETYPE=tiff;

Please note that using filetypes other than tiff are allowed, but tiff is the native language spoken by the fax system, and therefore requires the least ammount of work to handle, on the fax server.

Configuring Email to Fax with Exim

The email becomes the first page and all attachments will be sent as additional pages, however handling of the attachments is not perfect, in particular jpeg. For best results use PDFs as they seem to be processed reliably and are already paper sized.

Fax recipients must have addresses in this format:

name@faxnumber.fax

Router

exifax:
   driver = manualroute
   transport = exifax
   route_list ="*.fax"

Transport

exifax:
  driver = pipe
  user = faxmaster
  command ="/usr/bin/faxmail -n ${local_part}@${extract{1}{.}{$domain}}"

Automatically Printing Incoming Faxes

If you would like to print and then move incoming faxes out of the /var/spool/hylafax/recvq/ directory, you would create a FaxDispatch file this below:

## and/or by device
FOLDER="/var/spool/hylafax/recvq/"
FULLPATH="${FOLDER}${FILENAME}.tif"
case "$DEVICE" in
ttyS14)   /usr/bin/tiff2ps -w 8.5 -h 11 -a $FILE |lpr -P kyocera; mv $FULLPATH /var/spool/hylafax/recvq/dept1/;;    # all faxes received on ttyS14
ttyS15)   /usr/bin/tiff2ps -w 8.5 -h 11 -a $FILE |lpr -P kyocera; mv $FULLPATH /var/spool/hylafax/recvq/dept2/;;    # all faxes received on ttyS15
esac

Please note that specifying the size of a page is recommended to make sure 11x14 pages are printed properly.

Viewing faxes through internet browser

To do that install apache web server

apt-get update
apt-get install apache2

Now add a link to your faxes

cd /var/www
ln -s /var/spool/hylafax/recvq fax

Now open a broswer and go to http://localhost/fax/, or by your ip address http://10.10.10.10/fax

Fax Sending Clients

In general the list of all the software is here, but you can just go to the following URL. http://www.hylafax.org/content/Client_Software

Linux

You can use Gfax or Kde Print Fax. You install it Gfax by:

apt-get update
apt-get install gfax

Then Go to Application then Office then Gfax.

This needs to be tested but:

Now i can do fax from OpenOffice, TextEditor, etc..

1. Install GFax from apt-get install gfax
2. Configure GFax with your Fax Server (HylaFAX).. I hope you know how to do it..
   Ok, you can test your GFax configuration by test send a fax with Text Editor (Applications -
Accessories)
3. To make it work with openoffice, run /usr/lib/openoffice/program/spadmin  (with root access), you
 do sudo -i, or whatever.
4. You add fax / pdf converter from spadmin GUI, fill the command with: gfax (TMP)
5. That's it... you save the configuration
6. Try fax an openoffice document

1st time i try fax with Fax Printer, it hang..
then i tried fax with PDF Converter and set the PDF Folder, then after fax, i close the GFax and not
hang.

Windows

On windows you would use this Win print Hylafax software. You can download it at http://winprinthylafax.sourceforge.net/
ADMINISTRATION:Download program called WHFC which will tell you the status of the hylafax servers.

Known Working Hardware

Serial Modems

US Robotics 56K External Fax Modem; 5686E (Does not come with cable)
USRobotics Courier V.Everything External Fax Modem
Amigo AME-CA95, External V.92 DATA/FAX/TAM Modem -(newegg.com)

Multiport Serial Adapters

Startech.com 4 Multi Port Serial PCI Card
Startech.com 2 Port Serial PCI Card

USB Modem

Link that sells the USB modem (sorry it's in greek, I couldn't find any other site for it): http://www.e-shop.gr/show_per.phtml?id=PER.533709

lsusb recognizes it as:

Bus 001 Device 002: ID 0483:7554 SGS Thomson Microelectronics 56k SoftModem
  idVendor           0x0483 SGS Thomson Microelectronics
  idProduct          0x7554 56k SoftModem

The driver known to work with it is the 'slusb' SmartLink driver, see slmodem.

The modem is installed under /dev/ttySL0. Special Hylafax configuration does not appear to be necessary.

Another one that works with the cdc_acm module, limited testing with Hylafax, is the TRENDnet TFM-561U. Under Debian Squeeze this is plug-and-play.

lsusb info:

Bus 007 Device 002: ID 0572:1329 Conexant Systems (Rockwell), Inc. 
  idVendor           0x0572 Conexant Systems (Rockwell), Inc.
  idProduct          0x1329

The (first) device is /dev/ttyACM0. Hylafax's faxaddmodem seemed to have configured it correctly.

Adding a Dial Prefix

To configure HylaFax to dial a number and pause before dialing the requested number, use your favorite text editor to add the following line to your config.<DEVICE> files:

ModemDialCmd: ATDT9,%s

Pause: The comma (,) dial modifier causes the modem to pause while dialing ATD9,17731231234
Pause and wait for dial tone: The W causes most modems to wait for a dial tone before dialing the number following it. ATDT 9 W 17731231234
Final Modem Dial Command on the system could look like this:

ModemDialCmd: ATDT9,W%s

9 says dial 9; comma says wait; W says wait for dial tone; %s says dial this number
If you experience no dial tone in your logs try something like:

ModemDialCmd:     ATX3DT8,,,%s

AT - picks up the phone, X3- disables dial tone check, DT tells it to use tone, dial 8, then ",,," for wait, then the phone number.

Multiple Incoming Fax Lines

Configuring a multi-port serial PCI card

There's really no limit to the number of serial cards Linux can support, but there is a kernel configuration parameter for the number of supported serial ports.(CONFIG_SERIAL_8250_NR_UARTS)
Currently the limit in Debian supported ports is 4. (read on for more then 4 port support)
So if you have a 2 port serial card you want to add to your pc, here is what you do.
If you connect more modems or when you buy a serial pci card you will want to know which ttyS port they are using. You can do it by :

dmesg |grep tty

You should see something like:

faxserver:~# dmesg |grep ttyS
ttyS0 at I/O 0x3f8 (irq = 4) is a 16550A
ttyS14 at I/O 0xdf08 (irq = 209) is a 16550A
ttyS15 at I/O 0xdf10 (irq = 209) is a 16550A

If you installed another serial pci card (2 port or 4 port), you can see if it was detected by typing:

lspci -v

This should list something like:

0000:02:00.0 Serial controller: NetMos Technology PCI 9835 Multi-I/O Controller (rev 01) (prog-if 02 [16550])
        Subsystem: LSI Logic / Symbios Logic 2S (16C550 UART)
        Flags: medium devsel, IRQ 209
        I/O ports at df08 [size=8]
        I/O ports at df10 [size=8]
        I/O ports at df18 [size=8]
        I/O ports at df20 [size=8]
        I/O ports at df28 [size=8]
        I/O ports at df30 [size=16]

As you can see the IRQ should be the same as the one specified in dmesg.
Install setserial. This program will let you control serial port better.

apt-get update
apt-get install setserial

Then try:

setserial -g /dev/ttyS*

If you don't see a ttyS#(ex. ttyS14) in /dev/ you will need to create ttyS14 device.

ls /dev/ttyS*

So in my case I am missing ttyS14, ttyS15 in /dev/ folder

MAKEDEV ttyS14
MAKEDEV ttyS15

Now run setserial -g /dev/ttyS* again and you should see your new serial ports.
Plug in your modems and Run:

faxaddmodem

Select the new ttyS and you are done setting up multiple fax machines.

FaxNotify

When fax fails to send, user gets an email notifying of a failure. Default is to just sent an email with a job number. To make sure they get a copy of what they actually sent we need to add FaxNotify to /etc/hylafax.
Create FaxNotify in /etc/hylafax/
Inside put

RETURNFILETYPE=tiff;

Common Errors

You can find hylafax specific error codes here: Hylafax Error Codes

Minicom works, but faxaddmodem does not see a modem

Minicom automatically uses an init string that turns Numeric Result Codes off (ATV1). If you have an US Robotics Courier V.Everything External, check the position of jumper switch #2.

Failure to receive silence

Added to config.ttyS14; failure to receive silence
#http://www.hylafax.org/archive/2002-08/msg00260.php
Add this to your configuration: config.ttyS#

Class1SwitchingCmd: "<delay:7>"

T.30 T2 timeout, expected signal not received

Switching to Class 1, and adding the "delay" will solve the problem.
Run the faxaddmodem command again and add the delay.

Unspecified Phase C error, including too much delay between TCF and +FDR command

Switching to Class 1 solved the problem.

No Dial Tone

Adding dial string 9 then pause then number to config file solved the problem
See "PBX, Dial 9 before number" section and if you need more details on options see http://members.tripod.com/michaelgellis/modem.html

No carrier Detected

Adding longer wait has solved the problem of no dial tone, but you might still get the no carrier detected. Look into logs to determine if this is the case in your setup. See if these are busy signal. For some reason busy signal gets labeled as no carrier detected.

cat /var/spool/hylafax/log/xferfaxlog

Modem Wedged

After a month of good work (11,000 faxes) suddenly the modem become wedged. Because USR modem doesn't have the un-wedged option as the Mainpine modem, you have to tell hylafax to try to set it up more then (default)2 times. Add this to your config.tty#

MaxSetupAttempts:    10

4 ports serial card, more then 4 modem support

There's really no limit to the number of serial cards Linux can support, but there is a kernel configuration parameter for the number of supported serial ports.(CONFIG_SERIAL_8250_NR_UARTS)
To find out how many serial port your kernel is configured for do:

dmesg |grep Serial

And look for line like:

 Serial: 8250/16550 driver $Revision: 1.90 $ 4 ports, IRQ sharing enabled

Shows that the driver is compiled to support only 4 ports.
I was getting following logs which I will include here for reference.

serial8250: ttyS2 at I/O 0x3e8 (irq = 4) is a 16550A
 00:08: ttyS2 at I/O 0x3e8 (irq = 4) is a 16550A
 0000:05:04.0: ttyS0 at I/O 0x1010 (irq = 201) is a 16550A
 0000:05:04.0: ttyS1 at I/O 0x1018 (irq = 201) is a 16550A
 0000:05:04.0: ttyS3 at I/O 0x1020 (irq = 201) is a 16550A

Couldn't register serial port 0000:05:04.0: -28

shows that ttyS2 is on the motherboard.  ttyS0, S1, and S3 are
on the 9845 card.  The driver found the fourth port on the 9845 card,
but couldn't use it because all four ports (ttyS0-ttyS3) were already
in use (that's what the "-28" error means).

You can list your pci cards by doing the following. This will show you all pci cards. Look for the one that mentions serial

lspci -v

These are mine:

 2 port:
 02:00.0 Serial controller: NetMos Technology PCI 9835 Multi-I/O
 Controller (rev 01) (prog-if 02 [16550])
         Subsystem: LSI Logic / Symbios Logic 2S (16C550 UART)
         Flags: medium devsel, IRQ 209
         I/O ports at df08 [size=8]
         I/O ports at df10 [size=8]
         I/O ports at df18 [size=8]
         I/O ports at df20 [size=8]
         I/O ports at df28 [size=8]
         I/O ports at df30 [size=16]


 4 port:
 02:02.0 Serial controller: Unknown device 9310:9845 (rev 01) (prog-if 02
 [16550])
         Subsystem: LSI Logic / Symbios Logic Unknown device 0004
         Flags: medium devsel, IRQ 201
         I/O ports at 1000 [size=8]
         I/O ports at 1008 [size=8]
         I/O ports at 1010 [size=8]
         I/O ports at 1018 [size=8]
         I/O ports at 1020 [size=8]
         I/O ports at 1030 [size=16]

To update under Grub

Lets add a more serial ports to our system. We do it by adding the 8250.nr_uarts=16 at end of kopt line in the grub menu configuration file.
Edit /boot/grub/menu.lst and change the following lines by adding the 8250.nr_uarts=16 at the end of kopt.

## DO NOT UNCOMMENT THEM, Just edit them to your needs

## ## Start Default Options ##
## default kernel options
## default kernel options for automagic boot options
## If you want special options for specific kernels use kopt_x_y_z
## where x.y.z is kernel version. Minor versions can be omitted.
## e.g. kopt=root=/dev/hda1 ro
##      kopt_2_6_8=root=/dev/hdc1 ro
##      kopt_2_6_8_2_686=root=/dev/hdc2 ro
# kopt=root=/dev/sda1 ro 8250.nr_uarts=16

Then

update-grub

Reboot

To update under Grub2

Lets add a more serial ports to our system. We do it by adding the 8250.nr_uarts=16 at end of GRUB_CMDLINE_LINUX_DEFAULT line in the grub defaut configuration file.
Edit /etc/default/grub and change the following lines by adding the 8250.nr_uarts=16 at the end of GRUB_CMDLINE_LINUX_DEFAULT.

# If you change this file, run 'update-grub' afterwards to update
# /boot/grub/grub.cfg.

GRUB_DEFAULT=0
GRUB_TIMEOUT=5
GRUB_DISTRIBUTOR=`lsb_release -i -s 2> /dev/null || echo Debian`
GRUB_CMDLINE_LINUX_DEFAULT="quiet 8250.nr_uarts=16"
GRUB_CMDLINE_LINUX=""

Then

update-grub

Reboot

Then confirm everything is working

When you log in run the command:

setserial -g /dev/ttyS*

This will show you list of all serial ports addresses and corresponding ttyS
Mine looks like:

faxserver:/home/lucas# setserial -g /dev/ttyS*
/dev/ttyS0, UART: 16550A, Port: 0x03f8, IRQ: 4
/dev/ttyS1, UART: 16550A, Port: 0x1010, IRQ: 201
/dev/ttyS10, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS11, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS12, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS13, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS14, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS15, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS2, UART: 16550A, Port: 0x1018, IRQ: 201
/dev/ttyS3, UART: 16550A, Port: 0x1020, IRQ: 201
/dev/ttyS4, UART: 16550A, Port: 0x1010, IRQ: 201
/dev/ttyS5, UART: 16550A, Port: 0x1018, IRQ: 201
/dev/ttyS6, UART: 16550A, Port: 0x1020, IRQ: 201
/dev/ttyS7, UART: 16550A, Port: 0x1028, IRQ: 201
/dev/ttyS8, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS9, UART: unknown, Port: 0x0000, IRQ: 0

So now from lspci -v I know that first port on my 4 port serial card is 1010 which is ttyS1, second 1018 is ttyS2....etc
Its really easy.
The maximum number of the serial ports you can set the kernel boot to is 16,if you need more, kernel 2.6.24 will have 32 as upper limit.see Debian Bug 440807.

Tools

Archive Faxes

If you have a need to archive each fax by date, there is a script that does just that.
http://www.hylafax.org/archive/2007-02/msg00399.php
Download the archive.py file to some folder. I use /usr/local/bin/
Edit a cron job:

crontab -e

Now set up the time it will run. The extension it should use. And a folder where the faxes are.

1 0 * * * python /usr/local/bin/archive.py /var/spool/hylafax/recvq tif

Above line will run the program every day at 00:01 am. Change the "/usr/local/bin/archive.py" to where you have downloaded the program. Change "/var/spool/hylafax/recvq" to where your faxes are located. Change "tif" to the extension you are using for storing your faxes.
If you just need to run it once. This command will do.

python /usr/local/bin/archive.py /var/spool/hylafax/recvq tif

Send batch faxes

To send multiple faxes, first you need to create a file that will have fax numbers per one line. Type it or do a database query.

17731231234
13121231234

If you need to add 1 in front of the number you could use vim to do it with this code: press ESC

:%s/^/1/g

This will replace ^(beginning of a line) with 1
After your file is ready and you have a pdf of what you want to send. Issue this command

sendfax -z batchfaxnumbers.csv FILE2007NEWS.pdf

To make only one modem be responsible for sending that job. And to enable enough time for it to send we can issue this command which will use ttyS0 modem and will expire in 24 hours.

sendfax -h ttyS0@localhost -n -k 'now + 24 hours' -z batchfaxnumbers.csv FILE2007NEWS.pdf

Maintenance

To see a status of the fax service on the local machine, Type

faxstat -s

Restart Hylafax

/etc/init.d/hylafax restart

Checking Fax Status

To check the status of hylafax, we use the faxstat command:

faxstat

Type in the password(if it asks for one) and you should see something similar to the following:

faxserver:~# faxstat
Password:
HylaFAX scheduler on localhost.localdomain: Running
Modem ttyS15 (1.773.123.1234): Running and idle
Modem ttyS14 (1.773.123.1234): Running and idle

Removing a fax job

to remove a sent fax from the queue, issue the following command:

faxrm  jobid

Where JOBID is the ID of the job in question.

You can also remove multiple faxes at once, like the following:

faxrm 1011 1012 1013

If you have more then a 100 faxes to remove

Don't do this:

Open excel/openoffice calc file
Create a range of 1...100; save as csv; Open in vim; Issue a command :%s/"//g to remove quotes; Issue a command %s/\n/ /g to replace new line with space; Add at the beginning faxrm ; On your server issue a command bash filename.csv

Do:

faxrm $(seq 1 100)

Printer not printing

If you followed SystemPrinting, log into the cups software via the http://localohost:631 and you can resume printing from there or see the status of the printer.

Country Specific

General

For hopefully obvious reasons, the country code and dialling prefixes will vary by country.

CategoryModem | CategoryNetwork