Release notes - Rational Publishing Engine 2.1.1

This document contains information about the features, system requirements, installation, and known issues, and fixed defects for IBM® Rational® Publishing Engine 2.1.1.

Description

Rational Publishing Engine automates documentation generation from Rational products and select third-party applications, helping you generate documents for daily use, formal reviews, contractual obligations, and compliance with standards. With Rational Publishing Engine, you spend less time creating documents and keeping them up to date.

New features

See the What's new topic for details.

System requirements

For more information about hardware and software requirements for Rational Publishing Engine, you can generate the system requirements for Rational Publishing Engine from this page: http://www.ibm.com/software/reports/compatibility/clarity/softwareReqsForProduct.html.

Download instructions

For information about downloading Rational Publishing Engine, see the Download document.

Installation instructions

You can purchase or renew licenses from the IBM License Key Center.

For step-by-step installation instructions, see these roadmaps in the information center: Rational Publishing Engine supports Java™ 7.0 and 8.0.
Note: If you are installing help on an intranet server, the Knowledge Center is now included in the product installation in the [RPE_HOME]\kcci folder. See Installing help on an intranet server.

Do not extract the IBM Knowledge Center to the Rational Publishing Engine installation directory. Use another directory, such as C:\kcci. Deployment of the Knowledge Center to the product installation path might make it difficult to completely uninstall the product in the future.

Fixed defects

For a detailed list of problems (APARs) solved in this release, see the Fix list for Rational Publishing Engine.

Known problems

  • Remote Services deprecation

    The 1.x Remote Services applications (Central Management, Monitor and Control, Remote Document Generation, and Report Scheduler) are deprecated in this release. You can now perform these tasks using Document Builder. See Migrating assets from 1.x Remote services to Document Builder.

    1.x Remote Services Document Builder
    Monitor and Control View running jobs on the Job Details page.
    Central Management Assets can be stored in Document Builder. Report designers can upload and work with assets on the Design page.
    Remote document generation Generate documents on the Generate page
    Report Scheduler Schedule document generation jobs on the Generate page.
  • After upgrade, remote-services directory name in RPE_HOME does not get updated with the new name

    If you upgrade to version 2.1.1, the remote-services directory name that contains the .war and .ear files for Document Builder does not get updated to the new document-builder folder name.
  • Legacy PDF driver no longer supported

    If your document specification points to the old legacy PDF driver, modify the specification to refer to the default PDF driver.
  • Rename wizard in Schema editor not working

    You cannot rename elements in the schema editor by using the rename wizard. To work around this problem, you can edit the name in the Properties view.
  • Use a server name for DGAAS_URL

    If an administrator has set the DGAAS_URL runtime variable to an IP address and that address changes, they may not be able to access the web app. To work around this problem, administrators can set the OVERRIDE_DGAAS_URL system variable or Java property to the new server name. Then restart the server. To avoid this problem, use a server name for the DGAAS_URL variable instead of an IP address.
  • Bidi limitations

    Table 1. Bidi support in Rational Publishing Engine
    Version Microsoft Office 2003-2010 Microsoft Office 2013
    1.3 Full support Not supported
    2.1.1 Some use cases might not produce correct results if the generated report is opened with MS Office 2003-2010. For example, a combination of document direction value (ltr, rtl) and text content direction value (ltr, rtl, auto) in various elements of the report such as table of contents, chapter title, paragraph. Full support
  • Bidi PDF limitations

    Bidi support is unavailable for generated PDF documents. To work around this problem, you can generate a Word document using Rational Publishing Engine and then convert the document to PDF using Microsoft Word.

Additional known problems are documented in the form of individual technotes in the Support knowledge base. As problems are discovered and resolved, the IBM Support team updates the knowledge base. By searching the knowledge base, you can quickly find workarounds or solutions to problems.

To launch a customized query of the live Support knowledge base, use this link: Known problems for Rational Publishing Engine.


Feedback