FaxChange news Content User documentation Administrator documentation Index of terms Technical Support Search on-line

FaxChange Installation

This document describes installation of FaxChange Server. Read following document first, please: Before installation.

You can install all basic and add-on Faxchange components from the installation CD.
All components can be installed by runnig program autorun.exe from root of installation CD. If your CD drive supports Autorun feature, setup will run automatically. Select Faxchange from the UMS products and now you can select what component you want to install.

Electronic documentation can be found on the CD in file faxchange\doc\uk\index.html


Preparation before installation
Installation options
Custom installation
Advanced - distributed installation
Correctness of installation
Installation of clients

What you should know and prepare before installation

You should know the following data before installing the FaxChange:

Next it is necessary to do the preparation work:

At this point you have finished preparation work and now you can start the installation.

back to top of page


Installation options

When you start the installation you can select one of three valid options:

The following table shows a general overview of the installation types:

Installation type Destination directory Database type Note
Express Automatic MS Access  
Custom Custom Supported MS Access, MS SQL or Oracle SQL server (if ODBC drivers are installed and module is licensed) Exchange directory structure can be used
Advanced Custom Supported MS Access, MS SQL or Oracle SQL server (if ODBC drivers are installed and module is licensed) Allows to distribute installation to several servers and to use Exchange directory structure

If you want to add another gateway into existing installation, use _gateway.cmd script from setup folder.

back to top of page


Custom installation

The whole installation is controlled by wizard which asks for certain informations and controls installation according answers. When you run setup (by autorun or by faxchange\i386\server\setup\setup.exe program) some supporting files will be copied to the harddisc first. Restart can be required - in such case restart your server and run setup again.
Then first dialog of the wizard will be displayed.

Here you can read license agreement - you must agree to be able to continue.
Second dialog allows you to read installation documentation from the CD; we recommend to see also online Faxchange web.
 

Then enter key for the Faxchange activation. The key consists of four groups of letters and numbers and it contains coded FaxChange version, number of users, eventual time limit and available components. Enter the key into the "Key" field and press the Use button. If you used a correct key type it will be displayed in the "Current status of Faxchange" field.

If you encounter a message "The key is invalid", check if you haven't interchanged similar characters, as "l" and "1", "o" and "0" and so on.
 

In the following window select installation type - see table above. In the next part we assume you have selected custom installation and we notice for differences from express installation.
 

Now select installation folder for Faxchange (this dialog is missing in express installation, where is automatically selected "Faxchange" folder on the system drive).

ATTENTION! Folder name must not contain space, otherwise Faxchange will not work correctly.
 

Proceed to the next screen. Enter service account and password here under which FaxChange operates. This account must be member of Administrators group and it must also have the administration's authority on Exchange server. We usually use the same account under which Exchange server works. Account can be specified as local in <servername\account_name> form or as domain in the <domain\account_name> form. Because Exchange gateway must always run under domain account (when using the SQL database also faxserver) we recommend always to use domain service account. You should keep this in mind, especially when you are installing the FaxChange on the standalone server. If you enter wrong password the installation program will warn you.


 

If your key contains more gateways, you must select one of them to be installed on the next dialog.

If you have selected gateway different from Exchange, read information about your gateway:


 

This block is related to installation with Exchange Server


After the selection of Exchange gateway, you may be advised of detected version OS Win 2003 SBS. In such case, the service "Microsoft Exchange MTA Stacks" will be enabled automatically and registry entries will be performed. Restart is required after successful installation. Next ->

After Exchange gateway selection setup asks for Exchange server version - Exchange 2003 or 2000. If you select incorrect version, Faxchange setup fails!

TIP: If Exchange is installed in Cluster environment (and Faxchange runs on different PC), install Faxchange normally - nothing changes from Faxchange's viewpoint. As Exchange server name enter "common" logical cluster name, not physical name of one of cluster nodes.


 

In the next step, you must run the Exchange (or Outlook) client with the fax administrator profile. The administrator's mailbox must be of course on the Exchange server into which you are installing FaxChange. The administrator must also be authorized to install forms - see chapter about preparation before installation for details. Leave client running for the rest of installation.

In case that message
"A recently installed program may cause Microsoft Office or other e-mail-enabled programs to function improperly. Outlook can resolve this conflict without affecting the program that originally caused the problem. Do you want Outlook to resolve this problem?"
or similar appears when Outlook is started, it is necessary to press No for reliable work of both Exchange and Faxchange administrative tools. If you press Yes, then mapi32.dll library in %SystemRoot%\system32 folder will be overwritten. For correct work you must replace this file by version from "\Program Files\Exchsrvr\bin" folder.
 

Proceed to the next screen - enter fax administrator's name (or better alias - part of the SMTP address before @ symbol) and press the Use name button. Exchange address of administrator will appear in "Exchange address" field.

If exchange address returns reference to wrong server, wrong user etc. you have set fax administrator's profile incorrectly.
If name is not unambiguous mail client shows list of possible users and you must select one of them as fax administrator.


 

