Skip to content

Commit 6bba916

Browse files
Merge pull request #1740 from syncfusion-content/259599-ug
259599-ug: Update more information about IIS OCR ( net 8.0) troubleshooting details
2 parents 5007571 + 046f2bf commit 6bba916

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

Document-Processing/PDF/PDF-Library/NET/Working-with-OCR/Troubleshooting.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -491,6 +491,39 @@ NuGet: <a href="https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux.NoD
491491
</tr>
492492
</table>
493493

494+
## IIS Fails to Load Tesseract OCR DLLs
495+
<table>
496+
<th style="font-size:14px" width="100px">Exception</th>
497+
<th style="font-size:14px">The application failed to load Tesseract OCR DLLs when hosted on IIS, resulting in the error:
498+
Could not find a part of the path 'C:\inetpub\wwwroot\VizarCore\x64'.</th>
499+
<tr>
500+
<th style="font-size:14px" width="100px">Reason
501+
</th>
502+
<td> * IIS couldn't load the required Tesseract and Leptonica DLLs because some system components were missing.<br>
503+
* The Visual C++ Redistributables for VS2015-VS2022 (x86 and x64) were not installed.<br>
504+
* IIS on a 64-bit server needs both redistributables to load native libraries correctly.<br>
505+
* The application's folder paths and permissions were not properly set up for OCR binaries.<br>
506+
</td>
507+
</tr>
508+
<tr>
509+
<th style="font-size:14px" width="100px">Solution</th>
510+
<td>
511+
<b>Installed Required Redistributables</b><br>
512+
Installed both <b>VC_redist.x86</b> and <b>VC_redist.x64</b> for VS2015-VS2022 on the IIS server.<br>
513+
<b>Updated Server</b><br>
514+
Applied all available Windows updates (including cumulative and Defender updates) to ensure system stability.<br>
515+
<b>Configured Application Paths</b><br>
516+
Set default paths for OCR binaries:<br>
517+
* C:\inetpub\wwwroot\myapp\Tesseractbinaries<br>
518+
* C:\inetpub\wwwroot\myapp\tessdata<br>
519+
<b>Set Proper Permissions</b><br>
520+
Ensured IIS_IUSRS group has <b>Read & Execute</b> and <b>List folder contents</b> permissions on the above directories.<br>
521+
<b>Observed Delayed Activation</b><br>
522+
OCR functionality did not activate immediately-likely due to IIS caching or delayed DLL loading-but began working shortly after configuration.<br>
523+
</td>
524+
</tr>
525+
</table>
526+
494527
## OCR not working on Azure App Service Linux Docker Container: Exception has been thrown by the target of an invocation
495528
<table>
496529
<th style="font-size:14px" width="100px">Exception</th>

0 commit comments

Comments
 (0)