BusinessObjects Enterprise Administrator's Guide

Configuring the Java Web Component Adapter

To configure the Java WCA you edit the web.xml file associated with the WCA:

• Windows: C:\Program Files\Business Objects\BusinessObjects Enterprise 11.5\java\applications directory
• UNIX: WEB-INF subdirectory of the webcompadapter.war archive file stored in the bobje_root/enterprise115/java/applications directory

For example, the context parameter that controls whether a group tree will be generated looks like this:

<context-param>

<param-name>viewrpt.groupTreeGenerate</param-name>

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

<desctiption>"true" or "false" value determining whether a group tree will be generated.</description>

</context-param>

To change the value of a context parameter, edit the value between the <param-value> </param-value> tags.

To configure web.xml

Note:    Your Java Web Application Server may provide tools to allow you to edit web.xml directly from an administrative console.Otherwise use the following procedure to configure web.xml.

1. Stop your application server.
2. Extract the web.xml file from the webcompadapter.war archive.
3. Edit the file by using a text editor such as Notepad or vi.
4. Reinsert the file into the WEB-INF directory in webcompadapter.war.

Tip:    To reinsert web.xml into WEB-INF using WinZip, right-click on the WEB-INF directory that contains your edited web.xml file and select "Add to Zip File...". Adding the file in this way ensures that it is placed in the correct directory inside the archive.

5. Restart your application server.

When you install more than one WCA, each webcomponentadapter.war file contains its own web.xml file containing configuration parameters for that WCA. However, you can only set the parameters listed in the following table individually for each WCA. The remaining parameters must be the same for all WCA in your system.

Context Parameter	Description
display-name	Equivalent to WCA name.
cspApplication.defaultPage	The default page that will be loaded if no filename is specified in a particular request.
cspApplication.dir	This is the real path to the directory containing the CSP/WAS application(s) that you would like to host. This is a required field.
connection.cms	This is the name (or name and port number) of the CMS that you would like your application(s) to connect to.
connection.listeningPort	This field defaults to the port that the WCA related servlets are running on.
log.file	Filename of the logfile including full real path to file, excluding extension. Defaults to WCA with no path
log.ext	File extension of logfile, defaults to .log
log.isRolling	Determines whether or not the logs will be rotated, defaults to true.
log.size	If log rolling is turned on, this will govern the max size before logfile is rotated. Accepted suffix: MB, KB and GB.
log.level	The default loglevel is "error."
log.entryPattern	Please refer to log4j documentation for accepted log entry patterns.