Step 2: Configure the Output Generator to use another version of the Open Toolkit

This procedure describes how to configure the Output Generator to use another version of the Open Toolkit.

It assumes that the new version of the Open Toolkit is stored in the following location:
%OutputGenDir%/data
And that the directory name follows this naming convention:
DITA-OTx.y.z
Where x.y.z is the Open Toolkit version number. For example:
C:\Ixiasoft\OutputGenerators\OutputGen_Prod_3.4\data\DITA-OT1.8
C:\Ixiasoft\OutputGenerators\OutputGen_Prod_3.4\data\DITA-OT1.6.2
To use another version of the Open Toolkit:
  1. Edit the %OutputGenDir%/conf/classpath.conf file and set the wrapper.java.classpath.43, wrapper.java.classpath.44, and wrapper.java.classpath.80 properties to point to the new DITA Open Toolkit path.

    For example:

    # DITA OT library and properties configuration
    wrapper.java.classpath.43=../data/DITA-OT1.8/lib/dost.jar
    wrapper.java.classpath.44=../data/DITA-OT1.8/lib
    
    ....
    
    # The FOP has to be pre-loaded to avoid duplication method behavior
    wrapper.java.classpath.80=../data/DITA-OT1.8/plugins/org.dita.pdf2/fop/build/fop.jar
  2. Edit the %OutputGenDir%/data/catalogs/catalog-dita-outgen.xml file and set the catalog attribute to the new DITA Open Toolkit path.
    For example:
    <?xml version="1.0" ?>
    <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"
       prefer="public">
       <nextCatalog catalog="../DITA-OT1.8/catalog-dita.xml"/>
    </catalog>
  3. Edit the %OutputGenDir%/data/outgen-init.xml file and set the ot.version attribute to the new version of the Open Toolkit.
    For example:
    <property name="ot.version" value="1.8"/>
  4. For versions 1.6.2 and up of the Open Toolkit:
    1. Edit the %OutputGenDir%/data/conductor-ixia.xml file.
    2. In the dita2reviewpdf target, look for the following block of lines:
      <case value="1.6.2">
         <antcall target="dita2reviewpdf162"/>
      </case>
    3. Duplicate this block of lines and set the value attribute to the new version of the Open Toolkit.
      For example:
      <case value="1.6.2">
         <antcall target="dita2reviewpdf162"/>
      </case>
      <case value="1.8">
         <antcall target="dita2reviewpdf162"/>
      </case>
      Note: The dita2reviewpdf162 target was developed for the DITA Open Toolkit version 1.6.2. You may be able to use it as is with the version of the Open Toolkit that you downloaded. However, it is also possible that the version of the Open Toolkit that you are using is not compatible with this target. In this case, you may need to create your own dita2reviewpdf target. Contact DITA CMS Support for more information.
    4. Repeat steps b and c for the dita2redlinepdfwrapper target.
  5. Restart the Output Generator service.
  6. To test your installation, generate an output using the Open Toolkit.