Adobe 38043740 - ColdFusion Standard - Mac Development Manual page 399

DEVELOPING COLDFUSION 9 APPLICATIONS
Developing CFML Applications
About the ColdFusion Debugger
The ColdFusion Debugger is an Eclipse plugin. It runs in the Eclipse Debug perspective. You can use the ColdFusion
Debugger to perform debugging tasks, including the following:
• Setting breakpoints
• Viewing variables
• Stepping over, into, and out of function calls
Install and uninstall the ColdFusion Debugger
To use the ColdFusion Debugger, you must have the following software installed:
• Eclipse version 3.1.2, Eclipse version 3.2, Flex Builder 2, or Flash Builder
• ColdFusion 9
To install the ColdFusion Debugger, you install the ColdFusion Eclipse plugins. For more information, see Installing
ColdFusion.
Set up ColdFusion to use the Debugger
Before you can use the Debugger, enable debugging in the ColdFusion Administrator.
In the ColdFusion Administrator, select Debugging & Logging > Debugger Settings.
1
Enable the Allow Line Debugging option.
2
3 Specify the port to use for debugging if different from the default that appears.
Specify the maximum number of simultaneous debug session if different from the default.
4
Click Submit Changes.
5
6 You may have to increase the time after which requests time-out by doing the following:
Select Server Settings > Settings.
a
Enable the Timeout Requests After (Seconds) option.
b
c Enter 300 or other appropriate number in the text box.
The debugger server listens for commands from the Eclipse client from a separate port from the one specified in
7
step 3. By default, ColdFusion launches the debugger server with a random available port. This could be a problem
if ColdFusion (and hence debugger server) is behind a firewall and the firewall blocks the random port that the
debugger is listening..
To prevent this problem, you can specify a fixed debugger server port number and allow this port in the firewall.
To set a fixed debugger server port number, specify the following JVM argument on the Java and JVM page of the
ColdFusion Administrator (or the appropriate place for you J2EE Application Server), replacing portNumber with
the port you want to use:
-DDEBUGGER_SERVER_PORT=portNumber
8 Restart ColdFusion. If you are running the J2EE configuration of ColdFusion, restart the server in debug mode with
the debug port as specified.
Last updated 1/20/2012
394