Upgrading from DITA-FMx 1.0 or 1.1

Tips for a painless migration from an earlier version of DITA-FMx.

DITA-FMx 2.0 should handle your existing DITA-FMx 1.1 structure applications without any problems, especially if you’re upgrading from the latest release (1.1.18). If you are 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 DITA-FMx Specific Element Definitions topic.

The default structure application provided with DITA-FMx 2.0 supports the DITA 1.2 model. You should be able to use this app for DITA files created with earlier DITA models, but you can also continue to use your existing apps if you prefer.

Tip: The changes made to the structure applications are documented in the “Structure Application Updates” sections of the Revision History for each update. It may be useful to review all of these changes from your version when upgrading a custom structure application.

Because DITA-FMx 2.0 installs into a new directory structure (FrameMaker\DITA-FMx-2), it will not overwrite your DITA-FMx installation. After running the installer, run FrameMaker and you’ll be prompted to install the new DITA 1.2 structure applications. These are also installed to a new directory structure so will not overwrite your existing application files.

This allows you to maintain both DITA-FMx 1.1 and 2.0 installations side-by-side. To switch from one to the other, see Switching Between DITA-FMx 1.1 and 2.0.

After installing DITA-FMx 2.0, you may want to migrate some of the settings in the 1.1 ditafmx.ini file. There have been some changes to this INI file, but some of the settings will be the same.