DITA-FMx User Guide

Upgrading from DITA-FMx 1.0

Tips for a painless migration from DITA-FMx 1.0 to DITA-FMx 1.1.

DITA-FMx 1.1 is designed to work well with your existing DITA-FMx 1.0 structure applications. When using an older app, some of the new features that rely on specific structure application settings may not work. But you should be able to install the update and continue working, and expect the same level of functionality that you’re used to. When you are ready to migrate the new features into your structure application, you should review the Required Element Definitions topic.

Tip: The changes made to the structure applications from DITA-FMx 1.0 to DITA-FMx 1.1 are documented in the Structure Application Updates section of the Revision History. It may be useful to review these changes when upgrading your custom structure application.

When upgrading form DITA-FMx 1.0 it’s best to have a “fresh” install. To do this you should perform the following steps:

  1. Rename the existing FrameMaker\DITA-FMx folder (perhaps to something like DITA-FMx.1.0) before running the new installer.
  2. Run the installer. This will give you a completely new installation of files, and will let you compare the new files to the old files and allow you to “roll back” to the previous version if needed.
  3. Start FrameMaker, then exit. This will create the new ditafmx.ini file.
  4. Manually migrate any manually entered settings in the ditafmx.ini file (such as items related to OT build settings). In particular, you’ll need to migrate the info in the Registration section. Just copy and paste the entire Registration section into the new ditafmx.ini file after it is created. (You can also re-enter your registration information and authorization code through the DITA-FMx menu.)
  5. Install the new DITA-FMx 1.1 structure applications as described in Installing the Structure Applications.

The DITA-FMx 1.1 structure applications follow a similar naming convention and file structure as before, but include a “_1.1” suffix. This lets you install the new 1.1 apps along side of your existing apps and switch between them as needed.

Note: DITA-FMx 1.1 no longer uses the ditafmx_book client (its functionality has been folded in to the ditafmx client). The installer should remove this entry from the maker.ini file, but if you get an error when starting FrameMaker that mentions the ditafmx_book client, you may need to remove it manually.