Getting started with BizTalk Health Monitor (BHM)


BizTalk 2013 R2 ships with a new tool called “BizTalk Health Monitor”. BHM is also available as a standalone download for BizTalk Server 2013 and 2010.

In this post we will learn:

1-     Where to find BizTalk Health Monitor

2-     How to register BizTalk Health Monitor SnapIn

3-     How to integrate BHM SnapIn to BizTalk Admin Console

 

Where to find BizTalk Health Monitor

On BizTalk 2013 R2, BHM can be found at the following location: 

<installationdrive>\Program Files (x86)\Microsoft BizTalk Server 2013 R2\SDK\Utilities\Support Tools\BizTalkHealthMonitor

Another option is to download the standalone version from http://www.microsoft.com/en-us/download/details.aspx?id=43716 and unzip it onto the machine

(Updated on 7/7/2015 : With BHM v3.1 you no longer need to do rest of the manual steps mentioned in this article to get started with BHM. The recommended way to setup BHM is via BHMSetup.exe. Read this article for complete details. However, if you are on BizTalk 2010 you need to follow the manual steps shown here to integrate BizTalk Admin Console and BHM)

How to register BizTalk Health Monitor SnapIn

We can use InstallUtil.exe which comes with BizTalk Health Monitor tool to register the BHM snap in. Follow these steps to register the snap-in:

1-     Open a command prompt as an administrator

2-     Navigate to the location of BHM

3-     Type InstallUtil.exe MBVSnapIn.dll and hit enter. This step will do some registry changes and register the SnapIn to be used

 

How to integrate BHM SnapIn to BizTalk Admin Console

(Updated on 3/10/2015 : Few issues have been reported with the method shown to Integrate BizTalk Admin Console and BHM in to same MMC. So we are updating this column with the new steps as mentioned by Sandro in his blog to address those issues.)

By now we have already registered the BHM SnapIn and now we will integrate this to be used with BizTalk Administration Console.

Before we proceed please note that BHM SnapIn can be used independently and need not to be integrated with BizTalk Administration Console. We are showing this step more from convenience point of view.

1-     From Run, type mmc /32 and press enter. This will open a new MMC window.

2-     From MMC console, go to File menu and select “Options…” option

    • In the text box, replace “Console1” for “BizTalk Administration Console”

    • In the Console mode combo box, select “User mode – full access”

    • And confirm that the option “Do not save changes to this console” is uncheck

3-     Go to File–>Add/Remove Snap-in

4-     From the Add or Remove Snap-ins Window add following snap-ins and then click Ok

a. Microsoft BizTalk Server Administration

b. BizTalk Health Monitor  

c. Event Viewer


5-     By now your new MMC is ready which shows BizTalk Server Administration, BizTalk Health Monitor and Event viewer

Console View

6-     Now you might want to save this as a new .msc file so that you don’t have to repeat these steps again. For that, go to File–>Save As option, give a name and then save it. However, it is recommended that you save it with the name “BTSmmc.msc” otherwise you can run in to the issue as mentioned in  the Known Issues with BizTalk Health Monitor page. To save the console as BTSmmc.msc do the following:

    • Firstly navigate to BizTalk installation folder e.g. C:\Program Files(x86)\Microsoft BizTalk Server 2013R2

    • Rename BTSmmc.msc, e.g. BTSmmc-old.msc

    • Now save your new (BizTalk Admin Console + BHM) mmc with the name BTSmmc.msc under the BizTalk installation folder e.g. C:\Program Files(x86)\Microsoft BizTalk Server 2013R2\BTSmmc.msc

7-     From next time onwards, you can use this new .msc file to open you BizTalk Admin Console which will be incorporated with the BizTalk Health Monitor. OR if you have saved it with BTSmmc.msc, you can directly open the BizTalk Administration Console which will be incorporated with the BizTalk Health Monitor (recommended)

Comments (12)

  1. Steef-Jan Wiggers says:

    In How to register BizTalk Health Monitor SnapIn you need to navigate to <Installation drive>Program FilesMicrosoft BizTalk Server 2013 R2SDKUtilitiesSupport ToolsBizTalkHealthMonitor folder and then Type InstallUtil.exe MBVSnapIn.dll and hit enter.

  2. For 64Bit use the following path.

    <Installation drive>Program Files (x86)Microsoft BizTalk Server 2013 R2SDKUtilitiesSupport ToolsBizTalkHealthMonitor.

  3. Christ says:

    Can we install it on a remote server other then Biztalk it self

  4. JPAUC says:

    yes: BHM is sharing the same engine than MBV tool so BHM can be used like MBV on a different server than a BizTalk server but you will have to enter in the group node settings the location of the BizTalk Mgmt database (db name and server name) of the group to monitor.

    JP

  5. Jacob Jones says:

    I have installed BHM plugin for monitoring BizTalk 2010 health & performance, but facing issue with schedule analyze part.

    When we try to schedule the tool for analysis, i.e we check the checkbox 'Schedule Analyze' with the required settings, while entering the credentials , we get the following error "Launching schtasks /Create /RU <domainuserid> /RP <passowrd> /TN " BizTalk Health Monitor{ BizTalk Group} "/F/XML " CusersuseridAppDataLocalTemptmp8DF4.tmp"

    Check the status bar for pending activity

    ERROR: A specified logon session does not  exist. It may already have been terminated.

    Please let me know if there is prerequisite setting needed from network end to go through the schedule activity process.

    -Jacob

  6. JP says:

    Jacob,

    Maybe the policy  "Do not allow storage of passwords and credentials for network authentication" is disabled preventing to create a task under a specific user account.

    If it is GPO, maybe you cannot change it.

    For local policy, in "Local Security Policies' mmc, expand 'Local Policies'"and select 'Security Options' and then disable that property (The system must reboot for the change to take effect)"

    JP

  7. Praveen says:

    i am trying to install BHM on biztalk 2010 . facing an error . can some one help me out .

    it says " MMC has detected an error and the snapin will unload" can some one help me please.

  8. JP says:

    Hi Praveen,

    1) Is the first install of BHM on this box ?

    2) Do you use well the v3 ? (avail on Microsoft DLC)

    2) Did you well register the snapin (cmd : "installutil mbvsnapin.dll")

    3)  Did you try to start BHM like after a first install (I mean w/o existing profiles created) :

        You can backup and then delete your content of "C:ProgramDataMicrosoftBizTalkHealthMonitor"and then restart the MMC. If it works then there is maybe a problem loading  profiles.

    Keep me informed

    Thanks

    JP

  9. praveen13788 says:

    Hi JP,

    Thanks for your reply.

    I have downloaded the latest version V3 and the first install is on this box. I have never tried V2 or the earlier ones. and i registered the snapin in command prompt and it was successful. I took teh backup as you said and tried again. But its the same error.

    PLease suggest some solution or let me know if you can take a look at it if possible

    Thanks.

  10. JP says:

    Hi Praveen

    ping me directly (jpierauc@microsoft.com) and I will investigate that issue with you

    JP

  11. romeelian says:

    How do I get the BHM in the 2013R2 default version up-to-date? Do I've to download the stand alone copy to overwrite it?

    Please advise. Thank you.

  12. JP says:

    Hello,

    you can copy the latest version (v3) in the same location than the default one (v1) one but the most important step is to re-register the snapin:

    "Installutil mbvsnapin.dll"

    see the good post of Sandro detailing this upgrade :

    sandroaspbiztalkblog.wordpress.com/…/how-to-upgrade-biztalk-health-monitor-from-a-previous-version-to-the-latest-one

    JP