HylaFSP FAQ

As of version 4.0, HylaFSP has been split into Workstation and Server versions. A workstation license supports Windows 2000, 2003, XP, Vista Business & Ultimate. The server license supports Windows 2000 and 2003 Server. Windows 7 and 2008 Server coming soon

* Windows Vista Home Basic and Home Premium do not support fax services and are not compatible with HylaFSP.

After upgrading your HylaFAX server you can no longer send faxes via HylaFSP. Looking in the debug log shows that the password is not being accepted. The issues stems from a change that was made to HylaFAX as of version 4.2.1. Due to security concerns the format of hosts.hfaxd has changed somewhat. For example, in order to specify a range of IPs you should now use the following notation:

.*@10\.0\.10\.*

This example would allow passwordless based access from the 10.0.10.* class c subnet. More information on the change can be found in the hosts.hfaxd man page.

Yes. Please see: http://www.slipstick.com/addins/services/winxpfax.htm#better

Internet Explorer 7 introduced a problem with HylaFSP's online registration. This issue was resolved in version 3.0.5 of HylaFSP. All users are recommended to upgrade to the latest version of HylaFSP in order to fix this problem.

The error message you are receiving indicates that user under which Microsoft Fax Services is running does not have the appropriate privileges. The account, by default NetworkService, will require access to FAX_JOB_QUERY.

You can view the access rights for the fax component by opening: start menu/control panels/Administrative Tools/Computer Management

Then, expand "Services and Applications" and select "Fax"

Right click on "Fax" and select properties. Choose the Security tab.

Click the Advanced button and select the "SERVICE" group, then choose edit.

You will see a list of the possible permissions. The one needed is "view fax jobs." However, for testing can you give "SERVICE" access to all the permissions.

Please then open the HylaFSP control panel and go to the server tab. Enter in a path to a log file to generate. (for example: c:\hylafsp.log) Restart fax services and try to send a fax. If it fails then refer to the log file for additional information.

The default permissions of Windows 2000 only permit faxing by Administrators. You can allow the Users group to fax by changing the permissions on the fax directory. Please see the following Microsoft Knowledgebase article for instructions:

http://support.microsoft.com/default.aspx?scid=kb;en-us;248427

Editing cover pages in Windows 2000:

1. Open the \Documents and Settings\All Users\Documents\My Faxes\Common Cover Pages folder.
2. Double-click any cover page to open it in the Fax Cover Page Editor.

Creating new cover pages in Windows 2000:

• Make a copy of an existing cover page, open and edit it as above.

  OR

• Open any existing cover page, then choose File | New from the Fax Cover Page Editor's menu.

When running Windows 2000 the fax wizard does not have access to the Outlook Address Book. The Windows Address Book (Outlook Express) is fully supported by HylaFSP and the Microsoft Fax Wizard. Please see the following Microsoft Knowledgebase article for more information:

OL2002 Contacts Are Not Available in the Send Fax Wizard for Windows 2000 Fax

Although not supported by Microsoft it may be possible to configure Windows 2000 to use the Outlook Address Book. Please contact your iFAX Solutions representative for more information.

HylaFSP is licensed on a per-workstation basis; when you purchase a copy online it is for one workstation only. If you are changing PCs, please contact This email address is being protected from spam bots, you need Javascript enabled to view it for more information. Otherwise we ask that you purchase additional licenses as needed.

Internet Explorer 7 introduced a problem with HylaFSP's online registration. This issue was resolved in version 3.0.5 of HylaFSP. All users are recommended to upgrade to the latest version of HylaFSP in order to fix this problem.

HylaFSP will work with all modern versions of HylaFAX Open Source and Enterprise Editions.

HylaFSP uses passive FTP to communicate with the HylaFAX server. A control channel is established on port 4559 and then a data channel is opened on a random passive FTP port. Therefore, your firewall must understand passive FTP on port 4559.

If you are using iptables as your firewall, the following command will configure the firewall for passive FTP on the correct ports for standard FTP and HylaFSP.

