This article provides basic troubleshooting tips and information.
When troubleshooting RAD PDF, it is important to remember that RAD PDF comprises several different components (an ASP.NET WebControl, an ASP.NET HttpHandler, a SQL Server Database, a Windows System Service, etc.).
Issues Getting Started
The three most common problems when getting started with RAD PDF are caused when:
- RAD PDF has not installed on the server using our installer, instead only the Web Control is deployed. RAD PDF requires access to its installed system service (the RAD PDF Service) as well as other resources installed and configured. Simply copying the RAD PDF Web Control to your server does not properly deploy these other components.
- SQL Server has not been properly configured. Most commonly, the Web Application is properly setup to connect to the database; however the RAD PDF Service is not properly setup as specified in the SQL Server Setup Guide. The RAD PDF System Service also must be able to access the database so that it can retrieve, process, and save common resources.
Locating Error Descriptions
Unlike some ASP.NET WebControls, an error can occur within RAD PDF without an ASP.NET exception being raised. There are several locations to look for information about RAD PDF errors and exceptions.
- Windows Event Viewer - The Windows Event Viewer is the most comprehensive place to start troubleshooting. The RAD PDF System Service logs information, warnings, and errors to the Application Log using the Source "RAD PDF". Critical HttpHandler errors are logged to the Application Log as well. (Visibility into a custom HttpHandler can sometimes be difficult; as such, RAD PDF logs important notifications here.) ASP.NET also logs warnings here such as unhandled ASP.NET exceptions which may be useful in troubleshooting your RAD PDF configuration.
- Client Browser - As you likely know, if your web.config file is configured to display descriptive debug information, unhandled ASP.NET exceptions will render information about the exception. If using a browser which supports resource inspection (e.g. Internet Explorer with Internet Explorer Developer Toolbar, Firefox with Firebug), HttpHandler error information will be made available to you. (Without resource inspection, the more detailed error descriptions returned by the RAD PDF HttpHandler are not displayed directly in the browser.)
- Error Catching - RAD PDF's WebControl exposes the RadPdfException class (and its inherited exceptions) which is raised for many RAD PDF specific problems. These exceptions can be handled using try / catch blocks to diagnose WebControl issues related to your RAD PDF configuration in a custom manner.
Additional Support
Additional support for RAD PDF is provided at: http://www.CTdeveloping.com