Download another version of DITA-OT

The DITA Open Toolkit website provides all the DITA-OT versions.

When you download a new version of the DITA Open Toolkit, it must be stored in the %OutputGenDir%/data folder, with the following naming convention:

  • DITA-OT 1.x family: DITA-OTversion
  • DITA-OT 2.x and 3.x family: dita-ot-version
Note: These folder names are those defined by the DITA-OT. IXIA CCMS Output Generator assumes that the DITA-OT files are stored in a directory that follows this naming convention.

Leave the folder name as-is when you extract the zip file

where

  • version is the DITA-OT version number
  • [version] is replaced by the CCMS Output Generator release version number
C:\Ixiasoft\OutputGenerators\OutputGen_Prod_[version]\data\DITA-OT1.8.5
C:\Ixiasoft\OutputGenerators\OutputGen_Prod_[version]\data\dita-ot-2.5.4
C:\Ixiasoft\OutputGenerators\OutputGen_Prod_[version]\data\dita-ot-3.4.1

To download another version of DITA-OT:

  1. Go to the DITA Open Toolkit download website. See http://www.dita-ot.org/download.html.
  2. Download the package for the relevant version of the DITA-OT.
    Note: The DITA-OT is packaged as a Windows .zip or Linux .tar.gz file.
  3. Extract the file to the %OutputGenDir%/data folder, keeping the folder name as-is.
  4. Copy the following plug-ins from the %OutputGenDir%/data/dita-ot-2.5.4/plugins directory, or whichever DITA-OT you have been using, to the %OutputGenDir%/data/%NewOT_Dir%/plugins directory, such as %OutputGenDir%/data/dita-ot-3.4.1/plugins.
    • com.ixiasoft.dita13.dtd
      Note: If you use DITA 1.2, the filename is com.ixiasoft.dita.dtd
    • com.ixiasoft.images
    • com.ixiasoft.pdf.review20
    • org.w3c.mathml3
      Note: File present only if you use DITA 1.2
    • org.oasis-open.dita.mathml.doctypes
      Note: File present only if you use DITA 1.2
    • org.w3c.svg1.0
    • org.w3c.svg1.1
    • org.w3c.html.doctypes
    • org.w3c.xhtml.doctypes
  5. Copy your custom plugins from your previous DITA-OT plugins folder, such as your custom DTD and output plugins, to the plugins folder of the new DITA-OT.
    Note: If you developed your custom output plugins for an earlier version of the DITA-OT, they might not work with a newer version. You may need to upgrade your plugins to use a newer version of the DITA-OT.
  6. Copy any custom DITA-OT changes from %OutputGenDir%/data/%OldOT_Dir%/resource to %OutputGenDir%/data/%NewOT_Dir%/resource. See the DITA-OT documentation.
  7. Make a copy of one of the following files in the %OutputGenDir%/data/ subfolder of the CCMS Output Generator.
    • For Windows, copy one of the _DITA-OT-x.x.x-integrator.bat or _DITA-OT-x.x.x-install.bat files
    • For Linux, copy one of the _DITA-OT-x.x.x-integrator.sh or _DITA-OT-x.x.x-install.sh files
  8. Change the file's name to reflect the version of the new DITA-OT for install.
  9. Edit the file to change the DITA-OT version number.
    • For Windows, edit line 23 of the .bat file.
    • For Linux, edit line 19 of the .sh file.
  10. Run the DITA-OT integrator.
    This step depends on the DITA-OT family.
    DITA-OT 1.x family:
    • If the version is lower than 1.6.2, contact IXIA CCMS Customer Support.
    • Windows: In the %OutputGenDir%/data/ directory, double-click the _DITA-OT-1.x.x-integrator.bat file.
    • Linux:
      1. In the %OutputGenDir%/data/%OT_Dir%/ directory, run the following command as root:
        startcmd.sh
      2. At the command prompt, enter:
        ant -f integrator.xml

    The integration build runs, and you should soon see BUILD SUCCESSFUL.
    DITA-OT 2.x and 3.x family:
    • Windows: In the %OutputGenDir%/data/ directory, double-click the _DITA-OT-x.x.x-install.bat.
    • Linux: In the %OutputGenDir%/data/ directory, double-click the _DITA-OT-x.x.x-install.sh.

    The integration build runs, and you should soon see BUILD SUCCESSFUL.
    Note: For error notifications similar to this one, take the appropriate action.
    Unable to locate tools.jar. Expected to find it in C:\Program Files\Java\jre6\lib\tools.jar
    This notification means that you are using a JRE instead of a JDK to run CCMS Output Generator. You can ignore this message if you do not need to compile Java classes in your plugin. Otherwise, you must configure CCMS Output Generator to run the JDK instead of the JRE. Update this information in the wrapper.conf file. For more information, see Installing IXIA Output Generator .