Installing a DITA-FMx Update

Basic options for upgrading your DITA-FMx installation to the latest point release.

To reinstall or update DITA-FMx over an existing installation, you’ve got two basic options.

Quick and simple, but unable to revert to the previous version
When installing an interim update, or you don’t care about being able to roll back to the previous version, this approach is for you.
Just run the installer. No backup or uninstall is required. The installer will overwrite all like-named files in the DITA-FMx-2 folder. It will not overwrite the ditafmx.ini file, so your settings will not be lost.
Fresh install, and able to revert to the previous version
If you’d like to get a “fresh” install, you should rename the existing DITA-FMx-2 folder (perhaps to something like DITA-FMx-2.<oldversion>) before running the new installer. This will give you a completely new set of files, and will let you compare the new files to the old files and allow you to “roll back” to a previous version if needed. If you choose this approach, you will need to manually migrate any manually entered settings in the ditafmx.ini file. 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, then restart FrameMaker. (Otherwise, you’ll need to enter your registration information and auth code in order to initialize the application.)

After installing the update, you may want to copy the new structure applications to the FrameMaker\Structure\xml\ folder so you can take advantage of any changes that have been made. The DITA-FMx installer does not install the new structure applications, they are provided in a ZIP file in the DITA-FMx-2 folder. If you’re using your own custom applications, you should review the DITA-FMx Revision History, so you can integrate any structure application updates. In particular, you should consider using the updated XSLT scripts for the Book application to take advantage of any fixes to the book-build processing.

Note: If you’re installing an update on Windows Vista, 7, 8, or 10, keep in mind that the user-editable INI files are in the “app data” area not in the Program Files area.
Important: If you’re installing an update on FM12, due to a core problem in FrameMaker, you must manually delete the ModalDialogPosition.ini file to allow updated DITA-FMx dialogs to display at their proper size. This INI file can be found in “%appdata%\Adobe\FrameMaker\12”.