Configuration Settings in BPMA_Server_Config.xml

In This Section:

Changing the Connection Time Out Setting

The BPMA_Server_Config.xml file has two main elements, DimensionServer and log4net. The DimensionServer section contains settings that are specific to internal workings of the Dimension Server and other related components. The log4net section contains settings that are used by the log4net module, which is used to log warnings, errors, and so on. You can find the BPMA_Server_Config.xml file in: <EPM_ORACLE_INSTANCE>\config\EPMA. The following is an excerpt of the BPMA_Server_Config.xml file:

<?xml version="1.0" encoding="utf-8" ?>
<Config>
  <DimensionServer>
    <Data_Access_Layer>
      <ConnectRetries>3</ConnectRetries>
      <ConnectRetryTimeout>30</ConnectRetryTimeout>
          <CommandTimeout>900</CommandTimeout>
          <UseWindowsAuthentication>false</UseWindowsAuthentication>
    </Data_Access_Layer>
   
   <SessionManager>
        <ClassPath>%EPM_ORACLE_HOME%\products\Foundation\BPMA\AppServer\DimensionServer\ServerEngine\bin\awbutil.jar;%EPM_ORACLE_HOME%\products\Foundation\BPMA\AppServer\DimensionServer\ServerEngine\bin\CASSecurity.jar;%EPM_ORACLE_HOME%\common\jlib\11.1.2.0\epm_j2se.jar;</ClassPath>

Note:

Some descriptions in the following table indicate a default value, which are automatically pre-populated when you install Performance Management Architect. Do not leave settings blank unless noted.

The following table shows the parameter, description, and default setting for settings in BPMA_Server_Config.xml.

Parameter	Description	Default Setting
DimensionServer	Contains settings specific to internal workings of the Dimension Server and other related components, such as Session Manager.
Data_Access_Layer	Contains values that are used to create a connection to a database if the connection details cannot be retrieved from Shared Services. All Performance Management Architect components connect to the Performance Management Architect database using the same settings. The following settings are in the Data_Access_Layer: ConnectRetries—The number of times that a connection to the database will be attempted before an exception (error) is thrown ConnectRetryTimeout—The number of seconds between each database connection retry. CommandTimeout—The number of seconds that will elapse after sending a query to the database before a database error is reported. The default value is 900 which is 900 seconds or 15 minutes. UseWindowsAuthentication—For SQL Server databases only. If set to True, this setting uses Windows authentication. If set to False, SQL Server authentication is used.
EPMATempFilePath	The directory where the following Performance Management Architect temporary files are stored. If OutputExportDocuments is set to False (default), the final export results are written to: FinishedDeploymentDocument.xml in the folder set in the EPMATempFilePath. If OutputExportDocuments is set to True, the final export results are written to: FinishedDeploymentDocument.xml in the folder set in ExportXSLPath. The default location is: <EPM_ORACLE_INSTANCE>\tmp\EPMA.
SessionManager	Contains values that are used by the Session Manager service to connect to Shared Services through the NetJNIBridge Service. Oracle Hyperion Shared Services is used by the Session Manager to retrieve user authentication, group, role, rights information, database connection information, and so on.
JavaMinHeap	Located in the SessionManager section. This setting stores the minimum value for the JVM heap memory at initiation. The maximum value that you can define is 256m.	16m
JavaMaxHeap	Located in the SessionManager section. This setting stores the maximum value for the JVM heap memory at initiation. The maximum value that you can define is 1024m.	512m
EnableNestedGroups	Set to True to indicate that when group memberships are requested for a particular user, any nested groups are returned along with top-level groups. Set this to False to indicate that when group memberships are requested for a particular user, only top-level groups are returned (no nested groups are included).	True
NetJNIBridgePort	Port number used by the NetJNIBridge service to communicate with the SessionManager service.	5255
NetJNIBridgeHost	Name of the physical machine where the NetJNIBridge service is running. The name can be localhost if NetJNIBridge is running on the same machine as the Dimension Server.
Port	Port number that the EPMA Server listens on.	5251
DimensionServerStartupTimeout	The number of seconds to wait for an instance of the dimension server to start before throwing an exception.	300
ExportCompressionThreshold	The maximum number of bytes in size for an exported application before the export is compressed.	102400
ExportXSLPath	The path to the .XSL files that are used to format application exports.
OutputExportDocuments	Enables or disables the creation of files in the file system during an application export (which is part of deployment). By default, it is disabled and set to False. To enable it, set the value to True.	False
ProductMetadataPath	The path to the .XML files that define the product metadata. This is used by the Dimension Server to load property definitions, and so on.
CustomMetadataPath	(Deprecated)
Validations	Contains values that are used to control validations. Contains the following settings: Application, MaxReportedErrors, MaxReportedWarnings, and DefaultMessages.
Application	Contains values to are used to control application validations.
MaxDeploymentHistoryEntries	Add this setting to override the maximum number of application deployment history entries. The value entered must be greater than 1.	10
MaxReportedErrors	The maximum number of errors that will be recorded when an application is validated.	5000
MaxReportedWarnings	The maximum number of warnings that are recorded when an application is validated.	5000
DefaultMessages	The maximum number of combined errors and warnings that are reported to the user when an application is validated.	25
AutoCleanupTemporary ApplicationsStartTime AutoCleanupTemporary ApplicationsMinimumAge	Control how the server automatically cleans up temporary applications. Temporary applications are used by the Application Creation Wizard, and if a temporary application is not properly cleaned up, it might never get removed. By default, the server automatically removes any applications marked as "temporary," at 4:00:00 (4 am). Note: The time is in local time, military format. For example, the format for 2:30 p.m. is entered as 14:30:00. You can adjust the time by modifying the AutoCleanupTemporaryApplicationsStartTime setting. By default, applications that are older than 24 hours are included for cleanup. The minimum age of an application can be modified by setting the AutoCleanupTemporaryApplicationsMinimumAge value in number of minutes.	AutoCleanupTemporaryApplicationsStartTime default is 4:00:00. AutoCleanupTemporaryApplicationsMinimumAge default is 1440.
PurgeBaselineStartTime	Sets the time when the automatic purging of baselines that are no longer needed begins. By default, it is at 3:00 a.m. local time (entered as 3:00:00). Note: The time is in local time, military format. For example, the format for 2:30 p.m. is entered as 14:30:00.	3:00:00
ImportErrorThreshold	Maximum number of combined errors and warnings that can occur before a running import shuts down.	Default value: 1000 Minimum value: 0 No maximum value defined
ExcludedMemberLimit	Limits the number of members returned by the EnumExcludedMembers() API call.	Default value: 5000 Minimum value: 0 Maximum value: 5000
log4net	Contains settings used by the log4net module to log errors, debug information, and so on. Caution! Do not change values in this section unless specifically directed by Oracle Customer Support.