IBM FileNet P8, Version 5.2.1            

Configuring multi-process access to DITA Open Toolkit installations

If you have multiple processes accessing a single DITA Open Toolkit installation, you might encounter intermittent input and output failures as the DITA Open Toolkit reads the build files. To avoid this problem, each server instance that will perform DITA publishing must have a separate DITA Open Toolkit installation. If multiple server instances are operating on the same machine, there must be multiple instances of the DITA Open Toolkit installed, one for each server instance. DITA publishing for each server instance must be configured with the Queue Item Max Dispatchers set to 1, instead of the default value of 2. This results in one publishing thread operating on a separate DITA Open Toolkit installation.

About this task

In this example a cluster has three server instances, all operating a single server, and all server instances are to be configured to support DITA publishing.

Important: This procedure requires that you do not configure LIQUENT publishing at the server instance level unless you want LIQUENT and DITA publishing to share a single publishing thread. Specify LIQUENT publishing configuration at a higher level than the server instance, for example, the site level. Here you can specify as many publishing threads as needed for LIQUENT publishing.

Procedure

To configure multi-process access:

  1. Install three instances of DITA Open Toolkit, for example:
    • C:\DITAOT-S1
    • C:\DITAOT-S2
    • C:\DITAOT-S3
  2. Configure DITA publishing.
    1. In the administration console in the domain navigation pane, click Global Configuration > Administration > Sites > site > Virtual Servers.
    2. For each server instance, do the following steps on the Publishing Subsystem tab:
      1. Override the inherited settings by selecting object_name (this object) for the configuration source.
      2. Change the Maximum publish request handlers value from 2 to 1.
      3. Verify that the DITA Open Toolkit location in the DITA Rendition Engine Connection is unique for this server instance.

Results

Each server instance will have a unique DITA Open Toolkit location and will have one publishing thread available to use that DITA Open Toolkit installation.



Last updated: October 2015
pub_install_rendition_engine_server006.htm

© Copyright IBM Corporation 2015.