TechNote (Archived)

URL containing the word cluster in a directory name returns 403 or 404 error

Issue

When using the word "cluster" in a URL with ColdFusion 7.0.1 on JRun with Updater 6 and IIS, a 403 forbidden error or a 404 page not found error is thrown.

For example, http://www.mywebsite.com/cluster/index.cfm would throw such an error.

The word "cluster" is a reserved word in JRun and should not be used in virtual or physical directory names.

Reason

This is due to the ClusterDeployerService being active in the jrun.xml file. The ClusterDeployerService manages automatic deployment across JRun servers in a cluster.

JRun automatically deploys any new module archive file or directory found in the directory specified in a deployDirectory attribute. JRun checks this location upon server startup and also monitors new files while the server is running.

Solution

If you cannot rename your virtual or physical directories, then you can set the ClusterDeployerService to be inactive.

Edit the jrun.xml and locate the following service class section:

 <service outputclass="jrunx.cluster.ClusterDeployerService" name="ClusterDeployerService"><attribute name="deployDirectory">{jrun.server.rootdir}/SERVER-INF/cluster</attribute><attribute name="deactivated">false</attribute></service>

Change this line:

<attribute name="deactivated">false</attribute>

to this:

<attribute name="deactivated">true</attribute>

This change prevents the use of auto deploy, therefore we recommend that the word "cluster" not be used when creating ColdFusion MX or JRun 4 clusters.