Installing Apache 2.0.59 to a Windows-based computer, locally: Part 2

In Part 1 of this Apache 2.0.59 guide, we setup Apache 2.0.59 on a Windows XP SP2 machine. We also setup Perl and mod_perl, attempting to mimic our Apache 1.3.34 install. This time, we'll be continuing in our quest by installing ColdFusion MX 6.1 and 7.

Assumptions

First, I assume that you've already installed ColdFusion MX. Of course, you may not have installed 6.1 and 7, but I'm going to assume you've installed at least one. If you've installed neither, then you may want to check out my guides on ColdFusion MX 6.1 and/or ColdFusion MX 7.

Since you'll be making modifications to the httpd.conf file for Apache 2.0.x, you'll also want to back this file up.

It's also important to determine how many installations of ColdFusion MX you'll be doing. You'll need to know this to determine whether or not you'll need to switch between one version of ColdFusion and another. I'm going to assume that you'll be enabling both, so feel free to skip whatever steps as necessary below.

Keep in mind that if you're just going to install ColdFusion MX, then the steps below will not be necessary. This is only if you've already installed ColdFusion MX for Apache 1.3.x.

Hooking up ColdFusion MX 6.1

Start by creating a backup copy of the httpd.conf.

When ColdFusion MX 6.1 is installed, it inserts the following lines into the httpd.conf file.

# JRun Settings
LoadModule jrun_module "C:/CFusionMX/runtime/lib/wsconfig/1/mod_jrun.so"
<IfModule mod_jrun.c>
JRunConfig Verbose false
JRunConfig Apialloc false
JRunConfig Ssl false
JRunConfig Ignoresuffixmap false
JRunConfig Serverstore "C:/CFusionMX/runtime/lib/wsconfig/1/jrunserver.store"
JRunConfig Bootstrap 127.0.0.1:51010
#JRunConfig Errorurl <optionally redirect to this URL on errors>
AddHandler jrun-handler .jsp .jws .cfm .cfml .cfc
</IfModule>

Unfortunately, Apache 2.0.x requires a different mod_jrun.so file altogether. This means that we'll need to get a copy of this file, and point our httpd.conf file to it.

What we're first going to do is copy this text into the Apache 2.0.x httpd.conf file. On Apache 1.3.x, ColdFusion MX adds this after the BrowserMatch content, so we'll do a search for BrowserMatch, from the bottom of the file, and add the above lines after the following line.

BrowserMatch "^Dreamweaver-WebDAV-SCM1" redirect-carefully

There's some modifications that we'll need to make. As you can see below, I've pointed to the /2/ folder, and mod_jrun20.so file (which doesn't yet exist).

# JRun Settings
LoadModule jrun_module "C:/CFusionMX/runtime/lib/wsconfig/2/mod_jrun20.so"
<IfModule mod_jrun20.c>
JRunConfig Verbose false
JRunConfig Apialloc false
JRunConfig Ssl false
JRunConfig Ignoresuffixmap false
JRunConfig Serverstore "C:/CFusionMX/runtime/lib/wsconfig/2/jrunserver.store"
JRunConfig Bootstrap 127.0.0.1:51010
#JRunConfig Errorurl <optionally redirect to this URL on errors>
AddHandler jrun-handler .jsp .jws .cfm .cfml .cfc
</IfModule>

Now save httpd.conf. Next, head over to the C:\CFusionMX\runtime\lib\wsconfig\ folder. Within this folder there will be a '1' folder, and three files (jrunwin32.dll, wsconfig.log, and wsconfig.properties).

First, create a copy of the '1' folder and call the copy '2'. Next, make a backup copy of the wsconfig.properties file, and open the original in Notepad.

This file currently contains the following information.

#JRun/ColdFusion MX Web Server Configuration File
#Thu Feb 23 19:08:04 GMT-06:00 2006
1=Apache,C:/Program Files/Apache Group/Apache/conf,"",C:\\Program Files\\Apache Group\\Apache\\Apache.exe,""
1.srv=localhost,"default"
1.cfmx=true,<null>

What we're going to do is copy the last three lines (they all start with '1') to the end of the this file. We're then going to enter a bunch of '2's so that we have the following in this file.

#JRun/ColdFusion MX Web Server Configuration File
#Thu Feb 23 19:08:04 GMT-06:00 2006
1=Apache,C:/Program Files/Apache Group/Apache/conf,"",C:\\Program Files\\Apache Group\\Apache\\Apache.exe,""
1.srv=localhost,"default"
1.cfmx=true,<null>
2=Apache,C:/Program Files/Apache Group/Apache2/conf,"",C:\\Program Files\\Apache Group\\Apache2\\Apache.exe,""
2.srv=localhost,"default"
2.cfmx=true,<null>

Save and close wsconfig.properties. Now open the '2' folder. There's a mod_jrun.so file here, but as I said earlier, this won't work with Apache 2.0.x. So, we'll need to get the mod_jrun20.so file for Apache 2.0.x. You can get this file by installing ColdFusion and selecting Apache 2.0.x as the server. Since it's not particularly helpful in this case, I did so on another box, and have attached a zip file containing this file here (mod_jrun20.zip).

Save all necessary files and start the Apache2 service (either through the Services panel or through the Apache Services Monitor). Apache 2 should start, and you should be able to access the ColdFusion MX 6.1 Administrator Login.

Now, make a backup copy of the httpd.conf file and call it something like httpd_CFMX6.1.conf. With that, you're ready to either hook-up ColdFusion MX 7, or begin working on ColdFusion on Apache 2.0.x.

