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
This document is applicable to:
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.).
Extract the .so file from wsconfig.jar, in {CF-HOME}\cfusion\runtime\lib.
Create a folder under {CF-HOME}\config\wsconfig\{magic-number}, and copy the connector in that folder.
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
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
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
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"
Restart Apache.
You can also download Connector binaries from the Adobe ColdFusion download page.