This document is applicable to:

  • ColdFusion 2016
  • ColdFusion 11
  • ColdFusion 10

ColdFusion 2016 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 Apache.

ColdFusion 2016 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 ColdFusion10 installation directory. (For example, the installation directory on UNIX is /opt/ColdFusion10 and C:\ColdFusion10 for windows.).

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

    • For Apache 64 bit, .so is under connectors\apache\intel-win64\prebuilt\mod_jk22.so
    • For Apache 32 bit, .so is under connectors\apache\intel-win\prebuilt\mod_jk22.so
  2. Create a folder under {CF-HOME}\config\wsconfig\{magic-number}, and copy the connector in that folder.

  3. Create a file uriworkermap.properties 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

  4. Create workers.properties under {CF-HOME}\config\wsconfig\{magic-number} and copy the content below into it. Make sure that the port mentioned is same as 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

  5. Create mod_jk.conf file in Apache configuration directory. Add the extracted connector path in the content below.

    LoadModule jk_module "{CF-HOME}\config\wsconfig\{magic_no}\mod_jk.so"
    # Where to find workers.properties
    JkWorkersFile "{CF-HOME}\config\wsconfig\{magic_no}\workers.properties"
    JkMountFile "{CF-HOME}\config\wsconfig\{magic_no}\uriworkermap.properties"
    # Where to put jk logs
    JkLogFile "{CF-HOME}\config\wsconfig\{magic_no}\mod_jk.log"
    # Where to put jk shared memory
    JkShmFile "{CF-HOME}\config\wsconfig\{magic_no}\jk_shm"
    # Set the jk log level [debug/error/info]
    JkLogLevel info
    # Select the timestamp log format
    JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
    AddHandler jakarta-servlet .cfm .cfml .cfc .cfr .cfswf
    Alias /CFIDE "{CF-HOME}\cfusion\wwwroot\CFIDE"

    Options Indexes FollowSymLinks
    AllowOverride None
    Order allow, deny
    Allow from all

    Order allow, deny
    Deny from all

  6. Open the httpd.conf from the Apache config directory. Add the line below at the end of the httpd.conf file.

    Include "C:\Program Files (x86)\Apache Software Foundation\Apache2.2\conf\mod_jk.conf"

  7. Restart Apache.

Note:

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

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