Setting Tomcat Instance (Host) Properties
See Also
The Host
property sheet enables you to edit the attributes of
a Host
.
To display the Host property sheet:
- On the Runtime tab of the Explorer, expand the Installed Servers node.
- Expand the Tomcat node, then expand the relevant installation node.
- Right click on the node representing the
Host
to be edited,
and choose Properties from the contextual menu.
On the Properties pane of the Host
property sheet, you can set
the following properties:
- Default Connector. Use this property to select the default Connector
for this Host from all available Connectors. To set the Default Connector
property, click on the right-hand column of the Default Connector row and
choose a value from the list.
- Engine:defaultHost. Use this property to specify the
defaultHost
attribute of the Engine
element within which this Host
is nested. The default host name identifies the Host
that will
process requests directed to host names on this server, but which are not
configured in this server's configuration file. The default host name must
match the name
attribute of one of the Host
elements
nested immediately inside. To set the Engine:defaultHost property, type a
pathname in the Engine:defaultHost property text field.
- Engine:name. Use this property to specify the
name
attribute
of the Engine element in which this Host
is nested. This attribute
specifies the logical name of the Engine, which is used in log and error messages.
To set the Engine:name property, type a pathname in the Engine:name property
text field.
- HTTP Connector. Use this property to specify the port number for
the HTTP connector. For Tomcat, the port number is usually 8080, however,
the HTTP port number for the internal Tomcat installation is
set to 8081 by default. To set this property, type the desired port number
in the HTTP Connector property field.
- Service:name. Use this property to specify the
name
attribute of the Service
element in which the host is nested.
This attribute specifies the display name of the Service
element.
The name of each Service
element associated with a particular
Server
element must be unique. To set the Service:name attribute,
type a service name in the Service:name property text field.
On the Attributes pane of the Host
property sheet, you can set
the following properties:
- appBase. Use this property to specify the application base directory
for the current virtual host. This is the pathname of a directory that might
contain web modules to be deployed on this virtual host. To set the appBase
property, type a pathname in the appBase property text field. You can specify
an absolute pathname, or a pathname that is relative to the
$CATALINA_HOME
directory.
- className. This read-only property specifies the Java class name
of the implementation to use. The default value is
org.apache.catalina.core.StandardHost
.
- debug. Use this attribute to specify the level of debugging detail
logged by the current engine to the associated logger. Higher numbers generate
more detailed output. If not specified, the default debugging detail level
is
0
. To specify the debug attribute, type a number in the right-hand
column of the debug property row.
- name. Use this attribute to specify the network name of the current
virtual host, as registered in your domain name service server. One of the
Hosts nested within an Engine must have a name that matches the
defaultHost
setting for that Engine. To set the name attribute, type a name in the name
property text field.
- unpackWARs. Set this attribute to true if you want web modules that
are deployed into the current virtual host from a WAR file to be unpacked
into a disk directory structure. If set to false, the web module executes
directly from the WAR file. To set this attribute, click on the right-hand
column of the unpackWARs row and choose a value from the list.
Legal Notices