Sun Java System Web Server 6.1 SP9 Administrator's Configuration File Reference

JAVA

Defines configurable properties for the integrated Java Virtual Machine (JVM), and for Java-based security and resources.

Subelements

The following table describes subelements for the JAVA element.

Table 2–29 JAVA Subelements

Element  

Required  

Description  

PROPERTY

zero or more 

Specifies a property or a variable. 

JVMOPTIONS

zero or more 

Contains JVM command line options. 

PROFILER

zero or one 

Configures a profiler for use with the server. 

SECURITY

zero or one 

Defines parameters and configuration information needed by the security service. 

RESOURCES

zero or one 

Specifies configured resources. 

Attributes

The following table describes attributes for the JAVA element.

Table 2–30 JAVA Attributes

Attribute  

Default  

Description  

javahome

<install-root>/bin/https/jdk

For SVR 4 package-based installation for Solaris: 

/usr/java

The path to the directory where the JDK is installed. 

debug

false

(optional) If true, the server starts up in debug mode ready for attachment with a JPDA-based (Java Platform Debugger Architecture-based) debugger. Legal values are on, off, yes, no, true, false, 1, 0.

debugoptions

-Xdebug -Xrunjdwp:transport=dt_socket, server=y,suspend=n

(optional) Specifies JPDA options. A list of debugging options that you can include is available at: 

http://java.sun.com/products/jpda/doc/conninv.html#Invocation

classpathprefix

none 

(optional) Specifies a prefix for the system classpath. You should only prefix the system classpath if you wish to override system classes, such as the XML parser classes. Use this attribute with caution. 

serverclasspath

none 

(optional) Specifies the classpath for the environment from which the server was started. This classpath can be accessed using System.getProperty("java.class.path").

classpathsuffix

none 

(optional) Specifies a suffix for the system classpath. 

nativelibrarypathprefix

none 

(optional) Specifies a prefix for the native library path. The native library path is the automatically constructed concatenation of the path to the server's native shared libraries, the standard JRE (Java Runtime Environment) native library path, the shell environment setting (LD_LIBRARY_PATH on UNIX), and any path specified in the PROFILER element. Since this is synthesized, it does not appear explicitly in the server configuration.

nativelibrarypathsuffix

none 

(optional) Specifies a suffix for the native library path. 

envclasspathignored

true

(optional) If false, the CLASSPATH environment variable is read and appended to the server classpath. The CLASSPATH environment variable is added after the classpath-suffix, at the very end.

For a development environment, this value should be set to false. For a production environment, this value should be set to true to prevent environment variable side effects.

Legal values are on, off, yes, no, 1, 0, true, false.

bytecodepreprocessors

none 

(optional) A comma-separated list of class names, each of which must implement the com.sun.appserv.BytecodePreprocessor interface. Each of the specified preprocessor classes is called in the order specified.

dynamicreloadinterval

2

Specifies the interval, in seconds, after which a deployed application is reloaded. 

loglevel

Value of level attribute of LOG element

(optional) Controls the type of messages logged by this element to the errors log. For details, see the description of the level attribute of the LOG element.