Installing CFWheels

[davidd]

Here are some steps for installing CFWheels on ColdFusion 8 and 9:

1. Download the latest version from http://cfwheels.org/download

2. Unzip the contents to a folder on your computer

3. Remove the "web.config" and "IsapiRewrite4.ini" files.

4. Edit the ".htaccess" with any plain text editor(I.E. notepad, wordpad, etc.) and replace the contents with the following:

RewriteEngine On

RewriteCond %{REQUEST_URI} !^.*/(flex2gateway|jrunscripts|cfide|cfformgateway|railo-context|files|images|javascripts|miscellaneous|stylesheets|robots.txt|sitemap.xml|rewrite.cfm)($|/.*$) [NC]
RewriteRule ^(.*)$ /rewrite.cfm/$1 [L]

5. Setup a MySQL database and create a ColdFusion DSN for the database. Below are some tutorials on how to do this through the Helm control panel:

Helm3:

How to create a MySQL Database

How to create a ColdFusion DSN


Helm4:

How to create a MySQL Database

How to create a ColdFusion DSN


6. Edit the "config/settings.cfm" file in a plain text editor and enter your datasource name and your database username and password. Also, remove the comments around that section:

Example:

	<cfset set(dataSourceName="MyDSNName")>
	<cfset set(dataSourceUserName="MyDatabaseUsername")>
	<cfset set(dataSourcePassword="MyDatabasePassword")>

7. Upload the files to your site(they must be inside the /wwwroot folder for URL rewriting to work properly).

Browse to your site, and you should see the default CFWheels home page.


David D.

[brianward]

You'll want to also add the path "CFFileServlet" to the .htaccess file if you want to use the "CFFILE" tag or any other ColdFusion tag that generates a file.