I & J

                                                                                                                                                                                                                                                                                                                                      Back to [Book]     [Topic]

server.xml elements beginning with I and J

The following elements are discussed below:

  include   index     instance  
 jdbc-resource   jvm  

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:
  1. Add the following line to the server.xml file of the web server instance.
    <jvm-options>-Xrs</jvm-options>
  2. Restart the instance.

See Also

servlet-container

Labels

configurationfile configurationfile Delete
+configguide +configguide Delete
java java Delete
server server Delete
configuration configuration Delete
administrator's administrator's Delete
sun sun Delete
webserver webserver Delete
application application Delete
system system Delete
webtier webtier Delete
guide guide Delete
webserver70 webserver70 Delete
file file Delete
sunjava sunjava Delete
web web Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Sign up or Log in to add a comment or watch this page.


The individuals who post here are part of the extended Sun Microsystems community and they might not be employed or in any way formally affiliated with Sun Microsystems. The opinions expressed here are their own, are not necessarily reviewed in advance by anyone but the individual authors, and neither Sun nor any other party necessarily agrees with them.

Copyright 1994-2009 Sun Microsystems, Inc.
Powered by Atlassian Confluence
Sun Guidelines on Public Discourse Privacy Policy Terms of Use Trademarks Site Map Employment Investor Relations Contact