LogoDark mode logo
LogoDark mode logo
Contact SupportLoading Light/Dark Toggle

    • Troubleshooting Open Access (v5 & v6)
    • Troubleshooting Open Access (v4)
    • Open Access: You do not have the required permissions or your current license does not include Open Access
    • Open Access: A valid mapping was not found for an Open Access page
    • Open Access: Some tiles on the Open Access page are not shown
    • Open Access - "An error occurred loading this dashboard" - Checking the Open Access Loopback URL on v4
    • Open Access: Open Access dashboards are cut off or show an unusable fixed scroll bar
    • HttpAntiForgeryException occurred on an endpoint
  • Collecting diagnostic information
  • Operations Manager 2012 Data Warehouse Health Check Script
  • Where to find log files

troubleshootingopen accesstroubleshooting open access v5

Troubleshooting Open Access (v5 & v6)

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

Troubleshooting steps

1. Check the SquaredUp application pool account has read-only access

Many issues can be resolved by rerunning the Open Access configuration to ensure that the SquaredUp application pool account has read-only permissions in SCOM. See Sharing Dashboards with anyone - Open Access

2. Re-generate the dashboard experiencing issues

If one particular dashboard is experiencing issues with Open Access we recommend you rerun the generate option for that dashboard.

To do this in SquaredUp DS click the top right-hand menu ☰ system > open access then click the generate link next to that particular Open Access dashboard.

Alternatively, from the dashboard itself you can disable Open Access and re-enable it, by toggling from on to off to on again, which will also run the regenerate option.

You will see the message 'Preparing your Open Access dashboard, please wait':

Common errors

HttpAntiForgeryException occurred on an endpoint or An unknown error occurred attempting to load this content

When Open Access dashboards or tiles are embedded in other pages, such as SharePoint, you may see an error where the tiles do not load.

See HttpAntiForgeryException occurred on an endpoint

"Unexpected Request" and the Open Access Upgrade step is unexpectedly displayed when an admin clicks an item on the navigation bar

The Open Access Upgrade step can be missed following an upgrade to v5 & v6 if a Core dashboard has been modified and shared via Open Access. This results in Open Access dashboards showing a yellow exclamation mark with the error "Unexpected Request" and the Open Access upgrade step being unexpectedly displayed when an administrator clicks an item on the navigation bar. This can be fixed by running through the Open Access Upgrade step that appears or clicking Generate All in system > open access.

"Error loading dashboard - No open access dashboards were found"

You may see this message when viewing the open access navigation bar if all the dashboards that were on the open access navigation have had Open Access disabled or are removed from the Open Access navigation bar.

"Error loading dashboard - This Open Access ID is expired or relates to a page which no longer exists"

You may see this message when viewing an Open Access URL for a dashboard that was previously enabled for Open Access but has since had Open Access disabled.

Some tiles on the Open Access page are not shown

Rerun the generate option for that dashboard, from the top right-hand menu ☰ system > open access as described above.

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

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

Missing SCOM Permission

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.

How do I increase the SquaredUp logging level to log data about Open Access?

Support may ask you to change the SquaredUp logging level from information to debug. You can do this from the top right-hand menu ☰ system > maintenance see Maintenance Page.

Enterprise Application perspectives shared with Open Access may not display correctly

Enterprise Application perspectives need a manual Open Access generation carried out if the Enterprise Application is modified.

Browse to the top right-hand menu ☰ system > open access, find the pinned perspective and click the generate link to run the Open Access generate step manually.

Reference: v5 & v6 Open Access settings

Global Open Access settings can be set and changed in the openaccess.json file. Global settings affect all Open Access dashboards, but some settings can be overridden on a per dashboard level in Dashboard Settings.

Json
Description
Default value
Suggested
oa-refresh-interval
Open Access dashboard refresh interval in seconds (not in ms) . Default is 60 seconds, but you might like to change this, for example "oa-refresh-interval": 120
60
120
oa-theme
Open Access dashboards in DS for SCOM can be in light theme or dark theme, for example "oa-theme": "darktheme"
lighttheme
darktheme
(if preferred)
oa-interaction
Open Access dashboards allow drilldown by default, and if the user isn't logged in they get the logon screen, to login or request a license. Drilldown can be switched off for all Open Access dashboards by changing this global value to false. Default value: true. Interaction can be changed on a per dashboard basis in System > Open Access (v5.5 and above).

  1. On the SquaredUp server, run Notepad as administrator (Start, Run, type notepad, and then right-click and select Run as administrator).

    With Notepad in administrator mode, open the openaccess.json file from the following path in the SquaredUp DS folder:

    ...\User\Configuration\openaccess.json

    The default location for the SquaredUp folder is C:\inetpub\wwwroot\SquaredUp

    For v5 it is C:\inetpub\wwwroot\SquaredUpv5 and for v4 C:\inetpub\wwwroot\SquaredUpv4.

    A custom location may have been chosen during the installation.

    Name of the SquaredUp folder

    The default name of the SquaredUp folder is SquaredUp for v6 and above.

    For v5 it is SquaredUpv5, and for v4 SquaredUpv4.

  2. If openaccess.json is blank or only contains {} then enter the setting and the value you require, for example:
    {
    "oa-refresh-interval": 120
    }
  3. If openaccess.json already contains settings, then you will need to add a comma at the end of the previous line, and then enter your setting and value, to look something like this:
    {
    "oa-theme": "darktheme",
    "oa-refresh-interval": 120
    }
  4. Save the file.
  5. In IIS recycle the SquaredUp application pool for the setting to take effect.
    If you are unable to access SquaredUp DS ("Server Error in '/SquaredUpvx' Application", "SquaredUp DS cannot start due to an error" or "Startup failed for 'Configuration'") after editing openaccess.json then there is an error in the file. Correct openaccess.json and recycle the SquaredUp DS application pool again.

Was this article helpful?


Have more questions or facing an issue?
Submit a ticket

On this page

  • Troubleshooting steps
  • 1. Check the SquaredUp application pool account has read-only access
  • 2. Re-generate the dashboard experiencing issues
  • Common errors
  • HttpAntiForgeryException occurred on an endpoint or An unknown error occurred attempting to load this content
  • "Unexpected Request" and the Open Access Upgrade step is unexpectedly displayed when an admin clicks an item on the navigation bar
  • "Error loading dashboard - No open access dashboards were found"
  • "Error loading dashboard - This Open Access ID is expired or relates to a page which no longer exists"
  • Some tiles on the Open Access page are not shown
  • "You do not have the required permissions or your current license does not include Open Access"
  • Missing SCOM Permission
  • How do I increase the SquaredUp logging level to log data about Open Access?
  • Enterprise Application perspectives shared with Open Access may not display correctly
  • Reference: v5 & v6 Open Access settings

Footer

Sites

  • SQUAREDUP
  • SQUAREDUP DS
  • DOWNLOAD
  • COMMUNITY ANSWERS

Quick Links

  • SUBMIT A REQUEST
  • EVENTS
  • CAREERS

Small Print

  • PRIVACY POLICY
  • TERMS AND CONDITIONS
Youtubex (Twitter)LinkedIn

© SquaredUp 2025