# Installing ColdFusion on Windows

This section addresses the following topics about installing ColdFusion on Windows:

- "Verifying that a Web server is running"
- "Installing ColdFusion"
- "Uninstalling ColdFusion"
- "Performing Windows-specific configurations"

## Verifying that a Web server is running

Before installing ColdFusion, check that your Web server is installed and running. You can do this by loading a page in your Web browser using the HTTP protocol.

| To check that your Web server is running:

Do one of the following actions:

- Enter the URL for a Web page or site in your browser's Address field and press Enter.

  For example, if the file myindex.htm is in your Web document root directory, load the page in your browser using the localhost URL:

      http://127.0.0.1/myindex.htm

  If your Web server is not running, you'll receive an error message.

- You can also check the Services icon in the Windows Control Panel or open your Web server administration utility to determine if your Web server is started or stopped.

## Installing ColdFusion

The installation procedure assumes you are installing from a CD. If you purchased and downloaded ColdFusion from the Allaire Online Store, follow the download instructions found there. Then follow the install procedure below, skipping step 2.

We recommend that you close all open applications before running the Setup program. This will ensure proper installation of the ODBC 3.0 drivers.

Note | Because of a problem in the way Verity handles indexing, ColdFusion must be installed to a directory path that contains no spaces in the path name. This restriction is necessary so that ColdFusion can properly access Verity collections.

| To install ColdFusion on Windows:

1. Log in to your system using the administrator's account or an account that is part of the Administrator's group.
2. Insert the ColdFusion Server v4.5 CD into your CD drive or access it from your network jukebox (Enterprise users).
3. Click Start>Run to display the Run dialog box.

4. Enter the path where the ColdFusion Setup.exe resides or click Browse to drill down to it.
5. Click OK.

   The ColdFusion v4.5 Setup program starts and displays the ColdFusion Setup Welcome page.

6. Click Next in the Welcome and Software License Agreement dialog boxes.

   The User Information dialog box appears after the Software License Agreement dialog box.

7. Enter your name, company, and ColdFusion serial number in the User Information dialog box and click Next.

   Note | You'll find your ColdFusion serial number on the product box.

   The Choose Destination Directory dialog box appears next.

8. Accept or change the default destination folder and click Next.

   The Select Web Server dialog box appears.

   If your Web server is already installed, the ColdFusion Setup program will automatically detect it.

9. If your Web server is not one of the ones listed, select the Other option and click Next. Otherwise, just click Next.

   The Select Web Server Document Directory dialog box appears next.

10. Either accept the Web server's default document directory or enter a different location for the default directory and click Next.

    Note | ColdFusion documentation and example code are installed in a subdirectory below the Web server's document directory.

    The Select Install Options dialog box appears.

11. Accept the default install options or select those that you want and click Next.

    Note | By default, Load Balancing and High Availability and Advanced Security Services are not installed. However, you can install either of them later by re-running the Setup program. For explicit instructions about installing the Load Balancing and High Availability services, see "Installing ClusterCATS". To install Advanced Security, see "Installing Advanced Security".

    The Select Administrator Password dialog box appears next.

12. Enter a password you will use to access the ColdFusion Administrator in the Password and Confirm fields and press Next.

    The Select ColdFusion Studio Password dialog box appears.

13. Enter a password in the Password and Confirm fields that you will use to access the ColdFusion Server when developing applications with ColdFusion Studio and press Next.
14. Click Next or OK in the remaining dialog boxes to begin copying the ColdFusion files to the server.

    If your system has a previous version of ColdFusion, the setup wizard replaces ColdFusion program files but does not remove or change any existing application pages (template files) that may be present.

    ColdFusion updates the Windows registry and the ColdFusion services start. If you chose to install the ODBC Desktop Drivers, a warning screen appears. Close all open applications before installing the drivers.

15. Click Finish to complete the installation.
16. To verify your installation, click Start>Programs>ColdFusion Server 4.5>ColdFusion Administrator to open the ColdFusion Administrator. Alternatively, you can enter the following URL into your browser:

        http://hostname/CFIDE/Administrator/index.cfm

    where hostname is the name of the server hosting ColdFusion.

If ColdFusion is not properly installed after following the steps above, please call Allaire Customer Service for assistance.

## Uninstalling ColdFusion

If you need to remove an installed version of ColdFusion, run the ColdFusion Uninstall Utility to make sure all of the program files and registry settings are removed completely from your system.

| To uninstall ColdFuison:

1. Click Start>Programs>ColdFusion Server>Uninstall ColdFusion.

   The InstallShield Uninstall program starts and displays the following confirmation dialog box.

2. Click Yes to delete all ColdFusion program files and components from your system. Otherwise, click No to abort the uninstall.

   If you clicked Yes, the InstallShield Uninstall program automatically removes ColdFusion program files and registry settings from your system.

## Performing Windows-specific configurations

After installing ColdFusion, you may need to perform the following configurations:

- "Configuring the Apache Web server for ColdFusion"
- "Changing the ColdFusion user account"

### Configuring the Apache Web server for ColdFusion

To configure the Apache Web Server v1.3.6 for use with ColdFusion, you need to:

- Get a copy of the Apache Web server from the Apache HTTP Server Project Web site at http://www.apache.org/.
- Read the Apache documentation on support for Win32 platforms: http://www.apache.org/docs/windows.html.
- Copy an Apache module to your Apache modules directory.
- Add a line to a configuration file.

The following procedure assumes that your Apache Web server is installed in `c:\Apache`.

| To configure Apache for ColdFusion:

1. If a version of the Apache Web server is running, shut down the Web server.
2. Copy the `cfusion\bin\ApacheModuleColdFusion.dll` module to your Apache modules directory.

   For example: `c:\Apache\modules\ApacheModuleColdFusion.dll`.

3. Edit the Apache configuration file (`c:\Apache\conf\httpd.conf`) to contain the following line:

       LoadModule coldfusion_module
           modules/ApacheModuleColdFusion.dll

4. Restart the Apache Web server.

### Changing the ColdFusion user account

By default, ColdFusion runs under the host System account. However, ColdFusion application pages may not have the access rights needed to interact with remote data sources, other application pages, COM objects, and so on when running under this account. Therefore, you may need to run ColdFusion under a specific account that provides the necessary access rights.

| To change the ColdFusion user account:

1. Click Start>Settings>Control Panel>Services.

   The Services dialog box appears.

2. Select the ColdFusion Application Server service and click Startup.

   The Service Properties dialog box appears.

   Use this dialog to set startup options for the ColdFusion Application Server service.

3. In the Log On As section, click the This Account radio button and enter the appropriate account information.