Integrated Troubleshooter
  • 08 Jul 2024
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Integrated Troubleshooter

  • Dark
    Light
  • PDF

Article summary

Integrated Troubleshooter is a part of the application. You can verify the missed permission of database, ports and windows active directory using the Integrated troubleshooter by launching the Application.

Let's say once after the installation, due to lack of permissions if a feature is not usable, then the integrated troubleshooter will help us to find the permissions that are missing.

image.png

You can access the Troubleshooter as shown in the image below or use the below path for navigation
http://localhost/biztalk360/troubleshooter/configuration
image.png

  • Launch the BizTalk360 application.
  • Click on the User Profile icon at the Top right corner of the application.
  • Select the Troubleshooter from the listed menu or you can use the following link to navigate to the Troubleshooter page (http://localhost/BizTalk360/troubleshooter/configuration).
  • The Account Name dropdown will display a list of all users including GMSA Accounts within the domain.
  • Provide the password of the Service account. If you are using gMSA (Group Managed Service Accounts, a specific kind of Active Directory account that offers a single identity solution for applications that are hosted on multiple hosts) Account please check the gMSA acount and leave the password empty.

image.png

Based on the environment setup user may have a different password configured for the IIS, Monitoring and Analytics service or shall have the same password. As per the configuration, we can prefer to choose.

  • Use Single Account
  • Use Different Account

BizTalk360 Health: User can check for the IIS configuration under the BizTalk Health once after clicking on the Troubleshoot BizTalk360 button.

Also the BizTalk/SQL Permission status will display. The permissions are nothing but the dependent port/services/protocols that need to be enabled on both BizTalk and SQL Servers for the smooth communications like,

  • RPC - Remote Procedure call (Windows Service),
  • TCP - Transmission Control Protocol (Port 135),
  • SQL SERVER - SQL Server Service (Port 1433, if you are using any custom port needs to be enabled),
  • MSDTC - Microsoft Distributed Transaction Coordinator (Windows Service),
  • WMI - Windows Management Instrumentation (Windows Service),
  • Local Admin permissions - Local Administrators group (Computer Management).

image.png

Environments: Available environments will be getting listed with its details under this menu, so that user shall check for the respective environment details. You can able to view the below details,

  • Environment Details
  • BizTalk NT Groups
  • AD Permission Check
  • SQL Permission Check

image.png

If a SQL permissions were missing Click on the Script a popup will be opened, you can copy the script and execute against the BizTalkMgmtDb.

BizTalk360 Config: The Below BizTalk360 Configuration details can be viewed under this section,

  • Dependencies
  • Web
  • Monitoring
  • Analytics
  • Database

Report Generation in Troubleshooter

On troubleshooting BizTalk360 will validate the configuration, advanced setting and its permission against the user and password provided. When the Troubleshooter validate user can be able to access the PDF option which will be in the top right corner which hold two options

  • View Report
  • Email Report

If the user holds multiple environments, you can select all the environments and get the environment details in the PDF report or if not required you can choose the respective environment which you opt for. With the help of a report PDF, you can view the full details in a single stretch.
View Report: Using this you can view the report if needed we can download the report as well.

  • Email Report: Using the email option, you can share the report PDF to any mail, and you can also send a report to multiple mail ids.

To view the PDF report, need to configure the Manage dependencies (Settings -> General -> Manage Dependencies), and to send the mail it is mandatory we had to configure the SMTP configuration (Settings -> Notifications -> SMTP)

image.png

Note
  • To collect the information of IIS the user must be added under IIS_IUSRS group.
  • To collect the information of BizTalk the user must be added under Administrators group (or) DCOM.
  • To collect the information and permissions of SSODB the user must be added under SSO Administrators group.

Was this article helpful?