Documentation forSolarWinds Platform Self-Hosted

Disable or delete HA pools, force a failover, or update an HA pool for SolarWinds Platform products

This topic applies only to the following products:

SolarWinds Observability Self-Hosted

DPAIM — EOC — IPAM — LA — NAM — NCM — NPM — NTA — SAM — SCM — SRM — UDT — VMAN — VNQM — WPM

Use the High Availability Deployment Summary page to view and manage your pools and to view the pool member type.

Disable HA pools

Before you perform an upgrade or maintenance on SolarWinds Platform High Availability (HA) pool members, you must disable the pool.

Disabling the pool allows internal HA processes, such as disconnecting the RabbitMQ cluster, to shut down cleanly. If these processes do not complete before maintenance begins, the deployment can become unstable or broken.

After you disable an HA pool, wait several minutes before starting maintenance to allow all processes to complete.

You may also need to disable an HA pool if you no longer have sufficient HA pool licenses for the number of enabled pools.

Disable an HA pool

  1. In the SolarWinds Platform Web Console, click Settings > My Deployment.

  2. Select the Pools tab.

  3. Select the pool you want to disable.

  4. Toggle High Availability to Off.

You can also disable the entire feature on the High Availability Settings page.

Force a manual failover

To test SolarWinds Platform High Availability or network configuration changes, or to upgrade, manually fail over to the standby pool member.

  • Failover can only occur when both pool members are up, the pool is enabled, and HA is enabled.
  • If the HA pool uses a virtual hostname, you may need to flush your browser's DNS cache by closing and reopening your browser.

  1. In the SolarWinds Platform Web Console, click Settings > My Deployment.

  2. Select the Pools tab.

  3. Select the pool you want to failover manually.

  4. Click Commands on the pool details section of the pool you want to failover.

  5. Click Force Failover.

The pool fails over to the secondary server, and an audit event is logged with details of who forced the failover and when.

You can use Orion SDK to trigger HA failover without accessing the High Availability Deployment Summary page. See the support article on forcing HA failover without accessing the SolarWinds Platform Web Console.

Update your credentials, VIP address, virtual hostname, or active server

  1. In the SolarWinds Platform Web Console, click Settings > My Deployment.

  2. Select the Pools tab.

  3. Select the pool to update.

  4. Click Commands on the pool details section.

  5. Click Edit Pool.

  7. Update your credentials, (including TSIG certificates), VIP address, virtual hostname, or preferred active server.

The pool is saved with the changes you made.

View the pool member type

Individual pool members display a Server Type and a HA Run Type in addition to polling metrics. Select a pool member to view its type and other polling information.

  • The Server Type displays the type of SolarWinds Platform server, such as Additional or Main Polling Engine.
  • The HA Run Type indicates whether the server is currently active or in standby.

Remove HA pools

You may need to remove one or more HA pools to free an HA pool license or to change pool members.

When you remove a pool in a single subnet pool, the VIP is still reserved in the database and is not recycled so you can re-establish the pool without modifying your network or device settings.

When you remove a pool in a multiple subnet pool, the DNS entry for the virtual host is still in your DNS server and associated with the server that is active when you remove the pool.

  1. In the SolarWinds Platform Web Console, click Settings > My Deployment.

  2. Select the Pools tab.

  3. Select the pool you want to remove.

  4. Click Commands on the Pool Details section.

  5. Click Remove Pool.

An audit event is logged when you remove a pool.

Change HA server role

This feature is available only for SolarWinds Observability Self-Hosted Enterprise Scale.

  1. In the SolarWinds Platform Web Console, click Settings > My Deployment.

  2. Select the Pools tab.

  3. Select the pool that contains the server whose role you want to change, and then click Edit.

  4. On Pool properties, expand the Role drop-down for the server, and select Standby or Active.

Changing the server role may take several minutes to complete. During the change, high availability for the pool is temporarily disabled and is automatically re-enabled after the change is complete.

While the role change is in progress, you can modify other pool properties, but cannot complete the configuration until the server role change finishes.