Allow me one more attempt at a clear doc?
1) If useIPVHosts=false (default), then the host header name determines
<Host> for processing, or default host of the Engine.
2) If useIPVHosts=true, then IP address of request determines <Host> for
processing, providing the IP is provided as the host name, or <Alias>.
If not found, then default host of Engine applies.
The actual rule is that Tomcat uses the value of request.getLocalName() to
determine the <Host>. So this is not completely true if you are using an
AJP connector. In this case, Tomcat uses the ServerName for the VirtualHost
that Apache picks. So if Apache is using named virtual hosts, they you get
the one that it resolved to in Apache. If you are using a HTTP/1.1
connector, then this is the name that the IP address resolves to on the
machine where Tomcat is running.
The useIPVHosts=true is useful when running with an AJP connector if you
have a lot of ServerAlias directives and/or change them often. It means
that the admin only needs to make the change to Apache without having to
make the corresponding change to Tomcat.
3) Nothing external to server.xml matters to Tomcat in resolving <Host>
for processing.
Well, not other than DNS resolution for a HTTP/1.1 connector when using
true. If you change the DNS name of the machine, then you need to change
server.xml as well.
Does that sound accurate?
Jeff (not the OP)
******************************* NOTICE *********************************
This message is intended for the use of the individual or entity to which
it is addressed and may contain information that is privileged,
confidential, and exempt from disclosure under applicable law. If the
reader of this message is not the intended recipient or the employee or
agent responsible for delivering this message to the intended recipient,
you are hereby notified that any dissemination, distribution, or copying
of this communication is strictly prohibited. If you have received this
communication in error, please notify us immediately by reply or by
telephone (call us collect at 512-343-9100) and immediately delete this
message and all its attachments.
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscr...@tomcat.apache.org
For additional commands, e-mail: users-h...@tomcat.apache.org
