Our VoIP phone system software comes with a fully integrated fax server as standard. The included fax server is HylaFax (http://www.hylafax.org/ “pascom Integrated HylaFax Server”), which is connected to the Asterisk telephony server via virtual IAX modems.
The integrated fax server offers a number of functions, which are described in this how-to:
Before the fax server can be used, a few settings need to be adjusted. This can be done in the menu
Appliance > Services > Fax server. It is important to configure a reasonable number of fax lines, which defines the number of virtual modems and thus the number of parallel faxes that can be sent and received. In practice, four modems is a reasonable setting to use.
After saving the configuration of the fax server, it still must be applied so the operating system becomes aware of the changes.
In order to use the e-mail gateway, sending and receiving e-mails must work properly. To check the corresponding settings that regulate e-mail services of the telephony appliance, go to
Appliance > Services > E-mail Server and enter the mail server and domain name that should be used in the forwarding process. When finished, the changes to the network configuration need to be applied.
More information can be found in the chapter Configuring the Network.
Since version 6.07.00, it is possible to display and also download the list of received and sent faxes in the web interface. The lists can be found in the menu
Information > Fax server.
All sent and received faxes, together with log files, are stored by the fax server in various directories in /var/spool/hylafax. To maintain a consistent performance level and to save space on the file system, a cronjob will delete those files once a week. The default setting of the appliance is to keep the documents for 30 days.
This duration can be adjusted at any time in the menu
Appliance > Cronjobs by editing the job “Clean up fax server”. The fax server can be maintained manually as well. This can be done in the menu
Apply > Clean up fax server.
Next, the user’s personal fax device must be set up. The extension number and e-mail forwarding must be configured. Different steps must be taken depending on whether the fax machine is intended for personal use by an individual or for shared use by a group of employees. All screens only require three values to create a fax device:
After creating the fax machines, apply the telephony settings to enable the changes with the operating system.
On the server, however, several changes need to be made before it can be used as an E-mail-to-fax gateway. The telephony’s E-mail system must be working. Your company’s E-mail server must be configured in a way so that e-mail from your clients can be sent to the fax server. The configuration must also be set up to ensure that E-mails sent to the domain “*.fax” are forwarded via SMTP to your telephony server. Depending on the E-mail being used, the steps necessary can differ
To send a fax after the configuration is done, simply send an E-mail using the following structure:
|Tofirstname.lastname@example.org||The number is evaluated and the part to the left of the “@” sign is used as the recipient on the cover page of a fax. (the default is to disable cover pages for fax).|
|Subject and body||Converted to PostScript and used as the first page of the fax.|
|Attachment||The actual fax as PDF or TIF file.|
In this version, the gateway’s behaviour can in part only be changed by changing the configuration files. This requires logging in to pascom using SSH and having root user permissions.
The default setting is to send out a plain-text e-mail whenever there is a change in a fax job (busy, failed, successful, etc.). This setting can be changed to use an alternative format. With the alternative format, an HTML E-mail will be used that has the first page of the fax embedded. The fax itself will be sent as an attachment in PDF format. This format is the same as the one used when a fax is received by a virtual fax machine configured to use the format=“inlinegif” option.
changes made to the format of notification e-mails will also affect the format of print-to-fax jobs.
If you would like to change the address format to email@example.com, follow these steps below:
First, use the system settings in the web interface to modify the sys.fax.configure.faxmail.matcher.fax entry. Use this value with the above example:
Apply this modification by clicking
Apply > Network services.
as mentioned above, the default address format is firstname.lastname@example.org. The format can be changed by editing the /etc/exim4/exim4.conf.mdc file.
fax: driver = manualroute transport = fax route_list ="\*.fax"
To change the address format to the example email@example.com, the following modification is necessary:
route_list = "mydomain.de"
To complete the changes, the file /etc/exim4/update-exim4.conf.conf needs to be edited:
Finally you need to uncheck the “EMail-Server” option under Basic Configurations > Network, otherwise the customized files will be overwritten.
It is possible to use the setting sys.fax.configure.faxmail.mode to specify which parts of an e-mail are sent when it is converted to a fax:
The directory /var/spool/hylafax/mimetype holds the scripts for the conversion process. The scripts will take an e-mail and split it into its individual parts, depending on the MIME type, and then convert the e-mail to a fax message. If there is a MIME type for which no script exists, the corresponding part in the e-mail is simply ignored and will not be included as part of the fax message. Below is a list of all scripts:
|application/pdf||converts a PDF attachment to a fax message|
|image/tiff||converts a TIF or TIFF attachment to a fax message|
|text/plain||converts a plain-text e-mail message body to a fax message|
|text/html||converts an HTML e-mail message body to a fax message|
The following steps are needed to make an Exchange Server forward all *.fax e-mails to pascom:
The print-to-fax gateway can be used to automatically send documents from ERP systems; documents can also be sent manually using the desktop client.
For system versions 6.12.01 or above, the system setting sys.fax.configure.faxprint.mode controls the gateway’s operating mode:
|1||Do not search for control fields and directly pass the job to the client.||For new installations from version 6.12.01 or newer|
|2||Control fields for automatic dispatch are looked up. By errors this process will be stopped.|
|3||Firstly the control fields will be searched. If none are found, the order will be sent to the client.||Appliances before version 6.12.01|
If automatic mode with control fields is not needed, mode 1 is recommended for performance reasons. Using this mode, the document does not have to be split and searched.
To enable the fax system to extract the destination number and other information from the print job, the document to be sent via fax must contain control fields. As those fields are usually not transmitted to the recipient, they can also be coloured in white.
The fax system can use the following expressions:
|@@+FAX:0991….@@||The recipient’s fax number. This is the only mandatory field!|
|@@+TAG:Bestellung 12345@@||Individual job description, displayed in lists and notifications.|
|@@+PRIO:100@@||Job priority (0-255). Jobs with a lower number are dispatched before others. Default priority is 200. Priorities that you should use in relation to time-consuming, large-volume batch jobs, will usually be assigned a priority of 250, otherwise all manually started jobs would have to wait for the batch job to finish.|
The notify control field accepts an e-mail address where all status reports concerning a certain fax job can be sent to. If the notify field is not present, there are two options:
The type of notification and other settings can be adjusted using the system settings at sys.fax.configure. The faxprint. sys.fax.configure.faxprint.notify key controls the type of notification used. The values accepted for this key are “faxmaster” or “user”.
Before the system can evaluate the control fields, the print job must be converted to text format. Depending on the complexity of the print job, the fonts being used and the type of printer driver, complications can arise.
Please bear in mind the following:
Some details on the print job can be viewed in the log file /var/log/mobydick/sendfax.log.
To facilitate the migration from another fax system, a number of settings of the gateway can be adjusted.
All values in the table below are saved in the system settings. Most values only need be added to the system settings only when they are needed.
|Regular expression matching the fax number in the document. The first pair of brackets indicates the position of the number.||/@@+FAX:
|Regular expression matching the user-specified job name in the document. The first pair of brackets indicates the position of the corresponding field.||/@@+TAG:
|Regular expression matching the priority in the document. The first pair of brackets indicates the position of the priority number||/@@+PRIO:
|Regular expression matching the E-mail address in the document. The first pair of brackets indicates the position of the address.||/@@+NOTIFY:
|Default priority for fax jobs if no priority is specified in the document.||200|
|Number of tries to fax the document.||3|
|If no e-mail address is specified in the job, the “faxmaster” and “user” values specify who is to be contacted when there are changes in a job.||faxmaster||user|
|If the usernames on the desktop workstations or in the print system differ from the user names on the telephony appliance, a regular expression can be specified for the selection of a user name.||(empty)||/^(\w+)..*/|
|Specifies the value used to replace the original user name. The “search” and “replace” values must be specified. In the example, the Windows user name is truncated at the first point.||(empty)||$1|
This is another platform-independent way of sending faxes. However, virtual printers need to be configured for each computer that uses this method. Please refer to the setup guides for your operating system as found below. For larger system environments, the printer can be connected to the individual computers using ActiveDirectory. Apart from single fax jobs, the print-to-fax gateway can be connected to an ERP system and be used to automatically send out newsletters etc.