Using An External Web Server; Web Server Configuration - MACROMEDIA COLDFUSION MX 61 - CONFIGURING AND ADMINISTERING COLDFUSION MX Manual

Using an external web server

ColdFusion MX uses the JRun web server connector to forward requests from an external web
server to the ColdFusion MX runtime system.
When a request is made for a CFM page, the connector on the web server opens a network
connection to the JRun proxy service. The ColdFusion MX runtime system handles the request
and sends its reply back through the proxy service and connector. The web server connector uses
web server-specific plug-in modules, as the following table shows:
Web server
Apache
IIS
SunONE Web Server,
includes iPlanet and
Netscape Enterprise
Server (NES)

Web server configuration

ColdFusion MX uses the Web Server Configuration Tool to configure an external web server with
the modules and settings the connector needs to connect to ColdFusion MX. You can run the
Web Server Configuration Tool through either the command-line interface or the GUI mode. In
either case, the Web Server Configuration Tool configures your external web server to interact
with a ColdFusion MX server, as explained in the following discussions:
•
Using GUI mode
•
Using the command-line interface
•
Configuration files
Connector details
The Web Server Configuration Tool adds the following elements to the
Apache httpd.conf file:
• A LoadModule directive defines the connector.
• An AddHandler directive tells Apache to route requests for ColdFusion
pages through the connector.
For Apache 1.3.x, the connection module is mod_jrun.so; for Apache 2.x,
the connection module is mod_jrun20.so.
The Web Server Configuration Tool adds the following elements at either
the global level (default) or web server level:
• An ISAPI filter.
• Extension mappings tell IIS to route requests for ColdFusion pages
through the connector.
With IIS 4 and 5, the IIS connection module is jrun.dll. IIS 6 uses a
connection module named jrun_iis6.dll and a helper DLL named
jrun_iis6_wildcard.dll.
The Web Server Configuration Tool adds the following elements to
SunONE Web Server configuration files:
• obj.con A NameTrans directive for the JRun filter and ObjectType
directives to route requests for ColdFusion pages through the connector.
• magnus.conf Init directives to load and initialize the connector.
In Windows, the SunONE web server connection module is
jrun_nsapi35.dll; on UNIX and Linux, the SunONE web server connection
module is libjrun_nsapi35.so; on AIX, the module name is
libjrun_nsapi40.so.
With NES 3.5 and iPlanet 4.x, the Web Server Configuration Tool places all
settings in the obj.conf file.

Web server configuration

59