Step 2: Configure the Open Toolkit version for the transformation scenarios in a conductor file

This procedure describes how to configure the Open Toolkit version for all the transformation scenarios in a conductor file.

Note: You can also configure a default DITA-OT version by setting the outgen.ot.version property in the outgen-init.properties file. See Configure the version of the DITA-OT used by default for more information.
The procedure below assumes that the Open Toolkit is stored in the following location:
%OutputGenDir%/data
And that the directory name follows this naming convention:
  • DITA-OT 1.x family: DITA-OTversion
  • DITA-OT 2.x family: dita-ot-version
Where version is the Open Toolkit version number. For example:
C:\Ixiasoft\OutputGenerators\OutputGen_Prod\data\DITA-OT1.8.5
C:\Ixiasoft\OutputGenerators\OutputGen_Prod\data\DITA-OT1.5.4
C:\Ixiasoft\OutputGenerators\OutputGen_Prod\data\dita-ot-2.3.1

This directory name is automatically created when you unzip the Open Toolkit. Do not change it.

To configure the Open Toolkit version:

  1. Open the conductor file containing the targets that will use this version of the Open Toolkit.

    For example, for targets that will use the 2.3.1 DITA-OT, open the following file:

    C:\ixiasoft\OutputGenerators\Prod\data\conductor-client-2.3.1.xml
    Note: If the conductor file does not exist, create it using the conductor-client.xml.orig template.
  2. Set the outgen.ot.version attribute to the version of the DITA Open Toolkit.
    This is the string that comes after DITA-OT in the directory name. For example:
    <?xml version="1.0" encoding="UTF-8"?>

<project name="conductor-ixia" default="" basedir=".">

	<!-- Set the version of the OT that will be used -->
	<property name="outgen.ot.version" value="2.3.1"/>

    For example, for the DITA-OT1.8.M2 version, specify value="1.8.M2".

  3. Configure the location of the DITA-OT catalog:
    1. Open the %OutputGenDir%/data/catalogs/catalog-dita-outgen.xml file.
    2. Set the <nextCatalog> value to the location of the DITA-OT catalog-dita.xml file for the DITA-OT you installed.
      The directory nomenclature used by the DITA-OT changed between versions 1.8 and 2.x, so make sure to use the actual directory name for the DITA-OT you just installed.
    3. Comment out the previous DITA-OT catalog.
      Only one catalog can be specified at any time.
    4. Save and close the file.
  4. To test your installation, generate an output using this version of the Open Toolkit.