Customizing Java Component configuration

You set configuration parameters for the Java Component application to tune performance and to control service and application execution.

You configure the Java Component application by changing configuration file contents, such as web.xml. To understand the common configuration files and how each of their entries affect Java Component, see Actuate Java Component configuration.

The following section describes the customization procedure using the text editor.

How to customize Java Component configuration parameters

Use the following procedure to customize configuration parameters for Java Component. In this procedure, it assumed that web.xml is the configuration file.

1	Extract the contents of the Actuate Java Component WAR or EAR file into a temporary directory.

2	Make a backup copy of web.xml.

3	Using a text editor that supports UTF-8 encoding, edit web.xml to change parameter values. Parameter definitions use the following format:

<param-name><keyword></param-name>

<param-value><value></param-value>

where

<keyword> is the name of the parameter.

<value> is the parameter value.

Do not enclose the keyword and value within quotes, and use no spaces between <param-name>, the keyword or value, and </param-name>. For example, the definition for the default locale parameter is:

<param-name>DEFAULT_LOCALE</param-name>

<param-value>en_US</param-value>

4	Save web.xml.

5	Recompress your Java Components WAR file using the Java jar utility and redeploy it to the application server or servlet engine as an application.

6	Restart the application server or servlet engine that runs Java Component.

How to set a default Java Component locale and time zone

The default locale and timezone for Java Components are set when you install it. To change the default settings, you modify the values of the DEFAULT_LOCALE and DEFAULT_TIMEZONE configuration parameters.

1	Extract the contents of the Actuate Java component WAR or EAR file into a temporary directory.

2	Using a UTF-8 compliant code editor, open the web.xml configuration file.

3	Navigate to the lines that define DEFAULT_LOCALE, similar to the following code:

<param-name>DEFAULT_LOCALE</param-name>

<param-value>en_US</param-value>

Change the current locale id, en_US in the above example, to the desired locale id in param-value. Valid locale id strings are listed in <context root>\WEB-INF\localemap.xml.

4	Navigate to the lines that define DEFAULT_TIMEZONE, similar to the following code:

<param-name>DEFAULT_TIMEZONE</param-name>

<param-value>America/Los_Angeles</param-value>

Change the current time zone id, Pacific Standard Time in the above example, to the desired default time-zone in param-value. Valid time zone id strings are listed in <context root>\WEB-INF\TimeZones.xml.

5	Save web.xml.

6	Recompress your Actuate Java Component WAR or EARfile using the Java jar utility and redeploy it to the application server or servlet engine as an application.

7	Restart the application server or servlet engine that runs Java Component.

Copyright Actuate Corporation 2012