Troubleshooting
Problem
When you run an istool command, the out of memory error occurs. The issue might occur when you run commands with large amount of data, for example import, export, or query commands.
Symptom
In the following example, the istool query command fails and displays an OutOfMemoryError error in a JAVA heap message:
istool workbench query -domain myserver -username myname -password mypasswrd -queryname "BI Report Models"Initializing query engine .....JVMDUMP0061 Processing dump event "systhrow", detail "java/lang/OutOfMemoryError" - please wait.JVMDUMP0321 JVM requested Snap dump using '/data/IBM/InformationServer/Clients/istools/cli/Snap.2091125.10000Cause
By default, the max heap size that is configured for your computer is used. In case of some commands, this amount of memory is not sufficient, and commands fail.
Resolving The Problem
To resolve the issue, use the -Xmx parameter each time you run istool commands with large amount of data. This option specifies the max heap size to use to run the command. The value is the number of megabytes, with no spaces, ending with M to represent megabytes. For example:
export –dom ABC:9443 –username user1 –password pass1 -archive "c:\myarchive.isx" -Xmx1024M –all
In this example, the command sets the max heap size to 1024 MB to export all of the types of assets that are supported by the -all parameter.
Note: The -Xmx parameter increases the heap size temporarily, only as long as the command is run.
Was this topic helpful?
Document Information
Modified date:
23 June 2018
UID
swg21406714