Virtual Hosting

TeleFinder's Web Server supports IP Conservative Multi-homing by mapping domain names to specific URL's supported by your server. These URLs can be "Personal Web" sites, or sub-directories within your main web site. Webmasters can use this feature to provide virtual hosting services on the Macintosh.

This feature is dependent upon the "Host" header supplied by the NetScape, and Microsoft Internet Explorer browsers, and any HTTP 1.1 compliant browser.

The Host header is required by the HTTP/1.1 protocol.

For IP based Multi-homing, see "Server Info" in the "Server" pane.

 

Virtual Hosts

Select the "Server Settings" command from the Web menu to open the Web Settings dialog. The click on the "Virtual Host" icon to display the Virtual Host pane.

   
   
The "Virtual Host" entries map requests to separate URLs based on the domain name of the host being requested. TeleFinder handles the mapping internally so that the virtual host appears to be a completely separate server.

 

Requirements

The serving computer must have multiple Domain Names, one for each "virtual host." Multiple IP Addresses are not necessary.

Example:

In this example we show the entry that supports the www.tfnet.org web site on the Spider Island Server.

Click in the Virtual Host "Add" button. This opens the Host Mapping dialog.

The domain www.tfnet.org is being added as a Virtual host . The location is "/~tfnet."

   
   
Enter the Domain Name of the site you wish to serve in the "Domain" field. In the "Location" field, enter a URL Path to the Personal Web site or sub-directory containing the site's homepage. Do not include the trailing slash in the location.

Valid locations may include personal web sites, locations defined by URL directory mapping as well as suib-directories of the web server's root. Do not map the location to a file, it must map to a directory.

When TeleFinder receives a request for a resource in a Virtual Host, it internally modifies the URL to include the Location you specify. For exmaple, a request for "http://www.tfnet.org/" is treated as "http://www.tfnet.org/~tfnet/." The new, internal URL is the one used to locate the requested resource, test for security, and directory map.

Click in the OK button to enter this mapping in the Virtual Host list.

 

Handling Errors

If the Virtual Host is mapped to a Personal Web Site, you can customize the error files for that host by editing and copying the "Templates" folder into the user's Web Space folder. If the Virtual Host is mapped to a "Directory Mapping," errors will be handled by the files in the Templates folder defined for that path, if a Templates path was defined.

By default, TeleFinder will use the files in the "Templates" folder in the Primary Root to serve errors and directory listings.