The virtual-server element
The virtual-server element represents a virtual host, which is an association of a network name for a server (such as "www.mycompany.com" with the particular server on which Catalina is running. In order to be effective, this name must be registered in the Domain Name Service (DNS) server that manages the Internet domain you belong to - contact your Network Administrator for more information.
In many cases, System Administrators wish to associate more than
one network name (such as
company.com) with the same virtual host and applications.
This can be accomplished using the Host
Name Aliases feature discussed below.
One or more virtual-server elements are nested inside an subsystem=web element.
The virtual-server supports the following attributes:
Name of the Virtual Host
List of alias supported by the Virtual Host
Element describing how the access log information should be logged.
Element describing what the rewrite valve should do with requests corresponding to the Virtual Host.
Whether or not the bundled welcome directory is used as the root web context.
Webapp to use as default applicationWhether or not the bundled welcome directory is used as the root web context. If not specified, a default of
virtual-server doesn't support more attributes that the ones listed above.
access-logdescribes how the access log information should be logged. It adds the
AccessLogValveto the Virtual Host defined by
virtual-serverSee the AccessLogValve api documentation for more information.
directory location based on the global path configuration in the domain model. If not specified, it defaults to the JBoss Application data directory (jboss.server.base.dir).
directory location based on the referenced path.
Patern used by the AccessLogValve. The paterns are described in the AccessLogValve api documentation. If not specified, a default of
Tell the Valve to resolve or not the host names. If not specified, a default of
AccessLogValveIf not specified, a default of
Define the prefix to use to name the log file. If not specified, a default of
Tell the valve if it should rotate the ouput or not. If not specified, a default of
rewritedescribes how requests should be rewritten before processing. It adds the
RewriteValveto the Virtual Host defined by
virtual-serverSee URL Rewriting for more information.
conditionElements. See condition below.
Pattern is a perl compatible regular expression, which is applied to the URL of the request.
The substitution of a rewrite rule is the string which is substituted for (or replaces) the original URL which Pattern matched
Substitution options (See URL Rewriting for all the available options
conditiondescribes a condition of the conditions list to apply the pattern substitution
a test string is first evaluated, before being matched against the specified pattern
CondPattern is the condition pattern, a regular expression which is applied to the current instance of the test string
Matching options AND/OR and NC
ssodescribes how single sign on is processed. It adds a
Valveto the Virtual Host defined by
Name of the cache container to use for clusterised sso
Name of the cache to use for clusterised sso
Cookie domain to use.
Whether each request should cause a reauthentication.