How to install ColdFusion 8 on Leopard (OSX)
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/ mod_jrun22.la
- strip mod_jrun22.so
- sudo cp /Applications/JRun4/lib/src/connectors/src/mod_jrun22.so /Applications/JRun4/lib/wsconfig/1/mod_jrun22.so
- 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)
Enjoy!
Update: 31-Oct-2007
Couple more community posts on this that you might find interesting:
Let me know of anymore in the comments.
Comments
Aaron Roberson on 31 Oct 2007 08:39 AM
I tried it exactly as you have detailed here but when I go to start ColdFusion in the terminal it hangs at: 10/30 13:58:05 user FlexInternalServlet: init When I check the apachectl service with the -t flag I get the following: httpd: Syntax error on line 484 of /private/etc/apache2/httpd.conf: Cannot load /Applications/JRun4/lib/wsconfig/1/mod_jrun22.so into server: dlopen(/Applications/JRun4/lib/wsconfig/1/mod_jrun22.so, 10): no suitable image found. Did find:\n\t/Applications/JRun4/lib/wsconfig/1/mod_jrun22.so: mach-o, but wrong architecture
John on 09 Nov 2007 01:52 AM
I ran into two issues: 1) /1 did not exist in the /Applications/JRun4/lib/wsconfig so I had to create it (using su rights) 2) When I was all finished http://localhost/CFIDE/administrator/index.cfm promts to download What a pain in the @$$. I wish I didn't upgrade to leopard. The problems are greater than the enhancements in this case.
rob on 13 Nov 2007 07:49 PM
It worked thank you soo much :) the above issue sounds more of an apache config issue than an 10.5/cf8 one.
Spaceman Spiff on 17 Nov 2007 12:48 PM
I followed the instructions then ran into this problem when I tried to start coldfusion... 11/16 20:19:24 error Exception creating connection to: 169.254.151.87; nested exception is: java.net.SocketException: Host is down [1]java.net.SocketException: Host is down at java.net.PlainSocketImpl.socketConnect(Native Method) at java.net.PlainSocketImpl.doConnect(PlainSocketImpl.java:333) at java.net.PlainSocketImpl.connectToAddress(PlainSocketImpl.java:195) Any thoughts? Thanks in advance
Gavin Stewart on 24 Nov 2007 05:31 AM
Thanks for the instructions Geoff! Champion! You forgot to mention configure apache to use index.cfm <IfModule dir_module> DirectoryIndex index.cfm index.html </IfModule>
Shahryar on 24 Dec 2007 05:00 AM
I followed the instructions here and ran into the same problems that John described. To fix the problem of not being able to put the mod_jrun22.so file in the wsconfig folder, I had to change the settings in finder to allow me to read and write (before, it was set to read only). Once that was done, I manually copied the .so file. Changing the httpd.conf file in /etc/apache2/folder was also a little tricky. I had to first get to it using the "Go to Folder" command in finder and then in order to make changes, I had to copy it to my desktop, make the changes as mentioned by Gavin in the comments section, and then repaste it back in the original apache2 folder, overwriting the file already there. Now however, when I open up my browser to: http://localhost/CFIDE/ Using Safari, any link that I click on (for example: the Application.cfm file or the adminstrator folder) saves as a .class file. Any ideas on what's wrong?
R.R. on 14 Feb 2008 11:47 PM
Thanks, this guide worked. At first i was just getting an error page saying that there was a misconfiguration in my server settings. Killing ALL the jrun processes and then starting manually fixed the issue. Having said that, I told it to auto start and I still neeed to test once I reboot. - But I for now its working and I still have to finish getting PHP and mysql going.
Calculater on 27 Feb 2008 11:49 AM
Having a very hard time with the Coldfusion installation and. After the installation, I cannot find the cfm file. I can only find it available to me to download. After rebooting it, I still have the same problem. It doesn't run correctly even though I'm Using MAMP Pro. Let me ask a friend and see if he can do it.
angel on 07 Mar 2008 04:31 AM
all work fine untill this comand: /Applications/JRun4/lib/wsconfig/1/mod_jrun22.so in this part doesn`t exist de dir 1, what can i DO?
David Simmer on 09 Mar 2008 10:52 AM
Exactly the same hang and error message regarding mod_jrun22.so What's the fix?
David Simmer on 09 Mar 2008 01:18 PM
Scott Pinkston has posted a recomplied mod_jrun22.so: http://www.scottpinkston.org/blog/index.cfm/2007/10/29/ColdFusion-8-on-Leopard-with-Apache--an-answer-for-the-rest-of-us This solved the problem that I experienced ... Aaron, hope it takes care of things for you too.
Patrick Tai on 11 Oct 2008 04:47 PM
Apple has released a security update that breaks the connector - when starting Apache it you get a syntax error message in the http.conf something like the image could not be loaded wrong structure file for mod_jrun22.so - simply by recompiling it it fixes the problem.