Macromedia Coldfusion MX

Overview

This document contains information about how to integrate Zeus Web Server with Macromedia ColdFusion MX 6.1. There are two installation methods available:

    * Using the Zeus Web Server Gateway module (not recommended - see below)
    * Using NSAPI

This page is for the configuration of ColdFusion MX. There are separate installation instructions for ColdFusion 5.0 and below.

Support Considerations

ColdFusion MX features an installation option to use the built-in Web Server to supply
content, which Zeus Web Server can then Gateway to. Unfortunately, this Java-based Web Server
has been shown to have very low levels of performance, and so is only suitable for development
work where there is no requirement to serve large numbers of concurrent requests.

Zeus Technology strongly recomend using the NSAPI integration method for ColdFusion MX.

* The ColdFusion MX installer must be run as user "root"
* ColdFusion MX requires compatibility libc libraries on some distributions,

Please bear in mind that Coldfusion can only check for the prescense of these on RPM-based Linux distributions that follow RedHat's naming scheme. If you experience errors starting ColdFusion MX, then please try installing older libc libraries.

Installation Instructions

   1. Ensure that you installed ColdFusion using the NSAPI installation option.
   2. In your Zeus Administration Server for your chosen virtual server, follow the   
      instructions here to create default NSAPI configuration files.
   3. Now connect ColdFusion and Zeus Web Server together via the NSAPI connector.

   <cf_root>/jre/bin/java
   -jar <cf_root>/runtime/lib/wsconfig.jar -ws zeus
   -dir <$ZEUSHOME>/ns-config/https-<your site>/config -v

The following is a sample command:

     /opt/coldfusionmx/jre/bin/java \
     -jar /opt/coldfusionmx/runtime/lib/wsconfig.jar -ws zeus \
     -dir /usr/local/zeus/ns-config/https-cfmx/config -v

4. Navigate to:

$ZEUSHOME/ns-config/https-<your site>/config/obj.conf 

Please ensure that this configuration file now references the ColdFusion supplied shared library: libjrun_nsapi35.so. This library will have been unpacked from the wsconfig.jar file mentioned in Step 2.

Testing the ColdFusion MX installation

1. Once ColdFusion MX has been installed, start it by running $COLDFUSION/bin/coldusion start as root.
2. Now test that cfm files can be processed successfully by first making a request via the internal web server:

     
      http://[machinename]:8500/CFIDE/administrator/index.cfm

3. Now repeat the test but this time through Zeus Web Server via the NSAPI connector:

      
      http://CFIDE/administrator/index.cfm

When first accessed, this page may take some minutes to appear (especially on a slow host), as ColdFusion MX must compile each page from source, which can take some time for slow pages.
Further details

To remove the Web Server configuration files for ColdFusion MX, run the following command on a single (long) line:

   <cf_root>/jre/bin/java
   -jar <cf_root>/runtime/lib/wsconfig.jar -ws zeus
   -dir <$ZEUSHOME>/ns-config/https-<your site>/config -r -v

The following is a sample command:

   /opt/coldfusionmx/jre/bin/java \
   -jar /opt/coldfusionmx/runtime/lib/wsconfig.jar -ws zeus \
   -dir /usr/local/zeus/ns-config/https-cfmx/config -r -v

Macromedia's own instructions for integrating with Zeus Web Server can be found on their web site

Content Manager [Administrator] 08 November 2005