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
Last updated on
Dec 31, 2023
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.).
-
-
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 .cfswfOptions Indexes FollowSymLinks
AllowOverride None
Order allow, deny
Allow from allOrder 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.
Note:
You can also download Connector binaries here.
