Some people have encountered problems during the ColdFusion MX 7 install on Linux/Apache. When you first start the ColdFusion server, you may see something like this:

Configuring the web server connector (Launched on the first run of the ColdFusion MX 7 start script)
Running apache connector wizard...
=======================================
There was an error while running the connector wizard
Connector installation was not successful


The connector may or may not actually be installed. In some cases it is, but you still get this error. If it is installed, you should know it. Restart apache to make the httpd.conf changes take effect, then try browsing to a .cfm page. If it displays correctly, the connector was installed.

In this case, all you need to do to get rid of the error message is rename the /opt/coldfusionmx7/bin/cfmx-connectors.sh script. Thats normally what happens when the connector is successfully installed – ColdFusion renames that script to “cfmx-connectors-run.sh”.

If your connector did not successfully install, there are a few additional steps to get it properly installed. Change into the /opt/coldfusionmx7/bin/connectors directory. Open the apache_connector.sh file, and fix the paths to be correct to your system.

By default the file contains these lines (among others):
../../runtime/bin/wsconfig \
-server coldfusion \
-ws apache \
-dir /usr/local/apache2/conf \
-bin /usr/local/apache2/bin/httpd \
-script /usr/local/apache2/bin/apachectl \
-coldfusion

On RedHat/CentOS, they should usually look like this:

../../runtime/bin/wsconfig \
-server coldfusion \
-ws apache \
-dir /etc/httpd/conf \
-bin /usr/sbin/httpd \
-script /etc/rc.d/init.d/httpd \
-coldfusion

Even though those are the values I entered during the install, they don’t always make it to this connector script for some reason.

Save the script and run it. Restart apache, and browse to a .cfm file, or to the Administrator to verify that it is installed properly.

