28.4 Troubleshooting a Java Heap Space Exception

If you encounter a Java heap space exception during the database migration because of low memory:

  1. Edit the ZENworks_installation_path\bin\novell-zenworks-configure.bat file on Windows or /opt/novell/zenworks/bin/novell-zenworks-configure on Linux to change the heap space value in the following line, depending upon the RAM of the device where the migration utility is running:

    "%JAVA_HOME%\bin\java" -Djava.library.path=%ZENLIB% -cp "%MYCP%" %DEBUG_OPTS% %JAVA_OPTS% -Xmx1024m com.novell.zenworks.configure.ConfigureLoader %CONFIG_OPTS%

    The heap space value is represented in megabytes (MB) within -Xmx1024m. By default, it is 1024.

    For example, if the RAM of the device is 2048 MB, then the line in the novell-zenworks-configure.bat file can be updated as follows:

    "%JAVA_HOME%\bin\java" -Djava.library.path=%ZENLIB% -cp "%MYCP%" %DEBUG_OPTS% %JAVA_OPTS% -Xmx2048m com.novell.zenworks.configure.ConfigureLoader %CONFIG_OPTS%

    IMPORTANT:The heap space value must be either equivalent to or less than the RAM of the device. It is recommended to have a minimum 2048 MB to continue with database migration.

  2. At the console prompt, run the ZENworks_installation_path\bin\novell-zenworks-configure.bat file on Windows or /opt/novell/zenworks/bin/novell-zenworks-configure on Linux.

  3. Follow the prompts.

    When you are prompted to enter the location of the file required for resuming the migration, enter the the complete path of DBMigration.xml. The file is located in the ZENworks_installtion_path\bin directory on Windows, and in the /opt/novell/zenworks/bin directory on Linux.

    The XML file contains a list of tables and a flag indicating whether the table was successfully migrated or not. When the database migration resumes, only the tables with flag value set to False are migrated.