Host

From Resin 3.0

(Difference between revisions)
Jump to: navigation, search
 
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:Configuration]]  
+
{{Cleanup}} [[Category:Configuration]]  
  
 
+
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.
 
+
The <host> tag can use any [[Environment]] configuration item.  The host is allowed in the <[[server]]> tag.  The host configuration can occur in the <[[host]]> tag or in a <[[host-default]]> or <[[host-deploy]]> tag.
+
  
 
{|
 
{|
!tag||meaning||default
+
!directive||meaning||default
 
|-
 
|-
|[[Environment]]||Any [[Environment]] configuration tag is allowed in the host
+
|[[Environment]]||Any [[Environment]] configuration directive is allowed in the host
 
|-
 
|-
 
|[[Log Configuration|access-log]]||Host-specific access logging
 
|[[Log Configuration|access-log]]||Host-specific access logging
 
|-
 
|-
|document-directory||A default document-directory for child [[web-app]]s.
+
|document-directory||A default document-directory for child [[web-app]]s||optional
 
|-
 
|-
 
|ear-default||Default configuration for .ear files
 
|ear-default||Default configuration for .ear files
Line 32: Line 30:
 
|[[rewrite-dispatch]]||rewrites URLs and can redirect or return error codes
 
|[[rewrite-dispatch]]||rewrites URLs and can redirect or return error codes
 
|-
 
|-
|root-directory||specifies the virtual hosts's root directory
+
|[[root-directory]]||specifies the virtual hosts's root directory||recommended
 
|-
 
|-
 
|redeploy-mode||configures the hot-deployment redeploy mode
 
|redeploy-mode||configures the hot-deployment redeploy mode
Line 49: Line 47:
 
         xmlns:resin="http://caucho.com/ns/resin/core">
 
         xmlns:resin="http://caucho.com/ns/resin/core">
 
  ...
 
  ...
  <server>
+
  <cluster id="app-tier">
 
   ...
 
   ...
 
   <host host-name="www.foo.com"
 
   <host host-name="www.foo.com"
Line 63: Line 61:
 
   </host>
 
   </host>
 
   ...
 
   ...
  </server>
+
  </cluster>
 
  </resin>
 
  </resin>

Latest revision as of 21:17, 1 December 2011

40px-Edit-clear.png 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>
Personal tools