logo

Manual Pages


Table of Contents

NAME

na_httpd.hostprefixes - configuration of HTTP root directories for virtual hosts

SYNOPSIS

/etc/httpd.hostprefixes

DESCRIPTION

The httpd.hostprefixes file maps virtual hosts used in HTTP to corresponding root directories. The same configuration file is used for both IP virtual hosts (defined by the IP address used for connecting to the server) and HTTP virtual hosts (defined by the Host: header used in HTTP requests).

Each virtual host has a corresponding subdirectory within the directory specified by the option httpd.rootdir. This subdirectory is called the virtual host root directory. Clients connected to a virtual host can only access files within the virtual host root directory.

In the httpd.hostprefixes file, each line consists of a virtual host root directory followed by the names and IP addresses of a virtual host. If you specify an IP address, the virtual host root directory is associated with the given virtual host for IP-level virtual hosting. If you specify a name, the virtual host root directory is associated with the virtual host with that name, using HTTP-level virtual hosting. If the filer can resolve that name to an IP address, which is used for an IP-level host alias (see the alias option in na_ifconfig(1)), the filer uses that IP address in the same way as it would if you specified the IP address in the httpd.hostprefixes file.

If the /etc/httpd.hostprefixes file is edited, it is read again by the HTTP server after the changes are saved.

SETUP

1. Enable httpd.enable and set HTTP Root directory httpd.rootdir

2. Configure network interface with HTTP Virtual Host Addresses. For example, to add the 207.68.156.50 as HTTP Virtual Host address to the network interface e0a, enter the following command:

  toaster> ifconfig e0a alias 207.68.156.50

NOTE: In Data ONTAP 7.3 and later releases, VH interface is no longer supported for HTTP Virtual Hosting.

3. Edit /etc/httpd.hostprefixes file and map the Virtual Host addresses to respective subdirectories within the directory specified by the option httpd.rootdir. For example, to map the Virtual Host address 207.68.156.50 specified in Step 2 above to the httpdir1 subdirectory within httpd.rootdir, add the following entry to the /etc/httpd.hostprefixes file:

  /httpdir1 207.68.156.50

4. Test HTTP virtual host setup by sending HTTP request to the Virtual Host address added and mapped in Step 2 and 3 above.

EXAMPLE

This example maps requests sent to www.customer1.com to the customer1 subdirectory of httpd.rootdir and requests directed at a host with IP address 207.68.156.58 to the subdirectory customer2.

  /customer1 www.customer1.com
  /customer2 207.68.156.58

If the command

  toaster> ifconfig e0a alias www.customer1.com

had been issued before the configuration file was read, requests destined for the IP address of www.customer1.com would also be mapped to the /customer1 subdirectory, regardless any the Host: header they included.

EFFECTIVE

Any changes take effect within 5 minutes

PERSISTENCE

Changes are persistent across system reboots.

SEE ALSO

na_ifconfig(1), na_options(1)


Table of Contents