Skip to main content

Dashboard Packs

Catherine
  • Updated

Overview

Dashboards and perspectives are bundled into dashboard packs, to provide customized views of your data.

  • On disk, dashboard packs are a collection of JSON files, one for each dashboard and perspective.
  • Like SCOM Management Packs, you’re not expected to author all of the dashboard packs yourself. You can import additional dashboard packs from the right-hand menu ☰ then system and then the Community Packs or from community.squaredup.com.
  • You can personalise any dashboard or perspective from a dashboard pack by editing them.
  • A handful of key dashboard packs are imported when SquaredUp is installed to get you started (Windows, SCOM, SQL and IIS). To import further dashboard packs see how to import a dashboard pack.

How to import a dashboard pack

We install a handful of key dashboard packs to get you started (Windows, SCOM, SQL and IIS), but let's go ahead and import another dashboard pack from the community.

  1. In SquaredUp click on the top right hand menu ☰ > import dashboard packs. Alternatively, you can download dashboard packs from the SquaredUp Getting Started page or from community.squaredup.com

    ImportDashboardPacks.png

  2. Select a dashboard pack from the list - or search for a dashboard pack - and click Install.

  3. You must have the required SCOM Management Packs installed. For example, if you have the Veeam HyperV Management Pack, install the Veeam HyperV dashboard pack.

  4. The dashboard pack is imported and if the pack contains top-level dashboards, these will automatically appear in the navigation bar at the top of the page.

    The dashboard pack will typically also contain perspectives. You'll see these when you drilldown into a server.

Dashboard pack upgrades

When you upgrade to SquaredUp v4.6 onwards any upgraded dashboard packs will be imported.

SetupUpgradeDashboardPacks.png

If you haven't made any changes to the dashboards or perspectives being upgraded then they will be overwritten automatically.

If changes have been made to the dashboards or perspectives in the upgraded packs then you will be shown a Conflicts Detected page when logging in to SquaredUp.

Conflicts Detected

The Conflicts Detected screen is shown if you have modified any dashboards or perspectives for which there are updated copies.

Modified dashboards or perspectives

If you have modified any dashboards or perspectives and there is an upgrade available for them then you will be asked which copy you want to keep. You can also choose to keep both copies.

PackUpgradeConflictsDetectedYourCopyModified.png

Select the copy or copies you want to keep, then click next.

If you are unsure how to resolve a conflict you can click skip and come back to it later. If you don't resolve a conflict, then your existing copy remains visible and users won't see the new copy until the conflict is resolved.

You can return to the Pack Upgrade Conflicts Detected page any time by clicking on the notification from the right-hand menu ☰ > notifications. If you have dismissed the notification it will be in Dismissed Notifications at the bottom of the page. Or you can browse to https://<SquaredUpURL>/upgrade/conflict.

UpgradeConflictResolution.png

The dashboard will still be available in Open Access (if enabled) regardless of which copy you keep.

Deleted dashboards or perspectives

If you have deleted a dashboard or perspective, and there is an upgrade available for it, then you will be asked whether you want to add the new copy or not.

PackUpgradeConflictsDetectedYourCopyDeleted.png

If you don't want to add the new copy then you can just click next.

If you want to add the new copy select it and then click next.

Troubleshooting dashboard packs

The first thing to do if you are experiencing any issues with dashboard packs is to force a reload of all dashboard packs:

In SquaredUp click on the top right hand menu ☰ > system > dashboards then click the reload button at the bottom of the dashboards perspective.

A dashboard or perspective is missing and listed as invalid

The dashboard or perspective may be missing from the navigation bar following an upgrade or dashboard migration, and listed as invalid on the dashboard packs perspective. This can occur when the dashboard is derived from a dashboard ID which doesn't exist. Follow the steps below to resolve this issue:

      1. On the SquaredUp server, open the SquaredUpv4 folder. The default location is C:\inetpub\wwwroot\SquaredUpv4, but a custom location may have been chosen during the installation.
      2. Browse to the \user\packages folder and locate the dashboard or perspective. Published dashboards and perspectives are in the everyone folder, and dashboards in a Team Folder will be in a folder of the same name.
      3. Open the JSON file you require from either the dashboards or perspectives folder.

      4. Scroll to the end of the file and change the derivedFrom ID to be all zeros:

        "derivedFrom": "00000000-0000-0000-0000-000000000000"

      5. Save the file.
      6. Open SquaredUp in your browser.
      7. From the right-hand menu ☰ click on system and then on the dashboards perspective.
      8. Click the reload button at the bottom of the page.

If you have any queries please contact SquaredUp Support.

The tile could not be found, you may be missing a dashboard pack

For help fixing this error see Tile could not be found.

Reloading dashboard packs

To reload all dashboard packs and content from disk follow the steps below:

      1. Open SquaredUp in your browser.
      2. From the right-hand menu ☰ click on system and then on the dashboards perspective.
      3. Click the reload button at the bottom of the page.

Related articles