Web Server Configuration - MACROMEDIA COLFUSION MX 7 - CONFIGURING AND ADMINISTERING COLDFUSION MX Manual

Web server configuration

ColdFusion MX uses the Web Server Configuration Tool to configure an external web server with
the modules and settings that the connector needs to connect to ColdFusion MX. You can run
the Web Server Configuration Tool through either the command-line interface or the graphical
user interface (GUI). In either case, the Web Server Configuration Tool configures your external
web server to interact with a ColdFusion MX server.
Using GUI mode
The Web Server Configuration Tool includes a GUI mode, which you can use to specify external
web server configuration settings through a graphical interface.
Note: When you use the Web Server Configuration Tool in GUI mode, you must select the Configure
Web Server for ColdFusion MX Applications check box.
To run the Web Server Configuration Tool in GUI mode:
Open a console window.
1.
Tip: In Windows, you can start the Web Server Configuration Tool by selecting Start > Programs >
Macromedia > ColdFusion MX 7 > Web Server Configuration Tool.
Change to the cf_root/runtime/bin (server configuration) or jrun_root/bin (multiserver
2.
configuration) directory.
Start the Web Server Configuration Tool using the wsconfig.exe (Windows) or wsconfig
3.
(UNIX) command.
The Web Server Configuration Tool window appears.
Click the Add button.
4.
Select the Configure Web Server for ColdFusion MX Applications check box.
5.
In the Server drop-down list box, select the server or cluster name that you want to configure.
6.
(Individual server names in a cluster do not appear. Clustering support is only available on the
multiserver configuration.)
Note: The server or cluster does not have to reside on the web server computer. In this case, enter
the IP address or server name of the remote computer in the JRun Host field.
In the Web Server Properties area, enter web-server-specific information, and click OK.
7.
(Optional) Move the CFIDE directory and other directories (such as cfdocs) from the built-in
8.
web server's web root to your web server root directory. In addition, you can copy your
application's CFM pages from the built-in web server's web root to your web server root
directory.
Note: When a page is requested, the web server connector first looks for the ColdFusion page in
the cf_root/wwwroot (server configuration) or jrun_root/servers/cfusion/cfusion-ear/cfusion-war
(multiserver configuration) directory, and then looks under the web server root. Alternatively, you
can use the command-line interface and specify the -cfwebroot option.
68 Chapter 4: Web Server Management