Stillnet Studios

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.

This entry was posted on Thursday, April 5th, 2007 at 9:20 pm and is filed under Web Development, System Administration, Linux.