System information

CONFIGURING AND ADMINISTERING COLDFUSION 9

Web Server Management

Last updated 2/21/2012

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 -server coldfusion -ws iis -site "web31" -coldfusion -v

On systems where all sites run ColdFusion, there is generally no need to configure an individual site.

2 Configure all existing IIS sites (ISPs):

cf_root/runtime/bin/wsconfig.exe -server coldfusion -ws iis -site 0 -coldfusion -cfwebroot

C:\Inetpub\wwwroot -v

The -cfwebroot option allows all sites to share the ColdFusion Administrator that runs under

C:\Inetpub\wwwroot. This example does not automatically configure newly added sites after the first

-site 0 run,

but you can rerun with

-site 0 at a later time, and the Web Server Configuration Tool configures new sites only.

3 Configure Apache on UNIX #1:

cf_root/runtime/bin/wsconfig -server coldfusion -ws Apache -bin /opt/apache2/bin/httpd -

script /opt/apache2/bin/apachectl -dir /opt/apache2/conf -coldfusion -v

4 Configure Apache on UNIX #2:

cf_root/runtime/bin/wsconfig -server coldfusion -ws Apache-bin /usr/bin/httpd -script

/usr/bin/httpd -dir /etc/httpd/conf -coldfusion -v

5 Configure Apache in Windows:

cf_root/runtime/bin/wsconfig.exe -server coldfusion -ws apache -dir "c:\program

files\apache group\apache2\conf" -coldfusion -v

6 Configure Netscape on UNIX:

cf_root/runtime/bin/wsconfig -server coldfusion -ws nes -dir [path to config] -coldfusion -v

7 Configure Sun ONE Web Server on UNIX:

cf_root/runtime/bin/wsconfig -server coldfusion -ws sunone -dir [path to config] -coldfusion -v

Configuration files

The Web Server Configuration Tool stores properties in configuration files, as follows:

IIS In the jrun.ini file, typically found in a subdirectory of the cf_root/runtime/lib/wsconfig (server configuration) or

jrun_root/lib/wsconfig (multiserver configuration) directory. For IIS 5 only, it also defines filter and extension

mappings in the IIS metabase.

Apache In the httpd.conf file, typically found in the apache_root/conf directory.

Sun ONE Web Server/iPlanet In the obj.conf and magnus.conf files, typically found in the ws_root/server-http-

xxx/config directory.

The following table describes the web server connector properties in the web server configuration files. The web server

connector uses these settings to help it find the ColdFusion server and know which servers to connect to.