| Administering ColdFusion MX |
|
|
Basic ColdFusion MX Administration |
|
| Administering ColdFusion MX |
|
|
Basic ColdFusion MX Administration |
|
You use the Debugging Settings and Debugging IPs pages of the Administrator to configure ColdFusion MX to provide debugging information for every application page requested by a browser. You specify debugging preferences using the pages as follows:
This section also includes pages for managing your Log Files, Scheduled Tasks, System Probes, and the Code Compatibility Analyzer.
The Debugging Settings page provides the following debugging options:
| Setting |
Description |
|---|---|
| Enable Debugging |
Enables the ColdFusion debugging service. |
| Select Debugging Output Format |
Select a format of:
|
| Report stack trace to a depth of [n] rows |
Reports execution times. The stack trace shows a hierarchical tree of executed templates, includes, modules, and custom tags that were executing at the time of the exception. The default is 5. A blank value or 0 implies no limit. |
| Database Activity |
Shows the database activity for the SQL Query events and Stored Procedure events in the debugging output. |
| Exception Information |
Shows all ColdFusion exceptions raised for the request in the debugging output. |
| Tracing Information |
Shows trace event information in the debugging output. Tracing lets you track program flow and efficiency through the use of the cftrace tag. |
| Variables |
Displays information about parameters, URL parameters, cookies, session, and CGI variables in the debugging output. |
| Enable Robust Exception Information |
Lets visitors view detailed information in the exceptions page, including: the template's physical path and URI, the line number and snippet, the SQL statement used (if any), the Data Source Name (if any), and the Java stack trace. |
| Enable Performance Monitoring* |
Enables the standard NT Performance Monitor application to display information about a running ColdFusion Application Server. |
| Enable CFSTAT* |
Shows performance information on platforms that do not support the NT Performance Monitor.For more information, see "Using the cfstat utility". |
The cfstat command-line utility provides real-time performance metrics for ColdFusion. Using a socket connection to obtain metric data, the cfstat utility displays the information that ColdFusion writes to System Monitor without actually using the System Monitor application. The following table lists the metrics that cfstat returns:
Before you use the cfstat utility, ensure that you selected the Enable Performance Monitoring check box in the ColdFusion Administrator (on the Debugging & Logging > Debugging Settings page). If you select this check box, you must restart ColdFusion for this change to take effect.
Your cfusionmx\bin directory contains the cfstat utility. From that directory, type cfstat and use the following available switches:
The following figure shows cfstat output in a Windows 2000 environment:
You use the Debugging IP Addresses page to restrict debugging output to one or more IP addresses. You can add and remove IP addresses.
Note: If you do not specify IP addresses, and debugging options are active, debugging output displays for all users.
You use the Logging Settings page of the Administrator to change ColdFusion MX logging options. The following table describes the settings:
The Log Files page of the Administrator lets you perform operations on log files, such as searching, viewing, downloading, archiving, and deleting.
Click on a Log File icon, located in the Actions column of the Available Log Files table, to search, view, download, archive, or delete a log file.
For more information, see the online Help.
The following table describes the ColdFusion MX log files:
You use the Scheduled Tasks page to schedule the execution of local and remote web pages and to generate static HTML pages. The scheduling facility is useful for applications that do not require user interactions or customized output. ColdFusion developers use this facility to schedule daily sales reports, corporate directories, statistical reports, and so on.
Information that is read more often than written is a good candidate for scheduled tasks. Instead of executing a query to a database every time the page is requested, ColdFusion MX renders the static page with information generated by the scheduled event. Response time is faster because no database transaction takes place.
You can run scheduled tasks once; on a specified date; or at a specified time, daily, weekly, or monthly. You can run a scheduled task daily, at a specified interval, or between specified dates.
The Schedule Task page lets you create, edit, and delete scheduled tasks. For more information, see the online Help.
System probes help you evaluate the status of your ColdFusion applications. Like scheduled tasks, they access a URL at a specified interval, but they can also check for the presence or absence of a string in the URL. If the URL contents are unexpected, or if an error occurred while accessing the URL, the probe can send an e-mail alert to the address specified in the System Probes page. The probe can also execute a script to perform a recovery action, such as restarting the server. All probe actions are logged in logs/probes.log. The System Probes page also displays the status of each probe.
You use the buttons in the Actions column in the System Probes table to perform the following actions:
Because probes run as scheduled ColdFusion tasks, they will not run if the ColdFusion MX server on which they are hosted crashes, or if the host web server crashes or otherwise does not respond.
The Code Compatibility Analyzer evaluates your ColdFusion pages for potential incompatibilities between ColdFusion MX and ColdFusion Server 5. For more information, see Migrating ColdFusion 5 Applications.
