Setting Up For Local CF8 Development with CFEclipse, Subversion(SVN) Ready

Installing and Configuring Apache 2.2.4

After installation of Apache, create a new folder called www on the C drive (C:\www).

Go up one level to:

1. Scroll down to Document Root and change it to:
   Document Root C:/www
2. Scroll down further to the second Directory tag and change that line to:
   #
   # This should be changed to whatever you set DocumentRoot to.
   #
   <Directory C:/www>
   Notice the comments which should be above the Directory tag you will change.
   

   Update on 11/27/2007: In order for things like the new AJAX features of CF8 to work properly, the CFIDE folder must be mapped correctly. Check out this new blog entry for further configuration of this httpd.conf file before the process is complete: How To Map Apache Virtual Hosts to CFIDE

3. Scroll down near the bottom of the file and find the line that looks like this:
   # Virtual hosts
   #Include conf/extra/httpd-vhosts.conf
   Remove the # (pound sign) to uncomment the line, like this:
   # Virtual hosts
   Include conf/extra/httpd-vhosts.conf
4. Process Complete. Restart Apache server by left-clicking the Apache Icon in the windows taskbar and selecting Apache 2>Restart.

NOTE: You can also right-click the Apache Icon and select Apache Monitor, which opens a dialog box. Then click the Restart button. This option lets you view the server stopping and restarting.

Configuring httpd-vhosts.conf on Apache

Configuring HOSTS

In this file you just add a new line for each site you add. The IP is always local, 127.0.0.1

Installing ColdFusion 8 Dev Edition

Export CF8 Beta Settings

Open the CF Administrator and on the left menu toward the bottom, there's an option called: Packaging and Deployment. Click on ColdFusion Archives. Enter a archive name, which is a filename with a .car on it - click Create.

NOTE: If you are using Firefox it will block the popup necessary to complete the process. Click the Options button in the upper right corner and select Allow Popups for 127.0.0.1. Then repeat this process again, until you can see the popup window.

In the popup window you have a choice. Either click Select All, and all settings will be written to the file. Or if you want to reduce the file size, you can select individual sections. Along the left edge are a bunch of links. Click one and the select the options you want to export. Keep Clicking and configuring until you have everything you want. When you are finished click the Close Window button.

Now it is time to Build the .car file. In the Actions column, next to your .car file, there are three circular button links. The first one Edit the config, Second one builds the .car file, and third one deletes. Click the center button.

A popup window opens showing its settings. Click Next in the bottom right corner. Choose a location to write the file, and then manually type in the name of your .car file. When you click next it will build the file. An alert box will indicate: Build Successful. Click OK. Click Close.

End of .car export process.

Now you can turnoff your Windows Services that ColdFusion is using and uninstall. When you reinstall, most of the settings you'll leave as default, but here are a few exceptions:

• I use the single server option (not multi-server), but you can choose multi-server if you want.
• For the Web Server, if you're using Apache, you'll need to click the Add button
  A dialog box pops up asking three questions:
  1. Apache
  2. "C:\Program Files\Apache Software Foundation\Apache2.2\conf"
  3. "C:\Program Files\Apache Software Foundation\Apache2.2\bin\httpd.exe"
• Change the location of the Webroot to
  C:/www
• Change the location of the ColdFusion 8 Administrator to C:\www\localhost\
That's the end of the process for Apache. If you're using IIS, use the settings the installer chooses for you unless you want to custom configure them.
• Make sure you enable RDS and enter passwords for it
• If you have trobule finishing the part of the install that runs in the web browser, open a browser manually and enter
  http://127.0.0.1/CFIDE/Administrator/index.cfm
• Installation should have completed without errors. If it reported errors you'll need to stop the ColdFusion Services, Uninstall, Delete "C:\ColdFusion 8" folder, and install it again.

Importing .car File

Installing Eclipse

Install the Tortoise MSI file.

About Eclipse Workspaces

I recommend creating a Workspaces directory on the C:\ drive and keep all of your Workspaces in that directory.

Configuring Eclipse and Installing Plug-ins

If you require proxy info, then before installing plug-ins enter your proxy settings into Eclipse. In Eclipse find Window>Preferences. In Preferences expand General and select Network Connections. Enter your proxy info.

The process of installing plug-ins has been greatly simplified in the past year. For every plug-in that has a remote site URL, you will follow this process:

Here is a list of the plugins and their URLS that I am using:

1. In the menus along the top find Help>Software Updates>Find and Install.
2. Select the Radio button next to: Search for new features to install and click Next.
3. Click the New Remote Site button.
4. In the box that pops up, enter any name you'd like to describe the plugin, and then enter the plugins URL. Click OK.
5. Wait for Eclipse to contact the download sites and get the latest plugin info. Eclipse will add the plug-in you manually add to the list that already exists too.
6. Now you check the boxes of the plugins you wish to install, but be careful. Checking the Parent checkbox selects all child checkboxes, and sometimes you don't want all of the children.
7. As mentioned before, there are already some plugins listed in the Software Updates window. You should click the + next to Europa Discovery Site.
   • Under Java Development, click the check box for J2EE Standard Tools.
   • Under Web and JEE Development, click the checkbox for Web Standards Tools (WST).
   Once those plugins are checked you might see an error message in the top of the window. This is telling you that other plugins are required to run the plugins you selected. Simply click the button on the right side that says Select Required. That will select everything else that is required to run the plugins you selected.
8. Install the ColdFusion 8 Extentions, which contain the line-by-line debugger and RDS functionality. Inside the Software Updates window click New Archived Site, enter any name that you'd like and then browse to the .zip file your downloaded. Click OK. Check the Box for it.
9. You should have everything you want to install checked. Now click Finish.

When it finishes it will ask if you want to re-start Eclipse - Select Yes.

That is it, everything is installed and configured for local development. See the Related Entry, How To Configure Eclipse to Work with Subversion Using Subclipse to get started with Subversion.