Installing a DITA-FMx Update
Basic options for upgrading your DITA-FMx 1.1 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.
- 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 folder (perhaps to something like DITA-FMx.<oldversion>) before running the new 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 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 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.