View comments | RSS feed

Configuring web servers

This section describes how to configure a web server to serve ColdFusion pages, for Windows and UNIX. Do this if you did not configure a web server automatically during installation, to change your web server, or to configure a web server for a cluster.

You configure an external web server connection using the Web Server Configuration Tool, which you can run either through a graphical user interface (GUI) or the command line. The Windows discussions describe GUI mode, and the UNIX instructions describe command-line mode; however, you can use GUI mode on UNIX if you have access to a graphical environment.

Tip: ColdFusion MX 7 provides batch files and shell scripts in the cf_root/bin/connectors directory to help you get started with command-line usage.

For more information on the Web Server Configuration Tool, including information on multihoming and distributed usage, see Configuring and Administering ColdFusion MX.

Note: If you cannot verify your configuration, repeat the procedure. If the problem persists, contact Macromedia Technical Support for assistance, or manually create the element that you cannot verify in the configuration (for example, manually add an entry to the Apache httpd.conf file, as described in this section).

Configuring web servers in Windows

This section explains how to configure the following web servers in Windows:

Configuring IIS in Windows

This section describes how to configure IIS for ColdFusion MX in Windows, and how to verify your configuration. You configure IIS using the Web Server Configuration Tool in either GUI or command-line mode. This discussion describes how to use GUI mode.

Tip: (Server configuration only) To use the command line, open the batch files located in cf_root\bin\connectors.

For more information, see the Web Server Management chapter in Configuring and Administering ColdFusion MX.

To configure IIS for ColdFusion MX 7 in Windows:

  1. Start the Web Server Configuration Tool by selecting Start > Programs > Macromedia > ColdFusion MX 7 > Web Server Configuration Tool.
  2. Click Add.
  3. In the Server drop-down list box, select the host name and the server or cluster name that you want to configure. In the ColdFusion MX 7 server configuration, the server name is always coldfusion. Clustering support is not available on the server configuration.

    Note: The server or cluster does not have to reside on the web server computer.

  4. In the Web Server Properties area, select IIS and specify the website. For IIS, you typically specify All.
  5. Select the Configure web server for ColdFusion MX applications option.

    Caution: Omitting the previous step causes your web server to serve ColdFusion MX 7 source code.

  6. Click OK.
  7. Copy the CFIDE and cfdocs directories from cf_root/wwwroot to your web server root directory. In addition, copy your application's CFM pages from cf_root/wwwroot to your web server root directory. In the multiserver configuration, these files are under the jrun_root/servers/cfusion/cfusion-ear/cfusion-war directory.

To verify your IIS configuration:

  1. Verify that the following file was created: cf_root/runtime/lib/wsconfig/jrun.dll (server configuration) or jrun_root/lib/wsconfig/jrun.dll (multiserver configuration). On IIS6, this file is named jrun_iis6.dll.
  2. For each of your IIS websites, verify that application mappings for .cfm, .cfml, .cfc, .cfswf, .cfr, .jsp, and .jws were added, as follows:
    1. In IIS, right-click an IIS website and select Properties.
    2. In the Properties dialog box, on the Home Directory tab, click Configuration.
    3. In the Application Configuration dialog box, click the App Mappings tab.

      4. You should see mappings for .cfm, .cfml, .cfc, .cfswf, .cfr, .jsp, and .jws in the Extension column.

  3. Verify that each of your IIS websites has a virtual directory called JRunScripts.

    The following figure shows a sample JRunScripts virtual directory:


    The IIS virtual directory for ColdFusion MX, called JRunScripts

  4. Verify that the JRunScripts directory in each of your IIS websites points to the correct location, as follows:
    1. Right-click the JRunScripts directory and select Properties.
    2. In the Properties dialog box, on the Virtual Directories tab, verify that the Local Path text box contains the following path:

      3. path/wsconfig/number (typically 1)

Configuring SunONE Web Server or iPlanet web server in Windows

This section describes how to configure SunONE Web Server 6 or iPlanet web server 6.x for ColdFusion MX 7 in Windows, and how to verify your configuration. You configure SunONE or iPlanet using the Web Server Configuration Tool in either GUI or command-line mode. This discussion describes how to use GUI mode.

Tip: (Server configuration only) To use the command line, open the batch files located in cf_root/bin/connectors.

For more information, see the Web Server Management chapter of Configuring and Administering ColdFusion MX.

To configure SunONE or iPlanet for ColdFusion MX 7 in Windows:

  1. Start the Web Server Configuration Tool by selecting Start > Programs > Macromedia > ColdFusion MX 7 > Web Server Configuration Tool.
  2. Click Add.
  3. In the Server drop-down list box, select the host name and the server or cluster name to configure. For the ColdFusion MX 7 server configuration, this is always coldfusion. Clustering support is not available on the server configuration.

    Note: The server or cluster does not have to reside on the web server computer.

  4. In the Web Server Properties area, select SunONE Web Server (iPlanet) or Netscape Enterprise Server (NES), and specify the path to the directory that contains the obj.conf file.
  5. Select the Configure web server for ColdFusion MX applications option.

    Caution: Omitting the previous step causes your web server to serve ColdFusion MX 7 source code.

  6. Click OK.
  7. Copy the CFIDE and cfdocs directories from cf_root/wwwroot to your web server root directory. In addition, copy your application's CFM pages from cf_root/wwwroot to your web server root directory. In the multiserver configuration, these files are under the jrun_root/servers/cfusion/cfusion-ear/cfusion-war directory.

To verify your SunONE or iPlanet configuration:

  1. Verify that the following file was created: cf_root/runtime\lib\wsconfig\number\jrun_nsapi35.dll (server configuration) or jrun_root/lib/wsconfig/number/jrun_nsapi35.dll (multiserver configuration).
  2. Open the SunONE configuration file, obj.conf, in the web server directory (for example, in C:\iPlanet\Servers\https-yourserver\config\obj.conf).
  3. Verify that the following line was added to the file: 
    NameTrans fn="jrunfilter"
  4. Verify that #JRun prefixes the following NameTrans line in the file: 
    #JRun NameTrans fn="pfx2dir" from="/servlet" 
    
dir="$docroot/servlet" name="ServletByExt"
  5. Verify that the following object element is at the end of the file: 
    <Object name="jrun">
PathCheck fn="jrunfilter"
Service fn="jrunservice"
</Object>

Configuring Apache web server in Windows

This section describes how to configure the Apache web server for ColdFusion MX 7 in Windows, and how to verify your configuration. You configure Apache using the Web Server Configuration Tool in either GUI or command-line mode. This discussion describes how to use GUI mode.

Tip: (Server configuration only) To use the command line, open the batch files located in cf_root\bin\connectors.

For more information, see the Web Server Management chapter in Configuring and Administering ColdFusion MX.

To configure Apache for ColdFusion MX 7 in Windows:

  1. Start the Web Server Configuration Tool by selecting Start > Programs > Macromedia > ColdFusion MX 7 > Web Server Configuration Tool.
  2. Click Add.
  3. In the Server drop-down list box, select the host name and the server or cluster name to configure. For the ColdFusion MX 7 server configuration, this is always coldfusion. Clustering support is not available on the server configuration.

    Note: The server or cluster does not have to reside on the web server computer.

  4. In the Web Server Properties area, select Apache and specify the path to the directory that contains the httpd.conf file.
  5. Select the Configure web server for ColdFusion MX applications option.

    Caution: Omitting the previous step causes your web server to serve ColdFusion MX 7 source code.

  6. Click OK.
  7. Copy the CFIDE and cfdocs directories from cf_root/wwwroot to your web server root directory. In addition, copy your application's CFM pages from cf_root/wwwroot to your web server root directory. In the multiserver configuration, these files are under the jrun_root/servers/cfusion/cfusion-ear/cfusion-war directory.

To verify your Apache configuration:

  1. Verify that one of the following files was created:
  2. Open the Apache configuration file, httpd.conf, in your Apache conf directory. In Windows, the default is C:\Program Files\Apache Group\Apache\conf\httpd.conf.

    Verify that the following code is appended to this file:

    # JRun Settings
LoadModule jrun_module "c:/CFusionMX7/runtime/lib/wsconfig/1/mod_jrun.so"
<IfModule mod_jrun.c>
  JRunConfig Verbose false
  JRunConfig Apialloc false
  JRunConfig Ssl false
  JRunConfig IgnoreSuffixmap false
  JRunConfig Serverstore 
"c:/CFusionMX7/runtime/lib/wsconfig/1/jrunserver.store"
  JRunConfig Bootstrap 127.0.0.1:51000
  #JRunConfig Errorurl <optionally redirect to this URL on errors>
  JRunConfig jrun-handler .jsp .jws .cfm .cfml .cfc .cfswf .cfr
</IfModule>

ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX | Forums | Developer Center | KnowledgeBase | Bug Reporting

Version 7

Comments


Fuseboxer said on Mar 22, 2005 at 11:52 AM :
I'm trying to configure my Sun Web Server 6.1 (SP3) server to use multiple software virtual hosts. In this setup, a different document root is used based upon the host header named submitted by the browser. IIS and Apache both support this model.

However, when I run the Web Server Connector utility, I can only configure one JRun/CFMX server to the entire Sun server instance. I can't seem to configure different JRun servers for each Sun Web Server Virtual Class.

Any ideas?
jrunrandy said on Apr 19, 2005 at 1:36 PM :
The only thing I can think of is to look at the event logs. I don't have Win 2K3, but on Win XP, the Event Viewer is in Settings > Control Panel > Administrative Tools. If that doesn't help, I suggest posting your question to the online forums. (In general, you will get a better and quicker answer by posting questions like this to the online forums: http://webforums.macromedia.com/.)
bgiddins said on May 9, 2005 at 9:35 PM :
Shouldn't the JRunConfig bootstrap be on port 51011, not 51000?
dmackland said on Jul 22, 2005 at 2:07 AM :
When connecting to http://localhost/CFIDE/administrator/index.cfm after installing and configuring Apache use IE rather than Firefox as Firefox prompts you to open the index.cfm file rather than serve it via coldfusion.
jrunrandy said on Jul 26, 2005 at 11:27 AM :
I'm sorry. I can't think of any reason why a page would display differently for different browsers.

You might try posting to the online forums: http://webforums.macromedia.com/coldfusion or click the Forums link on any CFMX 7 LiveDocs page.
No screen name said on Aug 16, 2005 at 2:23 PM :
Dmack.

IE will automatically treat text as html and guess its content type.

I would not think that your page should be served as text, but I suppose i could be happening somehow.
ASandstrom said on Nov 15, 2005 at 11:00 AM :
There is a tech note, "How to change the context root of ColdFusion MX running on JRun" at http://www.macromedia.com/cfusion/knowledgebase/index.cfm?id=5b768c0a.
No screen name said on Jun 8, 2007 at 6:51 AM :
DMack
I am having the same problem, to get round it for me, I edited the administrator link from the macromedia menu and made the CFIDE that is in capitals in the link to small characters ( cfide) and for some reason in firefox that works (most of the time)

 

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/7/htmldocs/00000049.htm