ColdFusionMX and Apache 2.0.40 How-To

Posted by Aaron West at 10:42 AM in ColdFusion

I recently purchased a new laptop and embarked on installing all the applications and software that I need. When it came time to install ColdFusion and a web server I thought twice about using Microsoft's Internet Information Server. I wanted to run ColdFusionMX and up until then I had only run CFMX on the built-in standalone web server. Avoiding IIS would save me time and potentially money. Time would be saved by not having to keep up with the plethora of security patches and critical updates. I decided to go with the well-known and highly favored Apache HTTP Web Server.

Over the last week I've been wrestling with Apache and CFMX trying to get everything set up and running properly. At first, Apache wasn't processing my CF templates. Later, I was prompted by Internet Explorer to open the CF templates or save them to the disk. All of these things happened over the course of approximately 4 installs of both the CF Server and Apache. Finally, I have it all working and I owe a lot to Todd Rafferty and Debbie Dickerson. So how did I finally get it working? Here's how:

Applicable Software Versions:

ColdFusionMX Application Server (we'll start with the initial release and end up installing the CFMX updater). View the updater release notes and download the updater here.

Apache 2.0.40

Steps to a proper installation:

1. If you already have ColdFusionMX installed, and can afford to uninstall it, I recommend doing that in this step.

2. If Apache is installed, skip to step 3, otherwise install Apache as normal.

3. Install ColdFusionMX being sure to select the Apache web server instead of the standalone web server. Also, be sure to install the web folders/files (the CFIDE directory) into your Apache installations htdocs folder (instead of the wwwroot folder under C:\CFusionMX). This is generally C:\Program Files\Apache Group\Apache2\htdocs\.

4. Stop the three ColdFusionMX services.

  1. ColdFusion MX Application Server
  2. ColdFusion MX ODBC Agent
  3. ColdFusion MX ODBC Server

5. Install the ColdFusionMX updater.

6. Run the batch file that removes ALL ColdFusion connections to Apache. The batch file is located here: C:\CFusionMX\bin\connectors and is called Remove_ALL_connectors.bat.

7. Run the batch file that ADDS the necessary connector from ColdFusion to Apache. The batch file is located here: C:\CFusionMX\bin\connectors and is called Apache_connector.bat.

8. Verify that the connector was installed properly. Do this by navigating to your Apache installation. You are looking for the Apache server configuration file which is usually located here: C:\Program Files\Apache Group\Apache2\conf and is called httpd.conf. Open this file in Notepad or your text editor of choice and check to see if the necessary connector lines have been added towards the end of the file. The lines should appear just before the Virtual Hosts section. Greymatter has one downside in that I can't post the actually code you'll be looking for. However, you should see a line like: Bring in additional module-specific configurations and LoadModule jrun_module "C:/CFusionMX/runtime/lib/wsconfig/1/" All-in-all, the connector adds 18 lines of code.

9. Test your work by attempting to load the ColdFusionMX Administrator using the Apache web server. http://localhost/cfide/administrator/index.cfm

If the CF Admin loads and looks fine, then you're good to go.

Aaron West's Gravatar
About this post:

This entry was posted by Aaron West on September 29, 2002 at 10:42 AM. It was filed in the following categories: ColdFusion. It has been viewed 1917 times and has 0 comments.

0 Responses to ColdFusionMX and Apache 2.0.40 How-To