System information

63
CONFIGURING AND ADMINISTERING COLDFUSION 9
Web Server Management
Last updated 2/21/2012
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.
-host Specifies the ColdFusion server address. The default value is localhost.
-server Specifies the ColdFusion server name.
-username Specifies a user name defined to the JRun server. The default value is guest account.
-password Specifies a password that corresponds to -username. The default value is guest account.
-norestart Specifies not to restart the web server.
-cluster Specifies the JRun cluster name. Use this option to define a connection to a JRun cluster instead
of a single server.
-l Enables verbose logging for the connector.
-a Enables native OS memory allocation.
-map.cfm,.cfc,.cfml,.cfr,
.cfswf,.jsp,.jws
Specifies the extension mappings list. (To use the web server connector with ColdFusion,
specify .cfm, .cfc, .cfml, .cfr, .cfswf, .jsp, .jws.)
-filter-prefix-only (IIS 5 only) Sets ignoresuffixmap=true in the jrun.ini file. This means that the connector
module runs as an IIS extension.
-coldfusion Ensures that the proper ColdFusion mappings are set (.cfm, .cfml, .cfc, .cfswf, .cfr, .jsp, .jws), and,
if IIS,
filter-prefix-only is implicitly specified.
Always use this option when you configure a web server for use with ColdFusion.
-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.
-cfwebroot Specifies the directory corresponding to cf_root/wwwroot. If you use this option, the Web
Server Configuration Tool creates web server mappings for /CFIDE and /cfdocs, each of which
points to the corresponding directories under cf_root/wwwroot. This option is useful in a
multihoming or hosting environment where you want multiple applications to share the
ColdFusion Administrator.
-list Lists all configured web servers.
-list -host server-host Lists all JRun 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.
Option Description