Upload
helder-silva
View
331
Download
2
Embed Size (px)
Citation preview
FaxServer
December 3 2008
Contents1 Installation 2
2 Configure 221 Configure Incoming Settings 522 Fax Status 5
3 Sending Fax 531 Linux 632 Windows 633 Mac 634 PBX Dial 9 before number 635 Adding users 7
4 Hardware 841 Done with simple setup 8
5 Multiple Incoming Fax Lines 851 Multi port Serial PCI card ttyS 852 Fax Dispatch 1053 FaxNotify 1254 View faxes through internet browser 12
6 Errors 1261 Failure to receive silence 1362 T30 T2 timeout expected signal not received 1363 Unspecified Phase C error including too much delay between TCF and
+FDR command 1364 No Dial Tone 1365 No carrier Detected 1366 Modem Wedged 1367 4 ports serial card more then 4 modem support 14
1
7 Tools 1671 Archive Faxes 1672 Send batch faxes 17
8 Maintenance 1881 Restart Hylafax 1882 Hylafax status 1883 Remove fax job 1884 Printer not printing 18
9 Extra 1991 usb fax modem 19
10 Country Specifc 19101 France 19
11 Support 19HylaFAXThe worldrsquos most advanced open source fax serverI can set up your fax server in just few hours See bottom of this page for more
informationTranslation EnglishPolskiKeywords Installing Hylafax server on Debian Linux multiple faxes serial PCI
card Printing fax server fax from windows fax from mac fax from linux emailreceived fax multiple modems high performance windows XP high volume setupfax server
I can set up your fax server in just few hours See bottom of this page for moreinformation
1 InstallationBased on httpwwwaboutdebiancomfaxhtm
bull Install hylafax
apt-get install hylafax-server
bull Connect the external modem Make sure you have a parallel cable to serial cableExternal Modem needs to be connected to a serial port Then
2 Configure
faxsetup
2
bull press Enter and yoursquoll see a lot of text fly by Answer Yes to adding a Fax Masteralias
bull For a user to received fax-related mail enter the user account you created foryourself during the Debian installation
bull Four configuration parameters will be listed and yoursquoll be prompted as to theircorrectness Press Enter to accept these values Yoursquoll then be asked if you wantto run faxaddmodem to set up the software to use the modem Press Enter toaccept the default Yes response
bull Enter the correct ttyS designation for the serial port(make sure your modem isconnected to serial port not the parallel port) your fax-modem is connected to(ttyS0 is for COM1) Yoursquoll be prompted for quite a few values For most youcan accept the default values by pressing Enter The values yoursquoll want to enterare
Country code (1 for US)
Area code
Phone number of fax modem
Local identification string (this should be larrsomething like rsquoMy Fax Serverrsquo as it is printed larron 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 larrdefault)
Tracing during send and receive operations (accept larrthe default)
Protection mode for received fax - enter 0644
Protection mode for session logs - enter 0644
Protection mode for ttySx - enter 0666
Rings to wait before answerNote The default is 1 but setting it to 0 larr
establishes your server as a Send Only fax larrsystem
Modem speaker volume (valid values are OFF QUIET larrLOW MEDIUM HIGH (you may want to set it to HIGH larrfor testing purposes as you can change it to OFF larrlater)
Command line arguments for getty (accept the larrdefault)
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 larrdefault)
3
Hold UUCP lockfile during voice calls (accept the larrdefault)
Percent good lines to accept (accept the default)
Max consecutive bad lines to accept (you may want larrto reduce the default 5 to 3)
Max number of pages to accept in a received fax ( larryou may want to increase the default value of 25)
Syslog facility name for ServerTracing messages ( larrthe default is rsquodaemonrsquo but you could change it larrto rsquolocal7rsquo if yoursquore logging to a remote syslog larrserver)
Set UID to 0 (accept default)
Use priority job scheduling (accept default)
bull Yoursquoll then be asked to confirm the values that you entered and then the utilitywill query to modem to determine the fax classes that it supports
bull Even if your modem supports both Class 1 and Class 2 you should set it to Class1 for compatibility with all fax machines
bull You will then be asked for values specific to the modem Just press Enter toaccept the default values as they are a result of the modem query and the classyou selected Yoursquoll then be prompted to confirm these values by pressing Enter
bull The non-default scheduler values will then be displayed with a confirmationprompt The Area Code may not be correct If so answer No and correct anyerroneous values You may also want to increase the time value for Timeoutwhen converting PostScript documents if you fax long documents but you canjust press Enter to accept the default values for the rest of the values
bull Answer No when asked if you want to configure another modem
bull Accept the default Yes answer to run faxmodem on your newly configured mo-dem to verify settings Yoursquoll then be returned to the shell prompt
bull If you want to manually edit the file that contains these settings do so with thecommand
vi etchylafaxconfigttyS0
bull You have to run the faxaddmodem utility to create this file first though
bull Next wersquoll set up HylaFAX to run automatically when you boot the systemCheck the configuration file
vi etcdefaulthylafax
bull to make sure therersquos no character at the beginning of the line containing RUN_HYLAFAX=1Exit the editor
4
21 Configure Incoming Settingsbull One last item that is to let HylaFAX know who is allowed to send faxes You can
use a modified subnet address to let everyone on your network submit faxes tothe server Edit the hostshfaxd file with the command
vi etchylafaxhostshfaxd
bull As an example if your using a subnet address for your network of 192168100enter the following line into the hostshfaxd file
19216810
bull Likewise if your using a subnet address of 1721600 your hostshfaxd file entrywould be
17230
bull You can enter as wide of a network address or multiple narrower address en-tries as yoursquod like If yoursquod like to restrict access to specific users you can entertheir individual IP addresses When done save the file and exit the editor
NOTE You will see the paths varspoolhylafax and var larrspoolhylafaxetc specified in HylaFAX documentation and larrutilities Do NOT edit the files in these directories larrThe files are duplicated in the etchylafax directory larrIf you ever want to manually edit the configuration files larr only edit the files in the etchylafax directory
bull Reboot the system by typing reboot and yoursquoll have yourself a fax server(Rebootis not necessary Restart of hylafax would do just fine)
22 Fax Statusbull To see a status of a fax server Type
faxstat -s
3 Sending FaxIn general the list of all the software is here but you can just go to the once we referencebelow httpwwwhylafaxorgcontentClient_Software
5
31 LinuxYou can use Gfax or Kde Print Fax You install it Gfax by
apt-get updateapt-get install gfax
Then Go to Application then Office then Gfax
bull This needs to be tested but
Now i can do fax from OpenOffice TextEditor etc
1 Install GFax from apt-get install gfax2 Configure GFax with your Fax Server (HylaFAX) I hope you larr
know how to do itOk you can test your GFax configuration by test send a larr
fax with Text Editor (Applications -Accessories)3 To make it work with openoffice run usrlibopenoffice larr
programspadmin (with root access) youdo sudo -i or whatever
4 You add fax pdf converter from spadmin GUI fill the larrcommand with gfax (TMP)
5 Thatrsquos it you save the configuration6 Try fax an openoffice document
1st time i try fax with Fax Printer it hangthen i tried fax with PDF Converter and set the PDF Folder larr
then after fax i close the GFax and nothang
32 Windowsbull On windows you would use this Win print Hylafax software You can download
it at httpwinprinthylafaxsourceforgenet
bull To get the addressbook working with winprinthylfax you can setup folder calledhylafaxaddressbook and i int create 2 empty files called namestxt and num-berstxt
bull ADMINISTRATIONDownload program called WHFC which will tell you thestatus of the hylafax servers
33 Mac
34 PBX Dial 9 before numberbull Add this to your configttyS14 files you can replace 9 with 8 or any other num-
ber
6
ModemDialCmd ATDT9s
bull Pause The comma () dial modifier causes the modem to pause while dialingATD917731231234
bull Pause and wait for dial tone The W causes a modem to wait for an dial tonesignal before dialing the number that follow the W ATDT 9 W 17731231234
ModemDialCmd ATDT9Ws
bull Final Modem Dial Cmd on the system could look like this
ModemDialCmd ATDT9Ws
bull 9 says dial 9 comma says wait W says wait for dial tone s says dial thisnumber
bull Also see ModemAtCommandSet
bull If you experience no dial tone in your logs try something like
ModemDialCmd ATX3DT8s
AT - picks up the phone X3- disables dial tone check DT tells it to use tone dial8 then bdquo for wait then the phone number
35 Adding usersbull You need a user on your system
adduser dept1
bull Fill in the username and password etc
bull Then add user to hylafax First find out what is your new user UID
bull Type
cat etcgroup
bull Find your user It should be something like dept1x1001 so this user UID is1001
bull Now tell hylafax about it
7
faxadduser -p password -u 1001 username
bull To see what users are already in do
cat varspoolhylafaxetchostshfaxd
4 HardwareModem Model
1 US Robotics 56K External Fax modem 5686E (Does not come with cable)(around $100)
2 Amigo AME-CA95 RS232 External V92 DATAFAXTAM Modem or ExternalConexant V92 modem (around $25 or less)-(neweggcom)
Serial Card
1 Startechcom 4 Multi Port Serial PCI Card
2 Startechcom 2 Port Serial PCI Card
41 Done with simple setupDone Everything beyond this point is for setting up multiple incomingoutgoingfax modems
5 Multiple Incoming Fax Lines
51 Multi port Serial PCI card ttySbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull Currently the limit in Debian supported ports is 4 (read on for more then 4 portsupport)
bull So if you have a 2 port serial card you want to add to your pc here is what youdo
bull If you connect more modems or when you buy a serial pci card you will want toknow which ttyS port they are using You can do it by
dmesg |grep tty
8
bull You should see something like
faxserver~ dmesg |grep ttySttyS0 at IO 0x3f8 (irq = 4) is a 16550AttyS14 at IO 0xdf08 (irq = 209) is a 16550AttyS15 at IO 0xdf10 (irq = 209) is a 16550A
bull If you installed another serial pci card (2 port or 4 port) you can see if it wasdetected by typing
lspci -v
This should list something like
000002000 Serial controller NetMos Technology PCI 9835 larrMulti-IO Controller (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART)Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
bull As you can see the IRQ should be the same as the one specified in dmesg
bull Install setserial This program will let you control serial port better
apt-get updateapt-get install setserial
bull Then try
setserial -g devttyS
bull If you donrsquot see a ttyS(ex ttyS14) in dev you will need to create ttyS14 device
ls devttyS
bull So in my case I am missing ttyS14 ttyS15 in dev folder
MAKEDEV ttyS14MAKEDEV ttyS15
9
bull Now run setserial -g devttyS again and you should see your new serial ports
bull Plug in your modems and Run
faxaddmodem
bull Select the new ttyS and you are done setting up multiple fax machines
52 Fax Dispatchbull Fax dispatch is a custom script that one can create for Hylafax to specify non-
standard delivery options (Standard is varspoolhylafaxrecvq)
bull If you want to have multiple fax destination folders for each fax you have (ttyS1ttyS14 ttyS15 etc)
bull Create Fax Dipatch file in etchylafax
touch etchylafaxFaxDispatch
bull Sample Fax Dispatch file might look like this httpwwwinfocoptercomknow-howhylafaxfax-dispatchhtml
bull Copy and past below to your etchylafaxFaxDispatch This will dispatch faxesto different folders based on device
bull Make sure you have created appropriate folders (In this case dept1 dept2 andchange device names to your names
$Id FaxDispatchv 12 20030504 234941 darren Exp larr$
Default FaxDispatch file - routes all inbound faxes to larr
FaxMaster as PDF Consult the faxrcvd(8C) man page for more information
SENDTO=faxMaster by default larremail to FaxMaster
FILETYPE=pdf in PDF larrformat
This excerpt from the man page gives you an idea of whatrsquos larr
possible here
10
You can route by senderrsquos TSIcase $SENDER in 15105261212) SENDTO=sam Samrsquos test larr
rig in Berkeley 14153901212) SENDTO=rasterasd 7L Xerox larr
room used for scanning 5107811212) SENDTO=peeblesmti stuff from larr
homeesac
andor by devicecase $DEVICE in ttyS1) SENDTO=john all faxes larr
received on ttyS1 ttyLT0) SENDTO=maryhome all faxes larr
received on ttyLT0 ttyS2) SENDTO=myemailexamplecom larr
myotheremailexample3com all faxes received larron ttyS1
esac
andor by deviceFOLDER=varspoolhylafaxrecvqFULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) mv $FULLPATH varspoolhylafaxrecvqdept1 larr
all faxes received on ttyS14ttyS15) mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
andor by caller idcase $CIDNUMBER in 435) SENDTO=lee FILETYPE=pdf all faxes larr
from area code 435 5059627777) SENDTO=amy FILETYPE=tif Amy wants larr
faxes in TIFFesac
bull If you would like to print and then move the file you would replace the relevantcode with this below
bull Make sure you install printer first DebianPrinting
bull Size of a page was added here to make sure 11x14 pages are printed properly
andor by deviceFOLDER=varspoolhylafaxrecvq
11
FULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larr
kyocera mv $FULLPATH varspoolhylafaxrecvqdept1 larr all faxes received on ttyS14
ttyS15) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larrkyocera mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
53 FaxNotifybull 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 theyactually sent we need to add FaxNotify to etchylafax
bull Create FaxNotify in etchylafax
bull Inside put
RETURNFILETYPE=pdf
54 View faxes through internet browserbull To do that install apache web server
apt-get updateapt-get install apache2
bull Now add a link to your faxes
cd varwwwln -s varspoolhylafaxrecvq fax
bull Now open a broswer and go to httplocalhostfax or by your ip addresshttp10101010fax
bull Enjoy Irsquove been told that this would cost 15000 dollars for consulting firm todo
6 Errorsbull You can find hylafax specific error codes here Hylafax Error Codes
12
61 Failure to receive silencebull Added to configttyS14 failure to receive silence
bull httpwwwhylafaxorgarchive2002-08msg00260php
bull Add this to your configuration configttyS
Class1SwitchingCmd ltdelay7gt
62 T30 T2 timeout expected signal not receivedbull Switching to calls 1 and adding the delay will solve the problem
bull Run the faxaddmodem command again and add the delay
63 Unspecified Phase C error including too much delay betweenTCF and +FDR command
bull Switching to Class 1 solved the problem
64 No Dial Tonebull Adding dial string 9 then pause then number to config file solved the problem
bull See PBX Dial 9 before number section and if you need more details on optionssee httpmemberstripodcommichaelgellismodemhtml
65 No carrier Detectedbull 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 yoursetup See if these are busy signal For some reason busy signal gets labeled asno carrier detected
cat varspoolhylafaxlogxferfaxlog
66 Modem WedgedAfter a month of good work (11000 faxes) suddenly the modem become wedgedBecause USR modem doesnrsquot have the un-wedged option as the Mainpine modemyou have to tell hylafax to try to set it up more then (default)2 times Add this to yourconfigtty
MaxSetupAttempts 10
13
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
7 Tools 1671 Archive Faxes 1672 Send batch faxes 17
8 Maintenance 1881 Restart Hylafax 1882 Hylafax status 1883 Remove fax job 1884 Printer not printing 18
9 Extra 1991 usb fax modem 19
10 Country Specifc 19101 France 19
11 Support 19HylaFAXThe worldrsquos most advanced open source fax serverI can set up your fax server in just few hours See bottom of this page for more
informationTranslation EnglishPolskiKeywords Installing Hylafax server on Debian Linux multiple faxes serial PCI
card Printing fax server fax from windows fax from mac fax from linux emailreceived fax multiple modems high performance windows XP high volume setupfax server
I can set up your fax server in just few hours See bottom of this page for moreinformation
1 InstallationBased on httpwwwaboutdebiancomfaxhtm
bull Install hylafax
apt-get install hylafax-server
bull Connect the external modem Make sure you have a parallel cable to serial cableExternal Modem needs to be connected to a serial port Then
2 Configure
faxsetup
2
bull press Enter and yoursquoll see a lot of text fly by Answer Yes to adding a Fax Masteralias
bull For a user to received fax-related mail enter the user account you created foryourself during the Debian installation
bull Four configuration parameters will be listed and yoursquoll be prompted as to theircorrectness Press Enter to accept these values Yoursquoll then be asked if you wantto run faxaddmodem to set up the software to use the modem Press Enter toaccept the default Yes response
bull Enter the correct ttyS designation for the serial port(make sure your modem isconnected to serial port not the parallel port) your fax-modem is connected to(ttyS0 is for COM1) Yoursquoll be prompted for quite a few values For most youcan accept the default values by pressing Enter The values yoursquoll want to enterare
Country code (1 for US)
Area code
Phone number of fax modem
Local identification string (this should be larrsomething like rsquoMy Fax Serverrsquo as it is printed larron 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 larrdefault)
Tracing during send and receive operations (accept larrthe default)
Protection mode for received fax - enter 0644
Protection mode for session logs - enter 0644
Protection mode for ttySx - enter 0666
Rings to wait before answerNote The default is 1 but setting it to 0 larr
establishes your server as a Send Only fax larrsystem
Modem speaker volume (valid values are OFF QUIET larrLOW MEDIUM HIGH (you may want to set it to HIGH larrfor testing purposes as you can change it to OFF larrlater)
Command line arguments for getty (accept the larrdefault)
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 larrdefault)
3
Hold UUCP lockfile during voice calls (accept the larrdefault)
Percent good lines to accept (accept the default)
Max consecutive bad lines to accept (you may want larrto reduce the default 5 to 3)
Max number of pages to accept in a received fax ( larryou may want to increase the default value of 25)
Syslog facility name for ServerTracing messages ( larrthe default is rsquodaemonrsquo but you could change it larrto rsquolocal7rsquo if yoursquore logging to a remote syslog larrserver)
Set UID to 0 (accept default)
Use priority job scheduling (accept default)
bull Yoursquoll then be asked to confirm the values that you entered and then the utilitywill query to modem to determine the fax classes that it supports
bull Even if your modem supports both Class 1 and Class 2 you should set it to Class1 for compatibility with all fax machines
bull You will then be asked for values specific to the modem Just press Enter toaccept the default values as they are a result of the modem query and the classyou selected Yoursquoll then be prompted to confirm these values by pressing Enter
bull The non-default scheduler values will then be displayed with a confirmationprompt The Area Code may not be correct If so answer No and correct anyerroneous values You may also want to increase the time value for Timeoutwhen converting PostScript documents if you fax long documents but you canjust press Enter to accept the default values for the rest of the values
bull Answer No when asked if you want to configure another modem
bull Accept the default Yes answer to run faxmodem on your newly configured mo-dem to verify settings Yoursquoll then be returned to the shell prompt
bull If you want to manually edit the file that contains these settings do so with thecommand
vi etchylafaxconfigttyS0
bull You have to run the faxaddmodem utility to create this file first though
bull Next wersquoll set up HylaFAX to run automatically when you boot the systemCheck the configuration file
vi etcdefaulthylafax
bull to make sure therersquos no character at the beginning of the line containing RUN_HYLAFAX=1Exit the editor
4
21 Configure Incoming Settingsbull One last item that is to let HylaFAX know who is allowed to send faxes You can
use a modified subnet address to let everyone on your network submit faxes tothe server Edit the hostshfaxd file with the command
vi etchylafaxhostshfaxd
bull As an example if your using a subnet address for your network of 192168100enter the following line into the hostshfaxd file
19216810
bull Likewise if your using a subnet address of 1721600 your hostshfaxd file entrywould be
17230
bull You can enter as wide of a network address or multiple narrower address en-tries as yoursquod like If yoursquod like to restrict access to specific users you can entertheir individual IP addresses When done save the file and exit the editor
NOTE You will see the paths varspoolhylafax and var larrspoolhylafaxetc specified in HylaFAX documentation and larrutilities Do NOT edit the files in these directories larrThe files are duplicated in the etchylafax directory larrIf you ever want to manually edit the configuration files larr only edit the files in the etchylafax directory
bull Reboot the system by typing reboot and yoursquoll have yourself a fax server(Rebootis not necessary Restart of hylafax would do just fine)
22 Fax Statusbull To see a status of a fax server Type
faxstat -s
3 Sending FaxIn general the list of all the software is here but you can just go to the once we referencebelow httpwwwhylafaxorgcontentClient_Software
5
31 LinuxYou can use Gfax or Kde Print Fax You install it Gfax by
apt-get updateapt-get install gfax
Then Go to Application then Office then Gfax
bull This needs to be tested but
Now i can do fax from OpenOffice TextEditor etc
1 Install GFax from apt-get install gfax2 Configure GFax with your Fax Server (HylaFAX) I hope you larr
know how to do itOk you can test your GFax configuration by test send a larr
fax with Text Editor (Applications -Accessories)3 To make it work with openoffice run usrlibopenoffice larr
programspadmin (with root access) youdo sudo -i or whatever
4 You add fax pdf converter from spadmin GUI fill the larrcommand with gfax (TMP)
5 Thatrsquos it you save the configuration6 Try fax an openoffice document
1st time i try fax with Fax Printer it hangthen i tried fax with PDF Converter and set the PDF Folder larr
then after fax i close the GFax and nothang
32 Windowsbull On windows you would use this Win print Hylafax software You can download
it at httpwinprinthylafaxsourceforgenet
bull To get the addressbook working with winprinthylfax you can setup folder calledhylafaxaddressbook and i int create 2 empty files called namestxt and num-berstxt
bull ADMINISTRATIONDownload program called WHFC which will tell you thestatus of the hylafax servers
33 Mac
34 PBX Dial 9 before numberbull Add this to your configttyS14 files you can replace 9 with 8 or any other num-
ber
6
ModemDialCmd ATDT9s
bull Pause The comma () dial modifier causes the modem to pause while dialingATD917731231234
bull Pause and wait for dial tone The W causes a modem to wait for an dial tonesignal before dialing the number that follow the W ATDT 9 W 17731231234
ModemDialCmd ATDT9Ws
bull Final Modem Dial Cmd on the system could look like this
ModemDialCmd ATDT9Ws
bull 9 says dial 9 comma says wait W says wait for dial tone s says dial thisnumber
bull Also see ModemAtCommandSet
bull If you experience no dial tone in your logs try something like
ModemDialCmd ATX3DT8s
AT - picks up the phone X3- disables dial tone check DT tells it to use tone dial8 then bdquo for wait then the phone number
35 Adding usersbull You need a user on your system
adduser dept1
bull Fill in the username and password etc
bull Then add user to hylafax First find out what is your new user UID
bull Type
cat etcgroup
bull Find your user It should be something like dept1x1001 so this user UID is1001
bull Now tell hylafax about it
7
faxadduser -p password -u 1001 username
bull To see what users are already in do
cat varspoolhylafaxetchostshfaxd
4 HardwareModem Model
1 US Robotics 56K External Fax modem 5686E (Does not come with cable)(around $100)
2 Amigo AME-CA95 RS232 External V92 DATAFAXTAM Modem or ExternalConexant V92 modem (around $25 or less)-(neweggcom)
Serial Card
1 Startechcom 4 Multi Port Serial PCI Card
2 Startechcom 2 Port Serial PCI Card
41 Done with simple setupDone Everything beyond this point is for setting up multiple incomingoutgoingfax modems
5 Multiple Incoming Fax Lines
51 Multi port Serial PCI card ttySbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull Currently the limit in Debian supported ports is 4 (read on for more then 4 portsupport)
bull So if you have a 2 port serial card you want to add to your pc here is what youdo
bull If you connect more modems or when you buy a serial pci card you will want toknow which ttyS port they are using You can do it by
dmesg |grep tty
8
bull You should see something like
faxserver~ dmesg |grep ttySttyS0 at IO 0x3f8 (irq = 4) is a 16550AttyS14 at IO 0xdf08 (irq = 209) is a 16550AttyS15 at IO 0xdf10 (irq = 209) is a 16550A
bull If you installed another serial pci card (2 port or 4 port) you can see if it wasdetected by typing
lspci -v
This should list something like
000002000 Serial controller NetMos Technology PCI 9835 larrMulti-IO Controller (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART)Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
bull As you can see the IRQ should be the same as the one specified in dmesg
bull Install setserial This program will let you control serial port better
apt-get updateapt-get install setserial
bull Then try
setserial -g devttyS
bull If you donrsquot see a ttyS(ex ttyS14) in dev you will need to create ttyS14 device
ls devttyS
bull So in my case I am missing ttyS14 ttyS15 in dev folder
MAKEDEV ttyS14MAKEDEV ttyS15
9
bull Now run setserial -g devttyS again and you should see your new serial ports
bull Plug in your modems and Run
faxaddmodem
bull Select the new ttyS and you are done setting up multiple fax machines
52 Fax Dispatchbull Fax dispatch is a custom script that one can create for Hylafax to specify non-
standard delivery options (Standard is varspoolhylafaxrecvq)
bull If you want to have multiple fax destination folders for each fax you have (ttyS1ttyS14 ttyS15 etc)
bull Create Fax Dipatch file in etchylafax
touch etchylafaxFaxDispatch
bull Sample Fax Dispatch file might look like this httpwwwinfocoptercomknow-howhylafaxfax-dispatchhtml
bull Copy and past below to your etchylafaxFaxDispatch This will dispatch faxesto different folders based on device
bull Make sure you have created appropriate folders (In this case dept1 dept2 andchange device names to your names
$Id FaxDispatchv 12 20030504 234941 darren Exp larr$
Default FaxDispatch file - routes all inbound faxes to larr
FaxMaster as PDF Consult the faxrcvd(8C) man page for more information
SENDTO=faxMaster by default larremail to FaxMaster
FILETYPE=pdf in PDF larrformat
This excerpt from the man page gives you an idea of whatrsquos larr
possible here
10
You can route by senderrsquos TSIcase $SENDER in 15105261212) SENDTO=sam Samrsquos test larr
rig in Berkeley 14153901212) SENDTO=rasterasd 7L Xerox larr
room used for scanning 5107811212) SENDTO=peeblesmti stuff from larr
homeesac
andor by devicecase $DEVICE in ttyS1) SENDTO=john all faxes larr
received on ttyS1 ttyLT0) SENDTO=maryhome all faxes larr
received on ttyLT0 ttyS2) SENDTO=myemailexamplecom larr
myotheremailexample3com all faxes received larron ttyS1
esac
andor by deviceFOLDER=varspoolhylafaxrecvqFULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) mv $FULLPATH varspoolhylafaxrecvqdept1 larr
all faxes received on ttyS14ttyS15) mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
andor by caller idcase $CIDNUMBER in 435) SENDTO=lee FILETYPE=pdf all faxes larr
from area code 435 5059627777) SENDTO=amy FILETYPE=tif Amy wants larr
faxes in TIFFesac
bull If you would like to print and then move the file you would replace the relevantcode with this below
bull Make sure you install printer first DebianPrinting
bull Size of a page was added here to make sure 11x14 pages are printed properly
andor by deviceFOLDER=varspoolhylafaxrecvq
11
FULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larr
kyocera mv $FULLPATH varspoolhylafaxrecvqdept1 larr all faxes received on ttyS14
ttyS15) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larrkyocera mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
53 FaxNotifybull 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 theyactually sent we need to add FaxNotify to etchylafax
bull Create FaxNotify in etchylafax
bull Inside put
RETURNFILETYPE=pdf
54 View faxes through internet browserbull To do that install apache web server
apt-get updateapt-get install apache2
bull Now add a link to your faxes
cd varwwwln -s varspoolhylafaxrecvq fax
bull Now open a broswer and go to httplocalhostfax or by your ip addresshttp10101010fax
bull Enjoy Irsquove been told that this would cost 15000 dollars for consulting firm todo
6 Errorsbull You can find hylafax specific error codes here Hylafax Error Codes
12
61 Failure to receive silencebull Added to configttyS14 failure to receive silence
bull httpwwwhylafaxorgarchive2002-08msg00260php
bull Add this to your configuration configttyS
Class1SwitchingCmd ltdelay7gt
62 T30 T2 timeout expected signal not receivedbull Switching to calls 1 and adding the delay will solve the problem
bull Run the faxaddmodem command again and add the delay
63 Unspecified Phase C error including too much delay betweenTCF and +FDR command
bull Switching to Class 1 solved the problem
64 No Dial Tonebull Adding dial string 9 then pause then number to config file solved the problem
bull See PBX Dial 9 before number section and if you need more details on optionssee httpmemberstripodcommichaelgellismodemhtml
65 No carrier Detectedbull 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 yoursetup See if these are busy signal For some reason busy signal gets labeled asno carrier detected
cat varspoolhylafaxlogxferfaxlog
66 Modem WedgedAfter a month of good work (11000 faxes) suddenly the modem become wedgedBecause USR modem doesnrsquot have the un-wedged option as the Mainpine modemyou have to tell hylafax to try to set it up more then (default)2 times Add this to yourconfigtty
MaxSetupAttempts 10
13
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
bull press Enter and yoursquoll see a lot of text fly by Answer Yes to adding a Fax Masteralias
bull For a user to received fax-related mail enter the user account you created foryourself during the Debian installation
bull Four configuration parameters will be listed and yoursquoll be prompted as to theircorrectness Press Enter to accept these values Yoursquoll then be asked if you wantto run faxaddmodem to set up the software to use the modem Press Enter toaccept the default Yes response
bull Enter the correct ttyS designation for the serial port(make sure your modem isconnected to serial port not the parallel port) your fax-modem is connected to(ttyS0 is for COM1) Yoursquoll be prompted for quite a few values For most youcan accept the default values by pressing Enter The values yoursquoll want to enterare
Country code (1 for US)
Area code
Phone number of fax modem
Local identification string (this should be larrsomething like rsquoMy Fax Serverrsquo as it is printed larron 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 larrdefault)
Tracing during send and receive operations (accept larrthe default)
Protection mode for received fax - enter 0644
Protection mode for session logs - enter 0644
Protection mode for ttySx - enter 0666
Rings to wait before answerNote The default is 1 but setting it to 0 larr
establishes your server as a Send Only fax larrsystem
Modem speaker volume (valid values are OFF QUIET larrLOW MEDIUM HIGH (you may want to set it to HIGH larrfor testing purposes as you can change it to OFF larrlater)
Command line arguments for getty (accept the larrdefault)
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 larrdefault)
3
Hold UUCP lockfile during voice calls (accept the larrdefault)
Percent good lines to accept (accept the default)
Max consecutive bad lines to accept (you may want larrto reduce the default 5 to 3)
Max number of pages to accept in a received fax ( larryou may want to increase the default value of 25)
Syslog facility name for ServerTracing messages ( larrthe default is rsquodaemonrsquo but you could change it larrto rsquolocal7rsquo if yoursquore logging to a remote syslog larrserver)
Set UID to 0 (accept default)
Use priority job scheduling (accept default)
bull Yoursquoll then be asked to confirm the values that you entered and then the utilitywill query to modem to determine the fax classes that it supports
bull Even if your modem supports both Class 1 and Class 2 you should set it to Class1 for compatibility with all fax machines
bull You will then be asked for values specific to the modem Just press Enter toaccept the default values as they are a result of the modem query and the classyou selected Yoursquoll then be prompted to confirm these values by pressing Enter
bull The non-default scheduler values will then be displayed with a confirmationprompt The Area Code may not be correct If so answer No and correct anyerroneous values You may also want to increase the time value for Timeoutwhen converting PostScript documents if you fax long documents but you canjust press Enter to accept the default values for the rest of the values
bull Answer No when asked if you want to configure another modem
bull Accept the default Yes answer to run faxmodem on your newly configured mo-dem to verify settings Yoursquoll then be returned to the shell prompt
bull If you want to manually edit the file that contains these settings do so with thecommand
vi etchylafaxconfigttyS0
bull You have to run the faxaddmodem utility to create this file first though
bull Next wersquoll set up HylaFAX to run automatically when you boot the systemCheck the configuration file
vi etcdefaulthylafax
bull to make sure therersquos no character at the beginning of the line containing RUN_HYLAFAX=1Exit the editor
4
21 Configure Incoming Settingsbull One last item that is to let HylaFAX know who is allowed to send faxes You can
use a modified subnet address to let everyone on your network submit faxes tothe server Edit the hostshfaxd file with the command
vi etchylafaxhostshfaxd
bull As an example if your using a subnet address for your network of 192168100enter the following line into the hostshfaxd file
19216810
bull Likewise if your using a subnet address of 1721600 your hostshfaxd file entrywould be
17230
bull You can enter as wide of a network address or multiple narrower address en-tries as yoursquod like If yoursquod like to restrict access to specific users you can entertheir individual IP addresses When done save the file and exit the editor
NOTE You will see the paths varspoolhylafax and var larrspoolhylafaxetc specified in HylaFAX documentation and larrutilities Do NOT edit the files in these directories larrThe files are duplicated in the etchylafax directory larrIf you ever want to manually edit the configuration files larr only edit the files in the etchylafax directory
bull Reboot the system by typing reboot and yoursquoll have yourself a fax server(Rebootis not necessary Restart of hylafax would do just fine)
22 Fax Statusbull To see a status of a fax server Type
faxstat -s
3 Sending FaxIn general the list of all the software is here but you can just go to the once we referencebelow httpwwwhylafaxorgcontentClient_Software
5
31 LinuxYou can use Gfax or Kde Print Fax You install it Gfax by
apt-get updateapt-get install gfax
Then Go to Application then Office then Gfax
bull This needs to be tested but
Now i can do fax from OpenOffice TextEditor etc
1 Install GFax from apt-get install gfax2 Configure GFax with your Fax Server (HylaFAX) I hope you larr
know how to do itOk you can test your GFax configuration by test send a larr
fax with Text Editor (Applications -Accessories)3 To make it work with openoffice run usrlibopenoffice larr
programspadmin (with root access) youdo sudo -i or whatever
4 You add fax pdf converter from spadmin GUI fill the larrcommand with gfax (TMP)
5 Thatrsquos it you save the configuration6 Try fax an openoffice document
1st time i try fax with Fax Printer it hangthen i tried fax with PDF Converter and set the PDF Folder larr
then after fax i close the GFax and nothang
32 Windowsbull On windows you would use this Win print Hylafax software You can download
it at httpwinprinthylafaxsourceforgenet
bull To get the addressbook working with winprinthylfax you can setup folder calledhylafaxaddressbook and i int create 2 empty files called namestxt and num-berstxt
bull ADMINISTRATIONDownload program called WHFC which will tell you thestatus of the hylafax servers
33 Mac
34 PBX Dial 9 before numberbull Add this to your configttyS14 files you can replace 9 with 8 or any other num-
ber
6
ModemDialCmd ATDT9s
bull Pause The comma () dial modifier causes the modem to pause while dialingATD917731231234
bull Pause and wait for dial tone The W causes a modem to wait for an dial tonesignal before dialing the number that follow the W ATDT 9 W 17731231234
ModemDialCmd ATDT9Ws
bull Final Modem Dial Cmd on the system could look like this
ModemDialCmd ATDT9Ws
bull 9 says dial 9 comma says wait W says wait for dial tone s says dial thisnumber
bull Also see ModemAtCommandSet
bull If you experience no dial tone in your logs try something like
ModemDialCmd ATX3DT8s
AT - picks up the phone X3- disables dial tone check DT tells it to use tone dial8 then bdquo for wait then the phone number
35 Adding usersbull You need a user on your system
adduser dept1
bull Fill in the username and password etc
bull Then add user to hylafax First find out what is your new user UID
bull Type
cat etcgroup
bull Find your user It should be something like dept1x1001 so this user UID is1001
bull Now tell hylafax about it
7
faxadduser -p password -u 1001 username
bull To see what users are already in do
cat varspoolhylafaxetchostshfaxd
4 HardwareModem Model
1 US Robotics 56K External Fax modem 5686E (Does not come with cable)(around $100)
2 Amigo AME-CA95 RS232 External V92 DATAFAXTAM Modem or ExternalConexant V92 modem (around $25 or less)-(neweggcom)
Serial Card
1 Startechcom 4 Multi Port Serial PCI Card
2 Startechcom 2 Port Serial PCI Card
41 Done with simple setupDone Everything beyond this point is for setting up multiple incomingoutgoingfax modems
5 Multiple Incoming Fax Lines
51 Multi port Serial PCI card ttySbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull Currently the limit in Debian supported ports is 4 (read on for more then 4 portsupport)
bull So if you have a 2 port serial card you want to add to your pc here is what youdo
bull If you connect more modems or when you buy a serial pci card you will want toknow which ttyS port they are using You can do it by
dmesg |grep tty
8
bull You should see something like
faxserver~ dmesg |grep ttySttyS0 at IO 0x3f8 (irq = 4) is a 16550AttyS14 at IO 0xdf08 (irq = 209) is a 16550AttyS15 at IO 0xdf10 (irq = 209) is a 16550A
bull If you installed another serial pci card (2 port or 4 port) you can see if it wasdetected by typing
lspci -v
This should list something like
000002000 Serial controller NetMos Technology PCI 9835 larrMulti-IO Controller (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART)Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
bull As you can see the IRQ should be the same as the one specified in dmesg
bull Install setserial This program will let you control serial port better
apt-get updateapt-get install setserial
bull Then try
setserial -g devttyS
bull If you donrsquot see a ttyS(ex ttyS14) in dev you will need to create ttyS14 device
ls devttyS
bull So in my case I am missing ttyS14 ttyS15 in dev folder
MAKEDEV ttyS14MAKEDEV ttyS15
9
bull Now run setserial -g devttyS again and you should see your new serial ports
bull Plug in your modems and Run
faxaddmodem
bull Select the new ttyS and you are done setting up multiple fax machines
52 Fax Dispatchbull Fax dispatch is a custom script that one can create for Hylafax to specify non-
standard delivery options (Standard is varspoolhylafaxrecvq)
bull If you want to have multiple fax destination folders for each fax you have (ttyS1ttyS14 ttyS15 etc)
bull Create Fax Dipatch file in etchylafax
touch etchylafaxFaxDispatch
bull Sample Fax Dispatch file might look like this httpwwwinfocoptercomknow-howhylafaxfax-dispatchhtml
bull Copy and past below to your etchylafaxFaxDispatch This will dispatch faxesto different folders based on device
bull Make sure you have created appropriate folders (In this case dept1 dept2 andchange device names to your names
$Id FaxDispatchv 12 20030504 234941 darren Exp larr$
Default FaxDispatch file - routes all inbound faxes to larr
FaxMaster as PDF Consult the faxrcvd(8C) man page for more information
SENDTO=faxMaster by default larremail to FaxMaster
FILETYPE=pdf in PDF larrformat
This excerpt from the man page gives you an idea of whatrsquos larr
possible here
10
You can route by senderrsquos TSIcase $SENDER in 15105261212) SENDTO=sam Samrsquos test larr
rig in Berkeley 14153901212) SENDTO=rasterasd 7L Xerox larr
room used for scanning 5107811212) SENDTO=peeblesmti stuff from larr
homeesac
andor by devicecase $DEVICE in ttyS1) SENDTO=john all faxes larr
received on ttyS1 ttyLT0) SENDTO=maryhome all faxes larr
received on ttyLT0 ttyS2) SENDTO=myemailexamplecom larr
myotheremailexample3com all faxes received larron ttyS1
esac
andor by deviceFOLDER=varspoolhylafaxrecvqFULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) mv $FULLPATH varspoolhylafaxrecvqdept1 larr
all faxes received on ttyS14ttyS15) mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
andor by caller idcase $CIDNUMBER in 435) SENDTO=lee FILETYPE=pdf all faxes larr
from area code 435 5059627777) SENDTO=amy FILETYPE=tif Amy wants larr
faxes in TIFFesac
bull If you would like to print and then move the file you would replace the relevantcode with this below
bull Make sure you install printer first DebianPrinting
bull Size of a page was added here to make sure 11x14 pages are printed properly
andor by deviceFOLDER=varspoolhylafaxrecvq
11
FULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larr
kyocera mv $FULLPATH varspoolhylafaxrecvqdept1 larr all faxes received on ttyS14
ttyS15) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larrkyocera mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
53 FaxNotifybull 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 theyactually sent we need to add FaxNotify to etchylafax
bull Create FaxNotify in etchylafax
bull Inside put
RETURNFILETYPE=pdf
54 View faxes through internet browserbull To do that install apache web server
apt-get updateapt-get install apache2
bull Now add a link to your faxes
cd varwwwln -s varspoolhylafaxrecvq fax
bull Now open a broswer and go to httplocalhostfax or by your ip addresshttp10101010fax
bull Enjoy Irsquove been told that this would cost 15000 dollars for consulting firm todo
6 Errorsbull You can find hylafax specific error codes here Hylafax Error Codes
12
61 Failure to receive silencebull Added to configttyS14 failure to receive silence
bull httpwwwhylafaxorgarchive2002-08msg00260php
bull Add this to your configuration configttyS
Class1SwitchingCmd ltdelay7gt
62 T30 T2 timeout expected signal not receivedbull Switching to calls 1 and adding the delay will solve the problem
bull Run the faxaddmodem command again and add the delay
63 Unspecified Phase C error including too much delay betweenTCF and +FDR command
bull Switching to Class 1 solved the problem
64 No Dial Tonebull Adding dial string 9 then pause then number to config file solved the problem
bull See PBX Dial 9 before number section and if you need more details on optionssee httpmemberstripodcommichaelgellismodemhtml
65 No carrier Detectedbull 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 yoursetup See if these are busy signal For some reason busy signal gets labeled asno carrier detected
cat varspoolhylafaxlogxferfaxlog
66 Modem WedgedAfter a month of good work (11000 faxes) suddenly the modem become wedgedBecause USR modem doesnrsquot have the un-wedged option as the Mainpine modemyou have to tell hylafax to try to set it up more then (default)2 times Add this to yourconfigtty
MaxSetupAttempts 10
13
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
Hold UUCP lockfile during voice calls (accept the larrdefault)
Percent good lines to accept (accept the default)
Max consecutive bad lines to accept (you may want larrto reduce the default 5 to 3)
Max number of pages to accept in a received fax ( larryou may want to increase the default value of 25)
Syslog facility name for ServerTracing messages ( larrthe default is rsquodaemonrsquo but you could change it larrto rsquolocal7rsquo if yoursquore logging to a remote syslog larrserver)
Set UID to 0 (accept default)
Use priority job scheduling (accept default)
bull Yoursquoll then be asked to confirm the values that you entered and then the utilitywill query to modem to determine the fax classes that it supports
bull Even if your modem supports both Class 1 and Class 2 you should set it to Class1 for compatibility with all fax machines
bull You will then be asked for values specific to the modem Just press Enter toaccept the default values as they are a result of the modem query and the classyou selected Yoursquoll then be prompted to confirm these values by pressing Enter
bull The non-default scheduler values will then be displayed with a confirmationprompt The Area Code may not be correct If so answer No and correct anyerroneous values You may also want to increase the time value for Timeoutwhen converting PostScript documents if you fax long documents but you canjust press Enter to accept the default values for the rest of the values
bull Answer No when asked if you want to configure another modem
bull Accept the default Yes answer to run faxmodem on your newly configured mo-dem to verify settings Yoursquoll then be returned to the shell prompt
bull If you want to manually edit the file that contains these settings do so with thecommand
vi etchylafaxconfigttyS0
bull You have to run the faxaddmodem utility to create this file first though
bull Next wersquoll set up HylaFAX to run automatically when you boot the systemCheck the configuration file
vi etcdefaulthylafax
bull to make sure therersquos no character at the beginning of the line containing RUN_HYLAFAX=1Exit the editor
4
21 Configure Incoming Settingsbull One last item that is to let HylaFAX know who is allowed to send faxes You can
use a modified subnet address to let everyone on your network submit faxes tothe server Edit the hostshfaxd file with the command
vi etchylafaxhostshfaxd
bull As an example if your using a subnet address for your network of 192168100enter the following line into the hostshfaxd file
19216810
bull Likewise if your using a subnet address of 1721600 your hostshfaxd file entrywould be
17230
bull You can enter as wide of a network address or multiple narrower address en-tries as yoursquod like If yoursquod like to restrict access to specific users you can entertheir individual IP addresses When done save the file and exit the editor
NOTE You will see the paths varspoolhylafax and var larrspoolhylafaxetc specified in HylaFAX documentation and larrutilities Do NOT edit the files in these directories larrThe files are duplicated in the etchylafax directory larrIf you ever want to manually edit the configuration files larr only edit the files in the etchylafax directory
bull Reboot the system by typing reboot and yoursquoll have yourself a fax server(Rebootis not necessary Restart of hylafax would do just fine)
22 Fax Statusbull To see a status of a fax server Type
faxstat -s
3 Sending FaxIn general the list of all the software is here but you can just go to the once we referencebelow httpwwwhylafaxorgcontentClient_Software
5
31 LinuxYou can use Gfax or Kde Print Fax You install it Gfax by
apt-get updateapt-get install gfax
Then Go to Application then Office then Gfax
bull This needs to be tested but
Now i can do fax from OpenOffice TextEditor etc
1 Install GFax from apt-get install gfax2 Configure GFax with your Fax Server (HylaFAX) I hope you larr
know how to do itOk you can test your GFax configuration by test send a larr
fax with Text Editor (Applications -Accessories)3 To make it work with openoffice run usrlibopenoffice larr
programspadmin (with root access) youdo sudo -i or whatever
4 You add fax pdf converter from spadmin GUI fill the larrcommand with gfax (TMP)
5 Thatrsquos it you save the configuration6 Try fax an openoffice document
1st time i try fax with Fax Printer it hangthen i tried fax with PDF Converter and set the PDF Folder larr
then after fax i close the GFax and nothang
32 Windowsbull On windows you would use this Win print Hylafax software You can download
it at httpwinprinthylafaxsourceforgenet
bull To get the addressbook working with winprinthylfax you can setup folder calledhylafaxaddressbook and i int create 2 empty files called namestxt and num-berstxt
bull ADMINISTRATIONDownload program called WHFC which will tell you thestatus of the hylafax servers
33 Mac
34 PBX Dial 9 before numberbull Add this to your configttyS14 files you can replace 9 with 8 or any other num-
ber
6
ModemDialCmd ATDT9s
bull Pause The comma () dial modifier causes the modem to pause while dialingATD917731231234
bull Pause and wait for dial tone The W causes a modem to wait for an dial tonesignal before dialing the number that follow the W ATDT 9 W 17731231234
ModemDialCmd ATDT9Ws
bull Final Modem Dial Cmd on the system could look like this
ModemDialCmd ATDT9Ws
bull 9 says dial 9 comma says wait W says wait for dial tone s says dial thisnumber
bull Also see ModemAtCommandSet
bull If you experience no dial tone in your logs try something like
ModemDialCmd ATX3DT8s
AT - picks up the phone X3- disables dial tone check DT tells it to use tone dial8 then bdquo for wait then the phone number
35 Adding usersbull You need a user on your system
adduser dept1
bull Fill in the username and password etc
bull Then add user to hylafax First find out what is your new user UID
bull Type
cat etcgroup
bull Find your user It should be something like dept1x1001 so this user UID is1001
bull Now tell hylafax about it
7
faxadduser -p password -u 1001 username
bull To see what users are already in do
cat varspoolhylafaxetchostshfaxd
4 HardwareModem Model
1 US Robotics 56K External Fax modem 5686E (Does not come with cable)(around $100)
2 Amigo AME-CA95 RS232 External V92 DATAFAXTAM Modem or ExternalConexant V92 modem (around $25 or less)-(neweggcom)
Serial Card
1 Startechcom 4 Multi Port Serial PCI Card
2 Startechcom 2 Port Serial PCI Card
41 Done with simple setupDone Everything beyond this point is for setting up multiple incomingoutgoingfax modems
5 Multiple Incoming Fax Lines
51 Multi port Serial PCI card ttySbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull Currently the limit in Debian supported ports is 4 (read on for more then 4 portsupport)
bull So if you have a 2 port serial card you want to add to your pc here is what youdo
bull If you connect more modems or when you buy a serial pci card you will want toknow which ttyS port they are using You can do it by
dmesg |grep tty
8
bull You should see something like
faxserver~ dmesg |grep ttySttyS0 at IO 0x3f8 (irq = 4) is a 16550AttyS14 at IO 0xdf08 (irq = 209) is a 16550AttyS15 at IO 0xdf10 (irq = 209) is a 16550A
bull If you installed another serial pci card (2 port or 4 port) you can see if it wasdetected by typing
lspci -v
This should list something like
000002000 Serial controller NetMos Technology PCI 9835 larrMulti-IO Controller (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART)Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
bull As you can see the IRQ should be the same as the one specified in dmesg
bull Install setserial This program will let you control serial port better
apt-get updateapt-get install setserial
bull Then try
setserial -g devttyS
bull If you donrsquot see a ttyS(ex ttyS14) in dev you will need to create ttyS14 device
ls devttyS
bull So in my case I am missing ttyS14 ttyS15 in dev folder
MAKEDEV ttyS14MAKEDEV ttyS15
9
bull Now run setserial -g devttyS again and you should see your new serial ports
bull Plug in your modems and Run
faxaddmodem
bull Select the new ttyS and you are done setting up multiple fax machines
52 Fax Dispatchbull Fax dispatch is a custom script that one can create for Hylafax to specify non-
standard delivery options (Standard is varspoolhylafaxrecvq)
bull If you want to have multiple fax destination folders for each fax you have (ttyS1ttyS14 ttyS15 etc)
bull Create Fax Dipatch file in etchylafax
touch etchylafaxFaxDispatch
bull Sample Fax Dispatch file might look like this httpwwwinfocoptercomknow-howhylafaxfax-dispatchhtml
bull Copy and past below to your etchylafaxFaxDispatch This will dispatch faxesto different folders based on device
bull Make sure you have created appropriate folders (In this case dept1 dept2 andchange device names to your names
$Id FaxDispatchv 12 20030504 234941 darren Exp larr$
Default FaxDispatch file - routes all inbound faxes to larr
FaxMaster as PDF Consult the faxrcvd(8C) man page for more information
SENDTO=faxMaster by default larremail to FaxMaster
FILETYPE=pdf in PDF larrformat
This excerpt from the man page gives you an idea of whatrsquos larr
possible here
10
You can route by senderrsquos TSIcase $SENDER in 15105261212) SENDTO=sam Samrsquos test larr
rig in Berkeley 14153901212) SENDTO=rasterasd 7L Xerox larr
room used for scanning 5107811212) SENDTO=peeblesmti stuff from larr
homeesac
andor by devicecase $DEVICE in ttyS1) SENDTO=john all faxes larr
received on ttyS1 ttyLT0) SENDTO=maryhome all faxes larr
received on ttyLT0 ttyS2) SENDTO=myemailexamplecom larr
myotheremailexample3com all faxes received larron ttyS1
esac
andor by deviceFOLDER=varspoolhylafaxrecvqFULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) mv $FULLPATH varspoolhylafaxrecvqdept1 larr
all faxes received on ttyS14ttyS15) mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
andor by caller idcase $CIDNUMBER in 435) SENDTO=lee FILETYPE=pdf all faxes larr
from area code 435 5059627777) SENDTO=amy FILETYPE=tif Amy wants larr
faxes in TIFFesac
bull If you would like to print and then move the file you would replace the relevantcode with this below
bull Make sure you install printer first DebianPrinting
bull Size of a page was added here to make sure 11x14 pages are printed properly
andor by deviceFOLDER=varspoolhylafaxrecvq
11
FULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larr
kyocera mv $FULLPATH varspoolhylafaxrecvqdept1 larr all faxes received on ttyS14
ttyS15) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larrkyocera mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
53 FaxNotifybull 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 theyactually sent we need to add FaxNotify to etchylafax
bull Create FaxNotify in etchylafax
bull Inside put
RETURNFILETYPE=pdf
54 View faxes through internet browserbull To do that install apache web server
apt-get updateapt-get install apache2
bull Now add a link to your faxes
cd varwwwln -s varspoolhylafaxrecvq fax
bull Now open a broswer and go to httplocalhostfax or by your ip addresshttp10101010fax
bull Enjoy Irsquove been told that this would cost 15000 dollars for consulting firm todo
6 Errorsbull You can find hylafax specific error codes here Hylafax Error Codes
12
61 Failure to receive silencebull Added to configttyS14 failure to receive silence
bull httpwwwhylafaxorgarchive2002-08msg00260php
bull Add this to your configuration configttyS
Class1SwitchingCmd ltdelay7gt
62 T30 T2 timeout expected signal not receivedbull Switching to calls 1 and adding the delay will solve the problem
bull Run the faxaddmodem command again and add the delay
63 Unspecified Phase C error including too much delay betweenTCF and +FDR command
bull Switching to Class 1 solved the problem
64 No Dial Tonebull Adding dial string 9 then pause then number to config file solved the problem
bull See PBX Dial 9 before number section and if you need more details on optionssee httpmemberstripodcommichaelgellismodemhtml
65 No carrier Detectedbull 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 yoursetup See if these are busy signal For some reason busy signal gets labeled asno carrier detected
cat varspoolhylafaxlogxferfaxlog
66 Modem WedgedAfter a month of good work (11000 faxes) suddenly the modem become wedgedBecause USR modem doesnrsquot have the un-wedged option as the Mainpine modemyou have to tell hylafax to try to set it up more then (default)2 times Add this to yourconfigtty
MaxSetupAttempts 10
13
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
21 Configure Incoming Settingsbull One last item that is to let HylaFAX know who is allowed to send faxes You can
use a modified subnet address to let everyone on your network submit faxes tothe server Edit the hostshfaxd file with the command
vi etchylafaxhostshfaxd
bull As an example if your using a subnet address for your network of 192168100enter the following line into the hostshfaxd file
19216810
bull Likewise if your using a subnet address of 1721600 your hostshfaxd file entrywould be
17230
bull You can enter as wide of a network address or multiple narrower address en-tries as yoursquod like If yoursquod like to restrict access to specific users you can entertheir individual IP addresses When done save the file and exit the editor
NOTE You will see the paths varspoolhylafax and var larrspoolhylafaxetc specified in HylaFAX documentation and larrutilities Do NOT edit the files in these directories larrThe files are duplicated in the etchylafax directory larrIf you ever want to manually edit the configuration files larr only edit the files in the etchylafax directory
bull Reboot the system by typing reboot and yoursquoll have yourself a fax server(Rebootis not necessary Restart of hylafax would do just fine)
22 Fax Statusbull To see a status of a fax server Type
faxstat -s
3 Sending FaxIn general the list of all the software is here but you can just go to the once we referencebelow httpwwwhylafaxorgcontentClient_Software
5
31 LinuxYou can use Gfax or Kde Print Fax You install it Gfax by
apt-get updateapt-get install gfax
Then Go to Application then Office then Gfax
bull This needs to be tested but
Now i can do fax from OpenOffice TextEditor etc
1 Install GFax from apt-get install gfax2 Configure GFax with your Fax Server (HylaFAX) I hope you larr
know how to do itOk you can test your GFax configuration by test send a larr
fax with Text Editor (Applications -Accessories)3 To make it work with openoffice run usrlibopenoffice larr
programspadmin (with root access) youdo sudo -i or whatever
4 You add fax pdf converter from spadmin GUI fill the larrcommand with gfax (TMP)
5 Thatrsquos it you save the configuration6 Try fax an openoffice document
1st time i try fax with Fax Printer it hangthen i tried fax with PDF Converter and set the PDF Folder larr
then after fax i close the GFax and nothang
32 Windowsbull On windows you would use this Win print Hylafax software You can download
it at httpwinprinthylafaxsourceforgenet
bull To get the addressbook working with winprinthylfax you can setup folder calledhylafaxaddressbook and i int create 2 empty files called namestxt and num-berstxt
bull ADMINISTRATIONDownload program called WHFC which will tell you thestatus of the hylafax servers
33 Mac
34 PBX Dial 9 before numberbull Add this to your configttyS14 files you can replace 9 with 8 or any other num-
ber
6
ModemDialCmd ATDT9s
bull Pause The comma () dial modifier causes the modem to pause while dialingATD917731231234
bull Pause and wait for dial tone The W causes a modem to wait for an dial tonesignal before dialing the number that follow the W ATDT 9 W 17731231234
ModemDialCmd ATDT9Ws
bull Final Modem Dial Cmd on the system could look like this
ModemDialCmd ATDT9Ws
bull 9 says dial 9 comma says wait W says wait for dial tone s says dial thisnumber
bull Also see ModemAtCommandSet
bull If you experience no dial tone in your logs try something like
ModemDialCmd ATX3DT8s
AT - picks up the phone X3- disables dial tone check DT tells it to use tone dial8 then bdquo for wait then the phone number
35 Adding usersbull You need a user on your system
adduser dept1
bull Fill in the username and password etc
bull Then add user to hylafax First find out what is your new user UID
bull Type
cat etcgroup
bull Find your user It should be something like dept1x1001 so this user UID is1001
bull Now tell hylafax about it
7
faxadduser -p password -u 1001 username
bull To see what users are already in do
cat varspoolhylafaxetchostshfaxd
4 HardwareModem Model
1 US Robotics 56K External Fax modem 5686E (Does not come with cable)(around $100)
2 Amigo AME-CA95 RS232 External V92 DATAFAXTAM Modem or ExternalConexant V92 modem (around $25 or less)-(neweggcom)
Serial Card
1 Startechcom 4 Multi Port Serial PCI Card
2 Startechcom 2 Port Serial PCI Card
41 Done with simple setupDone Everything beyond this point is for setting up multiple incomingoutgoingfax modems
5 Multiple Incoming Fax Lines
51 Multi port Serial PCI card ttySbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull Currently the limit in Debian supported ports is 4 (read on for more then 4 portsupport)
bull So if you have a 2 port serial card you want to add to your pc here is what youdo
bull If you connect more modems or when you buy a serial pci card you will want toknow which ttyS port they are using You can do it by
dmesg |grep tty
8
bull You should see something like
faxserver~ dmesg |grep ttySttyS0 at IO 0x3f8 (irq = 4) is a 16550AttyS14 at IO 0xdf08 (irq = 209) is a 16550AttyS15 at IO 0xdf10 (irq = 209) is a 16550A
bull If you installed another serial pci card (2 port or 4 port) you can see if it wasdetected by typing
lspci -v
This should list something like
000002000 Serial controller NetMos Technology PCI 9835 larrMulti-IO Controller (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART)Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
bull As you can see the IRQ should be the same as the one specified in dmesg
bull Install setserial This program will let you control serial port better
apt-get updateapt-get install setserial
bull Then try
setserial -g devttyS
bull If you donrsquot see a ttyS(ex ttyS14) in dev you will need to create ttyS14 device
ls devttyS
bull So in my case I am missing ttyS14 ttyS15 in dev folder
MAKEDEV ttyS14MAKEDEV ttyS15
9
bull Now run setserial -g devttyS again and you should see your new serial ports
bull Plug in your modems and Run
faxaddmodem
bull Select the new ttyS and you are done setting up multiple fax machines
52 Fax Dispatchbull Fax dispatch is a custom script that one can create for Hylafax to specify non-
standard delivery options (Standard is varspoolhylafaxrecvq)
bull If you want to have multiple fax destination folders for each fax you have (ttyS1ttyS14 ttyS15 etc)
bull Create Fax Dipatch file in etchylafax
touch etchylafaxFaxDispatch
bull Sample Fax Dispatch file might look like this httpwwwinfocoptercomknow-howhylafaxfax-dispatchhtml
bull Copy and past below to your etchylafaxFaxDispatch This will dispatch faxesto different folders based on device
bull Make sure you have created appropriate folders (In this case dept1 dept2 andchange device names to your names
$Id FaxDispatchv 12 20030504 234941 darren Exp larr$
Default FaxDispatch file - routes all inbound faxes to larr
FaxMaster as PDF Consult the faxrcvd(8C) man page for more information
SENDTO=faxMaster by default larremail to FaxMaster
FILETYPE=pdf in PDF larrformat
This excerpt from the man page gives you an idea of whatrsquos larr
possible here
10
You can route by senderrsquos TSIcase $SENDER in 15105261212) SENDTO=sam Samrsquos test larr
rig in Berkeley 14153901212) SENDTO=rasterasd 7L Xerox larr
room used for scanning 5107811212) SENDTO=peeblesmti stuff from larr
homeesac
andor by devicecase $DEVICE in ttyS1) SENDTO=john all faxes larr
received on ttyS1 ttyLT0) SENDTO=maryhome all faxes larr
received on ttyLT0 ttyS2) SENDTO=myemailexamplecom larr
myotheremailexample3com all faxes received larron ttyS1
esac
andor by deviceFOLDER=varspoolhylafaxrecvqFULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) mv $FULLPATH varspoolhylafaxrecvqdept1 larr
all faxes received on ttyS14ttyS15) mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
andor by caller idcase $CIDNUMBER in 435) SENDTO=lee FILETYPE=pdf all faxes larr
from area code 435 5059627777) SENDTO=amy FILETYPE=tif Amy wants larr
faxes in TIFFesac
bull If you would like to print and then move the file you would replace the relevantcode with this below
bull Make sure you install printer first DebianPrinting
bull Size of a page was added here to make sure 11x14 pages are printed properly
andor by deviceFOLDER=varspoolhylafaxrecvq
11
FULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larr
kyocera mv $FULLPATH varspoolhylafaxrecvqdept1 larr all faxes received on ttyS14
ttyS15) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larrkyocera mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
53 FaxNotifybull 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 theyactually sent we need to add FaxNotify to etchylafax
bull Create FaxNotify in etchylafax
bull Inside put
RETURNFILETYPE=pdf
54 View faxes through internet browserbull To do that install apache web server
apt-get updateapt-get install apache2
bull Now add a link to your faxes
cd varwwwln -s varspoolhylafaxrecvq fax
bull Now open a broswer and go to httplocalhostfax or by your ip addresshttp10101010fax
bull Enjoy Irsquove been told that this would cost 15000 dollars for consulting firm todo
6 Errorsbull You can find hylafax specific error codes here Hylafax Error Codes
12
61 Failure to receive silencebull Added to configttyS14 failure to receive silence
bull httpwwwhylafaxorgarchive2002-08msg00260php
bull Add this to your configuration configttyS
Class1SwitchingCmd ltdelay7gt
62 T30 T2 timeout expected signal not receivedbull Switching to calls 1 and adding the delay will solve the problem
bull Run the faxaddmodem command again and add the delay
63 Unspecified Phase C error including too much delay betweenTCF and +FDR command
bull Switching to Class 1 solved the problem
64 No Dial Tonebull Adding dial string 9 then pause then number to config file solved the problem
bull See PBX Dial 9 before number section and if you need more details on optionssee httpmemberstripodcommichaelgellismodemhtml
65 No carrier Detectedbull 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 yoursetup See if these are busy signal For some reason busy signal gets labeled asno carrier detected
cat varspoolhylafaxlogxferfaxlog
66 Modem WedgedAfter a month of good work (11000 faxes) suddenly the modem become wedgedBecause USR modem doesnrsquot have the un-wedged option as the Mainpine modemyou have to tell hylafax to try to set it up more then (default)2 times Add this to yourconfigtty
MaxSetupAttempts 10
13
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
31 LinuxYou can use Gfax or Kde Print Fax You install it Gfax by
apt-get updateapt-get install gfax
Then Go to Application then Office then Gfax
bull This needs to be tested but
Now i can do fax from OpenOffice TextEditor etc
1 Install GFax from apt-get install gfax2 Configure GFax with your Fax Server (HylaFAX) I hope you larr
know how to do itOk you can test your GFax configuration by test send a larr
fax with Text Editor (Applications -Accessories)3 To make it work with openoffice run usrlibopenoffice larr
programspadmin (with root access) youdo sudo -i or whatever
4 You add fax pdf converter from spadmin GUI fill the larrcommand with gfax (TMP)
5 Thatrsquos it you save the configuration6 Try fax an openoffice document
1st time i try fax with Fax Printer it hangthen i tried fax with PDF Converter and set the PDF Folder larr
then after fax i close the GFax and nothang
32 Windowsbull On windows you would use this Win print Hylafax software You can download
it at httpwinprinthylafaxsourceforgenet
bull To get the addressbook working with winprinthylfax you can setup folder calledhylafaxaddressbook and i int create 2 empty files called namestxt and num-berstxt
bull ADMINISTRATIONDownload program called WHFC which will tell you thestatus of the hylafax servers
33 Mac
34 PBX Dial 9 before numberbull Add this to your configttyS14 files you can replace 9 with 8 or any other num-
ber
6
ModemDialCmd ATDT9s
bull Pause The comma () dial modifier causes the modem to pause while dialingATD917731231234
bull Pause and wait for dial tone The W causes a modem to wait for an dial tonesignal before dialing the number that follow the W ATDT 9 W 17731231234
ModemDialCmd ATDT9Ws
bull Final Modem Dial Cmd on the system could look like this
ModemDialCmd ATDT9Ws
bull 9 says dial 9 comma says wait W says wait for dial tone s says dial thisnumber
bull Also see ModemAtCommandSet
bull If you experience no dial tone in your logs try something like
ModemDialCmd ATX3DT8s
AT - picks up the phone X3- disables dial tone check DT tells it to use tone dial8 then bdquo for wait then the phone number
35 Adding usersbull You need a user on your system
adduser dept1
bull Fill in the username and password etc
bull Then add user to hylafax First find out what is your new user UID
bull Type
cat etcgroup
bull Find your user It should be something like dept1x1001 so this user UID is1001
bull Now tell hylafax about it
7
faxadduser -p password -u 1001 username
bull To see what users are already in do
cat varspoolhylafaxetchostshfaxd
4 HardwareModem Model
1 US Robotics 56K External Fax modem 5686E (Does not come with cable)(around $100)
2 Amigo AME-CA95 RS232 External V92 DATAFAXTAM Modem or ExternalConexant V92 modem (around $25 or less)-(neweggcom)
Serial Card
1 Startechcom 4 Multi Port Serial PCI Card
2 Startechcom 2 Port Serial PCI Card
41 Done with simple setupDone Everything beyond this point is for setting up multiple incomingoutgoingfax modems
5 Multiple Incoming Fax Lines
51 Multi port Serial PCI card ttySbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull Currently the limit in Debian supported ports is 4 (read on for more then 4 portsupport)
bull So if you have a 2 port serial card you want to add to your pc here is what youdo
bull If you connect more modems or when you buy a serial pci card you will want toknow which ttyS port they are using You can do it by
dmesg |grep tty
8
bull You should see something like
faxserver~ dmesg |grep ttySttyS0 at IO 0x3f8 (irq = 4) is a 16550AttyS14 at IO 0xdf08 (irq = 209) is a 16550AttyS15 at IO 0xdf10 (irq = 209) is a 16550A
bull If you installed another serial pci card (2 port or 4 port) you can see if it wasdetected by typing
lspci -v
This should list something like
000002000 Serial controller NetMos Technology PCI 9835 larrMulti-IO Controller (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART)Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
bull As you can see the IRQ should be the same as the one specified in dmesg
bull Install setserial This program will let you control serial port better
apt-get updateapt-get install setserial
bull Then try
setserial -g devttyS
bull If you donrsquot see a ttyS(ex ttyS14) in dev you will need to create ttyS14 device
ls devttyS
bull So in my case I am missing ttyS14 ttyS15 in dev folder
MAKEDEV ttyS14MAKEDEV ttyS15
9
bull Now run setserial -g devttyS again and you should see your new serial ports
bull Plug in your modems and Run
faxaddmodem
bull Select the new ttyS and you are done setting up multiple fax machines
52 Fax Dispatchbull Fax dispatch is a custom script that one can create for Hylafax to specify non-
standard delivery options (Standard is varspoolhylafaxrecvq)
bull If you want to have multiple fax destination folders for each fax you have (ttyS1ttyS14 ttyS15 etc)
bull Create Fax Dipatch file in etchylafax
touch etchylafaxFaxDispatch
bull Sample Fax Dispatch file might look like this httpwwwinfocoptercomknow-howhylafaxfax-dispatchhtml
bull Copy and past below to your etchylafaxFaxDispatch This will dispatch faxesto different folders based on device
bull Make sure you have created appropriate folders (In this case dept1 dept2 andchange device names to your names
$Id FaxDispatchv 12 20030504 234941 darren Exp larr$
Default FaxDispatch file - routes all inbound faxes to larr
FaxMaster as PDF Consult the faxrcvd(8C) man page for more information
SENDTO=faxMaster by default larremail to FaxMaster
FILETYPE=pdf in PDF larrformat
This excerpt from the man page gives you an idea of whatrsquos larr
possible here
10
You can route by senderrsquos TSIcase $SENDER in 15105261212) SENDTO=sam Samrsquos test larr
rig in Berkeley 14153901212) SENDTO=rasterasd 7L Xerox larr
room used for scanning 5107811212) SENDTO=peeblesmti stuff from larr
homeesac
andor by devicecase $DEVICE in ttyS1) SENDTO=john all faxes larr
received on ttyS1 ttyLT0) SENDTO=maryhome all faxes larr
received on ttyLT0 ttyS2) SENDTO=myemailexamplecom larr
myotheremailexample3com all faxes received larron ttyS1
esac
andor by deviceFOLDER=varspoolhylafaxrecvqFULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) mv $FULLPATH varspoolhylafaxrecvqdept1 larr
all faxes received on ttyS14ttyS15) mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
andor by caller idcase $CIDNUMBER in 435) SENDTO=lee FILETYPE=pdf all faxes larr
from area code 435 5059627777) SENDTO=amy FILETYPE=tif Amy wants larr
faxes in TIFFesac
bull If you would like to print and then move the file you would replace the relevantcode with this below
bull Make sure you install printer first DebianPrinting
bull Size of a page was added here to make sure 11x14 pages are printed properly
andor by deviceFOLDER=varspoolhylafaxrecvq
11
FULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larr
kyocera mv $FULLPATH varspoolhylafaxrecvqdept1 larr all faxes received on ttyS14
ttyS15) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larrkyocera mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
53 FaxNotifybull 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 theyactually sent we need to add FaxNotify to etchylafax
bull Create FaxNotify in etchylafax
bull Inside put
RETURNFILETYPE=pdf
54 View faxes through internet browserbull To do that install apache web server
apt-get updateapt-get install apache2
bull Now add a link to your faxes
cd varwwwln -s varspoolhylafaxrecvq fax
bull Now open a broswer and go to httplocalhostfax or by your ip addresshttp10101010fax
bull Enjoy Irsquove been told that this would cost 15000 dollars for consulting firm todo
6 Errorsbull You can find hylafax specific error codes here Hylafax Error Codes
12
61 Failure to receive silencebull Added to configttyS14 failure to receive silence
bull httpwwwhylafaxorgarchive2002-08msg00260php
bull Add this to your configuration configttyS
Class1SwitchingCmd ltdelay7gt
62 T30 T2 timeout expected signal not receivedbull Switching to calls 1 and adding the delay will solve the problem
bull Run the faxaddmodem command again and add the delay
63 Unspecified Phase C error including too much delay betweenTCF and +FDR command
bull Switching to Class 1 solved the problem
64 No Dial Tonebull Adding dial string 9 then pause then number to config file solved the problem
bull See PBX Dial 9 before number section and if you need more details on optionssee httpmemberstripodcommichaelgellismodemhtml
65 No carrier Detectedbull 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 yoursetup See if these are busy signal For some reason busy signal gets labeled asno carrier detected
cat varspoolhylafaxlogxferfaxlog
66 Modem WedgedAfter a month of good work (11000 faxes) suddenly the modem become wedgedBecause USR modem doesnrsquot have the un-wedged option as the Mainpine modemyou have to tell hylafax to try to set it up more then (default)2 times Add this to yourconfigtty
MaxSetupAttempts 10
13
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
ModemDialCmd ATDT9s
bull Pause The comma () dial modifier causes the modem to pause while dialingATD917731231234
bull Pause and wait for dial tone The W causes a modem to wait for an dial tonesignal before dialing the number that follow the W ATDT 9 W 17731231234
ModemDialCmd ATDT9Ws
bull Final Modem Dial Cmd on the system could look like this
ModemDialCmd ATDT9Ws
bull 9 says dial 9 comma says wait W says wait for dial tone s says dial thisnumber
bull Also see ModemAtCommandSet
bull If you experience no dial tone in your logs try something like
ModemDialCmd ATX3DT8s
AT - picks up the phone X3- disables dial tone check DT tells it to use tone dial8 then bdquo for wait then the phone number
35 Adding usersbull You need a user on your system
adduser dept1
bull Fill in the username and password etc
bull Then add user to hylafax First find out what is your new user UID
bull Type
cat etcgroup
bull Find your user It should be something like dept1x1001 so this user UID is1001
bull Now tell hylafax about it
7
faxadduser -p password -u 1001 username
bull To see what users are already in do
cat varspoolhylafaxetchostshfaxd
4 HardwareModem Model
1 US Robotics 56K External Fax modem 5686E (Does not come with cable)(around $100)
2 Amigo AME-CA95 RS232 External V92 DATAFAXTAM Modem or ExternalConexant V92 modem (around $25 or less)-(neweggcom)
Serial Card
1 Startechcom 4 Multi Port Serial PCI Card
2 Startechcom 2 Port Serial PCI Card
41 Done with simple setupDone Everything beyond this point is for setting up multiple incomingoutgoingfax modems
5 Multiple Incoming Fax Lines
51 Multi port Serial PCI card ttySbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull Currently the limit in Debian supported ports is 4 (read on for more then 4 portsupport)
bull So if you have a 2 port serial card you want to add to your pc here is what youdo
bull If you connect more modems or when you buy a serial pci card you will want toknow which ttyS port they are using You can do it by
dmesg |grep tty
8
bull You should see something like
faxserver~ dmesg |grep ttySttyS0 at IO 0x3f8 (irq = 4) is a 16550AttyS14 at IO 0xdf08 (irq = 209) is a 16550AttyS15 at IO 0xdf10 (irq = 209) is a 16550A
bull If you installed another serial pci card (2 port or 4 port) you can see if it wasdetected by typing
lspci -v
This should list something like
000002000 Serial controller NetMos Technology PCI 9835 larrMulti-IO Controller (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART)Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
bull As you can see the IRQ should be the same as the one specified in dmesg
bull Install setserial This program will let you control serial port better
apt-get updateapt-get install setserial
bull Then try
setserial -g devttyS
bull If you donrsquot see a ttyS(ex ttyS14) in dev you will need to create ttyS14 device
ls devttyS
bull So in my case I am missing ttyS14 ttyS15 in dev folder
MAKEDEV ttyS14MAKEDEV ttyS15
9
bull Now run setserial -g devttyS again and you should see your new serial ports
bull Plug in your modems and Run
faxaddmodem
bull Select the new ttyS and you are done setting up multiple fax machines
52 Fax Dispatchbull Fax dispatch is a custom script that one can create for Hylafax to specify non-
standard delivery options (Standard is varspoolhylafaxrecvq)
bull If you want to have multiple fax destination folders for each fax you have (ttyS1ttyS14 ttyS15 etc)
bull Create Fax Dipatch file in etchylafax
touch etchylafaxFaxDispatch
bull Sample Fax Dispatch file might look like this httpwwwinfocoptercomknow-howhylafaxfax-dispatchhtml
bull Copy and past below to your etchylafaxFaxDispatch This will dispatch faxesto different folders based on device
bull Make sure you have created appropriate folders (In this case dept1 dept2 andchange device names to your names
$Id FaxDispatchv 12 20030504 234941 darren Exp larr$
Default FaxDispatch file - routes all inbound faxes to larr
FaxMaster as PDF Consult the faxrcvd(8C) man page for more information
SENDTO=faxMaster by default larremail to FaxMaster
FILETYPE=pdf in PDF larrformat
This excerpt from the man page gives you an idea of whatrsquos larr
possible here
10
You can route by senderrsquos TSIcase $SENDER in 15105261212) SENDTO=sam Samrsquos test larr
rig in Berkeley 14153901212) SENDTO=rasterasd 7L Xerox larr
room used for scanning 5107811212) SENDTO=peeblesmti stuff from larr
homeesac
andor by devicecase $DEVICE in ttyS1) SENDTO=john all faxes larr
received on ttyS1 ttyLT0) SENDTO=maryhome all faxes larr
received on ttyLT0 ttyS2) SENDTO=myemailexamplecom larr
myotheremailexample3com all faxes received larron ttyS1
esac
andor by deviceFOLDER=varspoolhylafaxrecvqFULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) mv $FULLPATH varspoolhylafaxrecvqdept1 larr
all faxes received on ttyS14ttyS15) mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
andor by caller idcase $CIDNUMBER in 435) SENDTO=lee FILETYPE=pdf all faxes larr
from area code 435 5059627777) SENDTO=amy FILETYPE=tif Amy wants larr
faxes in TIFFesac
bull If you would like to print and then move the file you would replace the relevantcode with this below
bull Make sure you install printer first DebianPrinting
bull Size of a page was added here to make sure 11x14 pages are printed properly
andor by deviceFOLDER=varspoolhylafaxrecvq
11
FULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larr
kyocera mv $FULLPATH varspoolhylafaxrecvqdept1 larr all faxes received on ttyS14
ttyS15) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larrkyocera mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
53 FaxNotifybull 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 theyactually sent we need to add FaxNotify to etchylafax
bull Create FaxNotify in etchylafax
bull Inside put
RETURNFILETYPE=pdf
54 View faxes through internet browserbull To do that install apache web server
apt-get updateapt-get install apache2
bull Now add a link to your faxes
cd varwwwln -s varspoolhylafaxrecvq fax
bull Now open a broswer and go to httplocalhostfax or by your ip addresshttp10101010fax
bull Enjoy Irsquove been told that this would cost 15000 dollars for consulting firm todo
6 Errorsbull You can find hylafax specific error codes here Hylafax Error Codes
12
61 Failure to receive silencebull Added to configttyS14 failure to receive silence
bull httpwwwhylafaxorgarchive2002-08msg00260php
bull Add this to your configuration configttyS
Class1SwitchingCmd ltdelay7gt
62 T30 T2 timeout expected signal not receivedbull Switching to calls 1 and adding the delay will solve the problem
bull Run the faxaddmodem command again and add the delay
63 Unspecified Phase C error including too much delay betweenTCF and +FDR command
bull Switching to Class 1 solved the problem
64 No Dial Tonebull Adding dial string 9 then pause then number to config file solved the problem
bull See PBX Dial 9 before number section and if you need more details on optionssee httpmemberstripodcommichaelgellismodemhtml
65 No carrier Detectedbull 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 yoursetup See if these are busy signal For some reason busy signal gets labeled asno carrier detected
cat varspoolhylafaxlogxferfaxlog
66 Modem WedgedAfter a month of good work (11000 faxes) suddenly the modem become wedgedBecause USR modem doesnrsquot have the un-wedged option as the Mainpine modemyou have to tell hylafax to try to set it up more then (default)2 times Add this to yourconfigtty
MaxSetupAttempts 10
13
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
faxadduser -p password -u 1001 username
bull To see what users are already in do
cat varspoolhylafaxetchostshfaxd
4 HardwareModem Model
1 US Robotics 56K External Fax modem 5686E (Does not come with cable)(around $100)
2 Amigo AME-CA95 RS232 External V92 DATAFAXTAM Modem or ExternalConexant V92 modem (around $25 or less)-(neweggcom)
Serial Card
1 Startechcom 4 Multi Port Serial PCI Card
2 Startechcom 2 Port Serial PCI Card
41 Done with simple setupDone Everything beyond this point is for setting up multiple incomingoutgoingfax modems
5 Multiple Incoming Fax Lines
51 Multi port Serial PCI card ttySbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull Currently the limit in Debian supported ports is 4 (read on for more then 4 portsupport)
bull So if you have a 2 port serial card you want to add to your pc here is what youdo
bull If you connect more modems or when you buy a serial pci card you will want toknow which ttyS port they are using You can do it by
dmesg |grep tty
8
bull You should see something like
faxserver~ dmesg |grep ttySttyS0 at IO 0x3f8 (irq = 4) is a 16550AttyS14 at IO 0xdf08 (irq = 209) is a 16550AttyS15 at IO 0xdf10 (irq = 209) is a 16550A
bull If you installed another serial pci card (2 port or 4 port) you can see if it wasdetected by typing
lspci -v
This should list something like
000002000 Serial controller NetMos Technology PCI 9835 larrMulti-IO Controller (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART)Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
bull As you can see the IRQ should be the same as the one specified in dmesg
bull Install setserial This program will let you control serial port better
apt-get updateapt-get install setserial
bull Then try
setserial -g devttyS
bull If you donrsquot see a ttyS(ex ttyS14) in dev you will need to create ttyS14 device
ls devttyS
bull So in my case I am missing ttyS14 ttyS15 in dev folder
MAKEDEV ttyS14MAKEDEV ttyS15
9
bull Now run setserial -g devttyS again and you should see your new serial ports
bull Plug in your modems and Run
faxaddmodem
bull Select the new ttyS and you are done setting up multiple fax machines
52 Fax Dispatchbull Fax dispatch is a custom script that one can create for Hylafax to specify non-
standard delivery options (Standard is varspoolhylafaxrecvq)
bull If you want to have multiple fax destination folders for each fax you have (ttyS1ttyS14 ttyS15 etc)
bull Create Fax Dipatch file in etchylafax
touch etchylafaxFaxDispatch
bull Sample Fax Dispatch file might look like this httpwwwinfocoptercomknow-howhylafaxfax-dispatchhtml
bull Copy and past below to your etchylafaxFaxDispatch This will dispatch faxesto different folders based on device
bull Make sure you have created appropriate folders (In this case dept1 dept2 andchange device names to your names
$Id FaxDispatchv 12 20030504 234941 darren Exp larr$
Default FaxDispatch file - routes all inbound faxes to larr
FaxMaster as PDF Consult the faxrcvd(8C) man page for more information
SENDTO=faxMaster by default larremail to FaxMaster
FILETYPE=pdf in PDF larrformat
This excerpt from the man page gives you an idea of whatrsquos larr
possible here
10
You can route by senderrsquos TSIcase $SENDER in 15105261212) SENDTO=sam Samrsquos test larr
rig in Berkeley 14153901212) SENDTO=rasterasd 7L Xerox larr
room used for scanning 5107811212) SENDTO=peeblesmti stuff from larr
homeesac
andor by devicecase $DEVICE in ttyS1) SENDTO=john all faxes larr
received on ttyS1 ttyLT0) SENDTO=maryhome all faxes larr
received on ttyLT0 ttyS2) SENDTO=myemailexamplecom larr
myotheremailexample3com all faxes received larron ttyS1
esac
andor by deviceFOLDER=varspoolhylafaxrecvqFULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) mv $FULLPATH varspoolhylafaxrecvqdept1 larr
all faxes received on ttyS14ttyS15) mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
andor by caller idcase $CIDNUMBER in 435) SENDTO=lee FILETYPE=pdf all faxes larr
from area code 435 5059627777) SENDTO=amy FILETYPE=tif Amy wants larr
faxes in TIFFesac
bull If you would like to print and then move the file you would replace the relevantcode with this below
bull Make sure you install printer first DebianPrinting
bull Size of a page was added here to make sure 11x14 pages are printed properly
andor by deviceFOLDER=varspoolhylafaxrecvq
11
FULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larr
kyocera mv $FULLPATH varspoolhylafaxrecvqdept1 larr all faxes received on ttyS14
ttyS15) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larrkyocera mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
53 FaxNotifybull 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 theyactually sent we need to add FaxNotify to etchylafax
bull Create FaxNotify in etchylafax
bull Inside put
RETURNFILETYPE=pdf
54 View faxes through internet browserbull To do that install apache web server
apt-get updateapt-get install apache2
bull Now add a link to your faxes
cd varwwwln -s varspoolhylafaxrecvq fax
bull Now open a broswer and go to httplocalhostfax or by your ip addresshttp10101010fax
bull Enjoy Irsquove been told that this would cost 15000 dollars for consulting firm todo
6 Errorsbull You can find hylafax specific error codes here Hylafax Error Codes
12
61 Failure to receive silencebull Added to configttyS14 failure to receive silence
bull httpwwwhylafaxorgarchive2002-08msg00260php
bull Add this to your configuration configttyS
Class1SwitchingCmd ltdelay7gt
62 T30 T2 timeout expected signal not receivedbull Switching to calls 1 and adding the delay will solve the problem
bull Run the faxaddmodem command again and add the delay
63 Unspecified Phase C error including too much delay betweenTCF and +FDR command
bull Switching to Class 1 solved the problem
64 No Dial Tonebull Adding dial string 9 then pause then number to config file solved the problem
bull See PBX Dial 9 before number section and if you need more details on optionssee httpmemberstripodcommichaelgellismodemhtml
65 No carrier Detectedbull 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 yoursetup See if these are busy signal For some reason busy signal gets labeled asno carrier detected
cat varspoolhylafaxlogxferfaxlog
66 Modem WedgedAfter a month of good work (11000 faxes) suddenly the modem become wedgedBecause USR modem doesnrsquot have the un-wedged option as the Mainpine modemyou have to tell hylafax to try to set it up more then (default)2 times Add this to yourconfigtty
MaxSetupAttempts 10
13
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
bull You should see something like
faxserver~ dmesg |grep ttySttyS0 at IO 0x3f8 (irq = 4) is a 16550AttyS14 at IO 0xdf08 (irq = 209) is a 16550AttyS15 at IO 0xdf10 (irq = 209) is a 16550A
bull If you installed another serial pci card (2 port or 4 port) you can see if it wasdetected by typing
lspci -v
This should list something like
000002000 Serial controller NetMos Technology PCI 9835 larrMulti-IO Controller (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART)Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
bull As you can see the IRQ should be the same as the one specified in dmesg
bull Install setserial This program will let you control serial port better
apt-get updateapt-get install setserial
bull Then try
setserial -g devttyS
bull If you donrsquot see a ttyS(ex ttyS14) in dev you will need to create ttyS14 device
ls devttyS
bull So in my case I am missing ttyS14 ttyS15 in dev folder
MAKEDEV ttyS14MAKEDEV ttyS15
9
bull Now run setserial -g devttyS again and you should see your new serial ports
bull Plug in your modems and Run
faxaddmodem
bull Select the new ttyS and you are done setting up multiple fax machines
52 Fax Dispatchbull Fax dispatch is a custom script that one can create for Hylafax to specify non-
standard delivery options (Standard is varspoolhylafaxrecvq)
bull If you want to have multiple fax destination folders for each fax you have (ttyS1ttyS14 ttyS15 etc)
bull Create Fax Dipatch file in etchylafax
touch etchylafaxFaxDispatch
bull Sample Fax Dispatch file might look like this httpwwwinfocoptercomknow-howhylafaxfax-dispatchhtml
bull Copy and past below to your etchylafaxFaxDispatch This will dispatch faxesto different folders based on device
bull Make sure you have created appropriate folders (In this case dept1 dept2 andchange device names to your names
$Id FaxDispatchv 12 20030504 234941 darren Exp larr$
Default FaxDispatch file - routes all inbound faxes to larr
FaxMaster as PDF Consult the faxrcvd(8C) man page for more information
SENDTO=faxMaster by default larremail to FaxMaster
FILETYPE=pdf in PDF larrformat
This excerpt from the man page gives you an idea of whatrsquos larr
possible here
10
You can route by senderrsquos TSIcase $SENDER in 15105261212) SENDTO=sam Samrsquos test larr
rig in Berkeley 14153901212) SENDTO=rasterasd 7L Xerox larr
room used for scanning 5107811212) SENDTO=peeblesmti stuff from larr
homeesac
andor by devicecase $DEVICE in ttyS1) SENDTO=john all faxes larr
received on ttyS1 ttyLT0) SENDTO=maryhome all faxes larr
received on ttyLT0 ttyS2) SENDTO=myemailexamplecom larr
myotheremailexample3com all faxes received larron ttyS1
esac
andor by deviceFOLDER=varspoolhylafaxrecvqFULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) mv $FULLPATH varspoolhylafaxrecvqdept1 larr
all faxes received on ttyS14ttyS15) mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
andor by caller idcase $CIDNUMBER in 435) SENDTO=lee FILETYPE=pdf all faxes larr
from area code 435 5059627777) SENDTO=amy FILETYPE=tif Amy wants larr
faxes in TIFFesac
bull If you would like to print and then move the file you would replace the relevantcode with this below
bull Make sure you install printer first DebianPrinting
bull Size of a page was added here to make sure 11x14 pages are printed properly
andor by deviceFOLDER=varspoolhylafaxrecvq
11
FULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larr
kyocera mv $FULLPATH varspoolhylafaxrecvqdept1 larr all faxes received on ttyS14
ttyS15) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larrkyocera mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
53 FaxNotifybull 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 theyactually sent we need to add FaxNotify to etchylafax
bull Create FaxNotify in etchylafax
bull Inside put
RETURNFILETYPE=pdf
54 View faxes through internet browserbull To do that install apache web server
apt-get updateapt-get install apache2
bull Now add a link to your faxes
cd varwwwln -s varspoolhylafaxrecvq fax
bull Now open a broswer and go to httplocalhostfax or by your ip addresshttp10101010fax
bull Enjoy Irsquove been told that this would cost 15000 dollars for consulting firm todo
6 Errorsbull You can find hylafax specific error codes here Hylafax Error Codes
12
61 Failure to receive silencebull Added to configttyS14 failure to receive silence
bull httpwwwhylafaxorgarchive2002-08msg00260php
bull Add this to your configuration configttyS
Class1SwitchingCmd ltdelay7gt
62 T30 T2 timeout expected signal not receivedbull Switching to calls 1 and adding the delay will solve the problem
bull Run the faxaddmodem command again and add the delay
63 Unspecified Phase C error including too much delay betweenTCF and +FDR command
bull Switching to Class 1 solved the problem
64 No Dial Tonebull Adding dial string 9 then pause then number to config file solved the problem
bull See PBX Dial 9 before number section and if you need more details on optionssee httpmemberstripodcommichaelgellismodemhtml
65 No carrier Detectedbull 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 yoursetup See if these are busy signal For some reason busy signal gets labeled asno carrier detected
cat varspoolhylafaxlogxferfaxlog
66 Modem WedgedAfter a month of good work (11000 faxes) suddenly the modem become wedgedBecause USR modem doesnrsquot have the un-wedged option as the Mainpine modemyou have to tell hylafax to try to set it up more then (default)2 times Add this to yourconfigtty
MaxSetupAttempts 10
13
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
bull Now run setserial -g devttyS again and you should see your new serial ports
bull Plug in your modems and Run
faxaddmodem
bull Select the new ttyS and you are done setting up multiple fax machines
52 Fax Dispatchbull Fax dispatch is a custom script that one can create for Hylafax to specify non-
standard delivery options (Standard is varspoolhylafaxrecvq)
bull If you want to have multiple fax destination folders for each fax you have (ttyS1ttyS14 ttyS15 etc)
bull Create Fax Dipatch file in etchylafax
touch etchylafaxFaxDispatch
bull Sample Fax Dispatch file might look like this httpwwwinfocoptercomknow-howhylafaxfax-dispatchhtml
bull Copy and past below to your etchylafaxFaxDispatch This will dispatch faxesto different folders based on device
bull Make sure you have created appropriate folders (In this case dept1 dept2 andchange device names to your names
$Id FaxDispatchv 12 20030504 234941 darren Exp larr$
Default FaxDispatch file - routes all inbound faxes to larr
FaxMaster as PDF Consult the faxrcvd(8C) man page for more information
SENDTO=faxMaster by default larremail to FaxMaster
FILETYPE=pdf in PDF larrformat
This excerpt from the man page gives you an idea of whatrsquos larr
possible here
10
You can route by senderrsquos TSIcase $SENDER in 15105261212) SENDTO=sam Samrsquos test larr
rig in Berkeley 14153901212) SENDTO=rasterasd 7L Xerox larr
room used for scanning 5107811212) SENDTO=peeblesmti stuff from larr
homeesac
andor by devicecase $DEVICE in ttyS1) SENDTO=john all faxes larr
received on ttyS1 ttyLT0) SENDTO=maryhome all faxes larr
received on ttyLT0 ttyS2) SENDTO=myemailexamplecom larr
myotheremailexample3com all faxes received larron ttyS1
esac
andor by deviceFOLDER=varspoolhylafaxrecvqFULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) mv $FULLPATH varspoolhylafaxrecvqdept1 larr
all faxes received on ttyS14ttyS15) mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
andor by caller idcase $CIDNUMBER in 435) SENDTO=lee FILETYPE=pdf all faxes larr
from area code 435 5059627777) SENDTO=amy FILETYPE=tif Amy wants larr
faxes in TIFFesac
bull If you would like to print and then move the file you would replace the relevantcode with this below
bull Make sure you install printer first DebianPrinting
bull Size of a page was added here to make sure 11x14 pages are printed properly
andor by deviceFOLDER=varspoolhylafaxrecvq
11
FULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larr
kyocera mv $FULLPATH varspoolhylafaxrecvqdept1 larr all faxes received on ttyS14
ttyS15) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larrkyocera mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
53 FaxNotifybull 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 theyactually sent we need to add FaxNotify to etchylafax
bull Create FaxNotify in etchylafax
bull Inside put
RETURNFILETYPE=pdf
54 View faxes through internet browserbull To do that install apache web server
apt-get updateapt-get install apache2
bull Now add a link to your faxes
cd varwwwln -s varspoolhylafaxrecvq fax
bull Now open a broswer and go to httplocalhostfax or by your ip addresshttp10101010fax
bull Enjoy Irsquove been told that this would cost 15000 dollars for consulting firm todo
6 Errorsbull You can find hylafax specific error codes here Hylafax Error Codes
12
61 Failure to receive silencebull Added to configttyS14 failure to receive silence
bull httpwwwhylafaxorgarchive2002-08msg00260php
bull Add this to your configuration configttyS
Class1SwitchingCmd ltdelay7gt
62 T30 T2 timeout expected signal not receivedbull Switching to calls 1 and adding the delay will solve the problem
bull Run the faxaddmodem command again and add the delay
63 Unspecified Phase C error including too much delay betweenTCF and +FDR command
bull Switching to Class 1 solved the problem
64 No Dial Tonebull Adding dial string 9 then pause then number to config file solved the problem
bull See PBX Dial 9 before number section and if you need more details on optionssee httpmemberstripodcommichaelgellismodemhtml
65 No carrier Detectedbull 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 yoursetup See if these are busy signal For some reason busy signal gets labeled asno carrier detected
cat varspoolhylafaxlogxferfaxlog
66 Modem WedgedAfter a month of good work (11000 faxes) suddenly the modem become wedgedBecause USR modem doesnrsquot have the un-wedged option as the Mainpine modemyou have to tell hylafax to try to set it up more then (default)2 times Add this to yourconfigtty
MaxSetupAttempts 10
13
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
You can route by senderrsquos TSIcase $SENDER in 15105261212) SENDTO=sam Samrsquos test larr
rig in Berkeley 14153901212) SENDTO=rasterasd 7L Xerox larr
room used for scanning 5107811212) SENDTO=peeblesmti stuff from larr
homeesac
andor by devicecase $DEVICE in ttyS1) SENDTO=john all faxes larr
received on ttyS1 ttyLT0) SENDTO=maryhome all faxes larr
received on ttyLT0 ttyS2) SENDTO=myemailexamplecom larr
myotheremailexample3com all faxes received larron ttyS1
esac
andor by deviceFOLDER=varspoolhylafaxrecvqFULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) mv $FULLPATH varspoolhylafaxrecvqdept1 larr
all faxes received on ttyS14ttyS15) mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
andor by caller idcase $CIDNUMBER in 435) SENDTO=lee FILETYPE=pdf all faxes larr
from area code 435 5059627777) SENDTO=amy FILETYPE=tif Amy wants larr
faxes in TIFFesac
bull If you would like to print and then move the file you would replace the relevantcode with this below
bull Make sure you install printer first DebianPrinting
bull Size of a page was added here to make sure 11x14 pages are printed properly
andor by deviceFOLDER=varspoolhylafaxrecvq
11
FULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larr
kyocera mv $FULLPATH varspoolhylafaxrecvqdept1 larr all faxes received on ttyS14
ttyS15) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larrkyocera mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
53 FaxNotifybull 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 theyactually sent we need to add FaxNotify to etchylafax
bull Create FaxNotify in etchylafax
bull Inside put
RETURNFILETYPE=pdf
54 View faxes through internet browserbull To do that install apache web server
apt-get updateapt-get install apache2
bull Now add a link to your faxes
cd varwwwln -s varspoolhylafaxrecvq fax
bull Now open a broswer and go to httplocalhostfax or by your ip addresshttp10101010fax
bull Enjoy Irsquove been told that this would cost 15000 dollars for consulting firm todo
6 Errorsbull You can find hylafax specific error codes here Hylafax Error Codes
12
61 Failure to receive silencebull Added to configttyS14 failure to receive silence
bull httpwwwhylafaxorgarchive2002-08msg00260php
bull Add this to your configuration configttyS
Class1SwitchingCmd ltdelay7gt
62 T30 T2 timeout expected signal not receivedbull Switching to calls 1 and adding the delay will solve the problem
bull Run the faxaddmodem command again and add the delay
63 Unspecified Phase C error including too much delay betweenTCF and +FDR command
bull Switching to Class 1 solved the problem
64 No Dial Tonebull Adding dial string 9 then pause then number to config file solved the problem
bull See PBX Dial 9 before number section and if you need more details on optionssee httpmemberstripodcommichaelgellismodemhtml
65 No carrier Detectedbull 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 yoursetup See if these are busy signal For some reason busy signal gets labeled asno carrier detected
cat varspoolhylafaxlogxferfaxlog
66 Modem WedgedAfter a month of good work (11000 faxes) suddenly the modem become wedgedBecause USR modem doesnrsquot have the un-wedged option as the Mainpine modemyou have to tell hylafax to try to set it up more then (default)2 times Add this to yourconfigtty
MaxSetupAttempts 10
13
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
FULLPATH=$FOLDER$FILENAMEtifcase $DEVICE inttyS14) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larr
kyocera mv $FULLPATH varspoolhylafaxrecvqdept1 larr all faxes received on ttyS14
ttyS15) usrbintiff2ps -w 85 -h 11 -a $FILE |lpr -P larrkyocera mv $FULLPATH varspoolhylafaxrecvqdept2 larr
all faxes received on ttyS15esac
53 FaxNotifybull 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 theyactually sent we need to add FaxNotify to etchylafax
bull Create FaxNotify in etchylafax
bull Inside put
RETURNFILETYPE=pdf
54 View faxes through internet browserbull To do that install apache web server
apt-get updateapt-get install apache2
bull Now add a link to your faxes
cd varwwwln -s varspoolhylafaxrecvq fax
bull Now open a broswer and go to httplocalhostfax or by your ip addresshttp10101010fax
bull Enjoy Irsquove been told that this would cost 15000 dollars for consulting firm todo
6 Errorsbull You can find hylafax specific error codes here Hylafax Error Codes
12
61 Failure to receive silencebull Added to configttyS14 failure to receive silence
bull httpwwwhylafaxorgarchive2002-08msg00260php
bull Add this to your configuration configttyS
Class1SwitchingCmd ltdelay7gt
62 T30 T2 timeout expected signal not receivedbull Switching to calls 1 and adding the delay will solve the problem
bull Run the faxaddmodem command again and add the delay
63 Unspecified Phase C error including too much delay betweenTCF and +FDR command
bull Switching to Class 1 solved the problem
64 No Dial Tonebull Adding dial string 9 then pause then number to config file solved the problem
bull See PBX Dial 9 before number section and if you need more details on optionssee httpmemberstripodcommichaelgellismodemhtml
65 No carrier Detectedbull 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 yoursetup See if these are busy signal For some reason busy signal gets labeled asno carrier detected
cat varspoolhylafaxlogxferfaxlog
66 Modem WedgedAfter a month of good work (11000 faxes) suddenly the modem become wedgedBecause USR modem doesnrsquot have the un-wedged option as the Mainpine modemyou have to tell hylafax to try to set it up more then (default)2 times Add this to yourconfigtty
MaxSetupAttempts 10
13
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
61 Failure to receive silencebull Added to configttyS14 failure to receive silence
bull httpwwwhylafaxorgarchive2002-08msg00260php
bull Add this to your configuration configttyS
Class1SwitchingCmd ltdelay7gt
62 T30 T2 timeout expected signal not receivedbull Switching to calls 1 and adding the delay will solve the problem
bull Run the faxaddmodem command again and add the delay
63 Unspecified Phase C error including too much delay betweenTCF and +FDR command
bull Switching to Class 1 solved the problem
64 No Dial Tonebull Adding dial string 9 then pause then number to config file solved the problem
bull See PBX Dial 9 before number section and if you need more details on optionssee httpmemberstripodcommichaelgellismodemhtml
65 No carrier Detectedbull 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 yoursetup See if these are busy signal For some reason busy signal gets labeled asno carrier detected
cat varspoolhylafaxlogxferfaxlog
66 Modem WedgedAfter a month of good work (11000 faxes) suddenly the modem become wedgedBecause USR modem doesnrsquot have the un-wedged option as the Mainpine modemyou have to tell hylafax to try to set it up more then (default)2 times Add this to yourconfigtty
MaxSetupAttempts 10
13
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
67 4 ports serial card more then 4 modem supportbull Therersquos really no limit to the number of serial cards Linux can support but
there is a kernel configuration parameter for the number of supported serialports(CONFIG_SERIAL_8250_NR_UARTS)
bull To find out how many serial port your kernel is configured for do
dmesg |grep Serial
bull And look for line like
Serial 825016550 driver $Revision 190 $ 4 ports IRQ larrsharing enabled
bull Shows that the driver is compiled to support only 4 ports
bull I was getting following logs which I will include here for reference
serial8250 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A0008 ttyS2 at IO 0x3e8 (irq = 4) is a 16550A000005040 ttyS0 at IO 0x1010 (irq = 201) is a 16550A000005040 ttyS1 at IO 0x1018 (irq = 201) is a 16550A000005040 ttyS3 at IO 0x1020 (irq = 201) is a 16550A
Couldnrsquot register serial port 000005040 -28
shows that ttyS2 is on the motherboard ttyS0 S1 and S3 larrare
on the 9845 card The driver found the fourth port on the larr9845 card
but couldnrsquot use it because all four ports (ttyS0-ttyS3) were larralready
in use (thatrsquos what the -28 error means)
bull You can list your pci cards by doing the following This will show you all pcicards Look for the one that mentions serial
lspci -v
bull These are mine
14
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
2 port02000 Serial controller NetMos Technology PCI 9835 Multi- larr
IOController (rev 01) (prog-if 02 [16550])
Subsystem LSI Logic Symbios Logic 2S (16C550 UART larr)
Flags medium devsel IRQ 209IO ports at df08 [size=8]IO ports at df10 [size=8]IO ports at df18 [size=8]IO ports at df20 [size=8]IO ports at df28 [size=8]IO ports at df30 [size=16]
4 port02020 Serial controller Unknown device 93109845 (rev 01) larr
(prog-if 02[16550])
Subsystem LSI Logic Symbios Logic Unknown device larr0004
Flags medium devsel IRQ 201IO ports at 1000 [size=8]IO ports at 1008 [size=8]IO ports at 1010 [size=8]IO ports at 1018 [size=8]IO ports at 1020 [size=8]IO ports at 1030 [size=16]
bull Lets add a more serial ports to our system We do it by adding the 8250nr_uarts=16at end of kopt line in the grub menu configuration file
bull Edit bootgrubmenulst and change the following lines by adding the 8250nr_uarts=16at 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 larr
kopt_x_y_z where xyz is kernel version Minor versions can be larr
omitted eg kopt=root=devhda1 ro kopt_2_6_8=root=devhdc1 ro kopt_2_6_8_2_686=root=devhdc2 ro kopt=root=devsda1 ro 8250nr_uarts=16
15
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
bull Then
update-grub
bull Reboot
bull When you log in run the command
setserial -g devttyS
bull This will show you list of all serial ports addresses and corresponding ttyS
bull Mine looks like
faxserverhomelucas setserial -g devttySdevttyS0 UART 16550A Port 0x03f8 IRQ 4devttyS1 UART 16550A Port 0x1010 IRQ 201devttyS10 UART unknown Port 0x0000 IRQ 0devttyS11 UART unknown Port 0x0000 IRQ 0devttyS12 UART unknown Port 0x0000 IRQ 0devttyS13 UART unknown Port 0x0000 IRQ 0devttyS14 UART unknown Port 0x0000 IRQ 0devttyS15 UART unknown Port 0x0000 IRQ 0devttyS2 UART 16550A Port 0x1018 IRQ 201devttyS3 UART 16550A Port 0x1020 IRQ 201devttyS4 UART 16550A Port 0x1010 IRQ 201devttyS5 UART 16550A Port 0x1018 IRQ 201devttyS6 UART 16550A Port 0x1020 IRQ 201devttyS7 UART 16550A Port 0x1028 IRQ 201devttyS8 UART unknown Port 0x0000 IRQ 0devttyS9 UART unknown Port 0x0000 IRQ 0
bull So now from lspci -v I know that first port on my 4 port serial card is 1010 whichis ttyS1 second 1018 is ttyS2etc
bull Its really easy
bull The maximum number of the serial ports you can set the kernel boot to is 16ifyou need more kernel 2624 wil have 32 as upper limitsee Debian Bug 440807
7 Tools
71 Archive Faxesbull If you have a need to archive each fax by date there is a script that does just that
httpwwwhylafaxorgarchive2007-02msg00399php
16
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
bull Download the archivepy file to some folder I use usrlocalbin
bull Edit a cron job
crontab -e
bull Now set up the time it will run The extension it should use And a folder wherethe faxes are
1 0 python usrlocalbinarchivepy varspoolhylafax larrrecvq tif
bull Above line will run the program every day at 0001 am Change the us-rlocalbinarchivepy to where you have downloaded the program Changevarspoolhylafaxrecvq to where your faxes are located Change tif to theextension you are using for storing your faxes
bull If you just need to run it once This command will do
python usrlocalbinarchivepy varspoolhylafaxrecvq tif
72 Send batch faxesbull 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
1773123123413121231234
bull If you need to add 1 in front of the number you could use vim to do it with thiscode press ESC
s^1g
bull This will replace ˆ(beginning of a line) with 1
bull After your file is ready and you have a pdf of what you want to send Issue thiscommand
sendfax -z batchfaxnumberscsv FILE2007NEWSpdf
bull To make only one modem be responsible for sending that job And to enableenough time for it to send we can issue this command which will use ttyS0modem and will expire in 24 hours
sendfax -h ttyS0localhost -n -k rsquonow + 24 hoursrsquo -z larrbatchfaxnumberscsv FILE2007NEWSpdf
17
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
8 Maintenance
81 Restart Hylafax
etcinitdhylafax restart
82 Hylafax status
faxstat
bull Type in the password and you should see a line like this
faxserver~ faxstatPasswordHylaFAX scheduler on localhostlocaldomain RunningModem ttyS15 (17731231234) Running and idleModem ttyS14 (17731231234) Running and idle
83 Remove fax jobbull Remove sent fax from queue Replace jobid with actual number
faxrm jobid
bull Example faxrm 38
bull You could also remove multiple faxes
faxrm 1011 1012 1013
bull If you have more then a 100 faxes to remove Open excelopenoffice calc filecreate a range of 1100 save as csv Open in vim Issue a command sg toremove quotes Issue a command sn g to replace new line with space Addat the beginning faxrm On your server issue a command bash filenamecsv
84 Printer not printingbull If you followed DebianPrinting log into the cups software via the httplocalohost631
and you can resume printing from there or see the status of the printer
18
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
9 Extra
91 usb fax modem
Link that sells the USB modem (sorry itrsquos in greek I couldnrsquo larrt find any other site for it)
httpwwwe-shopgrshow_perphtmlid=PER533709
lsusb recognizes it asBus 001 Device 002 ID 04837554 SGS Thomson Microelectronics larr
56k SoftModemidVendor 0x0483 SGS Thomson MicroelectronicsidProduct 0x7554 56k SoftModem
The driver I used is the rsquoslusbrsquo SmartLink driver (google for larrslmodem-2911-20070813targz)
The modem is installed under devttySL0 I didnrsquot have to larrreconfigure hylafax for it I used the same config file larras before for the PCI softmodem (basically configured as larra generic Class1 modem as in varspoolhylafaxconfig larrclass1)
10 Country Specifc
101 Francebull The only difference is the country code and the prefixe for internationnal
11 Supportbull If you have analog modems connected or would like to setup your
1 home
2 small office
3 medium corporation
bull with
1 server based incomingoutgoing faxes
2 faxing from a computer
3 receive all faxes as images etc
please sent me an email webmasterlucasmanualcom Basic setup over ssh canbe done in around $130 if you have supported hardware and this will include basic
19
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20
support on configuration and running hylafax Other options also exists If you workfor a company I can show your IT department how to setup hylafax in few steps andbring them up to speed in a day so they can install and run the software
Add your comment Curtis Taylor How do I uninstall this package on CentOS 522008-08-26 075142 X[1]
20