30.8 Using a Route Configuration File

The GWIA supports the use of a route configuration file (route.cfg) to specify destination SMTP hosts. This can be useful in situations such as the following:

  • You are using a relay host for outbound messages. However, you want some outbound messages sent directly to the destination host rather than the relay host. Whenever a message is addressed to a user at a host that is included in the route.cfg file, the GWIA sends the message directly to the destination host rather than the relay host.

  • You need to send messages to SMTP hosts that are unknown to the public Domain Name Servers. The route.cfg file acts much like a hosts file to enable the GWIA to resolve addresses not listed in DNS.

  • The GWIA uses external DNS servers but the server it is running on has an internal IP address. This prevents the GWIA from querying external DNS servers for its own internal domain names and receiving Host Down errors from the external DNS servers.

  • You want to route messages through an SMTP host that checks for viruses (or performs some other task) before routing them to the destination host.

To set up a route.cfg file:

  1. Create the route.cfg file as a text file in the domain\wpgate\gwia folder.

  2. Add an entry for each SMTP host you want to send to directly. The entry format is:

    hostname  address
    

    Replace hostname with a DNS hostname or an Internet domain name. Replace address with an alternative hostname or an IP address. For example:

    novell.com gwia.novell.com
    unixbox [172.16.5.18]
    

    If you use an IP address, it must be included in square brackets, as shown above.

    To reference subdomains, place a period (.) in front of the domain name as a wildcard character. For example:

    .novell.com gwia.novell.com
    

    Ensure that you include a hard return after the last entry.

  3. Save the route.cfg file.

  4. Restart the GWIA.