![]() ![]() ![]() |
||
|
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.
Property |
Description |
---|---|
bootstrap |
Specifies the IP address and port on which the JRun servers 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). |
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. |
verbose |
Creates more detailed web server log file entries for the connector. Enabling this option can cause the web servers log files to fill quickly. Specify |
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. |
ssl |
(Optional) Enables secure sockets layer (SSL) between the web server and the JRun server. You must set this setting to |
apialloc |
Enables native OS memory allocation rather than the web servers allocator (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. |
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. |
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.
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.
The following is a typical httpd.conf file for an installation of ColdFusion MX on the same computer as an Apache 2.0 web server:
# JRun Settings LoadModule jrun_module "C:/CFusionMX7/runtime/lib/wsconfig/1/mod_jrun20.so" <IfModule mod_jrun20.c> JRunConfig Verbose false JRunConfig Apialloc false JRunConfig Ssl false JRunConfig Ignoresuffixmap false JRunConfig Serverstore "C:/CFusionMX7/runtime/lib/wsconfig/1/jrunserver.store" JRunConfig Bootstrap 127.0.0.1:51011 #JRunConfig Errorurl <optionally redirect to this URL on errors> #JRunConfig ProxyRetryInterval <number of seconds to wait before trying to reconnect to unreachable clustered server> #JRunConfig ConnectTimeout 15 #JRunConfig RecvTimeout 300 #JRunConfig SendTimeout 15 AddHandler jrun-handler .jsp .jws .cfm .cfml .cfc .cfr .cfswf </IfModule>
For IIS, the connector uses the jrun.ini file to initialize the jrun.dll file (jrun_iis6.dll on IIS 6). The following is a typical jrun.ini file:
verbose=false scriptpath=/JRunScripts/jrun.dll serverstore=C:/CFusionMX7/runtime/lib/wsconfig/1/jrunserver.store bootstrap=127.0.0.1:51011 apialloc=false ssl=false ignoresuffixmap=true #errorurl=<optionally redirect to this URL on errors> #proxyretryinterval=<number of seconds to wait before trying to reconnect to unreachable clustered server> #connecttimeout=<number of seconds to wait on a socket connect to a JRun server> #recvtimeout=<number of seconds to wait on a socket receive to a JRun server> #sendtimeout=<number of seconds to wait on a socket send to a JRun server>
The following is a typical obj.conf file for Netscape, iPlanet, or Sun ONE Web Server:
Note: Java must be disabled for the virtual server class that contains the server configured for JRun.
... <Object name="default"> AuthTrans fn="match-browser" browser="*MSIE*" ssl-unclean-shutdown="true" NameTrans fn="pfx2dir" from="/mc-icons" dir="C:/Sun/WebServer6.1/ns-icons" name="es-internal" NameTrans fn="pfx2dir" from="/manual" dir="C:/Sun/WebServer6.1/manual/https" NameTrans fn="document-root" root="$docroot" PathCheck fn="nt-uri-clean" PathCheck fn="check-acl" acl="default" PathCheck fn="find-pathinfo" PathCheck fn=find-index index-names="index.jsp,index.html,home.html,index.cfm" PathCheck fn="jrunfilter" ObjectType fn=type-by-exp exp=*.jsp type="jrun-internal/ext" ObjectType fn=type-by-exp exp=*.jws type="jrun-internal/ext" ObjectType fn=type-by-exp exp=*.cfm type="jrun-internal/ext" ObjectType fn=type-by-exp exp=*.cfml type="jrun-internal/ext" ObjectType fn=type-by-exp exp=*.cfc type="jrun-internal/ext" ObjectType fn=type-by-exp exp=*.swf type="jrun-internal/ext" ObjectType fn=type-by-exp exp=*.mxml type="jrun-internal/ext" ObjectType fn=type-by-exp exp=*.cfr type="jrun-internal/ext" ObjectType fn="type-by-extension" ObjectType fn="force-type" type="text/plain" Service method=(GET|HEAD|POST) type="jrun-internal/*" fn="jrunservice" Service method="(GET|HEAD)" type="magnus-internal/imagemap" fn="imagemap" Service method="(GET|HEAD)" type="magnus-internal/directory" fn="index-common" Service method="(GET|HEAD|POST)" type="*~magnus-internal/*" fn="send-file" Service method="TRACE" fn="service-trace" AddLog fn="flex-log" name="access" </Object> ...
The following is a typical magnus.conf file for Netscape, iPlanet, or Sun ONE Web Server:
... Init fn="load-modules" shlib="C:/CFusionMX7/runtime/lib/wsconfig/1/jrun_nsapi.dll" funcs="jruninit,jrunfilter,jrunservice" Init fn="jruninit" serverstore="C:/CFusionMX7/runtime/lib/wsconfig/1/jrunserver.store" bootstrap="127.0.0.1:51011" verbose="true" apialloc="false" ssl="false" ignoresuffixmap="false" #errorurl="<optionally redirect to this URL on errors>" connecttimeout="15" recvtimeout="300" sendtimeout="15"
|
||
![]() ![]() ![]() |