Mitel Networks SME server manager







Tested on: V 5.1.2
last modified: September 6, 2002

HylaFAX Email to Fax gateway

In this HOWTO you can find howto setup your SME server as a fax gateway.

Install HylaFAX on Mitel Network SME Server

There allready is a very good site for getting information on howto install hylafax.
Please visit Rick Sulman's site for installing HylaFAX.

If you are looking for all the rpm's, you can check my server at this link.

Setting up SME-Server

Open your server-manager. (I guess this!)

Create a new user account using the one of the following data:

 Account name:faxuser
 First name:fax
 Last name:fax
 E-mail delivery:Deliver e-mail locally
 Forwarding address: 

Create a new virtual domain:

 Domain name:fax
 Brief description:fax
 Content:Primary web site


Changing SME-Server configuration

redirect all mail for .fax domain to faxuser
Next step is to redirect all mail for the domain .fax to the user faxuser. We can do this by creating a custom template file in the apropriate folder.

Create the folder (if not allready exists).
 mkdir -p /etc/e-smith/templates-custom/var/qmail/control/virtualdomains

Create the custom template file
 pico /etc/e-smith/templates-custom/var/qmail/control/virtualdomains/95faxmail

In this 95faxmail file we will enter the virtual domain, and connect it to the faxuser.
The only line in this file will look like this:
 .fax:faxuser

Redirect mail for faxuser to mailfax script.
I don't know exactly why, but qmail seems not to save this message according to the .qmail settings, but to process them as described in the ....users/faxuser/.qmail-default file. Therefore we create a new file that tells qmail to pipe all mail to the (to be created) mailfax script.

In the users home directory /home/e-smith/files/users/faxuser. We create and edit the file named .qmail-default:
 pico /home/e-smith/files/users/faxuser/.qmail-default

Containing only one line
 | /etc/hylafax/etc/mailfax

Set the ownership and rights on .qmail-default to the user only:
 chown faxuser:faxuser /home/e-smith/files/users/faxuser/.qmail-default
 chmod 644 /home/e-smith/files/users/faxuser/.qmail-default

Restart the qmail server.
First we'll have to rebuild the configuration files. Then we can restart qmail.

Rebuild the SME-Server configuration files by executing:
 /sbin/e-smith/signal-event console-save

This can take a while, after that we restart qmail:
 service qmail restart


Adding the mailfax script

We can download the mailfax script from this location, and copy it to the /etc/hylafax/etc folder.

eg: Say it is downloaded to the /tmp folder.
 cp /tmp/mailfax /etc/hylafax/etc/mailfax

Change the ownership and rights for this script:
 chown root:root /etc/hylafax/etc/mailfax
 chmod 755 /etc/hylafax/etc/mailfax


Receiving faxes by email

We can also route all incoming faxes to the faxuser's email box. To do this we must create a new HylaFAX configuration file. It is possible to receive the incoming faxes in one of three formats. (.ps .pdf or .tif)

 pico /var/spool/hylafax/etc/FaxDispatch

This file must contain:
 FILETYPE=pdf;
 SENDTO=faxuser;

Substitute tif or ps for pdf as you desire.
More information on this subject can be found at: HylaFAX Received Fax Delivery HOWTO. This is where I found the information anyway.

Testing

Say what! Are we testing allready? This is great!
Send a mail from your favorite mailing software to the SME-Server. This means that the smtp server in your email software must be set to the SME-Server. Because the email adress we are going to be using will only be known by our server. Then we will send a e-mail with to following recepeint: Name@FaxNumber.fax


 e.g: EwaldVanGemert@0031413247338.fax

+ The name can be any name.
+ The fax number is going to be used for faxing the document.
+ Mail can only be send as a plain text email.
+ Mail can have a postscript attachment, this attachment will also be faxed. (filename.ps)
   So don't expect your html formatted emails to be faxed! Sorry!
+ Please don't use the example fax number!


Your comments

Name or alias
E-mail (or empty)
City, Country
I think this page is:


Naam: ptitjo
Plaats: FRANCE
Datum: Wed Jul 23 18:05:27 2003
Thanx for your great job ! everthing work find at the first time ! (on a sme 5.6) just a little thing to add, a script that convert the email attachment automaticaly to a .ps file, insted of printing to a virtual printer to have a .ps file, for exemple: file.doc (microsft word) --> file.ps file.pdf --> file.ps file.xls (microsft excel) --> file.ps file.jpg --> file.ps if someone have this I want it now !

Naam: tanyu
Plaats: Uzes, France
Datum: Wed Jun 4 16:36:23 2003
Worked perfectly for me. Good work.

Naam: Per Sorensen
E-Mail:hyla@per-s.dk
Plaats: Esbjerg Denmark
Datum: Sat Jan 11 00:13:13 2003
Very good howto! I got it working first time, thats rare! (Maybe it's just me though)

Naam: daley
E-Mail:daley@pathlab.com.my
Plaats: KL, Malaysia
Datum: Tue Dec 17 14:58:18 2002
Hi, i have found the star-support hylafax contrib via http://www.star-support.com/downloads/mitel/contrib/hylafax/install_hylafax.bak, do you know what are the differences between the both setup? Thank you. regards, daley

Naam: Erasmo
E-Mail:e.correia@microasap.com
Plaats: Porto, Portugal
Datum: Wed Aug 21 18:49:57 2002
Hi there, i couldn't find all the rpms to install the hylafax...could you help me out by sending me the links for each rpm file? Thanks, Erasmo Correia


Deze website is ontworpen door Ewald van Gemert. Hosting door van GEE Techniek

Mitel Networks SME Server
Copyright 2002 van GEE Techniek.
Copyright 2002 Mitel Networks Corporation.
All rights reserved.