Overview of the upgrade path to IXIASOFT CCMS 6.3

The following describes what needs to be updated when upgrading to IXIASOFT CCMS 6.3 from IXIASOFT CCMS 5.2 .

Note: The order presented in this guide for upgrading IXIASOFT CCMS components is the order recommended by IXIASOFT. However, after you upgrade TEXTML Server, CCMS Web, and the Content Store, you can upgrade the remaining components in whatever order best suits your deployment. For instance, you might have requirements that make upgrading IXIASOFT CCMS Desktop before CCMS Output Generator preferable.

Upgrading TEXTML Server

You must upgrade IXIASOFT TEXTML Server to 4.4.1.5249 or later. Upgrading does not require any conversion or re-indexing.

Upgrading IXIASOFT CCMS Web

You need to update to CCMS Web 6.3. The Web Installer for CCMS Web 6.3 installs important mandatory configuration changes.

New parameters have been added to implement generating output in CCMS Web, and new parameters have been added that implements the DRM cache system.

Also, there are some changes to keep in mind:

  • Starting in CCMS Web 6.0, a framework is no longer mandatory for your DTDs in 6.3
  • Your existing frameworks and plugins are copied into backup folder in the installation folder prior to the upgrade
  • You must manually reinstall your custom frameworks and plugins

Upgrading the Content Store

The Web Installer automatically handles all of the mandatory updates to the Content Store.

The only required changes are the following:

  • Add users to the Advanced Users group in users.xml to give them access to the advanced user functions (i.e. make them writers).
  • Update the ixia.cms.version value for the system

There are optional configuration changes you should review, including the ability to configure the default format and type of images based on the filename extension of images. And there are changes to access rights in IXIASOFT CCMS Web because new features were added.

Upgrading IXIASOFT CCMS Desktop

You need to upgrade to CCMS Desktop 6.3. You must update the eclipse.ini file to avoid timeout errors when generating output.

Upgrading IXIASOFT CCMS Output Generator

You must upgrade to CCMS Output Generator 6.3.

To support changes in DITA Open Toolkit 3.x, CCMS Output Generator 6.1 and later versions create output using a new method. You must upgrade your conductor files to use this new method if you want to be able to do the following:

  • To generate output in CCMS Web
  • To create Approvals and Collaborative Reviews in CCMS Web
  • To use DITA-OT 3.x

If you still want to use older versions of DITA-OT, you can. The default DITA-OT version of CCMS Output Generator 6.3 is 2.5.4, and CCMS Output Generator works with all versions of DITA-OT though some versions may require a few additional changes.

If you have SSL enabled on IXIASOFT TEXTML Server, there is a new SSL java property in the wrapper.conf file you must configure

There are also the following changes in IXIASOFT CCMS Output Generator 6.3:

  • Dynamic loading of output types and preprocessors configuration (no restart required)
  • A new plugin for MathML in FOP
  • Native support for SVG in FOP

Upgrading IXIASOFT CCMS Scheduler

There are no mandatory configuration changes for CCMS Scheduler, but CCMS Scheduler templates do need to be manually updated to avoid issues with email notifications.