| 1 | <?xml version="1.0" encoding="UTF-8"?>
|
|---|
| 2 | <!DOCTYPE html
|
|---|
| 3 | PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|---|
| 4 | <html xml:lang="en-us" lang="en-us">
|
|---|
| 5 | <head>
|
|---|
| 6 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
|
|---|
| 7 | <meta name="copyright" content="(C) Copyright 2005"/>
|
|---|
| 8 | <meta name="DC.rights.owner" content="(C) Copyright 2005"/>
|
|---|
| 9 | <meta name="DC.Type" content="reference"/>
|
|---|
| 10 | <meta name="DC.Title" content="Other error messages"/>
|
|---|
| 11 | <meta name="abstract" content="In addition to error messages generated by the DITA Open Toolkit, you might also encounter error messages generated by Java or other tools."/>
|
|---|
| 12 | <meta name="description" content="In addition to error messages generated by the DITA Open Toolkit, you might also encounter error messages generated by Java or other tools."/>
|
|---|
| 13 | <meta name="DC.Relation" scheme="URI" content="../readme/troubleshooting-overview.html"/>
|
|---|
| 14 | <meta name="DC.Format" content="XHTML"/>
|
|---|
| 15 | <meta name="DC.Identifier" content="troubleshooting"/>
|
|---|
| 16 | <meta name="DC.Language" content="en-us"/>
|
|---|
| 17 | <link rel="stylesheet" type="text/css" href="../commonltr.css"/>
|
|---|
| 18 | <link rel="stylesheet" type="text/css" href="../dita-ot-doc.css"/>
|
|---|
| 19 | <title>Other error messages</title>
|
|---|
| 20 | </head>
|
|---|
| 21 | <body id="troubleshooting">
|
|---|
| 22 |
|
|---|
| 23 |
|
|---|
| 24 | <h1 class="title topictitle1">Other error messages</h1>
|
|---|
| 25 |
|
|---|
| 26 |
|
|---|
| 27 | <div class="body refbody"><p class="shortdesc">In addition to error messages generated by the DITA Open
|
|---|
| 28 | Toolkit, you might also encounter error messages generated by
|
|---|
| 29 | Java or other tools.</p>
|
|---|
| 30 |
|
|---|
| 31 |
|
|---|
| 32 | <div class="section" id="troubleshooting__section_stj_4gj_wd"><h2 class="title sectiontitle">Out of Memory error</h2>
|
|---|
| 33 | <p class="p">In some cases, you might receive a message stating the build
|
|---|
| 34 | has failed due to an <samp class="ph msgph">Out of Memory</samp> error. Try the following
|
|---|
| 35 | approaches to resolve the problem:</p>
|
|---|
| 36 | <ol class="ol" id="troubleshooting__ol_rfb_c2p_qg">
|
|---|
| 37 | <li class="li">(For custom-configured environments, not the DITA-OT Full Easy
|
|---|
| 38 | Install) If you use Xalan as the default XSLT processor,
|
|---|
| 39 | switch to Saxon.</li>
|
|---|
| 40 |
|
|---|
| 41 | <li class="li">Increase the memory available to Java; see <a class="xref" href="increasing-the-jvm.html" title="If you are working with large documents with extensive metadata or key references, you will need to increase the memory allocation for the Java process. You can do this from the command-line prompt for a specific session, or you can increase the value of the ANT_OPTS environmental variable.">Increasing Java memory allocation</a>.</li>
|
|---|
| 42 |
|
|---|
| 43 | <li class="li">Reduce memory consumption by setting the <span class="keyword option">generate-debug-attributes</span>
|
|---|
| 44 | option to <samp class="ph codeph">false</samp>. This option is set in
|
|---|
| 45 | the <span class="ph filepath">lib/configuration.properties</span> file.
|
|---|
| 46 | This will disable debug attribute generation (used to trace DITA-OT
|
|---|
| 47 | error messages back to source files) and will reduce memory consumption.</li>
|
|---|
| 48 |
|
|---|
| 49 | <li class="li">Set <samp class="ph codeph">dita.preprocess.reloadstylesheet</samp> Ant property
|
|---|
| 50 | to <samp class="ph codeph">true</samp>. This will allow the XSLT processor
|
|---|
| 51 | to release memory when converting multiple files.</li>
|
|---|
| 52 |
|
|---|
| 53 | <li class="li">Run the transformation again.</li>
|
|---|
| 54 |
|
|---|
| 55 | </ol>
|
|---|
| 56 | </div>
|
|---|
| 57 |
|
|---|
| 58 | <div class="section"><h2 class="title sectiontitle">java.io.IOException: Can't store Document</h2>
|
|---|
| 59 | <p class="p">After running a JavaHelp transformation, you may receive a <samp class="ph msgph">java.io.IOException:
|
|---|
| 60 | Can't store Document</samp> message. </p>
|
|---|
| 61 | <p class="p">This problem occurs
|
|---|
| 62 | when HTML files unrelated to the current transformation are found
|
|---|
| 63 | in the output directory. Delete the content of the output
|
|---|
| 64 | directory and run the transformation again.</p>
|
|---|
| 65 | </div>
|
|---|
| 66 |
|
|---|
| 67 |
|
|---|
| 68 |
|
|---|
| 69 | <div class="section"><h2 class="title sectiontitle">Stack Overflow error</h2> <p class="p">If you receive an
|
|---|
| 70 | error about a stack memory overflow, increase the JVM and run the
|
|---|
| 71 | transformation again. See <a class="xref" href="increasing-the-jvm.html" title="If you are working with large documents with extensive metadata or key references, you will need to increase the memory allocation for the Java process. You can do this from the command-line prompt for a specific session, or you can increase the value of the ANT_OPTS environmental variable.">Increasing Java memory allocation</a>.</p>
|
|---|
| 72 | </div>
|
|---|
| 73 |
|
|---|
| 74 | </div>
|
|---|
| 75 |
|
|---|
| 76 | <div class="related-links">
|
|---|
| 77 | <div class="familylinks">
|
|---|
| 78 | <div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../readme/troubleshooting-overview.html" title="This section contains information about problems that you might encounter and how to resolve them.">Error messages and troubleshooting</a></div>
|
|---|
| 79 | </div>
|
|---|
| 80 | </div>
|
|---|
| 81 |
|
|---|
| 82 | </body>
|
|---|
| 83 | </html>
|
|---|