If there is more than one administrative group in your Exchange organization, select in which administrative group Faxchange will be installed.

The same is valid for routing groups - if there is more than one in your organization, you must select into which routing group Faxchange will be installed. Also you must select server for Faxchange installation, if more than one is located in administrative / routing group.
 

Last Exchange gateway parameter is name of Exchange server - it is necessary only if Exchange runs on different server than you are installing Faxchange. Express installation doesn't ask for this - it assumes Exchange runs on server where installation takes place.


 

In the next dialog select database type used by Faxchange. This is not possible in express installation - it selects MS Access automaticaly. List of available databases depends on activation key and installed database drivers.

When you are using MS Access database you don't need provide any configuration data and setup continues by entering local information.

Configuration of Oracle SQL is described in this document.
 

When setting up MS SQL database you need provide following data:


 

On the next screen enter information about your country - name of the country, international dial code (without + sign or initial zeros), national dial code of your city (without initial zero, empty in CR), language used here and how to work with phone numbers: if "Don't distinguish local and intercity calls" is checked, there are no intercity dial codes and prefixes and numbers are dialed always in full form. If not checked, numbers are dialed with consideration of intercity dial codes and prefixes.

Default setting is for Czech Republic - empty national dial code and no distinguish between local and intercity calls.

More about dial configuration read here.
 

Fax hardware selection follows. At this time are supported ISDN (CAPI), Brooktrout and Gammalink cards and Class 1/ 2/2.0 modems. If you have different card choose installation without fax driver and install driver later (from diskette for example).

Online list of approved card can be found at Faxchange web.
 

Next dialogs are dependent on the used fax card. All card installation will be described.
You can use more driver types - i.e. Brooktrout card + Gammalink card; Brooktrour card + modem etc. These combinations however weren't tested, so we can not guarantee non problematic working. If you need more lines we recommend to use more cards of the same type (i.e. two Brooktrout cards in one server).

