Virtual hosting enables a single proxy server to host multiple
domains and ports on a single IP address and port. You can create a proxy
virtual host for each Web domain that the proxy server hosts, or you can use
wild card characters to host multiple Web domains with a single proxy virtual
host.
About this task
A proxy virtual host consists of the name and the port representing
the Web domain and a set of proxy rule expressions to complete specified proxy
actions when a defined criteria exists. Additionally, each proxy virtual host
can override the server scope configuration of the proxy server to have configuration
elements that are defined specifically for that virtual host. Proxy virtual
hosts use a set of proxy server actions and proxy rule expressions. Proxy
rules expressions are evaluated when inbound requests are received by the
proxy virtual host. If the expression is evaluated to be true, any proxy server
actions that are specified by the proxy rule expression are completed.
Procedure
- From the administrative console, select proxy_server_namevirtual_host_name.
- Optional: Click to access the virtual hosts settings page and configure settings
for a new virtual host.
- Specify a name for the virtual host. The name of the
virtual host must match the Web domain it represents. If the Web domain is
www.proxy1.com, the name of the proxy server host must be www.proxy1.com.
The asterisk symbol, * , can be used as a wild card character to represent
all Web domains. If the proxy virtual host is *:80, then all inbound requests
on port 80 are handled by that proxy virtual host regardless of what Web domain
is being requested.
- Specify the port for the virtual host. The port of the
virtual host must match the port used by the Web domain it represents. If
the Web domain uses port 80, then the port of the proxy virtual host must
also be 80. The asterisk symbol, * , can be used as a wild card character
to represent all ports. If the proxy virtual host is www.proxy1.com:*, then
all inbound requests to www.proxy1.com are handled by that proxy virtual host
regardless of what port is being used.
- Choose one or more proxy rule expressions for the virtual host.
Proxy rule expressions allow for proxy actions to be performed when
the expression evaluates to true. See the proxy rule expressions and proxy
server actions articles for more information on proxy rule expressions and
proxy server actions.
- Optional: Move a proxy virtual host up or down in the
list to ensure the correct proxy virtual host is used. The usage
of wild card characters for virtual proxy hosts creates a situation where
an inbound request might match multiple proxy virtual hosts. In this scenario,
the request is handled by the first proxy virtual host that matches the request.
- Optional: Click Edit to change
the selected proxy rule expression.
- Optional: Click Proxy Virtual Host Settings to
override the server scoped settings for static file serving, logging, or error
page policy.
- If you want to override the static file serving settings for
this proxy virtual host, click Static File Serving,
select Customize for this virtual host. Specify a new
value for the Static file document root field.
- If you want to override the logging settings for this proxy
virtual host, click Logging, select Customize
for this virtual host. Specify new values for one or more of the
following fields:
- Enable access logging
- Access log maximum size
- Proxy access log
- Cache access log
- Local access log
- If you want to override the error page policy settings for this
proxy virtual host, click Error Page Policy, and then
select Customize for this virtual host, and then specify
new values for one or more of the following fields:
- Error page generation application URI
- Handle errors generated by the proxy server
- Handle errors generated by the application server
- Headers to forward to error page application
- HTTP status codes that are to be recognized as errors
- Click OK to save your proxy virtual host
settings, and return to the previous administrative console page.
- Click OK to save all of your other changes.