Installing DITA-FMx for the First Time

The initial installation of DITA-FMx requires you to edit the maker.ini file to disable the existing DITA support.

DITA-FMx cannot coexist with the default FM-DITA support. An error message will display to remind you of this if you neglect to modify the maker.ini file before installation.

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.

Open the maker.ini file (in the main FrameMaker program folder) and locate the APIClients section. Look for lines that start with ditafm, ditafm_app, ditabook (FM8 only), and possibly ditaOpenToolkit or DITA OT (in FM12/2015/2017 or if you’ve installed the DITA OpenToolkit connector). Delete or comment out these lines (by adding a semicolon at the start of each line).

In FM12/2015/2017, 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.