Common Problems

Memory Problems

Java Heap Space

If you see messages that refer to "Java Heap Space" while running the compiler, then the java virtual machine does not have enough memory to compile the given templates. You must increase the amount of memory allocated to the java virtual machine when you start the compiler. See the section [Doc/compiler/running Running the Compiler] for how to specify the VM memory.

Slow Compilation

If the compilation appears to be slow, check that the compiler is not thrashing because of a limited amount of memory. With the verbose option set, successful compilations will produce a summary like:

48 templates
517/0/517 compiled, 48/48 built
0/0 obj, 48/48 xml, 48/48 dep
0 errors, 31289 ms, 86 MB/506 MB heap, 11 MB/112 MB nonheap

The last line with gives the maximum amount of heap memory used and the maximum available (the value marked "heap"). If the maximum used is more than about 80% of the maximum, then you should consider increasing the memory allocated to the java virtual machine. See the section [Doc/compiler/running Running the Compiler] for how to specify the VM memory.