Technical information

FAX ON DEMAND CONNECTOR
59
Configuring FoDC devices localization
By default, the main device (i.e. FoDC) points to the USA platform and the failover device (FoDC2) points to the
European platform. Invert the two locations if you would rather have the European server as main device destination
and the USA server as failover location. Those addresses are:
USA: na.ondemand.esker.com
European: as1.ondemand.esker.com
Configuring notifications on device failure
If you want to be notified by email when the main device fails, you need to set the address to which the email will be
sent in the sys-devfail.tcl script:
set EMAIL "<youremail@company.com>"
Configuring the failover status re-initialization
When the main device fails, it is disabled and faxes are routed to the failover device. After a certain amount of time,
VSI-FAX will rollback to the default devices configuration (i.e. the main device will be enabled and the failover device
disabled). This is done via scripts:
The Crontab.lst file contains the call to the main re-initialisation srcipt:
!5 * * * * exec-online ./faxtcl "../lib/enp/restorefodc.tcl"
By default the main script is called every 5 minutes. You can change this value if needed.
The Restorefodc.tcl script is the re-initialization script that actually enables and disables devices. This script
allows you to configure the amount of time before the main device is re-enabled after a failure. To do so, set
the MAX_DOWN_TIME_MIN value to the amount of minutes you want:
set MAX_DOWN_TIME_MIN 30
Local device failure
This section describes how you can use the device fail script to handle local fax failover by routing faxes to the Fax
on Demand device in case of fax board failure.
Configuring the maximum number of attempts before the device fails
By default, a device is disabled after three consecutive attempts. You can change this value to any number by editing
the vsisrv.ini file. Locate the [VFXSCHED] section and and change the MaxNoResps key value. Below is an example
to set this value to 5 instead of 3:
[VFXSCHED]
MaxNoRsps=5
You can also use the vfxadmin config command to achieve the same result, by entering:
vfxadmin config -a VFXSCHED MaxNoRsps 5
Important note
Make sure the value set for the MaxNoRsps key is compliant with your current retry strategy: you want more
total retries than the maximum number of fails on a device, or esle you faxes will fail before they have been
submitted to the failover device.
Below is a sample sys-devfail.tcl file (whish script is executed whenever a device fail), which shows how to
route the faxes to the Fax on Demand devices in case of local fax board failure. This sample actually defines the
FoDDCClass as default class and enables the correct mainFoDC device, therefore using all the failover capacities of
the Fax on Demand configurations.
This sample logs the device failure and the failure reason in %VSI-FAX%/spool/ logs/devfail, and sends it
sends a notification email to an administrator, before routing the faxes to Fax on Demand devices..
#--------------------------------------------------------
# sys-devfail.tcl