Run the Installer Application

Extract the EXE from the ZIP archive and run it.

The DITA-FMx installer application is provided in a ZIP archive. Extract the executable from the archive and run it. The installer extracts and copies the required files to the FrameMaker\DITA-FMx-2 folder.

As part of the installation process, the installer modifies the maker.ini file. If you feel it is necessary, you may want to make a backup of this file before running the installer. If you are installing an update, see Installing a DITA-FMx Update.

The following files are installed:

After extracting the new files, the installer updates the APIClients section of the maker.ini file with references to the plugin DLLs. The following lines are added (the numbers will vary based on the FrameMaker version: “160” is FM2020, “150” is FM2019, “140” is FM2017, “130” is FM2015, “120” is FM12, and so on):

ditafmx=Standard, ditafmx, DITA-FMx-2\ditafmx_160.dll, structured 
ditafmx_app=Standard, ditafmx_app, DITA-FMx-2\ditafmx_160_app.dll, structured
Important: As of DITA-FMx 2.0.07, the installer application modifies the maker.ini file to comment out references to the default DITA plugins; you no longer need to do this manually.
Note: On Windows Vista, 7, 8, or 10, when you run FrameMaker, the user data files (like the ditafmx.ini file) are created in a DITA-FMx-2 folder in the application data area (typically C:\Users\USERNAME\AppData\Roaming\Adobe\FrameMaker\16\DITA-FMx-2). Any “global” data files that you create (like filtergroups.ini and ditafmx-bookbuild.ini), that the documentation indicates should be in the FrameMaker/DITA-FMx folder should be created in this location as well. The DITA-FMx > Open DITA-FMx Folder command is useful for accessing this folder.

Once the installation has completed, you need to set up the structure applications before you can create and edit DITA files. Continue to DITA Structure Applications.