The fields in this section are populated by vRealize Hyperic with information from the CATALINA_HOME/bin/setenv.sh file of the tc Runtime instance you are configuring.

If setenv.sh does not exist, or does not define JVM_OPTS, the Server Start fields are blank. Edits that you make to Server Start fields in the vRealize Hyperic user interface are written to setenv.sh.

Table 1. General Parameters

Field Name

Description

Java Home

Specifies the full pathname to the JDK or JRE used by the tc Runtime instance.

Use Server Hotspot VM

Select the checkbox to use the Java HotSpot Virtual Machine.

Min Heap Size

Specifies the initial size, in MB, of the memory allocation pool.

Max Heap Size

Specifies the maximum size, in MB, of the memory allocation pool.

Thread Stack Size

Specifies the amount of memory, in KB, allocated to a single JVM thread.

Sun-Specific JVM Options

The options in the following table are specific to Sun JVMs. Modify the option values with caution. If you use a non-Sun VM, altering the values might have unintended effects.

Table 2. Sun Specific JVM Parameters

Field Name

Description

Memory

Min Young Generation Size

Specifies the default size, in MB, of new generation.

Max Young Generation Size

Specifies the maximum size, in MB, of new generation.

Min Perm Gen Size

Specifies the initial size, in MB, of the permanent generation.

Max Perm Gen Size

Specifies the maximum size, in MB, of the permanent generation.

Garbage Collection

Max GC Pause

Sends a hint to the virtual machine that pause times of the specified milliseconds or less are preferred. The VM adjusts the Java heap size and other garbage collection-related parameters in an attempt to keep garbage collection-induced pauses shorter than the specified value.

Note:

This may cause the VM to reduce overall throughput, and in some cases the VM will not be able to meet the preferred pause time goal.

Max GC Minor Pause

Sends a hint to the virtual machine that pause times of the specified milliseconds or greater are preferred. The VM adjusts the Java heap size and other garbage collection-related parameters in an attempt to keep garbage collection-induced pauses greater than the specified value.

Debug

Heap Dump on Out of Memory Error

Directs the JVM to generate a heap dump when an allocation from the Java heap or the permanent generation cannot be satisfied.

Print Message at GC

Specifies whether the JVM should print messages to the garbage collection log file every time it performs a garbage collection.

Print Heap at GC

Specifies whether the JVM should print detailed information, including heap occupancy before and after a garbage collection, to the garbage collection log file.

Print GC Application Stopped Time

Specifies whether the JVM should print the amount of time an application is stopped during a garbage collection to the garbage collection log file.

Print GC Timestamps

Specifies whether the JVM should print time stamps related to garbage collection to the garbage collection log file.

Print GC Details

Specifies whether the JVM should print detailed information relating to garbage collection to the garbage collection log file.

GC Log File

Specifies the name of the garbage collection log file to which all garbage collection information is printed. Default value is CATALINA_BASE/logs/gc.log.

Advanced Parameters

Table 3. Advanced Parameters

Field Name

Description

Command Line Arguments

Enter additional options to the CATALINA_OPTS environment variables if they are not available as text fields on the configuration page. Use one of these forms with a space between options:

  • -XOptionValue

  • -XX:Option=Value

For example: -Xms512M -Xmx512M -XX:NewSize=128M

Context Container Parameters

The fields described in the following table configure the context for every Web application deployed to the tc Runtime instance. vRealize Hyperic loads and updates the values from the CATALINA_BASE/conf/context.xml file for the tc Runtime instance.

Table 4. Context Container Parameters

Field Names

Description

Static Resource Cache

Allow Caching

If selected, specifies that tc Runtime uses the cache for static resources.

Max Cache Size

Maximum size, in KB, of the static resource cache. Default value is 10240 (10 megabytes).

Cache TTL

Amount of time, in milliseconds, between cache entries revalidation. Default value is 5000 (5 seconds).

Web Application Logger

Swallow Output

If selected, specifies that tc Runtime redirects the bytes output by the Web application to System.out and System.err to the Web application logger.

Server Defaults - JSP

The fields described in the following table configure JSP-related init params for every Web application deployed to the tc Runtime instance. vRealize Hyperic loads and updates the values from the CATALINA_BASE/conf/web.xml file for the tc Runtime instance.

Table 5. Server Defaults - JSP Parameters

Field Names

Description

Recompile Check Interval (s)

