Faximum Fax Messaging Server (FMS) 2
README Updated 2003-08-30 for 2.0-35 (Linux)
Faximum Software Inc.
If you received this README file as a printed version in your software media kit it may be more current than the version on the media. Please use this version rather than the version on the CD-ROM. The most current copy is always available from http://www.faximum.com/support/readme/fms-2-linux.html.
If you did not order a printed copy of the manuals for this product, you may obtain a PDF (i.e. Adobe Acrobat) version of the manual from the Faximum Software website at http://www.faximum.com/support/manuals
Please visit http://www.faximum.com/status for the latest news on this software release. This web page also contains information on any updates that might be released after this document was written.
This README has been written to be brief and to the point in order to expedite the installation of the Faximum Fax Messaging Server in the most common situations. For more detailed information please see the FMS Reference Manual.
Upgrading from FMS 1
Please note that this version of the FMS software is designed for new installations only. It cannot be installed on top of an existing FMS 1 installation. If you are running FMS 1 then please contact firstname.lastname@example.org for special instructions on upgrading your installation.
Preparing to Install FMS
NOTE: Customers planning to install FMS on the SuSE eMail Server III ought to see the special instructions below.
NOTE: Customers planning to install FMS on SCO Linux or other UnitedLinux distributions will need to obtain an update package from Faximum Software Inc. in order to successfully complete their installation.
NOTE: Faximum Software has noted problems with Red Hat 9 that affect the operation of Faximum FMS and has filed a bug report (#103453) with Red Hat. If you are considering installing Faximum FMS or PLUS on Red Hat 9 please email email@example.com for information on the current status of this bug with RH9 and suggested work-arounds.
Special Preparations for SuSE eMail Server III
FMS uses the X11 font server, when available, to obtain the fonts used to create cover sheets and to convert text to fax format. Unfortunately the SuSE eMail Server III does not ship with any of the scalable fonts needed by FMS. You can remedy this by installing the xfntscl.rpm package. For the convenience of its customers Faximum has made available a copy of this package on its FTP server. To install this package please run the following command on your SuSE system:
rpm -i ftp://ftp.faximum.com/rpms/xfntscl.rpm
If your SuSE system is not directly connected to the Internet (or if the above command fails to download the needed RPM file), then please FTP the file from our server manually and then transfer it to your SuSE machine and type:
rpm -i xfntscl.rpm
Also please note that the default configuration of the Postfix email server that is part of the SuSE eMail Server III causes Postfix to tell our software that it is configured to handle fax email addresses even when it is not so configured. This means that when you get to the point of configuring your email server to accept email addresses (assuming you are configuring your FMS server to send faxes) then you will need to take the special steps outlined below.
Please contact Faximum Technical Support should you have any questions or problems with this.
Supported Email/Network Architectures - Outbound Faxing
It is necessary to understand the architecture of your existing email system since FMS integrates fax with your existing email infrastructure. If you have any questions about this then please consult with your network administrator or with Faximum Software.
If you are planning to use FMS to handle incoming faxes only then skip to the section below and Inbound Faxing.
If your network meets the following criteria then you can follow the instructions in this README to install the software:
If your network meets these two criteria then you can proceed to install FMS confident that it will interoperate with your email infrastructure. If these criteria are not meet then please email the details of your email infrastructure to firstname.lastname@example.org and Faximum's engineers will determine if an alternate FMS configuration can meet your needs. For an outline of how to configure FMS to work with networks that have no local SMTP email server (i.e. that use an external email server) see the next section.
If you wish to test a server to see if it is an SMTP server then run telnet to connect to port 25 on the server in question. Under Linux or UNIX (including Mac OS X) you can merely run "telnet 18.104.22.168 25" (without the quotation marks, where 22.214.171.124 is replaced by the IP address or domain name of the server in question) from a terminal session. Using Microsoft Windows, click on the "Start" button, select the "Run" menu option, and type in "telnet 126.96.36.199 25" (again, without quotation marks).
If you are running an SMTP email server on the system in question then
you will see a response of the form "
If your Linux system fails the above test then please see TechNote 236 (http://www.faximum.com/technotes/236).
Once you have verified that the system on which you plan to install FMS is running an SMTP email server then you ought to test that you can send an email to (say) the root account on the machine. If the FMS machine's domain name is (for example) fms.company.com, try sending email to email@example.com and make sure it arrives. If it does not then there may be a problem with (a) your domain name configuration, (b) your email configuration. In either case this problem will need to be resolved prior to installing FMS since if you cannot get email to this server then there will be no way your faxes can be passed to FMS for delivery.
Supported Email/Network Architectures - Inbound Faxing
To see if the Linux server on which you are planning to install FMS is suitable to deliver received faxes, verify that you can send email from this server to users on your network. On your Linux server run the following:
date | mail firstname.lastname@example.org
where email@example.com is the address of one of your users. If they receive an email message that contains the date and time, then your server's email is probably working fine. If not then you will need to work with your network administrator to get the email on your Linux server working otherwise FMS will be unable to deliver the faxes it receives!
How to Configure FMS to Work with External Email Servers
This section outlines how to approach FMS installations in organisations that use an external email server (such as one located at the organisation's ISP). This section is only relevant if you are planning to use FMS to send faxes and you do not use an email server on your local network to deliver email from your users' email clients. If you are going to use FMS to handle incoming faxes only you may ignore this section.
This discussion is, of necessity, relatively technical and intended for email network administrators. If you are not that person then this information ought to be passed to the appropriate person. If you do not have such a person inhouse, then it is necessary to discuss this matter either with Faximum Software or your reseller.
Faximum Software is committed to making your FMS installation a success and will work with you, your reseller, and your ISP to make it all work. Please do not hesitate to email us any questions (technical or otherwise) that arise during the planning of your FMS installation.
Before we proceed to the heart of the matter it will be useful to define some of the terms we will be using:
When installing FMS in an organisation that utilises an external MTA a key task is to determine how to route email so that messages that are to be delivered by fax are passed to the server running FMS for delivery.
If the organisation's Internet connection is always up and it is possible to send email from the Internet to the FMS MTA then there is no problem whatsoever. The default FMS installation and configuration will work just fine.
If this is not the case then one of two alternate approaches must be taken.
If all of the FMS users are located within the organisation (i.e. there is no need to support nomadic FMS users) then the easiest method is to (a) configure the FMS MTA to relay all non-local email to the external MTA; and (b) configure all of the FMS users' email clients to send all their email to the FMS MTA to process or relay to the external MTA.
Another method that will work if the organisation's ISP supports ETRN is to define another domain name for the FMS MTA (i.e. fax.company.com) and have the FMS MTA poll the External MTA for messages to deliver by fax. This requires that the fax domain be properly set up and the FMS MTA set up for ETRN polling.
In summary, configuring FMS to work with an external email server can be done in a number of ways but may present challenges not present when working with an internal email server. We recommend contacting Faximum Software early in your planning so that appropriate preparations can me made for your successful FMS implementation.
The primary security issue related to email-to-fax gateways such as FMS is preventing unauthorised users from sending faxes through your gateway. Since it is possible (depending on the configuration of your server and phone system) to send long distance (indeed overseas) faxes through an FMS gateway, controlling access to an FMS server is important to prevent unauthorised people from incurring toll charges on your phone lines.
FMS itself performs only the most rudimentary of identity checks for incoming email messages that are to be delivered by fax (i.e. it looks at the From header in the email message). Since it is possible to generate messages with fraudulent headers, this mechanism alone cannot be depended upon to prevent unauthorised use. Therefore it is recommended that your network administrator ensure that it is not possible for an email message from an external unauthorised user to be routed to your (internal) FMS server. If you need further assistance in securing your network please contact Faximum Software (firstname.lastname@example.org) for pointers to useful information on this topic.
Installation and Configuration
Installation from the Faximum Web Server
Installation from the Caldera Solutions Showcase CD
Copy the faximum-4.0-25-linux.tar file from the Caldera Solutions Showcase CD-ROM to a temporary directory on your server and continue with the section Running the Installation Script below.
Installation from Faximum CD-ROM
Running the Installation Script
Configuring the Software
Using the Software
Sending a Fax Without Using the FMS Print Driver
To send a fax using FMS merely compose an email message (in plain, not HTML, format) using any email client and address the message to:
where the name and fax number in the left-hand side of the address is changed to match your intended recipient and the domain name on the right-hand side is the domain name of your FMS server.
Note that the email address that you send the fax from must be associated with a FMS user account otherwise the request will be rejected as coming from an unauthorised user. For more information go to the Configure -- User Accounts section of the Webadmin interface, select a user, and check that the From email field matches the one you are using to originate the message.
Sending a Fax Using the FMS Print Driver for Windows
If all you need to fax are text messages then the instructions above ought to suffice. If, on the otherhand, you want to be able to fax from your Windows applications (i.e. Microsoft Word) then you will need to use the FMS Print Driver for Windows. You can download the FMS Print Driver from the webadmin interface.
Receiving a Fax
If you have enabled the fax line for receiving then you can test this facility by sending a fax to the fax modem and then checking to see if it has arrived by point your browser at http://your.server.name:7437/ (where your.server.name is replaced with the domain name of your FMS server) and select the Route -- Received Faxes link.
Integrating Faximum with your Application
The use of Faximum's APIs and issues related to the integration of Faximum with your application are beyond the scope of this document and product. Please contact email@example.com with information on your needs and we can determine how they might be best addressed.
Removing the Software
To remove the the server software follow these steps:
Resolving Problems and Contacting Technical Support
Should you experience any problems with this software, please visit our Technical Support web page at: http://www.faximum.com/support. This page provides access to our library of TechNotes that describe solutions to common problems.
Please also visit the page: http://www.faximum.com/status which contains updated information on bugs and fixes available for this release (i.e. your problem may be the result of a bug that has already been reported to Faximum).
If you are still unable to resolve your problem after following those steps, please contact the company that supplied you with this software.
If your vendor is unable to assist, please contact Faximum Technical Support by fax at (604) 926-8182, by email to support@Faximum.COM or by phone at (604) 922-7311.
Please read http://www.faximum.com/support/policy for detailed information on the options available for purchasing technical support.
Note that if you are contacting Faximum Technical Support with a question we need the following information:
It can also help Faximum Technical Support if you also send us a diagnostic snapshot of your installation. You can create this and email it to Faximum by running the following command on your FMS server:
If your FMS server is behind a firewall that prevents it from sending email directly to Faximum, then please email the diagnostic output to one of your users who can then forward it to firstname.lastname@example.org. You can do this by running: