How can I prevent Java heap space errors when performing large client actions like publishing, localizing, and DRM cloning?

You can increase the amount of memory allocated to DITA CMS.

Symptom

When publishing, localizing, or DRM cloning a large map, a java.lang.OutOfMemoryError: Java heap space error appears.

Problem

The DITA CMS Eclipse Client is running out of memory.

Solution

  1. Close DITA CMS.
  2. In your Eclipse folder, edit the eclipse.ini file.
  3. Increase the -Xmx1024m value to -Xmx2048m.
  4. Try the localize, publish, or DRM clone operation again.
  5. If it still fails, increase the value to either -Xmx3072m, -Xmx4096m, -Xmx5120m, or -Xmx6144m. We recommend trying the increase one value at a time to reserve as little memory as possible.
    Note: In order to increase the memory allocated, make sure that you have enough physical RAM installed on your computer.
  6. After each failed attempt, the partially created content needs to be removed from DITA CMS. Contact IXIASOFT Support if you need assistance.