Specifies the interval, in seconds, at which tc Runtime checks to see if a JSP and its dependent file must be recompiled. Default value is 0. If you set this field to a value greater than zero, and Development Mode is not selected, tc Runtime performs the compilation in the background.

Development Mode

Specifies that tc Runtime is working in development mode. When this value is selected, you can specify the frequency at which JSPs are checked for modification using the Modification Test Interval field.

Modification Test Interval (s)

Specifies the interval, in seconds, for tc Runtime to wait before checking JSPs and their dependent files for modifications. If you set this field to 0, tc Runtime checks the JSPs every time they are accessed. Default value is 4 seconds. This feature is enabled only when Development Mode is selected.

Compiler

Specifies the JSPs compiler used by tc Runtime. If not specified, tc Runtime uses the default Eclipse JDT Java compiler.

Compiler Target VM

Specifies the JDK version with which the generated files are compatible. Default value is JDK 1.4.

Compiler Source VM

Specifies the JDK version with which the source files are compatible. Default value is JDK 1.4

Compile Class With Debug Information

Specifies whether the JSP class should be compiled with debug information.

Classpath

Specifies the CLASSPATH for tc Runtime to use when compiling the generated servlets. tc Runtime creates the default CLASSPATH dynamically, based on the current Web application.

Fork JSP Page Compile to Separate JVM

Specifies whether tc Runtime should fork the compilation of JSPs so that they are performed in a JVM other than tc Runtime .

Enable Tag Handler Pooling

Enables tag handler pooling.

Internet Explorer class-id for <jsp:plugin> Tags

Specifies the class-id value that tc Runtime sends to Internet Explorer when using the tags. Default value is clsid:8AD9C840-044E-11D1-B3E9-00805F499D93.

Java File Encoding

Specifies the Java file encoding to use for generating Java source files. Default value is UTF8.

Keep Generated Source Code

Specifies whether tc Runtime keeps or delets the generated source code for each page.

Generate One Print Statement Per Input Line

Specifies whether tc Runtime generates static content with one print statement per input line, to ease debugging.

Trim Spaces In Template Text

Specifies whether tc Runtime trims white spaces in template text between actions or directives.

Suppress SMAP Information

Specifies whether tc Runtime suppresses the generation of SMAP information for JSR-45 debugging.

Dump SMAP Information

Specifies whether tc Runtime dumps SMAP information for JSR-45 debugging to a file. If you set this field to true (selected), clear Suppress SMAP Information.

Generate Strings as Char Arrays

Specifies whether strings are generated as character arrays. Selecting this field sometimes increases the performance of JSPs.

Issue Error For Invalid useBean Class Attribute

Specifies whether tc Runtime issues an error when the value of the class attribute in a useBean action is not a valid bean class.

Scratch Directory

Specifies the scratch directory that tc Runtime uses when compiling JSP pages. The default value is the work directory for the current Web application.

Add X-Powered-By Response Header

Specifies whether the generated servlet adds the the X-Powered-By response header.

Server Defaults - Static Content

The fields described in the following table configure static content-related init parameters for every Web application deployed to the tc Runtime instance. vRealize Hyperic loads and updates the values from the CATALINA_BASE/conf/web.xml file for the tc Runtime instance.

Table 6. Server Defaults - Static Content Parameters

Field Names

Description

Debug Level

Specifies the level of detail contained in the debugging messages from the current servlet. Default value is 0 (no debugging.)

File Encoding

Specifies the encoding that tc Runtime uses when reading static resources. The default value is the same as the file encoding of the platform on which tc Runtime is running.

Input Buffer Size

Specifies the size, in bytes, of the input buffer that tc Runtime uses when reading resources to be served. Default value is 2048.

Output Buffer Size

Specifies the size, in bytes, of the output buffer that tc Runtime uses when writing resources to be served. Default value is 2048.

Min Sendfile Size

Specifies the minimal file size, in KB, that tc Runtime uses with sendfile. This field only works if the connector supports sendfile. Default value is 48.

Show Directory Listings

Specifies whether tc Runtime produces a directory listing if there is no welcome file in the directory. WARNING: Directory listings that include many entries might be slow and consume a significant proportion of the tc Runtime resources.

Readme File Name

File name to display with the directory contents. No default value.

Read Only

Specifies whether the current context is read-only, which means that it rejects HTTP commands such as PUT and DELETE.