Configuration Files - MACROMEDIA COLDFUSION MX 61 - CONFIGURING AND ADMINISTERING COLDFUSION MX Manual

Using the batch files and shell scripts
ColdFusion MX ships with batch files and shell scripts that implement typical command-line
connector configurations. These files are in cf_root/bin/connectors. For example,
IIS_connector.bat 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 iPlanet, use these files as prototypes, editing and saving them, as appropriate
for your site.
Command-line interface examples
This section provides examples of multiple use-cases for different web servers:
•
Configure a specific IIS site:
/bin/java -jar wsconfig.jar -ws iis -site "web31" -filter-prefix-
only -map .cfm,.cfc,.cfml,.jsp,.jws -coldfusion -v
On systems where all sites are .cfm, there is generally no need to configure an individual site.
•
Configure all existing IIS sites: (ISPs):
/bin/java -jar wsconfig.jar -ws iis -site 0 -filter-prefix-only
-map .cfm,.cfc,.cfml,.jsp,.jws -coldfusion -v
This 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.
•
Netscape on UNIX:
/bin/java -jar /opt/coldfusionmx/runtime/lib/wsconfig.jar -ws nes
-dir [path to config] -map .cfm,.cfc,.cfml,.jsp,.jws -coldfusion -v
•
SunOne Web Server on UNIX:
/bin/java -jar /opt/coldfusionmx/runtime/lib/wsconfig.jar -ws
iplanet -dir [path to config] -map .cfm,.cfc,.cfml,.jsp,.jws -coldfusion
-v
•
Apache on UNIX:
/bin/java -jar /opt/coldfusionmx/runtime/lib/wsconfig.jar -ws
Apache -bin /opt/apache2/bin/httpd -script /opt/apache2/bin/apachectl -dir
/opt/apache2/conf -map .cfm,.cfc,.cfml,.jsp,.jws -coldfusion -v
•
Apache in Windows:
/bin/java -jar wsconfig.jar
"c:\program files\apache group\apache2\conf" -map
.cfm,.cfc,.cfml,.jsp,.jws -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
directory. It also defines a filter and extension mappings in the IIS metabase.
•
Apache In the httpd.conf file, typically found in the apache_root/conf directory.
•
Netscape/iPlanet
xxx/config directory.
62 Chapter 4: Web Server Management
In the obj.conf and magnus.conf files, typically found in the server-http-
-ws apache -dir