Troubleshoot the output issues with XML Documentation Add-on using FMPS.

Issue

Cannot publish any output from XML Documentation Add-on because the FMPS interface is not accessible. The issue occurs because any of the following reasons:

  • FMPS is not configured properly on the Internet Information Services (IIS).
  • The IT environment is highly secured.

Solution

The following sections cover the three parts of the solution. Follow the instructions in the same order and check if your issue is resolved.

Part 1

  1. Enter http://localhost in your web browser to check if the IIS is running.

  2. If IIS is not running, you can add the server role Web Server (IIS) in Server Manager and ensure that the following options are selected:

    • Web Server (IIS) > Web Server > Common HTTP Features > Static Content
    • Web Server (IIS) > Web Server > Security > Request Filtering
    • Web Server (IIS) > Web Server > Application Development > ASP, ASP.NET 3.5, and ASP.NET 4.6

    For information about installing IIS on Windows server, see the following URL.

    https://docs.microsoft.com/en-us/iis/get-started/whats-new-in-iis-8/installing-iis-8-on-windows-server-2012

  3. Download the following patch build for FMPS.

    Download

  4. Extract the .zip file and run the AdobePatchInstaller.exe file to initiate the installation.

  5. Configure the FMPS properly on the IIS. For more information see, Using FrameMaker Publishing Server (2017 release).

  6. Launch FMPS interface from the following URL and check if you can access it.

    http://localhost:6234/index.html

  7. Generate the output from the XML Documentation Add-on if you can access the FMPS interface. 

    If you can’t access the FMPS interface, perform the steps mentioned in the Part 2.

Part 2

Note:

Ensure that you back up the original applicationHost.config file from the following location and then proceed further.

C:\Windows\System32\inetsrv\config

If you can’t access the FMPS interface after performing the steps mentioned in the Part 1, perform the following steps:

  1. Open the applicationHost.config file in a text editor from the following location.

    C:\Windows\System32\inetsrv\config

  2. Search for the following string

    <fileExtensions allowUnlisted=”false” applyToWebDAV="true">

    Change it to

    <fileExtensions allowUnlisted=”true” applyToWebDAV="true">

  3. Save the applicationHost.config file.

  4. Generate the output from the XML Documentation Add-on.

    If you can’t generate the output, perform the steps mentioned in the Part 3.

Part 3

If you can’t generate output after performing the steps mentioned in the Part 2, perform the following steps:

  1. Open the applicationHost.config file in a text editor from the following location.

    C:\Windows\System32\inetsrv\config

  2. Search for the following string

    <httpProtocol>

                <customHeaders>

                    <clear />

                </customHeaders>

                <redirectHeaders>

                    <clear />

    Change it to

    <httpProtocol>

                <customHeaders>

                    <clear />

                </customHeaders>

                <redirectHeaders>

                    <clear />

                    <add name="X-Powered-By" value="ASP.NET" />

  3. Save the applicationHost.config file.

  4. Restart IIS.

  5. Generate the output from the XML Documentation Add-on.

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy