Run a DITA-OT transformation outside of CCMS Output Generator

CCMS Output Generator lets you re-run an OT transformation without having to retrieve the content from the Content Store and then re-run the conductor file.

Such an approach can help in troubleshooting your DITA-OT transformation. For example, if you are customizing the stylesheets of a DITA-OT plugin, you can test your changes by running the DITA-OT transformation offline. Instead of regenerating the output from the IXIA CCMS Desktop Generate Output dialog box, which can be time-consuming, you can re-run the DITA-OT transformation directly.

This works as follows:
  • You run CCMS Output Generator with the property outgen.job.keep.temp="yes". This ensures that a copy of the retrieved content will be kept locally.
  • You run your DITA-OT transformation once using the CCMS Desktop Generate Output dialog box. This stores all the files in the job directory. Since the outgen.job.keep.temp property is set to yes, the files are not deleted at the end of the job and you have a copy of all the files that you need to re-run the DITA-OT transformation.
  • You run your DITA-OT transformation from outside of the Output Generator.
To run a DITA-OT transformation outside of CCMS Output Generator:
  1. Run CCMS Output Generator with the property outgen.job.keep.temp="yes" (see Run IXIA CCMS Output Generator in debug mode).
  2. Run your DITA-OT transformation using CCMS Output Generator.
    At this point, you should have the following files:
    • Source files to transform: In %OutputGenDir%\temp\<job_id>\content
    • Build file: In %OutputGenDir%\temp\<job_id>\ (for example, build.xml)
  3. Run your build file. For example, if you are using the DITA-OT to transform the content, take the following actions:
    1. In the %OutputGenDir%/data/%OT_Dir%/ directory, follow the action that aligns with the operating system:
      • (Windows) Right-click startcmd.bat and select Run as administrator
      • (Linux) Run startcmd.sh
    2. Enter the following command:
      ant -f %OutputGenDir%\temp\<job_id>\build.xml
      For example:
      ant -f C:\ixiasoft\OutputGenerators\Prod\temp\ 
      Dita2Pdf.mtest.140.1417549370659\build.xml
      DITA-OT runs the transformation. This step is equivalent to running the dita_startcmd_ot_build target.
  4. Modify your stylesheets or DITA-OT plugin configuration and re-run the DITA-OT transformation.