Error messages and troubleshooting

In this section:

1. Error messages
   This topic defines all error messages generated by the DITA-OT.
2. Other error messages
   In addition to error messages generated by the DITA Open Toolkit, you might also encounter error messages generated by Java or other tools.
3. Log files
   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.
4. Accessing help from the command-line tool
   You can access a list of supported parameters for the command-line tool by issuing the -help parameter.
5. Determing the version of the DITA Open Toolkit
   You can use the command-line tool to determine the version of the DITA OT.
6. Enabling debug mode
   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.
7. Increasing Java memory allocation
   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.