Hooking up ColdFusion MX 7.0.2

Start by creating a backup copy of the httpd.conf. If you went through the above steps, then you'll want to grab the pre-ColdFusion MX 6.1 httpd.conf backup file. Otherwise, you can just change the lines that we added above.

When ColdFusion MX 7 is installed, it inserts the following lines into the httpd.conf file.

# JRun Settings
LoadModule jrun_module "C:/CFusionMX7/runtime/lib/wsconfig/1/mod_jrun.so"
<IfModule mod_jrun.c>
JRunConfig Verbose false
JRunConfig Apialloc false
JRunConfig Ssl false
JRunConfig Ignoresuffixmap false
JRunConfig Serverstore "C:/CFusionMX7/runtime/lib/wsconfig/1/jrunserver.store"
JRunConfig Bootstrap 127.0.0.1:51011
#JRunConfig Errorurl <optionally redirect to this URL on errors>
#JRunConfig ProxyRetryInterval 600
#JRunConfig ConnectTimeout 15
#JRunConfig RecvTimeout 300
#JRunConfig SendTimeout 15
AddHandler jrun-handler .jsp .jws .cfm .cfml .cfc .cfr .cfswf
</IfModule>

Unfortunately, Apache 2.0.x requires a different mod_jrun.so file altogether. This means that we'll need to get a copy of this file, and point our httpd.conf file to it.

What we're first going to do is copy this text into the Apache 2.0.x httpd.conf file. On Apache 1.3.x, ColdFusion MX adds this after the BrowserMatch content, so we'll do a search for BrowserMatch, from the bottom of the file, and add the above lines after the following line.

BrowserMatch "^Dreamweaver-WebDAV-SCM1" redirect-carefully

There's some modifications that we'll need to make. As you can see below, I've pointed to the /2/ folder, the mod_jrun20.so file (which doesn't yet exist), and the mod_jrun20.c module.

# JRun Settings
LoadModule jrun_module "C:/CFusionMX7/runtime/lib/wsconfig/2/mod_jrun20.so"
<IfModule mod_jrun20.c>
JRunConfig Verbose false
JRunConfig Apialloc false
JRunConfig Ssl false
JRunConfig Ignoresuffixmap false
JRunConfig Serverstore "C:/CFusionMX7/runtime/lib/wsconfig/2/jrunserver.store"
JRunConfig Bootstrap 127.0.0.1:51011
#JRunConfig Errorurl <optionally redirect to this URL on errors>
#JRunConfig ProxyRetryInterval 600
#JRunConfig ConnectTimeout 15
#JRunConfig RecvTimeout 300
#JRunConfig SendTimeout 15
AddHandler jrun-handler .jsp .jws .cfm .cfml .cfc .cfr .cfswf
</IfModule>

Now save httpd.conf. Next, head over to the C:\CFusionMX7\runtime\lib\wsconfig\ folder. Within this folder there will be a '1' folder, and three files (wsconfig.log, and wsconfig.properties).

First, create a copy of the '1' folder and call the copy '2'. Next, make a backup copy of the wsconfig.properties file, and open the original in Notepad.

This file currently contains the following information.

#JRun/ColdFusion MX Web Server Configuration File
#Thu Mar 30 17:54:42 GMT-06:00 2006
1=Apache,C:/Program Files/Apache Group/Apache/conf,"",C:\\Program Files\\Apache Group\\Apache\\Apache.exe,"",false
1.srv=localhost,"coldfusion"
1.cfmx=true,<null>

What we're going to do is copy the last three lines (they all start with '1') to the end of the this file. We're then going to enter a bunch of '2's so that we have the following in this file.

#JRun/ColdFusion MX Web Server Configuration File
#Thu Feb 23 19:08:04 GMT-06:00 2006
1=Apache,C:/Program Files/Apache Group/Apache/conf,"",C:\\Program Files\\Apache Group\\Apache\\Apache.exe,""
1.srv=localhost,"default"
1.cfmx=true,<null>
2=Apache,C:/Program Files/Apache Group/Apache2/conf,"",C:\\Program Files\\Apache Group\\Apache2\\Apache.exe,"",false
2.srv=localhost,"coldfusion"
2.cfmx=true,<null>

Save and close wsconfig.properties. Now open the '2' folder. There's a mod_jrun.so file here, but as I said earlier, this won't work with Apache 2.0.x. So, we'll need to get the mod_jrun20.so file for Apache 2.0.x. You can get this file by installing ColdFusion and selecting Apache 2.0.x as the server. Since it's not particularly helpful in this case, I did so on another box, and have attached a zip file containing this file here (mod_jrun20.zip).

Save all necessary files and make sure that you rename the cfdocs and cfide folders as necessary (that is, you'll need to make sure you have the CFMX 7 folders available to start ColdFusion MX 7). Start the Apache2 service (either through the Services panel or through the Apache Services Monitor). Apache 2 should start, and you should be able to access the ColdFusion MX 7.0 Administrator Login.

Now, make a backup copy of the httpd.conf file and call it something like httpd_CFMX7.0.conf. With that, you're ready to begin working on ColdFusion on Apache 2.0.x.

In the next part ...

In Part 3, we'll go over the PHP 4 and 5 installation. We also still have to connect to MySQL and PostgreSQL (which may end up being Part 4). Until then, have fun in ColdFusion MX on Apache 2!

View all of the steps to creating a local Web server, for development.