Installing ColdFusion on Windows

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

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.

Note To check that your Web server is running:

Do one of the following actions:

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.

Note 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.

Note 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

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

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

Note 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.

Note 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.