Technical information

INSTALLATION AND ADMINISTRATION GUIDE
132
Each server in the LCR Cluster must be identified with a route name. To do this you must edit the
$VSIFAX/lib/vsisrv.ini file and add the name of the server. This name can either be the hostname for the
server or a descriptive city/location name. Edit the file by making the following entry in the vsisrv.ini file:
[LCR]
route-name=NewYork
Launch Notify Procedure (LNP)
The LNP is a VSI-FAX script when a fax is queued to the system but before it is transmitted. The LCR operation is
accomplished via the standard VSI-FAX LNP procedure. The LCR LNP determines whether the fax request is a
group request (containing multiple recipients) or a normal fax (containing a single recipient).
POP client
In addition to the LNP, LCR functionality requires each fax server to have the email-to-fax gateway installed and
configured in order to retrieve and provide status for routed faxes that are directed to it. It should be noted that the
email-to-fax gateway feature is a standard component included with all fax servers and only requires minimal
configuration to use.
Additionally, each LCR-enabled fax server requires exclusive access to a POP email account. This account can be
shared with the VSI-FAX email-to-fax gateway feature, but cannot be used by any other client application or user. For
purposes of clarity, this email account will be referred to in the rest of this documentation as the autofax account.
Setting up routes
This section describes how the routes and LCR rules files are used by LCR to determine the routing of faxes. Based
on the previous example of two servers, one in New York and one in London, the following explanation shows how
the files would be set up.
The LCR function requires that dialing rules be established to match fax numbers. Fax dialing numbers are matched
based on the patterns and wildcards used to set up the LCR rules file. In addition to the structure of the LCR rules
files, the following rules should be considered:
If the dialing digits contains commas, LCR is not performed.
All non-digits such as parentheses, hyphens, etc., are removed from the phone numbers.
Any dialing digits set in brackets are assumed to be a credit card number and are not used.
Any digits that appear after an @ sign are assumed to be an extension number.
LCR routes file
The LCR routes file (lcrhosts.lst) is used to associate each route to the email account and is located in the
$VSIFAX/lib directory.
The following is an example of an LCR routes file.
# Sample LCR routes fil
#
# <route_owner>:<transport_account>
#
NewYork:[e-mail]
LondonUK:[e-mail]
Note
LCR is designed to allow all fax servers to share the same routing tables. Once these files are set up, they must
be distributed and copied to all servers in a cluster.
See also
Refer to Command Reference in the Reference Addendum
documentation for additional information.