27 Comments

  1. John Moore says:

    Thanks mucho!

  2. Ryan Stille says:

    FYI, I just confirmed the problem still exists in ColdFusion 8. I’m going to file a bug report with Adobe.

  3. ana says:

    And with Vista also.

  4. Greg M says:

    I had this issue, too (Fedora 8, Coldfusion 8). In addition to the apache_connector.sh script requiring a change, I needed to install the httpd-devel package. That allows the apache_connector.sh to modify and rebuild Apache to work with Coldfusion. That was “Coldfusion 8″

  5. Ryan Stille says:

    You were probably installing onto Apache 2.2.x then, instead of 2.0.2x which was more common. A recompile of the Apache module is needed when using 2.2.x.

  6. mika aste says:

    With Vista it is really diificult for me.

  7. Arthur says:

    I have just attempted to install Coldfusion8 Standard on RedHat 5.1running Apache 2.2

    The problem has not been fixed. Everytime I start up /opt/coldfusion8/bin/confusion, it reports that the connector installation was not successful.

    May 9, 2008

  8. WeBoat says:

    CF 8 Apache 2.2 here… CentOS 5 All 64 Bit

    Greg M hit it…

    Do the file changes
    Stop CF8
    yum install httpd-devel
    restart httpd
    start CF8

    Everything works fine now!

    Thanks everyone. Easy fix

  9. hoteles.es says:

    We had the same problems but it seemed to be fixed in CF*

  10. Carlos Cruz says:

    I’m trying to install CF8 onto redhat 9 / fedora 6.0.52.
    I did all the above steps and i still get the error that the Connector installation was not successful, can anyone give me any further guidance/ideas?
    Thanks in advance!!!

  11. Tristan Lee says:

    I am getting this error and none of the methods above fix my problem. When I run the apache-connector.sh file directly, I get this:

    [root@ns1 connectors]# ./apache_connector.sh
    Fedora release 9 (Sulphur)
    Server’s Module Magic Number: 20051115:11. Supported major magic numbers on this platform are 20020628 and 20020903.
    Attempting to build connector from sources
    Server version: Apache/2.2.8 (Unix)
    /usr/lib/apr-1/build/libtool –silent –mode=compile gcc -prefer-pic -O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector –param=ssp-buffer-size=4 -m32 -march=i386 -mtune=generic -fasynchronous-unwind-tables -DLINUX=2 -D_REENTRANT -D_GNU_SOURCE -D_LARGEFILE64_SOURCE -pthread -I/usr/include/httpd -I/usr/include/apr-1 -I/usr/include/apr-1 -I/usr/include/mysql -w -c -o /opt/coldfusion8/runtime/lib/wsconfig/1/mod_jrun22.lo /opt/coldfusion8/runtime/lib/wsconfig/1/mod_jrun22.c && touch /opt/coldfusion8/runtime/lib/wsconfig/1/mod_jrun22.slo
    cc1: error: unrecognized command line option “-fstack-protector”
    cc1: error: invalid parameter `ssp-buffer-size’
    /opt/coldfusion8/runtime/lib/wsconfig/1/mod_jrun22.c:1: error: bad value (generError running “/opt/coldfusion8/runtime/lib/wsconfig/1/build_jrun22”: exit code was 1
    Could not build Apache2 web server connector from source. Use build script /opt/coldfusion8/runtime/lib/wsconfig/1/build_jrun22.
    ic) for -mtune= switch
    apxs:Error: Command failed with rc=65536
    .

  12. Ryan Stille says:

    Tristan, first of all just to be clear the error you are getting is not related at all to the problem I’m addressing in this blog post.

    Secondly, you are aware you are installing on an unsupported platform? Adobe says CF8 runs on RedHat Enterprise 3, 4, or 5. RHEL 5 is based on Fedora 6, so you are a few versions newer. Not that it won’t run, but some issues are to be expected.

    I would start by googling for the error message you are getting. Searching for “apxs:Error: Command failed with rc=65536” turns up a lot of stuff, not ColdFusion related, but I don’t think your issue is specifically ColdFusion related.

  13. Tristan Lee says:

    I believe I had this working correctly on Fedora 8 by simply changing the paths as mentioned above and then the connector worked. I’m updating my libraries right now in hopes that will work.

  14. Sergio Felix says:

    Hi folks, just to let you know, I have RHEL5 and CF8 Enterprise on Apache 2.2.3 and I also had to do the path update inside the apache_connector.sh file.

    My connector name was cf-connectors.sh I just renamed that to cfmx-connectors.sh and voilá, no more boot errors!

    Btw, this wasn’t working on CF 8.0 and it’s still NOT fixed even after installing the CF 8.0.1 upgrade either.

    Anyway, thanks a lot for this post, It gave me like a four straight day’s headache. 🙂

  15. Aarni Da Octopus says:

    Hi,

    I had this error too, both with CF7 on CentOS 4 some time ago and now with CF8 on CentOS 5. All I had to do was rename the connector scripts, cfmx-connectors.sh and cf-connectors.sh, respectively.

    Best regards to all!

  16. tgs says:

    This thread really saved me a lot of time and headaches. I got coldfusion 8.1 up and running on Fedora 7 in about 30 minutes.

    Thanks to all who contributed.

  17. Aaron says:

    I am running Cent OS 5 and CF7 Dev edition.

    After receiving the JRUN/ColdFusion error I changed the pathing of apache_connectors.sh. However, when I attempt to run the script I still get the aforementioned error.

    I’ve tried so many different methods to fix this that I’m beginning to forget them.

    For anyone else’ consideration, here are 2 technotes that may help.

    http://kb.adobe.com/selfservice/viewContent.do?externalId=tn_19575&sliceId=2#apache

    http://kb.adobe.com/selfservice/viewContent.do?externalId=8001e97

  18. Aaron says:

    Whoops, just realized that I posted something that may be irrelevant…i’m getting my pages confused.

  19. Diane says:

    I am having problems with CF8 on RHEL5 Apache2.  I have updated the connectors file per everyone's instructions with no change.  I get the trying to connect 12 times and no luck.  Did the post from Felix above mean that I need to change cf-connectors.sh to cfmx-connectors.sh even on a cf8 install.  

    I am so frustrated….

  20. Ryan Stille says:

    Diane, you are not giving us a lot to go on.  When you manually run the command that is in the connector script, do you get an error?  What is the error?

  21. Tad Reeves says:

    Same problem with me here – Fedora 10 x64, running Apache 2.2.  Needed to install the httpd-devel package due to error logged in ConnectorInstall0.txt in the main CF install directory.  

    It throws the error: "Could not find the required apxs (Apache Extension Tool) binary /usr/sbin/apxs. Check that package httpd-devel package is installed.Could not build Apache2 web server connector from source.  Use build script /opt/coldfusion8/runtime/lib/wsconfig/1/build_jrun22."

  22. dillon says:

    centos 5.3 cf8 apache2
    thnaks WeBoat and Greg M
    Stop CF8
    yum install httpd-devel
    restart httpd
    start CF8
    Shazam

  23. Jason says:

    Hi,

    I have CF 8.01 and CentOS 5.4. I have done all of this, but I get an internal server error when I try to hit a .cfm page after. I checked cfserver.log and I do have some permission denied errors.

    /opt/coldfusion8 is set to apache:root and some directories apache:apache (as done by the install.

    Would I need to chmod anything?

  24. Ryan says:

    Usually you don't need to chmod anything.  Do the permission denied errors tell you where its failing?  Also look at the other log files, they are under runtime/bin I think.  Also check the apache log.

  25. jyoseph says:

    Had the same issues decribed here w/ the connector trying 12 times. Coldfusion 8 on fresh install of CentOS 5.4.

    Pretty much followed your instruction, along with instructions to yum install httpd-devel by greg m/weboat/dillon and I'm in business.

    I appreciate your time to document this and for everyone who contributed.

  26. Christopher Jazinski says:

    Awesome! CF 9 on CentOS 5.4 I needed the httpd-devel before i could run the cf-connectors.sh. Thanks

  27. Wendy Roberts says:

    Thank you! Helped with my Coldfusion 9 installation – also had to install httpd-devel and correct the paths.

    Cheers.