Troubleshoot installation or upgrade problems

To resolve Bold Reports^® Report Viewer SDK installation or upgrade problems, allow the SDK applications through Windows controlled folder access, and then check the installation folders and the sample browser launcher.

How do I allow the Report Viewer SDK through controlled folder access?

To let the Bold Reports^® Report Viewer SDK access protected folders, add its applications, such as iisexpress.exe and the Sample Browser Launcher, as allowed apps in Windows controlled folder access.

Controlled folder access helps you protect valuable data from malicious applications and threats, such as ransomware. Controlled folder access is included with Windows 10 and Windows Server 2019. When you enable the ransomware protection in your machine, the applications will be restricted to access the protected folders in your machine.

If the Bold Reports^® Report Viewer SDK or its related executables cannot access the protected folders on your machine when ransomware protection is enabled, follow these steps to give the Bold Reports^® application access to the protected folders.

You will receive notifications from Windows when an application is blocked from accessing the protected folders. For example, the following message appears when you try to preview a report with ransomware protection enabled.

Steps to allow Bold Reports^® Report Viewer SDK to access protected folders

• Open the Ransomware protection in Windows security using the start menu.

• Click the option Allow an app through Controlled folder access.

• Windows shows the list of applications that can access the protected folders on your machine. Click the Add an allowed app option.

• Windows helps you choose which application to allow by showing recently blocked apps and all apps.

You can click any one of the options and choose the Bold Reports^® Report Viewer SDK related applications.

• Allow the iisexpress and the Bold Reports^® Report Viewer SDK related applications to access your protected folders if the application is blocked in your machine.

• Now, you can continue to use the Bold Reports^® Report Viewer SDK without blocking any operations to your protected folders.

References

• Enable controlled folder access in Microsoft Defender

• Allow specific applications to make changes to controlled folders

What if the Report Viewer SDK Sample Browser does not launch?

If the Bold Reports^® Report Viewer SDK Sample Browser does not launch, check the installation folders, run StartSampleBrowserReportingTools.exe with your platform argument, and share the error log with support if needed.

If you have issues launching the Bold Reports Report Viewer SDK local samples, follow these troubleshooting steps.

• Even though you have allowed permission for blocking applications, still not able to launch the Report Viewer SDK Sample Browser?

Make sure that the following folders are present in the installation paths C:\Program Files (x86)\Bold Reports\Report Viewer SDK and C:\Users\Public\Documents\Bold Reports\Report Viewer SDK\Samples.

• The folders are present, but the Bold Reports^® Report Viewer SDK Sample Browser still does not launch?

Open the command prompt in administrator mode, navigate to the path C:\Program Files (x86)\Bold Reports\Report Viewer SDK\Utilities\StartSampleBrowserReportingTools, and run one of the following commands through the StartSampleBrowserReportingTools.exe.

After running the command, ensure the System tray contains IISEXPRESS.exe application which hosts the samples.

• If none of the preceding steps help to launch the samples?

You can find the error log file in the path C:\Program Files (x86)\Bold Reports\Report Viewer SDK\Utilities\StartSampleBrowserReportingTools. Contact Bold Reports^® support by creating a support ticket and share the generated log file.