How to increase the heap size for the Assure Client

This article details how to increase the heap size for Assure Client if the user is encountering "java.lang.OutOfMemoryError Java heap space" errors.

Note that this only updates the memory settings for Assure Client executions. If you are using scripts within the server-util directory, then please see our article on How to increase the heap size for the Assure Client.

1. Navigate to the below location:

<install_folder>/InfogixClient/config/default/IA and open client.properties file

      2.  Within the client.properties file, locate the parameter "CLIENT_JAVA_OPTIONS" as shown below:     

#Oracle JVM or standard IBM JVM options:

CLIENT_JAVA_OPTIONS=-Djavax.net.ssl.trustStore=${KEYSTORE_PATH} -Djavax.net.ssl.trustStorePassword=<passwod_removed> -Xmx128m

       3.  "CLIENT_JAVA_OPTIONS" parameter as shown in step 2, the -Xmx128m option specifies the maximum amount of memory the Java VM can use during client execution. If the client issues a "java.lang.OutofMemoryError exception", default value -Xmx128m for the amount of memory will need to be increased to an optimum number till the no more "java.lang.OutofMemoryError exception” Below is an example of the "CLIENT_JAVA_OPTIONS" after increasing the default heap.

#Oracle JVM or standard IBM JVM options:

CLIENT_JAVA_OPTIONS=-Djavax.net.ssl.trustStore=${KEYSTORE_PATH} -Djavax.net.ssl.trustStorePassword=<passwod_removed> -Xmx512m

     4. Once the heap size for the JVM has been increased as outlined in step 3, navigate to the  <install_folder>/InfogixClient/bin and execute the below command use the following command to deploy the client:

deploy-client.sh IA for Linux or deploy-client.bat IA for windows

     5. Upon successful deployment of the client in step 4, execute the below command from the <install_folder>/InfogixClient/bin.

AboutAssure.sh IA for linux or AboutAssure.bat for windows

     6.  Now, assure executions can be tested after all the above steps have been completed successfully.