Troubleshooting Open Access (v4)

This article describes how to troubleshoot Open Access on SquaredUp DS v4. If you are using v5 see Troubleshooting Open Access v5

1. Check Open Access is configured correctly

  1. Check that you are using the latest version of SquaredUp DS. The version number is shown in the bottom right corner of SquaredUp DS.

    Get the latest version of SquaredUp DS for SCOM

  2. In SquaredUp DS browse to the right-hand menu ☰ then system and then click on the Open Access perspective. Check you see a message saying SquaredUp DS is correctly configured for Open Access. If you do not see this message continue to the next step.
  3. Browse to http://SquaredUpServer/SquaredUpv4/setup?stage=openaccess (where SquaredUpServer should be replaced by the name of the server where SquaredUp DS is installed). Check you see a message saying that SquaredUp DS is correctly configured for Open Access. If you do not see this message click next to configure Open Access.
  4. If SquaredUp DS is unable to automatically configure Open Access please see Sharing Dashboards with anyone - Open Access.
  5. Re-run the SquaredUp permissions tool to ensure the application pool identity has the correct permissions to the SquaredUp directory, see How to check and modify the application pool identity.

2. Common problems

"Error loading dashboard - An error occurred loading this dashboard"

If you see the following error, you should check the Open Access loopback URL:

Open Access - "An error occurred loading this dashboard" - Checking the Open Access Loopback URL on v4

Some tiles on the Open Access page are not shown

You may need to increase the time between the dashboard being loaded and snapshot being taken:

Open Access: Some tiles on the Open Access page are not shown

Open Access dashboards are cut off or show an unusable fixed scroll bar

If the full length of the Open Access page is not shown or fixed scroll bars are visible then you may need to increase some settings:

See Open Access: Open Access dashboards are cut off or show an unusable fixed scroll bar

"You do not have the required permissions or your current license does not include Open Access"

Open Access: You do not have the required permissions or your current license does not include Open Access

3. Content that does not work on v4 Open Access pages

  • Open Access dashboards are non-interactive so users will not be able to hover or drill down for more information you may wish to design your dashboards slightly differently with Open Access in mind. For example, you should consider adding a key to a performance line graph.
  • Web Content tiles are not supported with Open Access, because in many cases they do not work. Slow webpages may show as blank in Open Access. Webpages requiring authentication will not work because Open Access does not use any authentication.
  • SCOM On-Demand tasks (see How to use the SCOM Task tile) cannot be run on Open Access dashboards, because Open Access is unauthenticated, so you will see the error MISSING_SCOM_PERMISSION.
  • When using top n with the time comparison on the Performance Report tile see How to use the Performance tile

Reference - v4 Open Access settings

This table shows the most used Open Access settings as described in this article. Most values are in milliseconds (ms), but oa-refresh-interval is in seconds.

Json
Description
Default value
Suggested
oa-loopback-base-url
Base loopback URL
http://localhost
https://CertificateURL
oa-ajax-complete-wait
How long to wait after an ajax call before assuming all calls are complete in ms (1000 ms is 1 second)
1000
5000
oa-width-resize-wait
Timeout applied before doing the width in ms (300 ms is 0.3 seconds)
300
1000
oa-height-resize-wait
Timeout applied before doing the length in ms (300 ms is 0.3 seconds)
300
1000
oa-engine-logging
When this is enabled an OpenAccessEngine.log file is generated in C:\inetpub\wwwroot\squaredupv4\Transient\Log
false
true (if troubleshooting)
oa-verbose-logging
When enabled SSR will log verbosely
false
true (if troubleshooting)
oa-refresh-interval
Open Access dashboard refresh interval in seconds (not in ms) (60 seconds)
60
60
oa-theme
Open Access dashboards in DS for SCOM default to light theme, but can be changed to darktheme
lighttheme
darktheme (if preferred)

Once troubleshooting is complete, remove the "oa-engine-logging": true, and "oa-verbose-logging": true lines and remove the comma from the last line.

Was this article helpful?

Have more questions or facing an issue?
Submit a ticket