(Created page with '== Debugging == When installing and configuring CKFinder, sometimes it may happen that for unknown reason CKFinder doesn't work as expected, for example it returns an error abou…') |
|||
| Line 3: | Line 3: | ||
When installing and configuring CKFinder, sometimes it may happen that for unknown reason CKFinder doesn't work as expected, for example it returns an error about insufficient permissions ("It was not possible to complete the request due to file system permission restrictions."). In such case it might be more usable to run the debug version of server connector to find out what's the problem. | When installing and configuring CKFinder, sometimes it may happen that for unknown reason CKFinder doesn't work as expected, for example it returns an error about insufficient permissions ("It was not possible to complete the request due to file system permission restrictions."). In such case it might be more usable to run the debug version of server connector to find out what's the problem. | ||
| − | === web.config === | + | ==== web.config ==== |
To use CKFinder for ASP.NET in debug mode, add <code><compilation debug="false"/></code> to the web.config. | To use CKFinder for ASP.NET in debug mode, add <code><compilation debug="false"/></code> to the web.config. | ||
| Line 11: | Line 11: | ||
</system.web> | </system.web> | ||
| − | === CKFinder.dll === | + | ==== CKFinder.dll ==== |
Apart from setting compilation element, the debug version of CKFinder binaries: CKFinder.dll and CKFinder.pdb should be copied to the "bin" directory of ASP.NET application. Both files are available in the ckfinder/bin/Debug directory. | Apart from setting compilation element, the debug version of CKFinder binaries: CKFinder.dll and CKFinder.pdb should be copied to the "bin" directory of ASP.NET application. Both files are available in the ckfinder/bin/Debug directory. | ||
| Line 19: | Line 19: | ||
'''Warning:''' it is not recommended to run production ASP.NET applications with debug mode enabled. | '''Warning:''' it is not recommended to run production ASP.NET applications with debug mode enabled. | ||
| + | |||
| + | == Disabling FCN == | ||
| + | |||
| + | When File Change Notifications (FCN) are turned on, session state may be lost after deleting a subfolder. See this [http://blogs.msdn.com/toddca/archive/2005/12/01/499144.aspx blog post on msdn] to find out more about this issue. | ||
| + | This might be a problem when using CKFinder, i.e. user might be automatically logged out after deleting a folder. | ||
| + | |||
| + | A resolution for this problem (apart from suggestions in the blog post mentioned above) is using a special HTTP module | ||
| + | that disables FCN provided with CKFinder, named StopAppDomainRestartModule. To enable this module, add the following to web.config inside the <system.web> element: | ||
| + | |||
| + | <httpModules> | ||
| + | <add name="StopAppRestartOnFolderDelete" type="CKFinder.Utils.StopAppDomainRestartModule" /> | ||
| + | </httpModules> | ||
| + | |||
| + | '''Note:''' this solution will not work in medium trust environment. | ||
Revision as of 17:37, 11 January 2010
Debugging
When installing and configuring CKFinder, sometimes it may happen that for unknown reason CKFinder doesn't work as expected, for example it returns an error about insufficient permissions ("It was not possible to complete the request due to file system permission restrictions."). In such case it might be more usable to run the debug version of server connector to find out what's the problem.
web.config
To use CKFinder for ASP.NET in debug mode, add <compilation debug="false"/> to the web.config.
<system.web> <compilation debug="true" /> </system.web>
CKFinder.dll
Apart from setting compilation element, the debug version of CKFinder binaries: CKFinder.dll and CKFinder.pdb should be copied to the "bin" directory of ASP.NET application. Both files are available in the ckfinder/bin/Debug directory.
When debugging problems with file uploads, using a tool to trace HTTP connections, like Fiddler, might be helpful.
Warning: it is not recommended to run production ASP.NET applications with debug mode enabled.
Disabling FCN
When File Change Notifications (FCN) are turned on, session state may be lost after deleting a subfolder. See this blog post on msdn to find out more about this issue. This might be a problem when using CKFinder, i.e. user might be automatically logged out after deleting a folder.
A resolution for this problem (apart from suggestions in the blog post mentioned above) is using a special HTTP module that disables FCN provided with CKFinder, named StopAppDomainRestartModule. To enable this module, add the following to web.config inside the <system.web> element:
<httpModules> <add name="StopAppRestartOnFolderDelete" type="CKFinder.Utils.StopAppDomainRestartModule" /> </httpModules>
Note: this solution will not work in medium trust environment.