Newbie Open Toolkit installation problem

I read about DITA concepts; now, I want  to see some working samples to find out what I can do with DITA, and how. 

So I'm now trying to install the Open Toolkit 1.2.2, on Windows, as per insturctions found here;

I'm encoutering two problems.

1) After I've downloaded and installed all the various components in the C:\ paths as directed, I'm supposed to set the environment variables.

    Substep c) for "If you use Saxon" says;

     Set up ANT_OPTS. For example:
  set ANT_OPTS=%ANT_OPTS% - Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl

    I don't understand how exactly I do this. Am I still setting an environmental variable?

2) With everything else but the above complete in the installation process, I went on to the next step, "Testing DITA Installation".

    This is what I get;

     C:\ditaot\build.xml:143 The following error occurred while executing this line:
     C:\ditaot\conductor.xml:354 The following error occurred while executing this line:
     C:\ditaot\ditatargets.xml:120 The following error occurred while executing this line:
     java.lang.NoClassDefFoundError: org/apache/batik/util/XMLResourceDescriptor

     What have I missed?

Sorry if these are obvious for techies. Thank you in advance.

- Yosuke



The exception of NoClassFoundError indicate that batik.jar is not included in classpath. Batik is used by FOP. If you're using FOP 0.20.5, please check the CLASSPATH and include fop.jar, avalon-framework-cvs-20020806.jar and batik.jar. For example, if you installed fop at c:\fop. You need to make sure that the following string
appear in your CLASSPATH.

Best Regards,

I figured it out.

Okay, so this is from one newbie to other newbies who might face the same problem.

- I had CLASSPATH defined for both XSLT processors (Saxon and Xalan), but I should only setup CLASSPATH for either.

- The *exact* procedure to "Set up ANT_OPTS", necessary when using Saxon, described consistently as the other environment variable settings, would be as follows;

  1. Click on New under the System variables section.
  2. Type %ANT_OPTS% in the variable name field.
  3. Type -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl in the variable value field.

- After installation, when you follow the insturctions found in "Testing DITA Installation" and do a ant all, you'll get a BUILD FAILED after a while --well, I did--, when building the "langref" demo, on either XSLT processor.

  But the problem seems to be only for this case; build fails when I do ant demo.langref, but successful for all other demos, docs, and samples. So I figure I  got passed installation.




Hi everyone,

I've been reading this post with great interest because I am myself experiencing some problems with the DITA Open Toolkit from the very beginning. I installed everything and followed all the instructions, but whatever I do, I get a BUILD FAILED message when I try to test the installation. I have not been able to find an answer, let alone figure out myself what I've done wrong.

So when I get the c:\ditaot> prompt, I type ant all, and then I get the following:

        Buildfile: build.xml
       Target 'all' does not exist in this project.

       Total time: 3 seconds

Anyone able to help?

Thanks a lot!!!

Thanks for figuring out the ANT_OPTS thing! I had the same issue.

I still get BUILD FAILED when everything is finished with this message:

C:\ditaot\build.xml:282: The following error occurred while executing this line: C:\ditaot\conductor.xml:350: The following error occurred while executing this l ine: java.lang.OutOfMemoryError

I guess it doesn't matter if the build passed or failed at this point since I'm just noodling to get a jump start on my company's imminent DITA migration, but does anyone have an idea what I'm doing wrong here?

This error is caused by JVM heap memory limits. When you're trying to transform a large document to PDF, the memory usage would be very  high. Sometimes exceed the default limit of 64MB in JVM. In this case, you need to adjust the limits to higher level. Please try to add string " -Xmx256m " in ANT_OPTS and try again. Thanks.
Note: the quotation mark shouldn't be inlcuded in ANT_OPTS.

Best Regards,
Stephen Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I