How To Set/Increase the Essbase Administration Services (EAS) Debug Level

How To Set/Increase the Essbase Administration Services (EAS) Debug Level [ID 974043.1]
Modified 28-JUN-2011 Type HOWTO Status PUBLISHED
In this Document
Goal
Solution
References

Applies to:

Hyperion Essbase - Version: 9.3.1.0.00 to 11.1.1.3.00 - Release: 9.3 to 11.1
Information in this document applies to any platform.
Goal

How to set/increase the Essbase Administration Services (EAS) debug level.
Solution

These instructions apply only to EAS v9.3.x and v11.1.1x. For EAS v11.1.2.x, please refer to the "Oracle Hyperion Enterprise Performance Management System Installation and Configuration Troubleshooting Guide".

Windows:

On Windows environments, EAS is typically configured as a Windows Service. To enable/increase the EAS debugging, modifications to the the registry are required.

The following steps should be done with the assistance of a Technical Support Engineer. Prior to any installation, upgrade or modification, it is advised that a full backup be done of all related environments. This includes servers, file systems, repositories, databases and the registry within the related environments.

1. Open the registry.
2. Navigate to HKEY_LOCAL_MACHINE->SOFTWARE->Hyperion Solutions->aas->HyS9aas
3. Add two new JVMOption string values. For example, if JVMOption7 is the last one defined, add JVMOption8 and JVMOption9.
4. Set one with -DEAS_LOG_LEVEL=9999 and the other with a path to the log -DEAS_LOG_LOCATION=%ARBORPATH%\bin\easserver.log.
5. Modify the JVMOptionCount to include the two additional settings. Below is an example screen shot of the registry settings:




NOTE: In some versions, there is already a JVMOption# with these settings (see screen shot above). You can modify the JVMOption that contains the -DEAS_LOG_LEVEL setting and set the log level to 9999.


UNIX:

1. Navigate to the $HYPERION_HOME/deployments/{appserver}/bin directory (appserver is the name of the application server you deployed EAS to, i.e. Tomcat)
2. Using a text editor, i.e. vi, open the file setCustomParamsaas.sh.
3. Add the following parameters to the JAVA_OPTIONS field, replacing the path with one for your environment:

-DEAS_LOG_LEVEL=9999 -DEAS_LOG_LOCATION=/home/Hyperion/AnalyticAdministrationServices/server/bin/easserver.log

For example:
JAVA_OPTIONS="-DEAS_HOME=/home/Hyperion/AnalyticAdministrationServices -DESS_ES_HOME=/home/Hyperion/AnalyticAdministrationServices/server -DEAS_LOG_LEVEL=9999 -DEAS_LOG_LOCATION=/home/Hyperion/AnalyticAdministrationServices/server/bin/easserver.log $JAVA_OPTIONS"

NOTE: In some versions, the log level is already set to 5000 which is the minimum setting. Set this value to 9999 which is the maximum setting.

In some WebSphere deployments, the above does not apply. Please refer to Note:956313.1 for instructions specific for WebSphere.



References

NOTE:956313.1 - How To Set/Increase Essbase Administration Services (EAS) Debug Level With WebSphere

Attachments
EAS_Registry.JPG (47.35 KB)