Using the command-line interface

You can also run the Web Server Configuration Tool through a command-line interface.

To run the command-line interface:

  1. Open a console window.
  2. Change to the cf_root/runtime/bin (server configuration) or jrun_root/bin (multiserver configuration) directory.
  3. Execute the wsconfig.exe (Windows) or wsconfig (UNIX) command:
       wsconfig.exe [-options]
       ./wsconfig [-options]
    

The following table describes the options:

Option

Description

-ws

Specifies the web server, as follows:

  • IIS
  • Apache
  • SunOne
  • iPlanet
  • NES

The web server name you supply is not case-sensitive.

-dir 

Specifies the path to the configuration directory (Apache conf or NES/iPlanet 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.

-server

Specifies the ColdFusion server name.

-username

Specifies a username 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 MX, you should 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 MX mappings are set (.cfm, .cfml, .cfc, .cfswf, .cfr, .jsp, .jws), and, if IIS, filter-prefix-only is implicitly specified.

Always use this option when configuring a web server for use with ColdFusion MX.

-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 MX 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

Uninstalls all configured connectors.

-h 

Lists all parameters.

Using the batch files and shell scripts

The ColdFusion MX 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

This section provides examples of multiple use-cases for different web servers: