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.
-
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
-
Select a dashboard pack from the list - or search for a dashboard pack - and click Install.
-
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.
-
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.
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.
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
.
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.
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:
- 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. - Browse to the
\user\packages
folder and locate the dashboard or perspective. Published dashboards and perspectives are in theeveryone
folder, and dashboards in a Team Folder will be in a folder of the same name. - Open the JSON file you require from either the dashboards or perspectives folder.
-
Scroll to the end of the file and change the
derivedFrom
ID to be all zeros:"derivedFrom": "00000000-0000-0000-0000-000000000000"
- Save the file.
- Open SquaredUp in your browser.
- From the right-hand menu ☰ click on system and then on the dashboards perspective.
- 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:
- Open SquaredUp in your browser.
- From the right-hand menu ☰ click on system and then on the dashboards perspective.
- Click the reload button at the bottom of the page.