Clustering the Power BI Data Gateway for High Availability (and Low visibility?)

Reading Time: 4 minutes

The functionality to cluster the Power BI Data Gateway for high availability was introduced with the November update of the Data Gateway. This has been in the works for a while though I must admit the workaround I describe back in June 2017 on SQL Shack (in the appendix) is straight forward enough and I’ll probably be keeping that in place for now until the problems I describe here get ironed out.

The documentation provided on Microsoft Docs is great and can get you setup with no issues; it’s the lack of some basic information and a few configuration drawbacks that is keeping me from implementing this new feature at the moment.

Getting set up

So, let’s assume you are operating with the workaround for disaster recovery at the moment and you have your Data Gateway app on your main production server (GWAY01) and you have the app installed on a secondary, DR server (GWAY02) waiting for a manual failover.

  • STOP! If you’re not comfortable with PowerShell, jump ahead to a restriction implementation of this functionality I detail later
  • To implement the clustering we have to first update the main/production server, which isn’t best practice but it’s new functionality and there’s no way around it I’m afraid. The name of this Data Gateway is what the cluster will be called so make sure you don’t start with your DR one first. (Assuming it’s named as such). For testing I used PRODUCTION_GATEWAY
  • You’d then update the DR server to the same version, but you can’t. There is no way to setup clustering on an already installed Gateway application (updated or not).
  • You have to uninstall the application and then re-install it.
  • During configuration you will be asked to take over an existing Gateway or create a new one. You should select to create a new one, set a name and check to add it to an existing cluster where you should see any other Gateways you own, you’ll also need the Recovery Key of the Gateway [cluster] you’re adding it to.

Power BI Data Gateway Setup

  • And you’re done. The setup is that simple, which is great. No complicated DNS, failover settings or witness servers etc.

Document it!

When you’ve completed the setup steps on the second node of your new cluster you’ll notice absolutely no indication that it is a member of a cluster. Check the main node too. Nothing there either.

Power BI Data Gateway Configuration

Power BI Data Gateway Configuration

Power BI Data Gateway Configuration


Log into the Power BI Service and it’s just the same. No visibility of how many servers are in your cluster or what those are so you need to write that down somewhere!

Power BI Data Gateway Management page

You can see two Gateways here but only the PRODUCTION_GATEWAY is clustered. They both look exactly the same from the Manage Gateways page though.

Just PowerShell

The information is there and you can get to it using PowerShell but it’s not yet straight forward…

I love PowerShell and I even wrote a module with functions to query Power BI metadata but there should always be another way to get this vital information.

The documentation I mentioned earlier points you to a PowerShell module file included in the November update. You can load this file & use the commands they provide to get information about your Gateway cluster and its members or make changes to clusters.

#Start in the Data Gateway's folder
cd 'C:\Program Files\On-premises data gateway'

#Import the module file into this session
Import-Module .\OnPremisesDataGatewayHAMgmt.psm1

#Login to Azure using the provided email. A pop-up prompt will ask for password
Login-OnPremisesDataGateway -EmailAddress

#Get all Gateway Clusters (This will include Gateways that aren't clustered)

#Get the member Gateways inside this sepecific Cluster ID
Get-OnPremisesDataClusterGateways -ClusterObjectId d05fc213-XXXX-XXXX-XXXX-9c52cab6b2e7

You might think this is an optional piece of information; maybe you aren’t familiar with PowerShell and don’t have time to dive into it. Either way, you need to know how to execute these commands

Removing a Gateway

At the time of writing this, the only way to remove a server from a Gateway cluster is by using the Remove-OnPremisesDataGateway PowerShell command. You can uninstall the application but the Gateway cluster will keep looking for that server.

Remove-OnPremisesDataGateway -ClusterObjectId d05fc213-XXXX-XXXX-XXXX-9c52cab6b2e7 -GatewayObjectID 935e9482-XXXX-XXXX-XXXX-a1d881865816


This is less than ideal and I hope they fix these issues in the January update.

You may also like...

7 Responses

  1. Carlos Cunha says:

    I am experiencing the same problem. I had a “old” gateway and when I need to migrate it to another site (because the source was migrating too) I added a new gateway to “an existing cluster and the two machines were up and running smoothly and i stopped the service on the first gateway and all was good.
    I am now decommissioning the server but wanted to cleanup shop. I gess that in the old versions the gateway and the cluster were the same so the id is the same. Now, the first gateway has the status of disconnected but has “isAnchorGateway” as true, also the command issues an error saying basically that I have the same ID on the gateway and cluster itself. How can I fix this?
    This new gateway cluster is/was not certainly thought out for this and failover and high availability was in the minds of the developers but this is a great tool for us sysadmins that need to rotate servers and want to avoid having to change all the gateways in all the datasets/reports.
    Does anyone have a thought on this ?

  2. Very helpful ! Thank you 🙂

  3. Evans says:

    Thanks for this post, I remove my gateway cluster successful on my pbi account.

  4. Jonathan Martin says:

    Still having troubledoing this. Disabling and stopping the service on my PC causes the gateway to appear offline. In Powershell, the attempt to remove my PC as a member of the cluster returns;

    WARNING: The remote server returned an error: (400) Bad Request.
    WARNING: {“error”:{“code”:”DMTS_CannotDeleteIfClusterMemberExistsErrorCode”,”pbi.error”:{“code”:”DMTS_CannotDeleteIfClusterMemberExistsErro

  5. Jonathan Martin says:

    I tried using this to remove the gateway from my PC. I had installed it prior to adding two more geways to the cluster on two servers. However, when I use the Get-OnPremisesDataClusterGateways command, I find that the gateway I want to remove has the same gatewayObjectId values as the objectId of the cluster, and when I try to remove it I get a “Bad Request” error. In addition, the gateway I want to delete has “isAnchorGateway” showing as True.

    • Craig says:

      Hi Jonathan, it sounds like you are trying to remove the current “live” gateway from the cluster. If you added the other 2 gateway installs to the cluster, you can just disable the service on your current PC, this should automatically switch the Gateway connection to one of the 2 servers. Once you do that, you’ll find that you can delete the gateway on your PC from the cluster and the IsAnchorGateway flag should no longer show. Please come back if that doesn’t work though. Thanks, Craig

Leave a Reply