Please run as root: modprobe ip_conntrack_ftp ports=21,4559

Even though you may check off 'Use dialing rules' in the Fax Wizard they may not be used. According to Microsoft, the dialing rules are only invoked if a phone number is in the following canonical format: +1 (215) 825-8700. Please see the following Microsoft Knowledgebase article for more information:

http://support.microsoft.com/kb/318575/EN-US/

* Instead of using MS dialing rules you can always 1) Enter the fax number exactly as you want it dialed, or 2) Modify the dialstring manipulation on the HylaFAX server.

HylaFSP and HylaFAX are able to accept a username that contains a space, such as John Doe. Versions prior to 2.0.7 required a workaround. In order for the username to be accepted properly you must enclose the full name within quotes when entering it in the HylaFSP control panel. If you enter John Doe (no quotes) within the control panel you will receive an error, however if you enter "John Doe" (with quotes) the fax will send correctly.

The recommended solution to users experiencing this problem is to upgrade to HylaFSP 2.0.7 or later.

Some old versions of HylaFAX do not allow the sender to specify a tagline. In the HylaFSP control panel turn on Debug logging and attempt to send a fax. A logfile will be written in c:\Windows\System32\HylaFSP_[version].log. If you find an entry in this logfile similar to the following you have encountered this problem.

SendFTPCommand JPARM USETAGLINE YES
SendFTPCommand reply: 503 Permission denied: no write access to job parameter USETAGLINE.

The recommended solution for this issue is to upgrade your HylaFAX server to the most recent version. If that is not possible you will be able to send faxes by changing your tagline settings in the HylaFSP control panel to use the server's tagline.

Yes, HylaFSP supports faxing to Outlook 2003 contacts and distribution lists.

Here is a sample VB script to programatically send faxes:

Sub CheckError(strDetails) Dim strErr If Err.Number <> 0 then strErr = strDetails & " : Exception " & Err.Description & " err.Number=0x" & Hex(Err.Number) WScript.Echo strErr WScript.Quit(Err.Number) End If End Sub ON ERROR RESUME NEXT

'For Windows XP

Set FaxServer = WScript.CreateObject("FAXCOMEX.FaxServer") CheckError("WScript.CreateObject(FAXCOMEX.FaxServer)") WScript.Echo "FaxServer created"

'Connect to the fax server. Specify computer name if the server is remote. See How to connect to a remote Fax Service for details.

FaxServer.Connect "" CheckError("FaxServer.Connect") Set FaxDoc = WScript.CreateObject("FAXCOMEX.FaxDocument") CheckError("WScript.CreateObject(FAXCOMEX.FaxDocument)")

'Set file name of any printable document.

FaxDoc.Body = "test.rtf" CheckError("FaxDoc.Body") FaxDoc.DocumentName = "My First Fax" CheckError("FaxDoc.DocumentName") FaxDoc.Recipients.Add ("12225550100") CheckError("FaxDoc.Recipients.Add")

'Set the sender properties.

FaxDoc.Sender.Name = "Bob" FaxDoc.Sender.FaxNumber = "7777777" CheckError("FaxDoc.Sender.FaxNumber")

'Submit the document to the connected fax server and get back the job ID.

JobID = FaxDoc.ConnectedSubmit(FaxServer) CheckError("FaxDoc.ConnectedSubmit") WScript.Echo "FaxDoc.ConnectedSubmit success"

'For Windows 2000

Set FaxServer = WScript.CreateObject("FaxServer.FaxServer") CheckError("WScript.CreateObject(FaxServer.FaxServer)") WScript.Echo "FaxServer created"

'Connect to the fax server.

FaxServer.Connect "\\" & "Computer Name" CheckError("FaxServer.Connect") Set FaxDoc = FaxServer.CreateDocument("test.rtf") CheckError("FaxServer.CreateDocument") FaxDoc.FaxNumber = "12225550100" FaxDoc.Send CheckError("FaxDoc.Send") WScript.Echo "FaxDoc.Send success"

For more information on sending faxes with Microsoft's Platform SDK please see: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/fax/fax/faxusing_3ee7.asp

This issue can occur if the system drive is formatted using NTFS and the "Users" group does not have the proper permissions. Please see the following Microsoft Knowledgebase article for the resolution: http://support.microsoft.com/default.aspx?scid=kb;en-us;248427

• IP address the HylaFAX host IP address
• Port the HylaFAX port (4559 by default)
• User Name user name for HylaFAX
• Password the HylaFAX users password. This field might not be required in a particular HylaFAX configuration, check with your HylaFAX administrator
• Max Tries maximum number of times the HylaFAX will try to deliver your fax
• Max Dials maximum number of times the HylaFAX will dial the destination number
• Billing Code billing code for HylaFAX
• Priority the HylaFAX priority
• Taglines specify whether to be generated by Windows Fax Service or by HylaFAX (the HylaFAX option is recommended). Only one check box must be selected
• E-mail address an e-mail address to send fax delivery notifications (this field is compulsory)
• Notification options radio buttons to select conditions for sending notifications, - on failure only; on delivery and / or on failure; on retries, delivery and / or failure.
• Debug select this check box when you need to troubleshoot a problem with HylaFSP. A HylaFSP log file will be created in your C: directory.

The two most common reasons are:

1. Your HylaFSP control panel is not properly configured. Please check that the server address, port and username/password (if required) are correct.

2. The HylaFAX server is not set up to accept incoming client requests. Please see the following page for more information: http://www.hylafax.org/howto/using.html#ss3.3

Yes, you can do a Fax Merge from Microsoft Outlook and Word. Please see the following Microsoft Knowledgebase article for detailed instructions:

http://support.microsoft.com/default.aspx?scid=kb;en-us;289532

Yes. As of version 3.0, HylaFSP supports Windows Terminal Services.

Yes, since HylaFSP integrates with Microsoft's Fax Service you are able to use its built-in coverpage editor. Both Windows 2000 and XP included the ability to create and manage coverpages.

HylaFSP integrates with your existing Windows address book. By default that is the Windows Address Book (WAB) which is used by Oulook Express. If you have installed Microsoft Outlook your system will use the Oulook Address Book (OAB) instead.

This error may occur when using HylaFSP to connect to an older version of HylaFAX.

The recommended solution is to upgrade your HylaFAX server to version 4.2.0 or later.

For more information and a possible workaround see below:

HylaFSP generates fax-optimised 2D-MMR tiff files for maximum compression. HylaFAX may need to convert the TIFF to MR or MH format if your modems (or the receiving fax machines) do not support 2DMMR.

The exit status 9 error you see during the conversion process is due to a known bug in libtiff that can occur when trying to carry out this conversion. See: http://www.hylafax.org/archive/2003-02/msg00181.html

You can either downgrade to libtiff-3.5.5, upgrade to libtiff-3.6.x (nor presently recommended because of MMR problems with libtiff), or apply the following patch to your current HylaFAX version: http://bugs.hylafax.org/bugzilla/show_bug.cgi?id=341

By far the best solution though is to upgrade to the latest release of HylaFAX which includes this patch already.

Libtiff version 3.6.1 on RHEL4/CentOS4 has been known to cause this because of a problem in the 'tiffcp' utility. The recommended solution is to upgrade libtiff, and that can be done by following the procedure below:

- Download the new libtiff Source RPM (.src.rpm) for your distribution (ie: from RHEL5/CentOS5)
- Build the new RPM package using "rpmbuild --rebuild" and the libtiff .src.rpm
- Upgrade libtiff by running "rpm -Uvh" with your newly built libtiff RPM

Keep in mind that you're upgrading a system library and if other software on the server depends on the older version of libtiff, you may experience incompatibility problems.

HylaFSP-specific support is available by contacting iFAX Solutions .