My ColdFusion Debugger Setup Cheatsheat

April 22, 2008 by Mike Henke    3 Comments
Posted under: CFEclipse · ColdFusion · Eclipse · FusionDebug

I will show how to setup FusionDebug on Windows for Multiple ColdFusion instances. And ColdFusion 8 Debugger on Ubuntu. A hint for both is turn off "timeout request after (seconds)" in the CF Administrator so your debugging info doesn't timeout. Within Eclipse, I use the Breakpoints, Debug, Variables, and Expressions views.

FusionDebug Windows

In the Coldfusion Administrator go to the "Enterprise Manager" and then "Instance Manager". Click "add new instance", this example we will name it FD1.

Check "Create Windows Service" option and create the new instance.
** note : Coldfusion will automatically create the first instance on port 8301 and increment by one when creating a new instance.

Stop the newly created instance through services, default name for this example would be "Macromedia CFMX AS FD1".

Use the FusionDebug Server Configuration Wizard to create the new config file. This will modify the jvm.config file, but for multiple instances you will need multiple jvm.config files.

Users of an older version of FusionDebug will have to copy and modify the jvm.config file as described in FusionDebug Guide.

The jvm.config is in JRun4in. Change address=8000 to 8001 and save as new config file, with new name, example jvm.config_FD1

** note : each new CF instance will have to listen on a separate port. I like to keep my port number consistant like CF port 8301 will match up to debugging port 8001.

Next we will remove the cf service we created during installation, and have it point to the new config file we created.

Open the command prompt and navigate to the bin of JRun4 then use these command:

cd C:JRun4in

jrunsvc -remove "Macromedia CFMX AS wfs1"

jrunsvc -install wfs1 "Macromedia CFMX AS wfs1" "Macromedia CFMX AS wfs1" -config jvm.config_wfs1

Now start the CF instance and configure the FusionDebug connection through Eclipse. Repeat this process for each instance.

Snapshots of FusionDebug setup within Eclipse. Run —> Open Debug Dialog —> FusionDebug

ColdFusion 8 Debugger on Ubuntu

Within ColdFusion 8 Administrator, you must turn on RDS and then specify the debugger port in the JVM settings of your application server. This example will be using port 80 for the webservice and port 8000 for debugging.

Setting the Debugging information is located at Debugging & Logging —> Debugger Settings. Make sure the "Allow line debugging" is checked also.

Besides this you will need to modify the jvm.config file. Mine was located /opt/jrun4/bin. I added
to the "Arguments to VM" section: -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8000, and restart the server.

Be extra carefull with spaces and returns.

Full Example of section:
# Arguments to VM
java.args=-server -Xmx512m -XX:MaxPermSize=192m -Djava.awt.headless=true -Dcoldfusion.rootDir={application.home}/ -Djava.compiler=NONE -Xnoagent -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8000

Now restart ColdFusion and you should be good ready to configure Eclipse.

You will need to configure two seperate settings for CF8 Debugger.

First is the Windows —> Preferences —> ColdFusion —> RDS Configuration

Second is Run —> Open Debug Dialog. Add a new ColdFusion Application.