How to set up per-server configuration when using high availability (HA)
By default, all servers share the same configuration files when configured for high availability (HA) (see Enabling High Availability). This means that they
connect to the same SCOM server (see How to reconfigure Dashboard Server after moving the Data Warehouse or SCOM server)
use the same Open Access loopback URL (v4) (see Troubleshooting Open Access (v5))
use the same Data Warehouse (see How to check and reconfigure the Data Warehouse connection)
If a server needs to use a different or unique configuration to the other servers then there are two things to consider:
- When using multiple SCOM servers or SQL servers we recommend that these are load balanced, for example using a SQL Listener or load balanced SCOM.
- If these services cannot be load balanced then 'configuration redirections', as described below, can be set up to give each server its own unique copy of a configuration which is not shared over HA.
Configuring different SCOM servers
You may wish to configure each SquaredUp server to use a different SCOM server, as an alternative way of ensuring Dashboard Server remains up if one of the SCOM servers goes down. You can do this by defining separate SCOM connectivity settings for each server, for example, one SquaredUp server pointing at SCOM server 1 and the other at SCOM server 2. To do this, follow the steps below, running the
haconfigs command on the HA server that you want to target at a different SCOM server and using the file name
Configuring different Open Access loopback URLs
On Dashboard Server v4 you can also configure different SquaredUp servers to use different Open Access loopback addresses (see "An error occurred loading this dashboard" - Checking the Open Access Loopback URL on v4). To do this set the loopback as normal for the Primary server and then follow the steps below running the
haconfigs command on the Secondary server and using the file name
openaccess.json to set a different loopback URL for the Secondary server. The loopback URL is only necessary on Dashboard Server v4.
Connecting to different Data Warehouse database instances
If you wish to configure SquaredUp servers to use different Data Warehouse database instances (see How to reconfigure Dashboard Server after moving the Data Warehouse or SCOM server) follow the steps below, running the
haconfigs command with the file name
connections.json. This will only work if the database instances are for the same Data Warehouse and the same Management Group.
- On the server that you wish to have a different configuration, such as your Secondary SquaredUp server, open a command prompt as an administrator (from Start > Run type
command prompt, rightclick on the Command Prompt icon and click Run as administrator).
Change to the Dashboard Server installation location, which by default is
C:\inetpub\wwwroot\SquaredUpv[Version Number]but may have been changed at installation, for example type:
Run the squaredup4 or squaredup5 command depending on your version:
squaredup5 haconfigs --filename=<filename>
squaredup4 haconfigs --filename=<filename>
command to create a unique local-only configuration, where
<filename>is the configuration file you wish to make unique for this server.
squaredup5 haconfigs --filename=scom.jsonto create a unique SCOM server address configuration for this server (see How to reconfigure Dashboard Server after moving the Data Warehouse or SCOM server)
squaredup5 haconfigs --filename=connections.jsonto point this server to a different Data Warehouse (see How to reconfigure Dashboard Server after moving the Data Warehouse or SCOM server)
squaredup5 haconfigs --filename=openaccess.jsonto add a unique Open Access loopback URL (see Troubleshooting Open Access (v5))
After running the command, you will automatically be presented with an elevated Notepad, allowing the file to be edited for use on the local server only:
- Edit the file as required, and save your changes.
- For some configurations to come into effect, you will need to recycle the Dashboard Server application pool. This tool does not automatically recycle the application pool after making or editing a configuration. You can recycle the Dashboard Server application pool from IIS or by running the command
You can view which configurations are unique to the current server by running
squaredup5 haconfigs or
squaredup4 recyclewith no additional arguments. This will also show how the local file is different to the HA-shared copy:
Editing an existing redirect
If you run
squaredup5 haconfigs --filename=<filename> or
squaredup4 haconfigs --filename=<filename> where there is already a redirect in place for
<filename>, an elevated notepad will be opened to allow you to edit the local configuration file.
To remove a redirect, run:
squaredup5 haconfigs --filename=<filename> --delete
squaredup4 haconfigs --filename=<filename> --delete
A manual confirmation is required to finish deletion.