Installing DITA-FMx for the First Time

As of DITA-FMx 2.0.07, the installation application modifies the maker.ini file to disable the existing DITA support; on earlier releases, you needed to do this manually.

DITA-FMx cannot coexist with the default DITA support. An error message will display to remind you of this if the maker.ini file has been edited to enable the default DITA support.

Note:

If installing on FrameMaker 7.2, read Installing DITA-FMx on FrameMaker 7.2 instead of this topic. For all other version of FrameMaker continue reading below.

The information in the following bullet item is provided for your information only; there is no action that is required.

After installation, the maker.ini file (in the main FrameMaker program folder) will have been modified to comment out the default DITA support. In the APIClients section, you should see lines that start with ditafm, ditafm_app, ditabook (FM8 only), and possibly ditaOpenToolkit or DITA OT (in FM12/2015/2017/2019/2020 or if you’ve installed the DITA OpenToolkit connector).

In FM12/2015/2017/2019/2020, you should see lines that look like the following:
```
;ditafm=Standard, Translation client for DITA, fminit\ditafm.dll, structured 
;ditafm_app=Standard, Translation client for DITA, fminit\ditafm_app.dll, structured 
;Dita OT=Standard, DITA OT client for DITA, fminit\openToolkit.dll, structured
```
Note: On Windows Vista, 7, 8, or 10, in order to edit the maker.ini file you may need to run Notepad (or whatever text editor you are using), “As Administrator”. This does not mean that you have Administrator permissions, but that you right-click the program icon and choose “Run As Administrator.”

On FrameMaker 10 and later, you must restart FrameMaker after initial setup to ensure that the proper structure applications have been registered in the default FrameMaker ditafm.ini file. Due to changes in these FrameMaker versions, the structure applications are stored in both the ditafmx.ini and the default ditafm.ini files.

Note: If you’re interested in switching between FM-DITA and DITA-FMx, refer to the topic Switching Between DITA-FMx and FM-DITA.

You may now proceed to Run the Installer Application.