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.
- Just run the installer. No backup or uninstall
is required. The installer will overwrite all like-named files in
the DITA-FMx 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 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.
Note: If you’re installing an update on Windows Vista or 7, keep
in mind that the user-editable INI files are in the “app data” area
not in the Program Files area.