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 SquaredUp DS after moving the Data Warehouse or SCOM server)
use the same Open Access loopback URL (v4) (see Troubleshooting Open Access (v4))
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 SquaredUp DS 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 SquaredUp DS v4 you can also configure different SquaredUp servers to use different Open Access loopback addresses (see Open Access - "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 SquaredUp DS 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 SquaredUp DS 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).
Navigate to the instance for which you wish to change authentication.
cd C:\inetpub\wwwroot\SquaredUpWhere to find the SquaredUp folder
Name of the SquaredUp folder
The default name of the SquaredUp folder is
SquaredUpfor v6 and above.
, and for v4.
Location of the SquaredUp folder
A custom location may have been chosen during the installation.
The default location for the SquaredUp folder is
For v5 it is
and for v4.
Run the SquaredUp command with
squaredup 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.What is the SquaredUp command for older versions?
The SquaredUp command for v6 and above is
SquaredUp. This is followed by an operator for the task you are carrying out, for example
SquaredUp windows, or
The SquaredUp command for v5 it is
, and for v4.
squaredup haconfigs --filename=scom.jsonto create a unique SCOM server address configuration for this server (see How to reconfigure SquaredUp DS after moving the Data Warehouse or SCOM server)
squaredup haconfigs --filename=connections.jsonto point this server to a different Data Warehouse (see How to reconfigure SquaredUp DS after moving the Data Warehouse or SCOM server)
squaredup 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 SquaredUp DS application pool. This tool does not automatically recycle the application pool after making or editing a configuration. You can recycle the SquaredUp DS application pool from IIS or by running the SquaredUp command with
You can view which configurations are unique to the current server by running
squaredup haconfigs or
squaredup 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
squaredup 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:
squaredup haconfigs --filename=<filename> --delete
A manual confirmation is required to finish deletion.