Out Of Memory (OOM) errors occur on an AdobeLiveCycle ES Update 1 JBoss turnkey installation. This issue is related to the MySQL JDBC driver version and the data source connection settings.
Caution: This update is strongly recommended.
Connection checking for the IDP_DS data source has been introduced in LiveCycle ES Update 1. Due to how connection checking is done by MySQL JDBC drivers prior to version 3.22.1 and how JBoss handles the validation result set, heap memory is being used with the JDBC driver, causing multiple open result sets. Because the JDBC driver installed as part of the turnkey installation is version 3.1.12, you must perform the tasks described in this article.
You must obtain and install version 5.1.6 of the JDBC driver to reduce the number of open result sets and resolve the out of memory issues. You must also change the data source and JVM settings.
- Obtain version 5.1.6 of the JDBC driver from the MySQL site by downloading the driver distribution kit mysql-connector-java-5.1.6.zip.
The data source settings as defined in the adobe-ds.xml file are intended for a heavy load with many concurrent connections and a long idle connection timeout (10 minutes). This results in a large number of prepared statements being cached on the heap. Reducing the idle connection timeout, the number of maximum open connections, and the size of the prepared statement cache for IDP_DS and EDC_DS will result in a reduction of heap memory allocated to the JDBC connections.
The JBoss turnkey install sets a number of JVM arguments in the run.bat file and in the JBoss for Adobe LiveCycle ES service definition. After you have updated the JDBC driver, you can modify the run.bat file.
To modify the JBoss for Adobe LiveCycle ES service definition you must uninstall and reinstall the service with new JVM arguments specified.
The JBoss server is configured using a batch file, InstallJBossService.bat that is created during system installation. During the turn-key setup of LiveCycle, LiveCycle PDF Generator ES support for native document conversion is an optional feature. The batch file will vary slightly, depending on whether you have enabled this feature.
If during the installation you chose to include this feature, then you will have entered a username and password into the LiveCycle setup. You will need to use this username and password to complete the reinstallation of the JBoss service.
- Check if the last part of the .bat file contains -user %1 -password %2. If so, native document conversion has been configured and you will need to enter the username and password when you reinstall the service.
Note: This is not the JBoss service user but the user credentials for the account used to install the native application software (such as Microsoft Office).
- Save and close the file.
Note: You will need the username and password that the service is using. To find the username, open the Services control panel, right-click JBoss for Adobe LiveCycle ES, select Properties from the menu and select the Log On tab. The same username and password combination should be used as during the original install.
- Reinstall the service. If native document conversion is enabled you will specify the username and password by entering the following command:
InstallJBossService [domain\username] [password]
Where [domain\username] and [password] are the credentials used during the original installation. If the ID is a local user, then it will be specified using the syntax MACHINENAME\USERNAME. A domain login ID must be specified as DOMAIN\USERNAME.
If native document conversion is enabled you will reinstall the service without specifying a login name using the following command:
InstallJBossService
Keywords:
kb406231
Twitter™ and Facebook posts are not covered under the terms of Creative Commons.
