Macromedia colfusion mx 7 Manual
72
Chapter 4: Web Server Management
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.
files. The web server connector uses these settings to help it find the ColdFusion server and know
which servers to connect to.
Each time you run the Web Server Configuration Tool, it creates a new configuration file and
directory. For example, the first time you run the tool in the server configuration, it creates files
under cf_root/runtime/lib/wsconfig/1; the second time, it creates cf_root/runtime/lib/wsconfig/2;
and so on. Each of these subdirectories contains the appropriate platform-specific connector
module and web-server-specific supporting files.
directory. For example, the first time you run the tool in the server configuration, it creates files
under cf_root/runtime/lib/wsconfig/1; the second time, it creates cf_root/runtime/lib/wsconfig/2;
and so on. Each of these subdirectories contains the appropriate platform-specific connector
module and web-server-specific supporting files.
Sample configuration files
To help describe the web server configuration file parameters, this section provides examples of
connector-specific web server properties. These examples assume that JRun and the web server are
on the same computer.
connector-specific web server properties. These examples assume that JRun and the web server are
on the same computer.
Property
Description
bootstrap
Specifies the IP address and port on which the JRun server’s proxy service is
listening for connector requests. JRun must also be configured to listen on this
port and address combination, the ProxyService must be activated, and the
JRun server must be running. Specify ipaddress:portnumber (for example,
127.0.0.1:51011).
listening for connector requests. JRun must also be configured to listen on this
port and address combination, the ProxyService must be activated, and the
JRun server must be running. Specify ipaddress:portnumber (for example,
127.0.0.1:51011).
serverstore
Specifies the full path and filename of the file that contains information for the
associated JRun server. The connector creates this file automatically. The
default filename is jrunserver.store.
associated JRun server. The connector creates this file automatically. The
default filename is jrunserver.store.
verbose
Creates more detailed web server log file entries for the connector. Enabling
this option can cause the web server’s log files to fill quickly. Specify
this option can cause the web server’s log files to fill quickly. Specify
true
or
false
; the default value is
false
. In Apache and Sun ONE Web Server, the
connector writes to the error log configured for the web server; on IIS, the
connector writes to its own log in the related wsconfig subdirectory.
connector writes to its own log in the related wsconfig subdirectory.
scriptpath
(IIS only) Points to the virtual /JRunScripts directory on the web server.
errorurl
(Optional) Specifies the URL to a file that contains a customized error
message. This property is commented out by default. You must restart the web
server after enabling this setting.
message. This property is commented out by default. You must restart the web
server after enabling this setting.
ssl
(Optional) Enables secure sockets layer (SSL) between the web server and the
JRun server. You must set this setting to
JRun server. You must set this setting to
false
.
apialloc
Enables native OS memory allocation rather than the web server’s allocator
(for use on Solaris with Sun ONE, at the direction of Macromedia Support
staff).
(for use on Solaris with Sun ONE, at the direction of Macromedia Support
staff).
ignoresuffixmap
(IIS only) Forces the connector to use application mappings.
proxyretryinterval
Specifies the number of seconds to wait before trying to reconnect to an
unreachable clustered server.
unreachable clustered server.
connecttimeout
Specifies the number of seconds to wait on a socket connect to a JRun server.
recvtimeout
Specifies the number of seconds to wait on a socket receive to a JRun server.
sendtimeout
Specifies the number of seconds to wait on a socket send to a JRun server.