Skip to content

Commit 32d5eff

Browse files
authored
docs(asyncupload): add more troubleshooting tips
1 parent 9b5ea1c commit 32d5eff

File tree

1 file changed

+25
-20
lines changed

1 file changed

+25
-20
lines changed

knowledge-base/asyncupload-red-dot-shown-file-not-uploaded-troubleshooting.md

Lines changed: 25 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -18,43 +18,48 @@ I am experiencing an issue where a red dot is shown next to every file I attempt
1818

1919
# Solution
2020
To resolve this issue, follow these steps:
21-
1. Check if you have write permission to your temporary folder. If you are hosting your application in IIS, make sure you have assigned additional permissions to the temporary folder. By default, the temporary upload folder is located at `~/App_Data/RadUploadTemp`. Ensure that the folder has full read and write permissions.
22-
2. Verify that the `Telerik.Web.UI.WebResource.axd` handler is registered in the `web.config` file. Open the `web.config` file and add the following code snippet within the `<system.web>` section:
21+
- Check if you have write permission to your temporary folder. If you are hosting your application in IIS, make sure you have assigned additional permissions to the temporary folder. By default, the temporary upload folder is located at `~/App_Data/RadUploadTemp`. Ensure that the folder has full read and write permissions.
22+
- Verify that the `Telerik.Web.UI.WebResource.axd` handler is registered in the `web.config` file. Open the `web.config` file and add the following code snippet within the `<system.web>` section:
2323

2424
```
25-
<httpHandlers>
26-
<add path="Telerik.Web.UI.WebResource.axd" type="Telerik.Web.UI.WebResource" verb="*" validate="false"/>
27-
</httpHandlers>
25+
<system.web>
26+
<httpHandlers>
27+
<add path="Telerik.Web.UI.WebResource.axd" type="Telerik.Web.UI.WebResource" verb="*" validate="false"/>
28+
</httpHandlers>
29+
</system.web>
2830
```
2931

30-
3. Also, ensure that the following code snippet is present within the `<system.webServer>` section:
32+
- Also, ensure that the following code snippet is present within the `<system.webServer>` section:
3133

3234
```
33-
<httpHandlers>
34-
<remove name="Telerik_Web_UI_WebResource_axd"/>
35-
<add name="Telerik_Web_UI_WebResource_axd" path="Telerik.Web.UI.WebResource.axd" type="Telerik.Web.UI.WebResource" verb="*" preCondition="integratedMode"/>
36-
</httpHandlers>
35+
<system.webServer>
36+
<handlers>
37+
<remove name="Telerik_Web_UI_WebResource_axd"/>
38+
<add name="Telerik_Web_UI_WebResource_axd" path="Telerik.Web.UI.WebResource.axd" type="Telerik.Web.UI.WebResource" verb="*" preCondition="integratedMode"/>
39+
</handlers>
40+
</system.webServer>
3741
```
3842

39-
4. You can test if the `Telerik.Web.UI.WebResource.axd` handler is registered correctly by opening the following URL: `https://domain/Telerik.web.ui.webresource.axd?type=rau`. If the output is `{"message" : "RadAsyncUpload handler is registered successfully, however, it may not be accessed directly."}`, then your handler is registered correctly.
43+
>Note: Test if the `Telerik.Web.UI.WebResource.axd` handler is registered correctly by opening the following URL: `https://[your domain or IP name]/Telerik.web.ui.webresource.axd?type=rau`. If the output is `{"message" : "RadAsyncUpload handler is registered successfully, however, it may not be accessed directly."}`, then your handler is registered correctly.
4044
4145
If the issue persists, consider the following additional tips:
4246
- The file upload will fail if the TemporaryUpload folder is not given enough permissions, even if the permissions of the TargetFolder are set properly. The default temporary upload folder is placed inside the App_data folder, so you have to give full read and write permissions to it as well: ~/App_Data/RadUploadTemp
4347
- Set the `UseApplicationPoolImpersonation` property as explained in the [Application Pool Impersonation](https://docs.telerik.com/devtools/aspnet-ajax/controls/asyncupload/troubleshooting/common-issues#application-pool-impersonation) article.
4448
- Exclude the handler from Windows Authentication (NTLM) and Forms Authentication by adding the following code snippet within the `<location path="Telerik.Web.UI.WebResource.axd">` section in the web.config:
4549

4650
```xml
47-
<location path="Telerik.Web.UI.WebResource.axd">
48-
<system.web>
49-
<authorization>
50-
<allow users="?" />
51-
</authorization>
52-
</system.web>
53-
</location>
51+
<location path="Telerik.Web.UI.WebResource.axd">
52+
<system.web>
53+
<authorization>
54+
<allow users="?" />
55+
</authorization>
56+
</system.web>
57+
</location>
5458
```
5559

56-
- Check if your application is using a valid SSL certificate, as RadAsyncUpload requires it.
57-
- Review the network requests in the browser dev toolbar or with a tool like Fiddler: https://www.telerik.com/blogs/improve-your-debugging-skills-with-chrome-devtools#inspect-network-requests. It is possible that some other network condition is breaking the requests (for example, a proxy changes or caches the requests while it should not). See what happens with the requests and whether the responses carry useful information (e.g., routing or authentication blocking the request).
60+
- Check if your application uses a valid SSL certificate, as RadAsyncUpload requires it.
61+
- The red dot may be due to a large file upload. Configure the control and your app as explained at https://docs.telerik.com/devtools/aspnet-ajax/controls/asyncupload/functionality/uploading-large-files.
62+
- Review the network requests in the [Chrome DevTools](https://www.telerik.com/blogs/improve-your-debugging-skills-with-chrome-devtools#inspect-network-requests) or with a tool like Fiddler: https://www.telerik.com/blogs/improve-your-debugging-skills-with-chrome-devtools#inspect-network-requests. It is possible that some other network condition is breaking the requests (for example, a proxy changes or caches the requests while it should not). See what happens with the requests and whether the responses carry useful information (e.g., routing or authentication blocking the request).
5863
- If your application is hosted in a web farm or web garden, follow the guidance provided in the [Web Farm and Load Balancing](https://docs.telerik.com/devtools/aspnet-ajax/controls/asyncupload/troubleshooting/web-farm) article.
5964
- For Azure WAF Firewall related issues, configure the Azure Application Gateway web application firewall (WAF) to allow the `WebResource.axd` and `Telerik.Web.UI.WebResource.axd` extensions. Refer to the following articles for more information:
6065
- [Customize web application firewall rules through the Azure portal](https://learn.microsoft.com/en-us/azure/web-application-firewall/ag/application-gateway-customize-waf-rules-portal)

0 commit comments

Comments
 (0)