Host Substitution

Host substitution makes it possible to change the web site that a wireless handheld requests without having to reconfigure the handheld. This can be very useful when changing server hosts.

With host substitution, you can set Good Intranet Server to map a specified host name in a URL to a different (substitute) host name that you also specify.

For example, if a wireless handheld is configured to initially send all of its HTTP requests to localhost, where localhost is Good Intranet Server, the server can be configured to send the request to a different host, such as www.gadocs.com.

hostsubst.enable  true
hostsubst.sub  localhost www.gadocs.com

The first line in the example enables host substitution; the second line specifies that requests to localhost are to be sent to www.gadocs.com.

Any time the handheld's requests need to be redirected to a different host, the hostsubst.sub property can be changed to specify the new destination.

You can specify multiple host-name substitutions by entering pairs of URLs as a space-separated list. In the following example, localhost is mapped to www.gadocs.com and www.abcdef.com is mapped to www.zyxwvu.com:

hostsubst.sub localhost www.gadocs.com www.abcdef.com www.zyxwvu.com

Host substitution properties include:

Property Name	Default	Description
hostsubst.enable	false	If set to true, enables host substitution.
hostsubst.sub	localhost www.SomeOtherHost.com	One or more host substitutions, specified as: host new_host host new_host... For example, to forward requests sent to www.gate.com to www.Good Intranet.com, enter: hostsubst.sub www.gate.com www.Good Intranet.com
hostsubst.log. enable	false	If set to true, enables logging of host substitution events.