
99
CONFIGURING AND ADMINISTERING COLDFUSION 10
Web Server Management
L
ast
u
p
dated
7/9/2
01
2
Using the batch files and shell scripts
The ColdFusion server configuration includes batch files and shell scripts that implement typical command-line
connector configurations. These files are in the
cf_root
/bin/connectors directory. For example, the IIS_connector.bat
file configures all sites in IIS to site 0, which establishes a globally defined connector so that all sites inherit the filter
and mappings.
If you use Apache or Sun ONE Web Server, use these files as prototypes, editing, and saving them as appropriate for
your site.
command-line interface examples
Examples of multiple use-cases for different web servers:
1
Configure a specific IIS site:
cf_root/runtime/bin/wsconfig.exe -ws iis -site "web31" -v
On systems where all sites run ColdFusion, there is generally no need to configure an individual site.
Option
Description
-ws
Specifies the web server, as follows:
•
IIS
•
Apache
•
SunOne
The web server name you supply is not case sensitive.
-dir
Specifies the path to the configuration directory (SunONE config).
-site
Specifies the IIS website name (case-sensitive). Specify All or 0 to configure the connector at a
global level, which applies to all IIS websites.
-host
Specifies the ColdFusion server address. The default value is
localhost
.
-norestart
Specifies not to restart the web server.
-cluster
Specifies the Tomcat cluster name. Use this option to define a connection to a Tomcat cluster
instead of a single server.
-l
Enables verbose logging for the connector.
-upgrade
Upgrades existing configured connectors with newer modules from a newer wsconfig.jar file.
-service
Specifies the Apache Windows service name. The default value is
Apache
.
-bin
Specifies the path to the Apache server binary file (apache.exe in Windows, httpd on UNIX).
-script
Specifies the path to the Apache UNIX control script file (apachectl, but slightly different with
certain Apache variants, such as Stronghold).
-v
Enables verbose output from the Web Server Configuration Tool.
-list
Lists all configured web servers.
-list -host server-host
Lists all Tomcat servers on the specified host.
-remove
Removes a configuration. Requires the -
ws
and either the -
dir
or -
site
options.
-uninstall
Removes all configured connectors.
-h
Lists all parameters.