Installing a CFX tag in ColdFusion 8 Multi-server Configuration

Recently I was asked to install a java CFX tag in the ColdFusion 8 Multi-server Configuration. I figured this would be an easy task, as I had done this many times before in the standalone server configuration. I went into the ColdFusion Administrator and installed the CFX tag as normal. However, when I called the CFX tag from the code I received an error that I had never seen before. The error was 500 com/allaire/cfx/CustomTag.

After trying everything I could think of, I decided to compare the java class paths between the stand alone configuration and the multi-server configuration. I found that the cfx.jar file was missing from the java class path in the multi-server configuration. ColdFusion therefore could not load com.allaire.cfx.CustomTag class. So, I decided to add the cfx.jar file to the java classpath and see if that would solve my error. To add the cfx.jar file to the classpath in the ColdFusion multi-server edition you must follow these steps.

  1. Open the jvm.config file located at {application.home}/bin
  2. Add {application.home}/servers/cfusion/cfusion-ear/cfusion-war/WEB-INF/lib to the section “java.class.path”
  3. Save the jvm.config file
  4. Restart the ColdFusion service.

After restarting the ColdFusion service, login to the CF administrator and go to the settings summary. Confirm that the cfx.jar file is in the java classpath. It was there, and I was able to call the CustomTag from my code.

Hope this helps anyone who runs into the same issue.

One comment on “Installing a CFX tag in ColdFusion 8 Multi-server Configuration

  1. I had my Server Admin do this and I am still getting the error com/allaire/cfx/CustomTag.

    Should the cfx.jar be in the CF Classpath under Java Class Path or Server Classpath under Java Class Path?

    Currently I see them under Server Classpath.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s