Configuring web servers on UNIX

This section explains how to configure the following web servers on UNIX:

Configuring Apache web server on UNIX

This section describes how to configure the Apache web server for ColdFusion MX 7 on UNIX, and how to verify your configuration.

Note: When running the Web Server Configuration Tool on the multiserver configuration, wsconfig.jar is located in jrun_root/lib. On the server configuration only, you can also use the scripts in cf_root/bin/connectors, modifying them, as appropriate for your environment.

To configure the Apache web server for ColdFusion MX 7 on UNIX:

  1. Enter the following command on a single line:
    wsconfig -server servername -ws Apache -dir <apache config directory> -coldfusion -v
    

    Note: You must enter the previous command as a single (long) line.

    The wsconfig file is in cf_root/runtime/bin (server configuration) or jrun_root/bin (multiserver configuration)

    The following is a sample command:

    /opt/cfusionmx7/runtime/bin/wsconfig -server coldfusion -ws Apache -dir /etc/httpd/conf  -coldfusion -v
    

    Note: For unique configurations (such as the preconfigured Apache web servers from Redhat or Sun), add the -bin and -script parameters, as described in Configuring and Administering ColdFusion MX.

  2. Copy the CFIDE and cfdocs directories from cf_root/wwwroot to your web server root directory. In addition, copy your application’s 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:

    In the multiserver configuration, this file is located under jrun_root/lib/wsconfig.

  2. Open the Apache configuration file, httpd.conf, in your Apache conf directory. By default it is /etc/httpd/conf/httpd.conf.

    Verify that the following code is added to this file:

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

Configuring SunONE or iPlanet web server on UNIX

This section describes how to configure SunONE Web Server or iPlanet web server (4.x or 6.x) for ColdFusion MX 7 on UNIX, and how to verify your configuration.

Note: When running the Web Server Configuration Tool on the multiserver configuration, wsconfig.jar is located in jrun_root/lib. On the server configuration only, you can also use the scripts in cf_root/bin/connectors, modifying them, as appropriate for your environment.

To configure Netscape or iPlanet for ColdFusion MX 7 on UNIX:

  1. Enter the following command on a single line:
    wsconfig -server servername -ws sunone | iplanet | nes -dir path_to_config  -coldfusion -v
    

    Note: You must enter the previous command as a single (long) line. Specify sunone, iplanet or nes.

    The following is a sample command:

    /opt/cfusionmx7/runtime/bin/wsconfig -server coldfusion -ws sunone -dir path_to_config -coldfusion -v
    
  2. 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 Netscape or iPlanet configuration:

  1. Verify that the following file was created:
    cf_root/runtime/lib/wsconfig/1/jrun_nsapi35.dll

    In the multiserver configuration, this file is located under jrun_root/lib/wsconfig.

  2. Open the Netscape configuration file, obj.conf, in the web server directory (for example, in /usr/netscape/server4/https-surf/config/obj.conf).
  3. Verify that the following line is in the file:
    NameTrans fn="jrunfilter"
    
  4. Verify that #JRun prefixes the following NameTrans line in the file:
    #JRun NameTrans fn="pfx2dir" from="/servlet" 
    dir="e:/netscape/servers/docs/servlet"
  5. Verify that the following object element is at the end of the file:
    <Object name="jrun">
    PathCheck fn="jrunfilter"
    Service fn="jrunservice"
    </Object>