server.xml elements beginning with I and J
The following elements are discussed below:
include
The include element configures the document types that should be indexed. This element may appear zero or one time within the search-collection element. For more information, see search-collection.
If the include element is not present, only documents matching the
*.html, * .htm, *.txt, *.pdf,
patterns are indexed. Documents with the jar, sxc, sxg, sxi, sxm, sxw, war, and zip file extensions are never indexed.
Subelements
The include element can contain the following subelement:
Table 3-24 List of include Subelements
| Element | Occurrences | Description |
|---|---|---|
| pattern | 0 or more | Specifies the wildcard pattern of files to be indexed |
See Also
index
The index element configures the document fields that are indexed for searching. This element may appear zero or one time within the search-collection element. For more information, see search-collection.
Subelements
The index element can contain the following subelement:
Table 3-25 List of index subelement
| Element | Occurrences | Description |
|---|---|---|
| meta-tag | 0 or more | The name of the HTML meta tag that should be indexed |
See Also
instance
The instance element defines a member of a server cluster. This element may appear one or more times within the cluster element. For more information, see cluster.
Subelements
The instance element can contain the following subelements:
Table 3-26 List of instance Subelements
| Element | Occurrences | Description |
|---|---|---|
| enabled | 0 or 1 | Determines whether the instance is enabled at runtime. The default value is true. |
| host | 1 | The network address of the instance. The value is the host name or the IP address. |
| session-replication | 0 or 1 | Configures the Servlet session replication for the instance. For more details, see session-replication. |
See Also
jdbc-resource
The jdbc-resource element configures a Java Database Connectivity (JDBC) resource. This element may appear zero or more times within the server element. For more information, see server.
Subelements
The jdbc-resource element can contain the following subelements:
Table 3-27 List of jdbc-resource Subelements
| Element | Occurrences | Description |
|---|---|---|
| enabled | 0 or 1 | Determines whether the resource is enabled at runtime. The default value is true. |
| jndi-name | 1 | The JNDI name of the resource. |
| datasource-class | 1 | The JDBC driver class. The value is a name of the class that implements java.sql.DataSource and java.sql.XADataSource. |
| min-connections | 1 | The minimum number of concurrent connections to maintain to the database server. The value can be from 1 to 4096. |
| max-connections | 1 | The maximum number of concurrent connections to maintain to the database server. The value can be from 1 to 4096. |
| idle-timeout | 1 | The timeout (in seconds) after which an idle connection to the database server will be closed. The value can be from 0 to 3600, or -1 for no timeout. |
| wait-timeout | 1 | The timeout (in seconds) after which a caller waiting for an available connection to the database server will receive an error. The value can be from 0.001 to 3600, or -1 for no timeout. |
| isolation-level | 0 or 1 | Specifies the transaction isolation level. The value can be read-uncommitted, read-committed, repeatable-read, or serializable. |
| isolation-level-guaranteed | 0 or 1 | Determines whether the server sets the isolation level each time a connection is leased to an application. The default value is false. |
| connection-validation | 0 or 1 | Specifies how the server validates a connection before leasing it to an application. The value can be false, auto-commit, meta-data, or table. |
| connection-validation-table-name | 0 or 1 | The name of the table used when connection-validation is table. The value is the database table name. |
| fail-all-connections | 0 or 1 | Determines whether all connections are immediately closed and reestablished when there is an error validating an individual connection. The default value is false. |
| property | 0 or more | Configures the JDBC driver (java.sql.DataSource and java.sql.XADataSource) properties. For more details, see property. |
| connection-creation-property | 0 or more | Configures the JDBC connection (java.sql.Connection) properties, when a new connection is created. For more details, see connection-creation-property. |
| connection-lease-property | 0 or more | Configures the JDBC connection (java.sql.Connection) properties each time a connection is leased to an application. For more details, see connection-lease-property. |
| description | 0 or 1 | The description of the resource. |
See Also
jvm
The jvm element configures the Java Virtual Machine (JVM). This element may appear zero or one time within the server element. For more information, see server.
Subelements
The jvm element can contain the following subelements:
Table 3-28 List of jvm Subelements
| Element | Occurrences | Description |
|---|---|---|
| enabled | 0 or 1 | Determines whether the server creates a JVM. The default value is true. |
| java-home | 1 | The location of the JDK. If relative path is used, it is relative to the server's config directory. |
| class-path-prefix | 0 or 1 | The prefix for the system classpath. Because this classpath takes precedence over the server classpath, changing it can prevent the server from working properly. To add classes to the system classpath, use the class-path-suffix element instead. |
| server-class-path | 0 or 1 | The classpath containing server classes. Changing this classpath can prevent the server from working properly. To add classes to the system class path, use the class-path-suffix element instead. |
| class-path-suffix | 0 or 1 | The suffix for the system classpath. |
| env-class-path-ignored | 0 or 1 | Determines whether the server ignores the CLASSPATH environment variable. The default value is true. |
| native-library-path-prefix | 0 or 1 | The prefix for the operating system native library path. |
| sticky-attach | 0 or 1 | Determines whether the server attaches each HTTP request processing thread to the JVM only once or attaches and detaches on each request. The default value is true. |
| debug | 0 or 1 | Determines whether JVM is started in debug mode, ready for attachment with a Java Platform Debugger Architecture (JPDA) debugger. The default value is false. |
| debug-jvm-options | 0 or more | Defines the JPDA options. For more details, see http://java.sun.com/products/jpda/doc/conninv.html#Invocation |
| jvm-options | 0 or more | Defines the server-wide JVM options. For more details, see http://java.sun.com/docs/hotspot/VMOptions.html |
| bytecode-preprocessor-class | 0 or more | The name of the bytecode preprocessor class. The value is a name of a class that implements com.sun.appserv.BytecodePreprocessor. |
| profiler | 0 or 1 | Configures a Java profiler. For more details, see profiler. |
| Note - (On Windows only). Logging out of the machine where the web server is installed might abort the web server process. To avoid this problem, perform these steps:
|