Installing and Configuring ColdFusion Server Previous Up One Level Next Search
Installing ColdFusion Server in Windows


Configuring Your Installation

After installing ColdFusion Server, you may have to perform the following actions:

Configuring Web servers manually

If you selected Other Server in the Web Server Selection dialog, or your Web server was not detected by the Install Wizard, you must manually configure your Web server. This section explains how to configure Web servers manually in Windows NT and Windows 2000. The instructions assume ColdFusion Server is installed in c:\cfusion.

This section explains how to configure these Web servers:

Internet Information Services (IIS)

The following procedure uses Windows 2000 Professional as the example operating system. The steps for Windows NT 4.0 are similar.


Tip

If you are running ColdFusion Server on Windows 2000 with IIS5, you can improve performance as follows: open the Internet Services Manager, right-click the Default Web Site, and select Properties. Under the Home Directory tab, select Low (IIS Process) in the Application Protection drop-down list, and click Apply. Stop IIS Admin and all Web services from the Windows NT Control Panel, and then restart IIS.

To configure IIS for ColdFusion Server:

  1. Start the Microsoft Management Console (MMC) by selecting Start > Programs > Administrative Tools > Computer Management.

    The MMC displays:

  2. In the Tree tab, under the Internet Information Services tree, right-click on your Web site and select Properties.

    The Properties dialog box displays:

  3. Click the Home Directory tab, then Configuration.

    Note

    If the Configuration button is greyed out, click Create then click Configuration.

    The Application Configuration dialog box displays:

  4. In the App Mappings tab, select existing entries for.cfm and .dbm, and click Remove.
  5. Click Add.

    The Add/Edit Application Extension Mappings dialog box displays:

  6. Click Browse and go to c:\cfusion\bin\iscf.dll. Enter .cfm in the Extension text box, and verify that the Script engine check box is selected. Click OK.
  7. Repeat Step 6 , substituting .dbm for the extension.

    Note

    In previous versions, ColdFusion Server used the .dbm file extension for ColdFusion Server files. Macromedia recommends that you rename templates that have a .dbm extension to .cfm.


  8. Click OK in the Application Configuration dialog box to save your changes.

Apache Web server

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

To configure Apache for ColdFusion Server:

  1. If it is not already installed, download a copy of the Apache Web server from the Apache HTTP Server Project Web site at http://www.apache.org/. Read the Apache documentation for Windows at http://www.apache.org/docs/windows.html.
  2. If a version of the Apache Web server is running, shut down the Web server.
  3. Copy the cfusion\bin\ApacheModuleColdFusion.dll module to your Apache modules directory.

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

  4. Edit the Apache configuration file (c:\Apache\conf\httpd.conf). Add the following line:
    LoadModule coldfusion_module modules/ApacheModuleColdFusion.dll
  5. Restart the Apache Web server.

Netscape/iPlanet Enterprise Web Server

Manually configuring Netscape/iPlanet Web servers for ColdFusion Server requires modifying two files, obj.conf and mime.types in the directory where the Netscape/iPlanet Web server is installed, such as c:\netscape\server4\https-yourserver.com\config.


Warning

Ensure that you do not alter files in the backup or install directories.

To configure Netscape/iPlanet for ColdFusion Server:

  1. Make a backup copy of the obj.conf file.
  2. Insert the following line at the top of the obj.conf file:
    Init fn="load-modules" funcs="DoCFRequest" shlib="C:/CFUSION/Bin/NS4CF.DLL"
  3. Look for the following line in the same obj.conf file:
    Service method =(GET|HEAD) type="magnus-internal/imagemap" fn="imagemap"

    After this line, insert the following line:

    Service fn="DoCFRequest" method="(GET|POST)" type="magnus-internal/cold-fusion"
  4. Make a backup copy of the mime.types file, which is located in the same directory as the obj.conf file.
  5. Insert the following line to the mime.types file:
    type=magnus-internal/cold-fusion exts=dbm,cfm,dbml,cfml
  6. Go into the Netscape Administrator, and save the changes.

    Note

    Netscape is case sensitive, so add the lines exactly as they appear in the instructions. Enter each command one line. If you remove ColdFusion Server, you must undo these changes. Otherwise, the iPlanet/Netscape Web server will not work.

O'Reilly WebSite Professional

This example uses Windows 2000 Professional as the example operating system and O'Reilly WebSite Professional 3.0 as the Web server.

To configure O'Reilly WebSite Professional for ColdFusion Server:

  1. Select Start > Programs > WebSite Professional > Server Properties.

    The WebSite Pro Server Properties dialog box displays:

  2. In the Mapping tab, click Associations in the Mapping Types box.
    1. In the File Extension text box, enter .cfm.
    2. In the File Extension text box, click Browse and go to c:\cfusion\bin\WSCF.DLL. Click Add.
    3. Repeat Step 2, substituting .dbm.
    4. Click Add.

      The .cfm and .dbm mappings display in the File Extension box.

  3. In the Mapping tab, in the Mapping Types box, click Content Types.
    1. In the File Extension text box, enter .cfm and .dbm.
    2. In the Media or Server-Side Content text field, enter wwwserver/wsapi.
    3. Click Add.

Configuring SNMP MIB

To use the ColdFusion Server MIB features, you must configure the following settings:

  1. For each system, such as a system with the IP address 192.178.64.88, that is to receive trap messages from the local host, open the local host's Registry to:
    \\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\TrapConfiguration\public

    For each system, add a value in the following form:

    1: REG_SZ:192.178.64.88
  2. Open the Debug Options page of the ColdFusion Administrator, and ensure that the Enable Performance Monitoring checkbox is selected.

    Tip

    You can find a copy of the MIB definition in CFusion/cfam/Database/lhmib.mib.


Using HTTPS and non-default ports

To use HTTPS, a different Web server name, or a different port to access the Web document root for ColdFusion MIB information, modify the contents of <installdir>/cfam/Database/mib.properties

For example, this file usually contains a single entry, such as http://maine where maine is the name of the local host, and http://maine represents the Web document root directory for the ColdFusion MIB information. To use HTTPS, a different Web document root (maine1), and port (459), edit the entry to https://maine1:459.

Changing the ColdFusion Server user account

By default, ColdFusion Server runs under the host's System account. However, under this account, ColdFusion application pages may have the access rights necessary to interact with other resources, such as remote data sources, other application pages, and COM objects.

You may have to run ColdFusion Server under a specific account that provides the necessary access rights. These instructions use Windows 2000 Professional as the example operating system.

To change the ColdFusion Server user account:

  1. Start the MMC by selecting Start > Programs > Administrative Tools > Computer Management.
    1. In the Tree tab, expand Services and Applications and select Services.
    2. Right-click ColdFusion Application Server and select Properties.

      The ColdFusion Application Server Properties dialog box displays:

  2. Select the Log On tab and click This account. Enter the appropriate account information.
  3. Click OK to apply the changes.

    Restart ColdFusion Server services.


    Warning

    Do not rename your Windows Administrator account. It causes problems with security policies and profiles.

Copyright © 2001, Macromedia Inc. All rights reserved. Previous Up Next Search

Banner.Novgorod.Ru