ColdFusion Apache manual connector configuration

This document applies to:

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

Adobe 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 Apache.

Adobe ColdFusion 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

    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 here.

 Adobe

Get help faster and easier

New user?