Oracle® Business Intelligence Presentation Services Administration Guide > Administering Oracle BI Presentation Services > Using the Javahost Service in Oracle BI Presentation Services >

Configuring the Javahost Service


To configure the Javahost service, you edit Javahost Service configuration elements in the following files:

Javahost Service Configuration Elements in the config.xml file

Table 7 lists and describes the Javahost service elements in the Javahost configuration file (config.xml). The elements are identified by their relative path starting from the /JavaHost element.

Table 7. Javahost Service Configuration Elements in config.xml
Element
Description

Loaders

Contains the following elements:

  • ListOfEnabledLoaders
  • Loader (there can be multiple Loader elements)

Loaders/ListOfEnabledLoaders

List of components (such as PDF, Charts, Oracle BI Publisher, and so on) to be enabled.

If this element is missing from the file, then all Loaders are enabled. If the element has an empty value, then all loaders are disabled.

Each component has a corresponding Loader element. The name of the component listed here must match the name specified in the corresponding Loader/Name element.

Loaders/Loader

Contains the following elements, which specify configuration information for a specific component:

  • Name
  • Class
  • ConfigNodePath
  • ClassPath

Loaders/Loader/Name

Specifies the unique name of the component. Use this name in the ListOfEnabledLoaders.

Loaders/Loader/Class

Specifies the Loader main class for the component.

Loaders/Loader/ConfigNodePath

Specifies the XPath (starting from the /Javahost element) to the configuration information for the Loader

Loaders//Loader/ClassPath

Specifies the class path.

MessageProcessor

Contains the SocketTimeout element.

MessageProcessor/SocketTimeout

Specifies the idle timeout (in milliseconds) for socket after which socket is returned to the idle sockets pool. Javahost uses a socket polling mechanism to wait for new data on the whole set of idle sockets in a single thread.

Default: 5000 (5 seconds)

Listener

Contains the following elements:

  • PermittedClientList
  • Port
  • Address
  • Secure

Listener/PermittedClientList

Specifies a list of IP addresses and host names from which Javahost accepts incoming connections. Separate each client by a comma. To accept all client connections, set this element to an asterisk (*).

Default: *

Listener/Port

Identifies the Javahost TCP/IP listening port.

Default: 9810

For information on using the Hosts/Host element to identify specific instances of Javahost processes, see Oracle Business Intelligence Enterprise Edition Deployment Guide.

Listener/Address

Specifies the network interface that Javahost is to bind to. If this element has no value, Javahost will bind to all available network interfaces.

Listener/Secure

Specifies whether to enable SSL encryption:

  • Yes: Enables SSL encryption
  • No: Disables SSL encryption

Default: No

For more information on SSL, see Oracle Business Intelligence Enterprise Edition Deployment Guide.

Charts

Contains the following elements:

  • InputStreamLimitInKB
  • ChartRoot
  • CordaRoot
  • EnableConsoleOutput

Charts/InputStreamLimitInKB

Specifies the maximum input size for charts requests. A value of zero deactivates this limit. If you cannot generate a chart using the default value, slowly increase this setting until you find the optimum value.

Default: 1024

Charts/ChartRoot

Specifies the path to the Corda chart_root directory.
Default:{CordaRoot}/chart_root.

Charts/CordaRoot

Specifies the path to the Corda installation.
Default: SAROOTDIR/Corda50
(where SAROOTDIR is the installation directory)

Charts/EnableConsoleOutput

Specifies whether to enable the Corda console diagnostic messages:

  • Yes: Enables the Corda console diagnostic messages
  • No: Disables the Corda console diagnostic messages

Default: No

Scheduler

Contains these elements:

  • Enabled
  • DefaultPurgingPeriod

Scheduler/Enabled

Specifies whether to enable Scheduler:

  • True: Enables Scheduler
  • False: Disables Scheduler

Default: False

Scheduler/DefaultUserJarFilePath

Specifies the default directory for users to put their Java extension utility jar files in.

When Scheduler is enabled, this element is required and accepts a single path.

Scheduler/DefaultTempFilePath

Specifies the default temporary file directory for Scheduler requests.

Default: {systemtempdir}
(where {systemtempdir} is the system temp directory)

Scheduler/DefaultPurgingPeriod

Specifies the default purging period (in seconds) for Scheduler requests to clean up failed jobs.

Default: 300

XMLP

Contains the InputStreamLimitInKB element.

XMLP/InputStreamLimitInKB

Specifies the maximum input size for Oracle BI Publisher requests. A value of zero deactivates this limit.

Default: 8192

Javahost Service Configuration Elements in the instanceconfig.xml File

Table 8 lists and describes the Javahost service elements in the Oracle BI Presentation Services configuration file (instanceconfig.xml). The elements are identified by their relative path starting from the /WebConfig/ServerInstance element.

Table 8. Javahost Service Configuration Elements in instanceconfig.xml
Element
Description

JavaHome

Specifies the path to the root directory of JDK or JRE installation.

Default: Value of JAVA_HOME environment variable

JavaHost/InitLoggerDir

Specifies the absolute path to the directory where sawjavahostsvc.exe writes log information before it loads java. If the value of this element is empty, logging is disabled.

Default: SADATADIR/web/log/javahost (where SADATADIR is the data directory).

JavaHost/JniLibrary

Specifies the absolute path to jvm.dll.

Default: {JavaHome}/jre/bin/server/jvm.dll
If that file does not exist, then:
{JavaHome}/bin/server/jvm.dll, where {JavaHome} is the path to JDK or JRE installation.

JavaHost/JVMOptions

Specifies the Java command line parameters.
Default: -Xms128m -Xmx256m -Xrs "-Djava.class.path={CLASSPATH}"
"-Djava.awt.headless=true"
"-Djava.util.logging.config.file=
{JAVAHOSTROOTDIR}/config/logconfig.txt" where {CLASSPATH} is the list of javahost jar files separated by semicolons and {JAVAHOSTROOTDIR} is the Javahost root directory SADATADIR/web/javahost

JavaHost/UseDefaultJVMOptions

Specifies whether to use the default JVMOptions:

  • Yes: Merges the value of the JavaHost/JVMOptions element with its default value.
  • No: Uses the value of the JavaHost/JVMOptions element, which specifies the exact command line for Java.

Default: Yes

Oracle® Business Intelligence Presentation Services Administration Guide Copyright © 2007, Oracle. All rights reserved.