Optimizing Performance by Changing the Heap Size

Depending on your environment, you might need to change the heap size for your Java web application server. For example, if you see "OutOfMemory" errors in WebLogic, increase the heap size. If you need to reduce the memory requirement of the WebLogic Server, decrease the heap size.

By default, if you deploy Java web applications to a single managed server, EPM System Configurator sets the default heap size for the single managed server based on the machine's memory:

12 GB or more on machine, sets heap size at 8 GB
6 GB or more, up to but not including 12 GB, sets heap size at 4 GB
Under 6 GB on a 32-bit machine, sets heap size at 750 MB
Under 6 GB on a 64-bit machine, sets heap size at 1.536 MB

Changing the Heap Size

Use Windows Registry Editor to change the heap size of the Windows service. To change the heap size of a managed server on Windows:

On the machine hosting the product whose managed server you want to modify, open Windows Registry Editor: Select Start and then Run, enter regedit, and then click OK.
In Registry Editor, select HKEY_LOCAL_MACHINE, then SOFTWARE, then Hyperion Solutions, then ManagedServerName, and then WindowsServiceName_InstanceName.

For example, if you deployed a single managed server, select HKEY_LOCAL_MACHINE, then SOFTWARE, then Hyperion Solutions, then EPMServer0, and then HyS9EPMServer_InstanceName.

If you scaled out a single managed server, on the scaleout machine, select HKEY_LOCAL_MACHINE, then SOFTWARE, then Hyperion Solutions, then EPMServer1, and then HyS9EPMServer_InstanceName.

For example, if you deployed Oracle Hyperion Planning, select HKEY_LOCAL_MACHINE, then SOFTWARE, then Hyperion Solutions, then Planning0, and then HyS9Planning_InstanceName.

If you need a complete list of managed servers in your deployment, run a deployment report:

Navigate to EPM_ORACLE_INSTANCE/bin and execute the following command:
```
epmsys_registry report deployment
```
The report file (deployment_report_YYYYMMDD_HHMMSS.html) is stored in EPM_ORACLE_INSTANCE/diagnostics/reports.
Right-click JVMOptionX (where X is 1, 2, ...) whose value starts with -Xmx, and then select Modify.
In Value data, change the value to a value appropriate for your environment.
```
-XmxValuem
```
For example, to set the heap size to 8 GB, enter the following:
```
-Xmx8000m
```
Click OK.
Close Registry Editor.
Start Oracle Enterprise Performance Management System by selecting Start, then All Programs, then Oracle EPM System, then Foundation Services, and then Start EPM System.
Complete these steps for each managed server on each machine in the deployment.

For Linux machines or as an alternate method for Windows machine, change the heap size of a managed server in the product start script:

On the machine hosting the product whose managed server you want to modify, open the product's custom start script in a text editor:
```
EPM_ORACLE_INSTANCE/bin/deploymentScripts/setCustomParamsManagedServerName.bat|.sh
```
For example, to change the heap size for the Oracle Hyperion Foundation Services managed server, open /bin/deploymentScripts/setCustomParamsFoundationServices.bat|.sh.
Modify the entry that looks like this:
```
set USER_MEM_ARGS=-Xms128m -XX:PermSize=64m -XX:MaxPermSize=256m -Xmx512m
```
and edit the value for –XmxValuem to a value appropriate for your environment.
Save the file.
Rerun the script for the product after making changes.
Complete these steps for each managed server on each machine in the deployment.

Validating the Heap Size

To validate that the heap size is set correctly:

Log in to the WebLogic Administration Console using WebLogic administrator credentials. (http://WebLogic_Admin_Host:WebLogic_Admin_Port/console, for example: http://FNDHOST1:7001/console (or select Start, then All Programs, then Oracle WebLogic, then User Projects, then EPMSystem, and then Admin Server Console).
In the Domain Structure, expand Environment, and then select Servers.
In Summary of Servers, select ManagedServerName.
Click the Monitoring tab, and then the Performance tab.
In Java Virtual Machine Memory Utilization Statistics, review the Heap Size Max setting.