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 accessopen access an error occurred loading this dashboard checking the open access loopback url on v4

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

Symptoms

Error loading dashboard

An error occurred loading this dashboard, there may be more information available in your log file.

On SquaredUp DS v4 this is fixed by setting the Open Access Loopback URL as described in this article. If you are using SquaredUp DS v5 see Troubleshooting Open Access (v5).

What is the Open Access Loopback URL?

When you visit an Open Access URL the rendering software prepares to take a snapshot of the dashboard. It renders the dashboard by acting as a browser and visiting a SquaredUp DS URL, it takes a snapshot and this image is then served back to the user who originally requested the page.

The SquaredUp DS URL, known as the Open Access loopback URL, is usually determined programmatically by checking the IIS bindings. With default IIS settings of localhost:80 the loopback URL that the system would automatically try would be http://localhost. Occasionally this default loopback URL can be determined incorrectly, however this problem can be overcome by specifying a oa-loopback-base-url in the openaccess.json file as described below.

Setting the Open Access Loopback URL

The loopback URL is only necessary on SquaredUp DS v4. If you are using SquaredUp DS v5 see Troubleshooting Open Access (v5).

  1. First we need to determine what the Open Access loopback URL should be.
    If you are using SSL the loopback URL should be the URL your SSL certificate is signed to, for example https://SquaredUp.Company.com
    If you are unsure what your loopback URL should be take a look at the bindings to see if a hostname is specified. On the server where SquaredUp DS is installed open IIS Manager and click on Default Web Site, then on Bindings on the right hand menu under Actions. If there is a hostname and port specified note them down. Do not edit the bindings.
    Next we need to specify the loopback URL in the openaccess.json file. You may need to try a few different options.
    • If port 80 is shown, then the loopback URL to try is http://hostname
  • If port 443 is shown, then the loopback URL to try is https://hostname
  • If no hostname is specified, but the port is 443, then the loopback URL to try is https://localhost
  • If no hostname or port is specified, but you do use a specific URL to access SquaredUp DSyou should try the hostname from this URL.
  • If you're not sure which settings to use, please contact SquaredUp Support and reply to the automatic response with the output of the SquaredUp DS Diagnostics (see Collecting diagnostic information).
  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. Modify the file to read as follows:
    {
        "oa-loopback-base-url": "LoopbackURL",
        "oa-ajax-complete-wait": 5000
    }

    where LoopbackURL should be replaced with the URL determined above, for example https://localhost or https://CertificateURL
  3. Save the file.
  4. In IIS recycle the SquaredUp DS application pool for the setting to take effect.
    If you are unable to access SquaredUp DS (Server Error in '/SquaredUpv4' Application) after editing openaccess.json then there is an error in the file. Correct openaccess.json and recycle the SquaredUp DS application pool again.
  5. When using high availability (HA) (see Enabling High Availability) by default the openaccess.json file is used to apply the same configuration to all servers. If you need each server to use a different configuration, such as different Open Access loopback URLs, see How to set up per-server configuration when using high availability (HA).
  6. If you are using Windows authentication with Kerberos delegation you may need to configure additional SPNs. The application pool identity will need an SPN added for the newly added loopback URL hostname.

    If you have another address you use to access SquaredUp DS, for example a DNS alias or alternative binding, you should create two additional SPNs for this address, the shorter address and the fully qualified domain name (FQDN).

    1. On a domain controller click on the Start button type:
      Command Prompt
    2. Right-click on the Command Prompt icon and click Run as administrator
    3. Type:
      SETSPN -S HTTP/Hostname domain\SquaredUpAccount
      Where Hostname is the address you specified in DNS Manager,domain is your domain, and SquaredUpAccount is the domain service account that you set as the SquaredUp DS application pool identity.
    4. Check that it shows Updated Object. If it shows Duplicate SPN found, aborting operation! see Duplicate SPN found - Troubleshooting Duplicate SPNs
    5. Once complete, type the following for the fully qualified domain name (FQDN):
      SETSPN -S HTTP/Hostname.domain.tld domain\SquaredUpAccount
      Where tld is the top level domain.
    6. Check that it shows Updated Object. If it shows Duplicate SPN found, aborting operation! see Duplicate SPN found - Troubleshooting Duplicate SPNs

    For more information see Troubleshooting Kerberos

Was this article helpful?


Have more questions or facing an issue?
Submit a ticket

On this page

  • Symptoms
  • What is the Open Access Loopback URL?
  • Setting the Open Access Loopback URL

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