| 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="task"/>
|
|---|
| 10 | <meta name="DC.Title" content="Error messages and troubleshooting"/>
|
|---|
| 11 | <meta name="abstract" content="This section contains information about problems that you might encounter and how to resolve them."/>
|
|---|
| 12 | <meta name="description" content="This section contains information about problems that you might encounter and how to resolve them."/>
|
|---|
| 13 | <meta name="DC.Relation" scheme="URI" content="../readme/DITA-readme.html"/>
|
|---|
| 14 | <meta name="DC.Relation" scheme="URI" content="../readme/DITA-messages.html"/>
|
|---|
| 15 | <meta name="DC.Relation" scheme="URI" content="../readme/DITA-troubleshooting.html"/>
|
|---|
| 16 | <meta name="DC.Relation" scheme="URI" content="../readme/DITA-log.html"/>
|
|---|
| 17 | <meta name="DC.Relation" scheme="URI" content="../readme/accessing-help-from-the-cl-tool.html"/>
|
|---|
| 18 | <meta name="DC.Relation" scheme="URI" content="../readme/determining-version-of-ditaot.html"/>
|
|---|
| 19 | <meta name="DC.Relation" scheme="URI" content="../readme/enabling-debug-mode.html"/>
|
|---|
| 20 | <meta name="DC.Relation" scheme="URI" content="../readme/increasing-the-jvm.html"/>
|
|---|
| 21 | <meta name="DC.Format" content="XHTML"/>
|
|---|
| 22 | <meta name="DC.Identifier" content="task_pd3_vdv_qg"/>
|
|---|
| 23 | <link rel="stylesheet" type="text/css" href="../commonltr.css"/>
|
|---|
| 24 | <link rel="stylesheet" type="text/css" href="../dita-ot-doc.css"/>
|
|---|
| 25 | <title>Error messages and troubleshooting</title>
|
|---|
| 26 | </head>
|
|---|
| 27 | <body id="task_pd3_vdv_qg">
|
|---|
| 28 |
|
|---|
| 29 |
|
|---|
| 30 | <h1 class="title topictitle1">Error messages and troubleshooting</h1>
|
|---|
| 31 |
|
|---|
| 32 | <p class="shortdesc">This section contains information about problems that you might encounter and how to
|
|---|
| 33 | resolve them.</p>
|
|---|
| 34 |
|
|---|
| 35 | <div class="related-links">
|
|---|
| 36 | <ul class="ullinks">
|
|---|
| 37 | <li class="link ulchildlink"><strong><a href="../readme/DITA-messages.html">DITA-OT error messages</a></strong><br/>
|
|---|
| 38 | The error messages generated by the DITA Open Toolkit contain a message ID, severity information, and message text. This topic lists each error message generated by the toolkit and provides additional information that might be helpful in understanding and resolving the error condition.</li>
|
|---|
| 39 | <li class="link ulchildlink"><strong><a href="../readme/DITA-troubleshooting.html">Other error messages</a></strong><br/>
|
|---|
| 40 | In addition to error messages generated by the DITA Open Toolkit, you might also encounter error messages generated by Java or other tools.</li>
|
|---|
| 41 | <li class="link ulchildlink"><strong><a href="../readme/DITA-log.html">Log files</a></strong><br/>
|
|---|
| 42 | When you run the DITA-OT, key information is logged on the screen. This information also is written to a log file. If you encounter a problem, you can analyze this information to determine the source of the problem and then take action to resolve it.</li>
|
|---|
| 43 | <li class="link ulchildlink"><strong><a href="../readme/accessing-help-from-the-cl-tool.html">Accessing help from the command-line tool</a></strong><br/>
|
|---|
| 44 | You can access a list of supported parameters for the command-line tool by issuing the <span class="keyword parmname">-help</span> parameter.</li>
|
|---|
| 45 | <li class="link ulchildlink"><strong><a href="../readme/determining-version-of-ditaot.html">Determing the version of the DITA Open Toolkit</a></strong><br/>
|
|---|
| 46 | You can use the command-line tool to determine the version of the DITA OT.</li>
|
|---|
| 47 | <li class="link ulchildlink"><strong><a href="../readme/enabling-debug-mode.html">Enabling debug mode</a></strong><br/>
|
|---|
| 48 | When the debug mode is enabled, additional diagnostic information is written to the log file. This information, which includes environment variables and stack trace data, can help you determine the root cause of a problem.</li>
|
|---|
| 49 | <li class="link ulchildlink"><strong><a href="../readme/increasing-the-jvm.html">Increasing Java memory allocation</a></strong><br/>
|
|---|
| 50 | 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.</li>
|
|---|
| 51 | </ul>
|
|---|
| 52 |
|
|---|
| 53 | <div class="familylinks">
|
|---|
| 54 | <div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../readme/DITA-readme.html" title="The DITA Open Toolkit User Guide is designed to provide basic information about the DITA-OT. It is geared for an audience that needs information about installing, running, and troubleshooting the toolkit. It contains documentation of the DITA-OT parameters; it also contains release notes and information about what components have been tested.">DITA Open Toolkit User Guide</a></div>
|
|---|
| 55 | </div>
|
|---|
| 56 | </div>
|
|---|
| 57 |
|
|---|
| 58 | </body>
|
|---|
| 59 | </html>
|
|---|
