I wrote a blog entry over a year ago discussing how to install Coldfusion on Windows 2008.
With the imminent release of Windows 7 and several user comments I decided to update the instructions for myself and anyone else who finds it useful.
I've installed Coldfusion 8 and 9 on most versions of Windows. I used the default setup options.
To make the Coldfusion install as painless as possible you need to take a few pre-installation steps.
(Unless otherwise noted the instructions apply across all versions.)
- Installer MUST be run using an administrator account.
- Ensure Windows and IIS components installed. NOTE: Core installs are not supported.
- Check ISAPI Extensions and Filters.
- Check ALL the IIS6 management items.
x64 USERS ONLY:
If you are installing 32-bit Coldfusion on a 64-bit Windows platform you need to ensure that your IIS application pool is setup to run 32-bit applications.
- Windows Vista / Server 2003 / Server 2008cscript %SystemDrive%\inetpub\AdminScripts\adsutil.vbs set w3svc/AppPools/Enable32bitAppOnWin64 1
- Windows 7%windir%\system32\inetsrv\appcmd set apppool /apppool.name:DefaultAppPool /enable32BitAppOnWin64:true
- Windows Vista / Server 2003 / Server 2008
NotesInstalling the 64-bit version will likely break any code that excutes 32-bit code (i.e. CFX and COM). I've also run into intermentent issues when using <cfexecute> to call a 32-bit executable.
500 errors are like the BSOD of IIS. Something didn't work and IIS doesn't know why.
Here are a few things that you can try before completely hosing your install:
Check permissions! (I hate that one.)
- Does the Coldfusion service account have access to the resource you are trying to access?
- Does the IIS user have access to the resource?
- Ensure the App pool being used is set to use a valid Identity in the Advanced Configuration dialog. For reference mine is set to ApplicationPoolIdentity
- Is the Coldfusion service running?
Are the appropriate IIS mappings setup? By doing the pre-install steps, the Coldfusion installer should setup the appropriate IIS mappings.
Errors occur on a specific page?
- YES: Any CFX tags or remote service dependent tags like cfexchangeconnection on the page?
- NO: Ensure non-Coldfusion content is accessible (i.e. IIS is functioning).
Errors when browsing non-Coldfusion content?
- YES: Probably IIS related.
- NO: Coldfusion/IIS connector related.
Check the application pool.
- Is the application pool running?
- x64 users running 32-bit Coldfusion must enable the application pool to run 32-bit apps. See #3 above.
- The application pool might be corrupt. More on creating application pools.