IBM FileNet P8, Version 5.2.1            

Installing the DITA Open Toolkit

Procedure

To install the DITA Open Toolkit:

  1. Download the DITA Open Toolkit from http://sourceforge.net/projects/dita-ot/.
  2. Expand the package (in .zip or .tar.gz format) to the installation directory on either the Content Platform Engine server or a server that is mapped or mounted on the Content Platform Engine server.

    For best performance, set this location to a local path on the Content Platform Engine server. Specifying a UNC path allows one DITA Open Toolkit location to support multiple DITA rendition engines. The advantage of a shared location is that there is only one location to update with new versions of the DITA Open Toolkit. The disadvantage is that loading the DITA Open Toolkit over the network is slower.

  3. Required for versions of the DITA Open Toolkit that are 1.4.3 or later: Copy the JAR files from DITA_HOME\lib\saxon to DITA_HOME\lib. Doing so puts the files in a folder that is in the CLASSPATH that is used when FileNet® P8 invokes the DITA Open Toolkit.

    Some installations of the DITA Open Toolkit on platforms other than Windows have incorrect permission settings for the Apache Ant tools. If you get the following error in the p8_server_error.log file, verify that file permissions in the DITA-OT/tools/ant/bin directory are set to grant execute privilege.

    FNRCE0000I - INFO DITA OT ERROR>java.io.IOException: ant^@: not found


Last updated: October 2015
pub_install_rendition_engine_server003.htm

© Copyright IBM Corporation 2015.