Summary of upgrade path

To help you understand what you need to do to prepare for the upgrade, identify the starting state of your deployment to obtain the list of tasks you must complete before starting the upgrade.

You must evaluate each of the following sections to identify the effort required to perform the upgrade.

Part 1: Remove legacy products

Beginning with the DITA CMS Core 4.5 release, the legacy Web Collaborative Reviewer and Web Author products are not longer supported products in the deployment.

Starting state of your deployment Tasks required BEFORE performing the upgrade to Core 4.5
If your deployment contains the legacy products Web Author or Web Collaborative Reviewer
  • Uninstall Tomcat 6.
  • Uninstall GlassFish 3.2.
  • Remove the Web Collaborative Reviewer plugins/dropins from the DITA CMS Eclipse Client instances.
  • Remove the Web Author configuration files from the Content Store.

These instructions are provided in Removing the legacy products.

Part 2: Prepare your Content Store

Your Content Store must be upgraded to the last release before performing the upgrade to this release. If your Content Store is not upgraded to Core 4.4.46, you must apply all the configuration changes required for each release between the build you have in your deployment and Core 4.4.46.

Starting state of your Core components Tasks required BEFORE performing the upgrade to Core 4.5
If your Content Store is at Core 4.2.31 or lower

Please contact IXIASOFT Services for assistance.

If your Content Store is at one of the versions from Core 4.2.33 to 4.2.53
  1. Backup your Content Store.
  2. Follow each of the instructions to update your Content Store configuration for each release from your existing version to Core 4.2.53. See Updating a Core 4.2.X to 4.2.53.
  3. Follow the instructions to upgrade your Content Store from Core 4.2.53 to Core 4.3.61. See Upgrade Core 4.2.53 to latest 4.3 release.
  4. Follow the instructions to upgrade your Content Store from Core 4.3.61 to Core 4.4.46. See Upgrade Core 4.3.61 to latest 4.4 release.
  5. Proceed with the upgrade to Core 4.5. See Upgrade your Content Store to current release.
If your Content Store is at one of the Core 4.3.X versions
  1. Backup your Content Store.
  2. Follow each of the instructions to update your Content Store configuration for each release from your existing version to Core 4.3.61. See Updating a Core 4.3.X to 4.3.61.
  3. Follow the instructions to upgrade your Content Store from Core 4.3.61 to Core 4.4.46. See Upgrade Core 4.3.61 to latest 4.4 release.
  4. Proceed with the upgrade to Core 4.5. See Upgrade your Content Store to current release.
If your Content Store is at one of the Core 4.4.X versions
  1. Backup your Content Store.
  2. No configuration updates are required. Proceed with the upgrade to Core 4.5. See Upgrade your Content Store to current release.
Note: If you are not sure which starting state is relevant to you, please contact IXIASOFT Support team.

Part 3: Prepare your DITA CMS Web component

The new DITA CMS Web component requires a change to your IXIASOFT license model. Please contact IXIASOFT Sales to find out how your organization can update its license to use DITA CMS Web.

For the full instructions for how to upgrade your existing DITA CMS Web component, see Upgrading the DITA CMS Web from 4.5 to 4.6 Guide on the DITA CMS Web page on http://archive.ixiasoft.com/en/products/dita-cms/documentation.

Table 1. Web upgrade path
Starting state of your Web component Tasks required BEFORE performing the upgrade to Web 4.6
If the webplatform folder in your Content Store only contains the web.platform.config.xml file
  1. Contact IXIASOFT Sales team to obtain your license for DITA CMS Web.
  2. Import the webroles files.
  3. Remove the Xeditor configuration from the Content Store.
  4. Ensure that the properties.txt file is present in the location where you installed DITA CMS Web.
  5. Once you have the license, proceed with the upgrade to Web 4.6.
If the webplatform folder in your Content Store contains the web.platform.config.xml, webroles.xml, and webroles.dtd files
  1. Contact IXIASOFT Sales team to obtain your license for DITA CMS Web.
  2. Once you have the license, proceed with the upgrade to Web 4.6.