One week into being an Ubuntu convert and I still have ZERO complaints.  This distro of Linux is so comfortable to use that not once in the past week have I thought "Man, if I was just using Windows!".   This weekend, I setup CFMX7 Developer edition with Apache 2.2.2 which just became officially supported by Adobe a couple of weeks ago. 

There were a few tricks to setting up ColdFusion with Apache though so I thought I might write about it to save someone else a few minutes if they follow the same path.

***DISCLAIMER*** I am not a long-time Linux guy.  I do not claim to be doing things the "right" way.  I realize there are likely other more efficient ways to achieve the things I am doing, but I don't know about them! :)  That said...

• Installing Apache 2.2.2 - One of the painless things about setting up new software in Ubunutu (and other Debian distros) is the apt-get command.  For intance if you want to install Apache, just open a command propmet and type in:
  
  >$ sudo apt-get install apache2
  
  Then in a few minutes you have an instance of Apache running.   ***HOWEVER***..... this is not what you want to do in this case.  By doing apt-get, you (read "I") do not have the ability to recompile it to suit your needs.  I found that when I tried to use the ColdFusion connector tool, it failed due to the installation type of Apache that I had.  So, to remove this I did:
  
  >$ sudo apt-get remove apache2
  
  I then removed the startup scripts from /etc/init.d.  Once this was complete found that there were a few prerequisites I needed as I went through the Apache compile/install.  


1. Make sure you have GCC installed, which was not installed on my system.  To do this run:
   >$ sudo apt-get install gcc
2. You also need a C compiler installed.  I am not sure this is the most efficient method, but what worked quite simply for me was to install Build Essential like this:
   >$ sudo apt-get install build-essential
3. I also found that I needed ZLib installed.  I pulled down the source from the ZLib project page and did the following:
   
   • extract tar to a directory and terminal into it.
     
   • run >$ sudo ./configure
   • run >$ sudo make
   • run >$ sudo make install
     
4. Once these prerequisite steps are taken, you are ready to install Apache.  Do the following:
   
   • Download the UNIX source here
   • Extract the tar file into a working directory and terminal into it.
   • run >$ sudo ./configure --prefix=/usr/local/apache2 --enable-mods-shared=all
   • run >$ sudo make
   • run >$ sudo make install
   You can start Apache now by running >$ sudo /usr/local/apache2/bin/apachectl start and test your installation by pulling up http://localhost/.
   
   
   
• Installing ColdFusion MX7 - Now that Apache is intalled we can install ColdFusion.  Pull down the latest ColdFusion binary from www.adobe.com.  There is nothing exceptionally tricky during the installation process except for a couple of key points. 
  
• During the pre-installation checklist you may get a warning regarding a missing C++ compatability pack.  This is used for C++ custom tags, and I believe for Verity as well.  I disregarded this warning and moved on.  I did choose to install "Search Services" when prompted however, and will address that issue in the near future with a Verity project that I have on the horizon.  When I do that I will come back and update this post.
• Another point to note is that I chose the multi-server installation.  I am not sure how the server configuration might differ from these steps.
• Lastly, when you get to the point of choosing which webserver you would like to use, choose the internal webserver that ships with ColdFusion.
  
  
• Once the installation is complete and you start the ColdFusion server by running:
  >$ sudo /opt/jrun4/bin/jrun start cfusion
  ... and then testing your installation by going to http://localhost:8300/CFIDE/administrator/
  
  
• Now it is time to connect ColdFusion to Apache.  You need to have the updated wsconfig.jar that was released in May 2006, and can be downloaded here.  Make a backup of /opt/jrun4/lib/wsconfig.jar ($> sudo mv wsconfig.jar wsconfig.jar.bak) and replace it with the wsconfig.jar in that zip file. 
  
  
• Stop and start the jrun process so that it picks up the new wsconfig.jar.
  
  
• Now open the connecter by running: >$ sudo /opt/jrun4/bin/wsconfig.  Once it opens make the following changes:
  
  1. For "Web Server" choose Apache
  2. For configuration directory, choose: /usr/local/apache2/conf
  3. Check the box for "Configure webserver for ColdFusion MX applications"
  4. Click OK and accept the prompt to restart the webserver.
     
     
• Copy the CFIDE directory into your webroot so that you have access to the ColdFusion administrator.  Run the following:
  >$ sudo cp -R /opt/jrun4/servers/cfusion/cfusion-ear/cfusion-war/CFIDE/ /usr/local/apache2/htdocs/

At this point you should be able to log into the ColdFusion administrator by going to:
http://localhost/CFIDE/administrator/index.cfm.

Have fun!