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”.