Troubleshooting Open Access (v4)
This section describes how to troubleshoot Open Access on Dashboard Server v4. If you are using v5 see Troubleshooting Open Access (v5)
See if your issue is in this list of common problems:
Check that you are using the latest version of Dashboard Server. The version number is shown in the bottom right corner of Dashboard Server.
In Dashboard Server browse to the right-hand menu ☰ then system and then click on the Open Access perspective. Check you see a message saying Dashboard Server is correctly configured for Open Access. If you do not see this message continue to the next step.
Browse to http://SquaredUpServer/SquaredUpv4/setup?stage=openaccess (where SquaredUpServer should be replaced by the name of the server where Dashboard Server is installed). Check you see a message saying that Dashboard Server is correctly configured for Open Access. If you do not see this message click next to configure Open Access.
If Dashboard Server is unable to automatically configure Open Access please see Enabling Open Access.
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
If you see the following error, you should check the Open Access loopback URL:
You may need to increase the time between the dashboard being loaded and snapshot being taken:
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:
- 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
- When using top n with the time comparison on the Performance Report tile see How to use the Performance tile - Why are the time comparison lines showing different objects to those shown on the legend?
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.
|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 SCOM Edition 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.