Migrate your Output Generator configuration to the new version when you are using DITA-OT 1.8.5 or 2.3.1

After you have installed and tested the latest version of the Output Generator, you need to migrate your configuration to the new version.

Remember: If you have more than one DITA-OT in your Output Generator, remember to perform the migration for each of them.

To migrate the configuration:

  1. Copy the contents of the %OutputGenDir%/conf/client/ folder from your previous version to the folder in the new version.
    For example, copy the contents of the following folder:

    C:\ixiasoft\OutputGenerators\Prod_[previous version]\conf\client\

    to the following folder:

    C:\ixiasoft\OutputGenerators\Prod_[new version]\conf\client\

  2. Copy the contents of the %OutputGenDir%/data/resources/client/ folder from your previous version to the folder in the new version.
    For example, copy the contents of the following folder:

    C:\ixiasoft\OutputGenerators\Prod_[previous version]\data\resources\client\

    to the following folder:

    C:\ixiasoft\OutputGenerators\Prod_[new version]\data\resources\client\

  3. Copy the contents of the %OutputGenDir%/libs/client/ folder from your previous version to the folder in the new version.
    For example, copy the contents of the following folder:

    C:\ixiasoft\OutputGenerators\Prod_[previous version]\libs\client\

    to the following folder:

    C:\ixiasoft\OutputGenerators\Prod_[new version]\libs\client\

  4. Copy all your custom transformation scenarios (e.g., conductor-acme.xml) from the %OutputGenDir%/data/ folder to the folder in the new version.
  5. Copy all the *-client.xml files from the %OutputGenDir%/data/ folder to the folder in the new version.
    For example, copy the following files:
    • outgen-init-client.xml
    • commontargets-client.xml
    • bmanifest-extension-client.xml
    • bmanifest-init-client.xml
  6. Copy the outgen-init.properties file from the %OutputGenDir%/data/ folder in the previous version and paste it in the same folder in the new version.
  7. Copy the outgen-init-cr.properties file from the %OutputGenDir%/data/ folder in the previous version and paste it in the same folder in the new version.
  8. Export a copy of your company's DTD plugin from the Content Store:
    1. Open the TEXTML Administration perspective by clicking the TEXTML Administration shortcut on the tool bar. If the shortcut is not displayed, follow these steps:
      1. In the TEXTML Administration view, double-click the server. If your server is not displayed in the view, you must add it to the view.
      2. When the Connect as dialog opens, type your username and password and click OK.
      3. Double-click the name of your docbase to open a connection to the Content Store.
    2. Expand the Content Store's Repository node and browse to /system/plugins to locate your company's DTD plugin; for example: com.company.dita.dtd
    3. Right-click the plugin and click Export.

      The plugin is saved as a folder locally as Content\system\plugins\com.company.dita.dtd where company is the name of your company.

      Important: DO NOT export the com.ixiasoft.dita.dtd plugin or com.ixiasoft.dita13.dtd and use it in the Output Generator.
  9. Copy your com.company.dita.dtd plugin from the location where you exported it and paste it to the new version of the Output Generator as follows:
    • If you are using DITA-OT 1.8.5: Paste it in the %OutputGenDir%\data\DITA-OT1.8.5\plugins folder.
    • If you are using DITA-OT 2.3.1: Paste it in the %OutputGenDir%\data\dita-ot-2.3.1\plugins folder.
  10. Transfer your custom transformation plugins from your previous version of the Output Generator to the new version as follows:
    Option Description
    If you are using DITA-OT 1.8.5
    1. Copy your custom plugins from the %OutputGenDir%\data\DITA-OT1.8.5\plugins folder in your previous version.
    2. Paste them into the plugins folder in the new version.
    If you are using DITA-OT 2.3.1
    1. Copy your custom plugins from the %OutputGenDir%\data\dita-ot-2.3.1\plugins folder in your previous version.
    2. Paste them into the plugins folder in the new version.