How to install ColdFusion 8 on Leopard (OSX)

written by Geoff Bowers on Tuesday, 30 October, 2007 @ 04:33 PM

The upgrade to Leopard may cause some havoc in your ColdFusion 8 development environment. We've cobbled together some tips and tricks from the community at large to get you going again, until Adobe have time to catch up and release an official update.

Leopard upgrades the underlying Apache server from 1.3 to 2.2. This is why your ColdFusion installation has gone up the tubes. The standard installer has no "web connector" for this Apache version on OSX, so you basically have to compile your own. It's not too arduous, but dropping to the terminal and compiling can be a little intimdating for GUI types.

These recommendations worked for us and are largely the collective thoughts of several community members. We put them here in a succinct list of steps.

  • Install Leopard.
  • Install the XCode Developer tools; you'll find this under your optional install directory option on the Leopard DVD. You'll need the updated GCC compiler in this lot -- yep it is a big install.
  • Uninstall ColdFusion 8; remove any remaining folders. Empty trash.
  • Restart; seems like the only way to be sure ColdFusion is truly gone. "Nuke it from orbit, its the only way to be sure."
  • Reinstall ColdFusion; just run the standard installer.
  • Select Multi-Server installation. This will install JRun etc. We haven't tried the "standalone" install, so we can't vouch for its success.
  • Web connector: when you get to the web server set up, select Apache and fill in the following details:
    • Configuration directory: /etc/apache2
    • Server Binary: /usr/sbin/httpd
    • Server Control Script: /usr/sbin/apachectl
  • Complete installation wizard. It will not be able to launch the CFIDE URL to complete the install. Don't worry.. continue on.
  • Open a terminal window and compile a new JRun "web connector". Type in the following verbatim, each point on its own line (hitting enter after each line):
    • cd /Applications/JRun4/lib
    • unzip -d src wsconfig.jar
    • cd src/connectors/src
    • apxs -c -Wc,-arch -Wc,x86_64 -Wl,-arch -Wl,x86_64 -n jrun22 mod_jrun22.c jrun_maptable_impl.c jrun_property.c jrun_session.c platform.c jrun_mutex.c jrun_proxy.c jrun_utils.c
    • apxs -i -n jrun22 -S LIBEXECDIR=/Applications/JRun4/lib/src/connectors/src/
    • strip
    • sudo cp /Applications/JRun4/lib/src/connectors/src/ /Applications/JRun4/lib/wsconfig/1/
  • Restart OSX. Basically you need to stop/start ColdFusion but we experienced various issues attempting to do this depending on the workstation. Safe bet seemed to be just restarting the OS.
  • Manually start ColdFusion and restart Apache:
    • sudo /Applications/JRun4/bin/jrun -start cfusion
    • sudo apachectl restart
  • Browse to the following URL and complete the ColdFusion installation: http://localhost/CFIDE/administrator/index.cfm
  • Keep your fingers crossed!

If you still have no joy at all, you might find the following commands useful for debugging:

  • sudo apachectl -t (tests Apache config and reports errors)
  • sudo apachectl restart (restarts Apache)
  • sudo java -jar /Applications/JRun4/lib/wsconfig.jar (runs the web connector config tool)
  • sudo /Applications/JRun4/bin/jrun -start cfusion (starts default ColdFusion instance)
  • sudo /Applications/JRun4/bin/jrun -stop cfusion (sops default ColdFusion instance)


Update: 31-Oct-2007

Couple more community posts on this that you might find interesting:

Let me know of anymore in the comments.