
98
CONFIGURING AND ADMINISTERING COLDFUSION 10
Web Server Management
L
ast
u
p
dated
7/9/2
01
2
Web server configuration
ColdFusion uses the Web Server Configuration Tool to configure an external web server with the modules and settings
that the connector requires connect to ColdFusion. 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 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, select the Configure Web Server for ColdFusion
Applications check box.
Run the Web Server Configuration Tool in GUI mode
1
Open a console window.
Note:
In Windows, to start the Web Server Configuration Tool, select Start > Programs > Adobe > ColdFusion 10 >
Web Server Configuration Tool.
2
Change to the
cf_root
/cfusion/runtime/bin.
3
Start the Web Server Configuration Tool using the wsconfig.exe (Windows) or wsconfig (UNIX) command.
The Web Server Configuration Tool window appears.
4
Click Add.
5
Select Configure Web Server For ColdFusion Applications.
6
Provide the application server host and the application server cluster.
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.
7
In the Web Server Properties area, enter web-server-specific information, and click OK.
8
(Optional) The web server connector does not serve static content (such as HTML files and images) from the built-
in web server’s root directory. If your ColdFusion web application has an empty context root (/) and you want to
serve pages from the built-in web server’s root directory, you can create a web server mapping to the corresponding
directory under the built-in web server.
Using the command-line interface
You can also run the Web Server Configuration Tool through a command-line interface.
Run the command-line interface
1
Open a console window.
2
Change to the
cf_root
/runtime/bin (server configuration) directory.
3
Execute the wsconfig.exe (Windows) or wsconfig (UNIX) command:
wsconfig.exe [-options]
./wsconfig [-options]
The following table describes the options: