Integrated Troubleshooter

Why use Troubleshooter:

The smooth functioning of BizTalk360 requires certain prerequisite permissions for the BizTalk360 service account. The list of permissions are mentioned in this document. At times, we might have missed assigning a couple of permissions that prevent us from using certain features of BizTalk360 as indicated below:

• 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 as shown in the image below.

• 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 account (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), please check the gMSA account box and leave the password empty.

Based on the environment setup, you may have a different service account configured for the IIS, Monitoring and Analytics service or shall have the same service account. As per the configuration, you can choose any one of the options mentioned below.

• Use Single Account

• Use Different Account

BizTalk360 Health:

Once you click on Troubleshoot BizTalk360 button, this section would display the required IIS features and BizTalk/SQL/IIS related permissions and their status. The dependent port/services/protocols that need to be enabled on both BizTalk and SQL Servers are also shown here.

• 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, it needs to be open for communication amongst the servers),

• MSDTC - Microsoft Distributed Transaction Coordinator (Windows Service),

• WMI - Windows Management Instrumentation (Windows Service),

To know the prerequisites of BizTalk360 server, please refer to the following URL: https://docs.biztalk360.com/docs/server-requirements

Environments:

This section lists all the added environments in the server and you can click on each environment to view the assigned permissions for that specific environment.

If you choose an environment here, you can find its Environment details, BizTalk NT groups, AD permission and SQL permission.

Incase if the service account is not added in any required BizTalk NT groups or if the necessary SQL permission is missing, those details can be checked here, as given in the below example:

If the SQL permissions are missing, it would be indicated as shown in the below image. You may click on the Script hyperlink to get the required SQL query and execute it against the BizTalkMgmtDb.

BizTalk360 Config:

This section consists of the following sub-divisions:

Dependencies:

In this section, the general group shows the current Windows version and the installed .NET versions of the BizTalk360 server. The Local BizTalk Server Configuration group has the details of BizTalk Server Version, BizTalk Server Version Number and the BizTalk Server Edition installed in the BizTalk360 server.

Web:

The web section displays the BizTalk360 website configurations and Application pool configurations. The BizTalk360 website configurations include the server information and IIS information whereas the BizTalk360 app details are shown in the Application pool configuration as shown in the image below:

Monitoring:

In this section, you can find the details of monitoring service such as the service account that runs the monitoring service, the installation folder, NT service status, version and the BizTalk360 database connection string information:

Analytics:

Just like the monitoring service, you can find the details of the Analytics service here:

Database:

Here, you can view the current BizTalk360 DB name, DB version, Instance name and the Security mode. The list of tables are listed in the grid with their storage usage details:

About Troubleshooter:

If the permissions are verified and still you face any challenges with BizTalk360, you can click on “About Troubleshooter” section to find the links for our support portal and documentation site. You may refer to the documentation site or contact support for additional help.

Download Troubleshooter Report:

The troubleshooter reports for the environments can be downloaded in PDF format or sent to an email address using the PDF button at the top right side. The PDF button is visible under the BizTalk360 health, environments and across the BizTalk360 config section.

Sample Report: