TechNote

ColdFusion MX 7.0.1 and 7.0.2: Hot fix available for Apache 2.2 support

Issue

---

ColdFusion MX 7.0.1 and 7.0.2 now support Apache 2.2. Apache 2.2 requires a separate connector module than Apache 2.0. The web server connector installer (wsconfig.jar build 107948) contains the connector changes required to support Apache 2.2.

Solution

---

This hot fix TechNote provides a new web server configuration installer (wsconfig.jar) to replace the original installer shipped with ColdFusion MX 7.0.1 or 7.0.2.

Installation instructions specific to Linux and Unix

The instructions below assume the user has previously compiled the Apache 2.2 web server on Linux or Unix from source obtained from www.apache.org.

Note: Many Linux systems (Red Hat 3.0, 4.0, Suse 9.x) may have glibc andcompat-libstdc++ compatibilty issues with the compiled connectors in wsconfig.jar. Check to make sure theglibc and compat libraries exist and are compatible with the installed connector.

rpm --query compat-libstdc++ (must be installed)
rpm --query glibc (if 2.2.5.x or higher, Apache connector compile required)

For some Linux installations (Red Hat 3/4, SuSe), rather than installing the compat libraries, it may be best to compile the JRun Apache 2.2 module mod_jrun22.so manually using wsconfig.jar [-apxs] switch.

For example, if after installing the default Apache 2.2 module with wsconfig.jar, Apache 2.2 serves .html pages but hangs serving .cfm pages, most likely the module needs to be compiled locally on the machine Apache 2.2 resides on. See Step 5 below for details for using the optional -apxs switch to compile a JRun Apache 2.2 module.

ColdFusion MX 7.0.1 or 7.0.2 Server edition

1. Backup the existing cf_root/runtime/lib/wsconfig.jar to wsconfig.jar.bu.
2. Download the hot fix (2.3MB).
3. Extract the new wsconfig.jar file and place it incf_root/runtime/lib.
4. Stop all ColdFusion servers and Apache 2.2.
5. Navigate to the cf_root/runtime/lib directory and run the connector installer from the commandline (example shown below with line wrap for clarity).

    cd {cf_root}/runtime/lib
   		
   
   	 java -Dtrace.ci=1 -jar wsconfig.jar -server coldfusion -ws apache
   		
   
   	         -dir /opt/apache22/conf
   		
   
   	  -bin /opt/apache22/bin/httpd
   		
   
   	         -script /opt/apache22/bin/apachectl
   		
   
   	         -coldfusion -v
   		
   
   	  [-apxs]
   		
   
   	 

6. Make sure the connector installation completed successfully.
   • Inspect cf_root/runtime/lib/wsconfig/wsconfig.log for errors
   • Check the error_log in the apache_root/logs directory to verify the version is correct (the old version was 92909).
     [Wed Apr 19 15:57:50 2006] [notice] jrApache[init] JRun 4.0 (Build 107948) Apache 2.2 module - Apr 6 2006 13:04:07
   • To check the wsconfig.jar version, query the wsconfig.jar directly as shown below:

      java -jar wsconfig.jar -info
     		
     
     	 

ColdFusion MX 7.0.1 or 7.0.2 MultiServer edition

Users can follow the instructions for the ColdFusion MX 7.0.1/7.0.2 Server edition above by using {jrun_root}/lib in place of {cf_root}/runtime/lib where appropriate.

Apache 2.2 httpd.conf configuration after install

The httpd.conf section for Apache 2.2 and ColdFusion MX 7.0.1/7.0.2 Server edition should look something like this:

 # JRun Settings
		

	 LoadModule jrun_module /usr/opt/coldfusionmx7/runtime/lib/wsconfig/1/mod_jrun22.so<IfModule mod_jrun22.c>
		

	    JRunConfig Verbose false
		

	    JRunConfig Apialloc false
		

	    JRunConfig Ssl false
		

	    JRunConfig Ignoresuffixmap false
		

	    JRunConfig Serverstore /opt/coldfusionmx7/runtime/lib/wsconfig/1/jrunserver.store
		

	    JRunConfig Bootstrap 127.0.0.1:51011
		

	    #JRunConfig Errorurl <optionally redirect to this URL on errors>
		

	    #JRunConfig ProxyRetryInterval 600
		

	    #JRunConfig ConnectTimeout 15
		

	    #JRunConfig RecvTimeout 300
		

	    #JRunConfig SendTimeout 15
		

	    AddHandler jrun-handler .jsp .jws .cfm .cfml .cfc .cfr .cfswf</IfModule>
		

	 

Search Support

---