| Virtual Host Templates |
Virtual host template can be used to simplify the
administration of virtual hosts with similar configuration,
especially, for mass hosting environment. Once a template is configured
properly, only minimum configuration is required when adding a new virtual
host.
Each template contains a template configuration file, a list of mapped listeners
and a list of member virtual hosts.
The template configuration file
contains all configuration entries for a virtual host, with some
fields requiring special values. For example, Virtual Host Root must contain a
special variable $VH_NAME in the path. In this way, each member
virtual host will have its own root directory based on its name.
To add a template-based virtual host, administrator only needs to
add a member to the template member list with a unique virtual host name and a
qualified domain name of that virtual host.
Lister-to-virtual host mapping will be added automatically for
all listeners in the mapped listener list.
Later on, if you need to customize the configuration for a particular
virtual host, just "instantiate" that member virtual host, a
standalone virtual host configuration will be created automatically.
Even when setting up a virtual host with different configuration,
it is still convenient to use a template as a starting point, and then customize it after instantiation.
|
| |
| Table of Contents |
|
| |
| Name |  |
|
| Description: A unique name for the template.
|
|
| Template File | |
|
| Description: Specifies the path to the configuration file of this template.
|
| Syntax: path |
|
| Mapped Listeners | |
|
| Description: Specifies the names of all listeners that this template maps
to. An implicit listener-to-virtual host mapping will be added for all
member virtual hosts based on their domain name and aliases.
|
| Syntax: comma-separated list |
|
| Name | |
|
Description: A unique name for this virtual host among all
template member virtual hosts and standalone virtual hosts. It can be
referenced by variable $VH_NAME inside a directory path
configuration.
If a standalone virtual host with the same name is also configured, then
the member virtual host configuration will be ignored.
|
|
| Domain | |
|
Description: Specifies a main domain name for this member virtual host. If left blank,
virtual host name will be used. This should
be a fully qualified domain name, but you can use IP address as well.
It is recommended to append : for web site not on standard
port 80. It can be referenced by variable $VH_DOMAIN for
configuration contains domain names.
It will be used in the following situation:
- To match the host name in the "Host" header when processing a
request.
- To populate domain name configurations for add-ons
like frontpage or awstats.
|
| Syntax: domain name |
|
| Aliases | |
|
Description: Specifies the alternate names for the virtual host. All possible
hostname and IP address should be added to the list. Wildcard character
* and ? are allowed in the name.
It is recommended to append : for web site not on standard
port 80.
It will be used in the following situations:
- To match the host name in the "Host" header when processing a
request.
- To populate domain name/alias configurations configurations for add-ons
like frontpage or awstats.
|
| Syntax: comma-separated list of domain name |
|
| Virtual Host Root | |
|
| Description: Specifies the root directory of this virtual host. Variable
$VH_NAME must appear in the path. If left
blank, the virtual host root path in the template
configuration will be used instead.
|
| Syntax: path |
|