When Brooktrout card is selected, Brooktrout System Software is checked and if not found, its installation is started. Then config tool is run to detect your card and create configuration files for FaxChange.
Next you need these config informations:

  • CSID - ID for sent faxes. Usually phone number to which card is connected to.
  • Outside line prefix - number to be dialed for access public phone network
  • Dial type - usually tone, older PBXs can use pulse dialing
  • Line type - PBX or trunk
  • Hardware settings - number of fax cards, IRQ, DMA. If you have PCI card check "Only PCI cards in the computer" - PCI bus itself assigns IRQ and DMA (PCI card doesn't have jumpers for IRQ and DMA)

IRQ and DMA settings must not have conflict with other hardware - cards must be switched correctly according the manufacturer's documentation.

After you press the Next--> button you will be asked to enter I/O address, number of telephone channels (producer supplies cards with two to thirty channels) and card type for particular card. You will enter these settings for every installed card separately.

If you use ISDN BRI Brooktrout card then number of channels means number of used B-channels. One BRI ISDN line has two B-channels.

For using ISDN PRI line read this document.

Warning - you can not combine TR114 and TRUfax cards. More informations here


In case of using modem first enter the number of modems - maximum supported number is 98. WARNING - because FaxChange uses its own drivers you cannot install modems used for faxing through the Control Panel - Modems!


  Modem setup informations are following:

  • CSID - fax ID. Typically it's telephone number in international format to which modem is connected to. But it can be also string of capital letters without diacritic marks. This ID is pasted into the fax header and fax can be routed to particular recipient based on this ID
  • Port - designation of serial port to which modem is physically connected
  • Dial - type of dialing, either pulse (old PBXs with step diallers) or tone (digital PBXs)
  • Line type - it affects dialing and engage tones detection. Public (trunk) lines usually don't generate dialing tone but PBX lines usually do
  • Outside line prefix - number that must be dialed to connect telephone network outside the enterprise ("outside the exchange")

Complete this dialog box for each modem separately. That means how many modems you entered it is how many times this dialog box will be displayed; enter configuration for each modem.


If you are using Gammalink cards, you need only enter CSID, dial type and outside line prefix . Other settings are discovered automatically by autodetect routine.


For CAPI ISDN card you must set CSID and prefix for dialing out of your PBX.

We don't recommend to use more CAPI cards from different producers - see more info here.


 

This block is related to installation with Exchange

In case of using Lotus Notes or SMTP gateway continue by registation and file copying.

If you are installing Exchange 2000 or higher gateway you can select where to store list of users - in the external database selected earlier during setup or directly in Active Directory. It allows to set fax properties of the user directly from Active Directory Users and Computers.

Warning: Installation on Exchange 2000/2003 with Active Directory integration must be done under administrative account, which is member of Schema Admins group!

If you select "FaxChange database", you must use FX User manager tool to configure rights and groups in Faxchange and perform manual synchronization to keep database current. If you select "Active directory", a new tab in "AD Users and Computers" tool appears in every user's property pages, where you can configure its Faxchange settings (of course you can still manage users using FX User manager).

To add this tab, Active Directory schema needs to be modified. If Faxchange is installed on PC, which is PDC and Exchange server runs here, installer itself enables AD modification. But if PDC and/or Exchange runs on different computer, it is necessary to import support/AD/ADenable.reg file from installation CD on both PDC and Exchange server (by doubleclick).

Next you can select Active Directory containers, from which users will be visible for Faxchange (i.e. you can enable them to fax). Set checkboxes for containers you want to be known for Faxchange. By default Faxchange "can see" all users in AD, what can lead to problems in big organizations with more branches (long reading of user list, not all users should be enabled to fax etc.).
You can set or change list of "enabled" containers after installation in the registry, see here.

Selection of directory database isn't available in express installation.

In case of installing gateway different from Exchange other dialogs will be displayed - see appropriate link:

When you finish entering fax configuration you can register your Faxchange and copying of files to the harddisk is started. Required binary files, libraries and documentation will be copied. Then database is created and FaxChange components are installed. Name of the component being installed is displayed in the caption of installation program window.

If you are installing Faxchange on Windows 2003, dialog with sequence of enabling kernel-mode driver installation for fax conversion printer appears. Perform these steps:

  1. Select Start menu -> Run..., enter "gpedit.msc" here and press OK
  2. Go to Computer Configuration -> Administrative Templates -> Printers
  3. Find item "Disallow installation of printers using kernel-mode drivers" and set it to "Disabled"
  4. Close gpedit application
Then press "Next".
 

This block is related to installation on Exchange only

The next step is forms installation (Exchange gateway only). In the displayed listbox, select appropriate libraries where you wish to install forms (only languages used by your clients are necessary). In case of problems during libraries creation and form installation you'll be notified. If necessary you can create libraries manually through Exchange System Manager, then press Refresh forms libraries list button to get updated list of available libraries. Fax administrator must have Owner permission for the selected libraries to successfully complete installation. Setup program will warn you in case of insufficient permissions.

If checkbox Install forms for Windows 2000 and newer systems is not checked (function available from version 6.0.36), "old forms" are installed - they work correctly only if user has administrative rights on his PC (has access to all parts of filesystem and is able to register components). This is valid for clients using Windows 9x/Me/NT4.0.
If clients use Windows 2000 and newer (or work on any version of terminal server), checkbox must be checked and some componenets must be installed on the client PC under administrator's account. More info here.


The last step is SMTP receiver installation. SMTP receiver application allows sending messages from SMTP server directly to FaxChange server, without necessity to route message into pop3 mailbox. It also allows clients or applications to send messages directly using SMTP protocol without necessity to communicate with their own SMTP server.

Select to installation SMTP receiver


 
 

After forms copying Faxchange installation is complete. List of errors encountered during setup will be displayed in the last window.
 

Now you must restart your computer. Before that, you can change FaxChange configuration using fxCfg program and import users using fxUserM. Their import is not necessary - new users will be added to the database automatically when you try to send the first fax.


 

back to top of page


How to make sure that installation was completed successfully

You can make sure that FaxChange has been successfully installed in the following way:

  1. Faxchange.ConvertBig
  2. Faxchange.ConvertMaster
  3. Faxchange.ConvertPrint
  4. Faxchange.ConvertRTF - these four services convert fax messages into fax format
  5. Faxchange.Gate.Fax - (Exchange) fax gateway, it captures fax messages and passes them to fax server
  6. Faxchange.Gate.Mail - mailbox agent (Exchange), it sends fax previews to users and (un)delivery reports
  7. Faxchange.GateNotes - Lotus Notes gateway
  8. Faxchange.Pop3Smtp - SMTP gateway
  9. Faxchange.LineDrvBT, LineDrv2, Gammalink or UMS.LineDrv.CAPI_ISDN - Brooktrout, Class2, Gammalink or CAPI ISDN fax card driver
  10. Faxchange.Server - fax server, it controls converter and line driver operation
  11. Faxchange.SysAtt - controls operation of all other FaxChange services
  12. Faxchange.ServerPrinter - server side of client fax printer

All these services should be started after restart the computer. There is also faxinit service (only for the Brooktrout card) which works only immediately after the restart and it initializes fax card. Then it is automatically stopped.

By default, Full Controll permission for Everyone is assigned to these shares. For higher security level you can set permissions more restrictive:
Faxchange - this share is used by Faxchange services for filesystem access and by administrator for administering purposes. Set Faxchange service account permissions to Full Control, Administrators - Full Control, Everyone - Read (or No acces, if faxspy utility for fax queue user access is not used).
Faxchange\fxprintq - used by users of shared NT client fax printer. Leave Everyone - Full Control permission. In this folder are created temporary files and clients need permission to delete them.
Faxchange\etc\fxloader - there are client components instalation files located here. Set Everyone - Read.

back to top of page