Tips for a painless migration from DITA-FMx 1.0 to DITA-FMx
1.1.
DITA-FMx 1.1 is designed to work well with your existing
DITA-FMx 1.0 structure applications. When 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 Required Element Definitions topic.
Tip: The changes made to the structure applications
from DITA-FMx 1.0 to DITA-FMx 1.1 are documented in the
Structure Application Updates section
of the Revision History. It may be useful to review these changes
when upgrading your custom structure application.
When upgrading form DITA-FMx 1.0 it’s best
to have a “fresh” install. To do this you should perform the following
steps:
- Rename the existing FrameMaker\DITA-FMx folder
(perhaps to something like DITA-FMx.1.0) before
running the new installer.
- Run the 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 the previous version if needed.
- Start FrameMaker, then exit. This will create the new ditafmx.ini file.
- Manually migrate any manually entered settings in the ditafmx.ini file
(such as items related to OT build settings). 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. (You can also re-enter your registration information and
authorization code through the DITA-FMx menu.)
- Install the new DITA-FMx 1.1 structure applications as described
in Installing the Structure Applications.
The DITA-FMx 1.1 structure applications follow
a similar naming convention and file structure as before, but include
a “_1.1” suffix. This lets you install the new 1.1 apps along side of
your existing apps and switch between them as needed.
Note: DITA-FMx 1.1 no longer uses the ditafmx_book client (its functionality
has been folded in to the ditafmx client). The installer should
remove this entry from the maker.ini file,
but if you get an error when starting FrameMaker that mentions the
ditafmx_book client, you may need to remove it manually.