IBM Support

Setting the IBM_JAVA_OPTIONS environment variable if you have problems installing or starting OmniFind Enterprise Edition

Technote (FAQ)


After verifying that the necessary user rights are assigned to the enterprise search administrator ID or the user ID that is used to install OmniFind™ Enterprise Edition, either the installation program does not start or the enterprise search system does not start even if the installation program successfully completed.

How can this situation be resolved?


The IBM® Java™ default maxiumum heap size (max heap size) value varies per operating system. Because some of the enterprise search scripts do not have an explicit value for the max heap size, you might see error JVMST062, depending on your system configuration.


Even if the correct user rights are assigned to the enterprise search administrative user, you might experience the following problems:

  • The installation program does not start. The launchpad is displayed, but the next window disappears.
  • The installation appears to succeed, but the following message is logged when you enter the esadmin system startall or startccl commands:

    [ **Out of memory, aborting** ]
    [  ]
    [ *** panic: JVMST062: Cannot allocate memory in initializeFRBits() ]

    This application has requested the runtime to terminate it in an unusual way.
    Please contact the application's support team for more information.

Those symptom indicate that the Java Virtual Machine (JVM) cannot allocate memory when initializing and thus terminates.

Windows® workaround:
On Windows, the amount calculated for the max heap size is based on the physical memory. To work around this problem, set the IBM_JAVA_OPTIONS environment variable as follows. The environment variable must be set permanently as long as OmniFind Enterprise Edition runs on the system.
  1. Open the Control Panel and then open the System settings.
  2. Select the Advanced tab and then click the Environment variable button.
  3. Select System variable, add a new environment variable named IBM_JAVA_OPTIONS that has the value -Xmx256M, and save your changes.

To confirm that the IBM_JAVA_OPTIONS environment variable is set:
  1. Open a command window.
  2. Enter this command: 'set | find "IBM_JAVA_OPTIONS"'

Linux® workaround:
To work around this problem on Linux:
  1. Open a login shell console and enter this command: export IBM_JAVA_OPTIONS=-Xmx256M
  2. Continue with the installation program or enter the esadmin system startall or startccl command.

Related information

Problems installing or starting on Windows (V8.4)
Problems installing or starting on Windows (V8.5)

Historical Number


Document information

More support for: OmniFind Enterprise Edition

Software version: 8.4, 8.5

Operating system(s): Linux, Windows

Reference #: 1298523

Modified date: 09 July 2008