Technical information

INSTALLATION AND ADMINISTRATION GUIDE
134
Configuring the email-to-fax gateway
1. Edit the $VSIFAX/lib/vsisrv.ini file and add the entries to the [VPOPD] section for the POP3 mail
server account.
2. Add a password using the vfxadminconfig command. For syntax see the
vsisrv.ini password entry is
encrypted, therefore it cannot be directly added via a text editor. You must use the vfxadmin command line
utility to add this entry..
3. Verify the configuration is correct by sending email to the email-to-fax gateway account.
4. Configure the [VMAIL] section of the vsisrv.ini file and confirm it is working by using the vmail -D
command to send an email message.
5. Edit the [LCR] section of the $VSIFAX/lib/vsisrv.ini file as follows:
6. Add a route-name=<name_of_route> entry.
Each machine in a group (cluster) must have a unique route name.
Add a debug=on entry (optional).
Add entries to specify route names and email addresses to the $VSIFAX/lib/lcrhosts.lst file.
For example:
AUTOFAX@hostname.company.com
Important
Note that the email address must be fully qualified.
7. Add entries for rules that will trigger the LCR events to the $VSIFAX/lib/lcrrules.lst file. For example:
[1]714*:lcrsupport
8. Copy both the lcrhosts.lst and lcrrules.lst files to all servers in the cluster.
9. Verify the completeness and correctness of the LCR rules you established using the vlcrchk -v command.
Statusing LCR fax requests
In order to get status of faxes that have been routed to a remote fax server, LCR provides a pseudo-device (lcr)as
well as an SMTP message type (stat_msg), which that are recognized by the VSI-FAX POP client process. The
lcr pseudo-device enables the originating fax server to maintain a tracer for fax requests that have been routed to a
remote fax server. Faxes that have been routed continue to appear in the lcr device queue with current status
information until transmitted by the remote server.
The status information of a routed fax is delivered from the remote fax server system transmit notify procedure to the
originating fax server using SMTP mail messages. These messages are communicated using the same transport, the
email-to-fax gateway.
Upon retrieval of a message having the type stat_msg, the originating fax server decodes and updates the local
databases with the current status of the remotely routed fax.
Status information, while slightly less real-time in nature due to the SMTP transport, is provided by vfxstat in the
same way as it is for non-routed faxes.
Statusing using the Transmit Notify Procedure
LCR uses a pseudo-device (called lcr) to provides status information to the originating fax server of a routed fax
request, through the use of the system transmit notify procedure (TNP).
To accomplish this, upon transmission of a fax, an LCR-enabled server determines if the fax was routed. If it was, an
SMTP message of type stat_msg is constructed and mailed back to the originating fax server's autofax account.
LCR tags
LCR uses five tags in the ologreg and ologgrp database: