IIS manual connector configuration | Adobe ColdFusion

This KB document is applicable to:

  • ColdFusion (2018 release)
  • ColdFusion (2016 release)
  • ColdFusion 11
  • ColdFusion 10

ColdFusion comes with a webserver configuration tool for connecting to external web servers. There can be occasions, however, when the tool doesn't work properly. If the tool doesn't work, you can configure the connector manually. This TechNote demonstrates the steps required to manually configure a connection to IIS.

ColdFusion server connects to webserver through Connector Port, which is in server.xml. You can find this file in the {CF-HOME}\cfusion\runtime\conf directory.

In all the configuration below, replace {CF-HOME} with actual ColdFusion installation directory. (For example, on UNIX,  /opt/ColdFusion2018 and C:\ColdFusion2018 for windows.)

  1. Extract the DLL from wsconfig.jar in {CF-HOME}\cfusion\runtime\lib.

    • The IIS 64-bit DLL is in connector\isapi\intel-win64\prebuilt\amd64\isapi_redirect.dll
    • The IIS 32-bit DLL is in connector\isapi\intel-win\prebuilt\isapi_redirect.dll
  2. Create a folder in {CF-HOME}\config\wsconfig\{magic-number} and copy the DLL into that folder.

  3. Create a file named isapi_redirect.properties and copy the content below into it.

    extension_uri = /jakarta/isapi_redirect.dll
    log_file = {CF-HOME}\config\wsconfig\{magic-number}\isapi_redirect.log
    log_level = info
    worker_file = {CF-HOME}\config\wsconfig\{magic-number}\workers.properties
    worker_mount_file = {CF-HOME}\config\wsconfig\{magic-number}\uriworkermap.properties
    iis_buffer_enable =  true

  4. Create uriworkermap.properties under {CF-HOME}\config\wsconfig\{magic-number} and copy the content below into it.

    /cfformgateway/* = cfusion
    /CFFormGateway/* = cfusion
    /flex2gateway/* = cfusion
    /flex2gateway = cfusion
    /cffileservlet/* = cfusion
    /CFFileServlet/* = cfusion
    /cfform-internal/* = cfusion
    /flashservices/gateway/* = cfusion
    /flex-internal/* = cfusion
    /rest/* = cfusion
    /*.cfml/* = cfusion
    /*.mxml = cfusion
    /*.as = cfusion
    /*.cfm = cfusion
    /*.cfm/* = cfusion
    /*.swc = cfusion
    /*.cfml = cfusion
    /*.cfc = cfusion
    /*.cfc/* = cfusion
    /*.cfr = cfusion
    /*.cfswf = cfusion
    /*.sws = cfusion
    /*.jsp = cfusion
    /*.hbmxml = cfusion

  5. Create workers.properties under {CF-HOME}\config\wsconfig\{magic-number} and copy the content below. Make sure that the port mentioned is the same as the connector port mentioned for protocol "AJP/1.3" in server.xml.

    worker.list=cfusion

    worker.cfusion.type=ajp13
    worker.cfusion.host=localhost
    worker.cfusion.port=8012
    worker.cfusion.max_reuse_connections=250

  6. Double-click Handler Mappings, click Add Script Map in the Actions panel. Add handlers for cfm, cfc, cfml, cfr, and cfswf extensions and point all of them to {CF-HOME}\config\wsconfig\{magic-number}\isapi_redirect.dll.

  7. Open IIS Manager, and select the website. Create the virtual directory CFIDE and jakarta.

    • Virtual Directory name CFIDE location {CF-HOME}\cfusion\wwwroot\CFIDE.
    • Virtual Directory name jakarta location {CF-HOME}\config\wsconfig\{magic-number}.
    • Select the jakarta virtual directory in the Connections panel.
    • Double-click the Handler Mappings icon in Feature View.
    • Click Edit Feature Permission in the Actions panel.
    • Ensure Execute is selected.
  8. Double-click ISAPI Filters and click Add in the Actions panel. Give a Filter name (for example, Tomcat) and point it to {CF-HOME}\config\wsconfig\{magic-number}\isapi_redirect.dll.

Note:

Enable the following features at IIS the level.

  • ISAPI Extensions
  • ISAPI Filters
  • CGI
  • ASP .NET

You can also download Connector binaries from the Adobe ColdFusion download page.

Adobe logo

Sign in to your account