Host

This article requires cleanup and may refer to a legacy version of Resin. Please visit http://www.caucho.com/documentation/ for the most up-to-date documentation.

The <host> directive can use any Environment configuration item. The host is allowed in the <server> directive. The host configuration can occur in the <host> directive or in a <host-default> or <host-deploy> directive.

directive	meaning	default
Environment	Any Environment configuration directive is allowed in the host
access-log	Host-specific access logging
document-directory	A default document-directory for child web-apps	optional
ear-default	Default configuration for .ear files
ear-deploy	Configures an .ear deployment directory
error-page	Custom error pages for unhandled error codes
host-alias	an alias virtual host name for this host
host-alias-regexp	a regular expression of host name aliases for the host
host-name	the canonical host name
id	configures the unique host identifier
regexp	creates virtual hosts based on a regular expression
rewrite-dispatch	rewrites URLs and can redirect or return error codes
root-directory	specifies the virtual hosts's root directory	recommended
redeploy-mode	configures the hot-deployment redeploy mode
startup-mode	configures the hot-deployment startup mode
web-app-deploy	configures a web-app deployment directory (webapps)
web-app-default	configures host-wide defaults for all web-applications
web-app	directly configures child web-apps

<resin xmlns="http://caucho.com/ns/resin"
       xmlns:resin="http://caucho.com/ns/resin/core">
...
<cluster id="app-tier">
  ...
  <host host-name="www.foo.com"
        root-directory="/var/www/foo.com">
    <host-alias>foo.com</host-alias>
    <host-alias>web.foo.com</host-alias>

    <resin:import path="host.xml"/>

    <access-log path-format="logs/%Y-%m/access.log.%Y-%m-%d

    <web-app-deploy path="webapps"/>
  </host>
  ...
</cluster>
</resin>