Login
Home CMS Documentation Home CMS 10 DITA Processing Pipeline Initial DITA Configuration

Initial DITA Configuration

Prerequisites: CMS 10.6 must be installed. See CMS Statistics for details to check your version.

Prior to uploading existing DITA sets or creating new ones, CMS administrators must configure Ingeniux CMS to process DITA. A typical DITA configuration should take no more than a few minutes. Use the diagram below as a basic DITA configuration guide and to get a sense of where in the CMS DITA configuration takes place and in what order. You can click the links in the diagram to learn more about each configuration step.

DITA Publishing Set Up
DITA Publishing Set Up

The DITA publishing environment within the CMS requires the following steps at a minimum. Click any of the links below to learn more about these steps and about additional options you can set.

Important

The DITA publishing pipeline requires at least 32 GB of RAM. Keep in mind the following factors:

  • If your organization plans to store large DITA collections in the CMS, you may require more than 32 GB of RAM.

  • When processing large DITA maps, the DITA-OT alone may use up to 8 GB of RAM. However, RAM utilization is typically released by Java VM. If you do not meet the RAM requirement, the server will remain out of memory until the process completes.

  • Dependency building during publish uses RAM, especially when content dependencies share extensive connections.

  • For published DITA content, the DSS will deserialize dependencies and cache them in RAM. This can take an additional 2 to 4 GB of RAM.

  1. Install Java: The DITA Open Toolkit requires theJava SDK to be installed on the server where Ingeniux CMS resides.

    See Oracle's Java SDK installation instructions for details. To complete the Java environment installation, you may need to restart the CMS server.

    Troubleshooting

    We recommend installing Oracle's Java SDK. An issue occurs with Microsoft's OpenJDK 17, where the cleanup of the temp folder fails during the DITA-OT transformation processes.

  2. Create DITA Root Folder: This will be the asset folder where all DITA content will reside in order for them to be published.

  3. Set DITA Root Folder: CMS administrators must set the asset ID of the DITA root folder in Administration > DITA > Setup.

  4. Install DITA-OT: CMS administrators must install a version of the DITA Open Toolkit in Administration: > DITA > Setup.

  5. Select DSS Schema (Rendering DITA Schema for DSS): CMS administrators must set the appropriate schema for DITA in Administration > DITA > Output Formats.

  6. Select Output: CMS administrators must select the required output formats in Administration: > DITA > Output Formats.

  7. Configure Post-Publish Processing: CMS administrators must configure the appropriate processing application in Administration > Publishing System > Publishing Targets.

  8. Upload DITA Assets: Users must upload DITA assets to Ingeniux CMS (or create them in the CMS).

  9. Check In DITA Assets: All DITA maps and their dependent content must be checked in prior to publishing.

  10. Mark Map(s) for Publish: All DITA maps and their dependent content must be marked for publish for the intended publishing target(s).

  11. Publish Map(s): Users with administrative rights publish DITA maps in the desired output formats.