Theme Personalization

Theme Personalization allows users to view SquaredUp DS in either dark theme or light theme.

Theme Personalization is available in SquaredUp DS v4.5 and above

New installations default to dark theme.

v5 and below default to light theme and retain this default on upgrading to v6.

A Teams edition license (or above) is required for this feature.

To upgrade please contact [email protected].

To check the license edition you are using see How to check which license key is being used. To see what is included in different product edition licenses see the Licensing Overview.

Setting your individual theme

You can decide if you want to view SquaredUp DS for SCOM in dark theme or light theme. The individual theme setting only affects the way SquaredUp DS looks to you, not how it looks to other users.

Go to the top right-hand menu ☰ > personalization.
Toggle the dark theme button to on or off.
When the dark theme button is set to off, you'll see SquaredUp DS in light theme. When it is set to on, you'll see SquaredUp DS in dark theme.

Setting the theme for all Open Access Dashboards

Open Access dashboards for new installations default to dark theme.

Open Access dashboards on v5 and below default to light theme and retain this default on upgrading to v6.

By default Open Access dashboards use the same theme, for example light theme, as normal dashboards, and all users who navigate to any of the Open Access URLs will be affected by this setting. If required, Open Access dashboards can be given a different theme by changing the global setting for all Open Access dashboards, or changing it on a per dashboard level:

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).

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.
If openaccess.json is blank or only contains {} then enter the setting and the value you require, for example:
```
{
"oa-refresh-interval": 120
}
```
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
}
```
Save the file.
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.

System > Open Access

This setting allows you to change the theme on a per Open Access dashboard basis.

This setting overrides the global Open Access theme.

Was this article helpful?

Have more questions or facing an issue?

Submit a ticket