Automated Hybrid Troubleshooting Experience


One of the more popular deployment options for Office 365, and more specifically Exchange Online, is the Exchange Hybrid Configuration. This deployment option gives customers a way to move some of their mailboxes to Exchange Online, while keeping some on-premises. Our goal with an Exchange Hybrid configuration is to make the two physically separate environments operate as if they were one. Features such as Mail Flow, Free/Busy, MailTips, and compliance features like eDiscovery searches work seamlessly even for mailboxes in different environments.

While all of this automation is great, there are some tradeoffs. When something goes wrong with the Hybrid Configuration Wizard (HCW), what do you do? We’ve heard complaints like, “This thing is a black box!” and “Why do the errors have to be so vague?” While we are proud of the work we’ve done with the HCW, we agree that troubleshooting some of the problems can be difficult.

Announcing a New Automated Troubleshooting Experience

The first version of the new automated troubleshooting experience is quite simple. You run a troubleshooter (https://aka.ms/HCWCheck) from the same server on which HCW failed (Internet Explorer only at this time). This will collect the HCW logs and parse them for you.

If you are experiencing a known issue, there will be a message that tells you what went wrong and then provide you with a link to an article that contains the solution.


Added Benefit

The troubleshooter has predetermined sets of patterns it looks for in the HCW logs to determine the conclusion. Whether it finds a conclusion or not, the HCW logs are uploaded to our datacenter and made available to a support professional in the event that you open a case. This can dramatically reduce the amount of time it takes for your issue to get resolved.


Moving forward

We plan on adding more complex checks and diagnostic results to this troubleshooter. We are working on a series of troubleshooters that will automate troubleshooting and data collection efforts for things like Migrations, Free/Busy, and OAUTH issues.


Got feedback?

We would love to hear any feedback you have. Drop us a line at HCWCheckFeedback@microsoft.com

Kudos goes to the following folks that made this possible:

Saidivya Velagapudi, Caius Preda, Scott Roberts, Nikhil Chinchwade, Karl Buhariwala, Timothy Heeney, Jeremy Kelly, Wei Wu, Cathy Westman, Gabriel Popescu, and numerous others

The Exchange Hybrid Team


Comments (1)
  1. David says:

    Cool! Is Exchange 2010 Hybrid supported?

  2. Glen Martin says:

    This is a wonderful tool, and came out just as I was needing to troubleshoot issues with HCW. Already, it has given me a laundry list of things I need to check. There are a few gaps, though:
    1) Although the tool seems to run Test-FederationTrust under the hood, it does not catch the need to refresh Federation Trust metadata, although running the command directly does.
    2) The tool is telling me that it couldn’t reach some of the O365 endpoints. It gives the names of those endpoints, but does not specify the IP addresses that it is failing to reach, nor the protocol. As far as I can tell, the specified endpoints ARE reachable
    from by hybrid server.

Comments are closed.

Skip to main content