Integrated Troubleshooter
  • Updated on 24 Sep 2019
  • 5 minutes to read
  • Contributors
  • Print
  • Share
  • Dark
    Light

Integrated Troubleshooter

  • Print
  • Share
  • Dark
    Light

This section discusses the Integrated Troubleshooter. The section consists of the following parts:

  • What is the Integrated Troubleshooter
  • In-depth look at the Integrated Troubleshooter

What is the Integrated Troubleshooter

BizTalk360 Troubleshooter is not a new tool/concept that we have introduced in BizTalk360. We already have the BizTalk360 Troubleshooter being used by our customers for the smooth and seamless installation of BizTalk360 on their BizTalk server environments. BizTalk360 Troubleshooter contains an extensive set of rules to verify the prerequisite conditions in order to successfully run BizTalk360. The initial version of BizTalk360 troubleshooter had all the details in a single pane/view. We improved the troubleshooter tool to have a better user interface with a bunch of new sections to view the configuration problems and issues in the environment. For detailed information about BizTalk360 Troubleshooter, we recommend you to read this blog article.

Why the Integrated BizTalk360 Troubleshooter

In the previous versions of BizTalk360 troubleshooter, when the customers faced any issues while installing BizTalk360, we recommended them to run the troubleshooter tool to identify the problematic areas in their environment. Customers had to download the troubleshooter tool (as a separate tool) and view the issues in their BizTalk environment. In order to avoid this technical challenge and to create a seamless experience for our customers, we decided to implement the troubleshooter tool as a web-based offering of BizTalk360 application.

You need to keep in mind that BizTalk360 Troubleshooter will not transmit any information without your consent. The tool is designed to run a defined set of rules that will validate your BizTalk server configuration in order to identify any configuration issues or permission issues.

How to access the Integrated BizTalk360 Troubleshooter

You can access the integrated BizTalk360 Troubleshooter by clicking the profile menu in the upper right corner of the page and click Troubleshooter. For detailed information about the options in the troubleshooter page, please read the next section.

-BizTalk360-Troubleshooter-How-To-Access-v2.png

In-depth look at the Integrated Troubleshooter

In this article, we will take a detailed look at the integrated BizTalk360 troubleshooter welcome screen. You can access the troubleshooter by clicking the small spanner icon at the top of the BizTalk360 user interface. On the troubleshooter welcome screen, you will see the icons for Components and Troubleshoot sections.

You need to keep in mind that BizTalk360 Troubleshooter will not transmit any information without any consent. The tool is designed to run a defined set of rules that will validate your BizTalk server configuration in order to identify any configuration issues or permission issues.

BizTalk360-Troubleshooter-Welcome-Screen.png

Overview of Components section
The Components section of BizTalk360 troubleshooter will provide read-only information about the configuration of components used by BizTalk360. This section will display the information about 5 Key components used by BizTalk360:

  1. Dependencies
  2. Web
  3. Monitoring
  4. Analytics
  5. Database

BizTalk360-Troubleshooter-Components-Screen.png

1.** Dependencies** - The Dependencies section will display the general information about the version of Windows, installed .NET versions, and the local BizTalk server configuration information (such as BizTalk server version, version number, and the edition of BizTalk server)

BizTalk360-Troubleshooter-Dependencies-Screen.png

  1. Web - The Web section will display information about the IIS configuration, Application pool configuration, and the site details such as site name, version, installation folder, admin service URL,

BizTalk360-Troubleshooter-Web-Screen.png

  1. Monitoring - The Monitoring section will display information about the BizTalk360 monitoring service and the service account under which the service actually runs

-BizTalk360-Troubleshooter-Monitoring-Screen.png

  1. Analytics - The Analytics section will display information about the BizTalk360 analytics service and the service account under which the service actually runs

BizTalk360-Troubleshooter-Analytics-Screen.png.

  1. Database- The Database section will display the information about the BizTalk360 database and the disk usage statistics of the BizTalk360 tables

BizTalk360-Troubleshooter-Database-Screen.png

Overview of Troubleshoot section

The Troubleshoot section of BizTalk360 troubleshooter will provide the option to run the vast set of rules against your BizTalk server configuration. The tool will perform different checks such as IIS configuration, permissions on the IIS account, monitor account, analytics account, and SQL SELECT. In order to allow the tool to perform the checks, you need to provide the password for the IIS account, monitoring account, and analytics account. Once the passwords are entered, the rules will be executed and you will see the status against each condition. If the rules are executed successfully, you will see the status as Configured against the rule. If any rule has an error associated, you will see the status as Not Configured. The below screenshot shows the detailed troubleshoot section and the different options available in the page.

-BizTalk360-Troubleshooter-Troubleshoot-Screen.png

**Use one password for all accounts **- You can toggle the icon if the IIS account, Monitoring account, and Analytics account have the same password. By toggling the icon, you will notice that all the three sections (IIS, Monitoring, and Analytics) will be combined into a single section (Service Account) and you will have only one text box to enter the password. If you have different passwords, you need to enter the password separately for IIS, Monitoring, and Analytics accounts.
IIS Account - Enter the password for the IIS account that is associated with the configuration. The account name information will be pre-populated with the IIS account username.
Monitoring Account - Enter the password for the monitoring account that is associated with the configuration. The account name information will be pre-populated with the monitoring account username.
Analytics Account - Enter the password for the analytics account that is associated with the configuration. The account name information will be pre-populated with the analytics account username.
Verify - Click the Verify button to start the troubleshooter operation. Until you click the Verify button, all the rules in the next sections will have the status as Unknown against them.
IIS Check - Contains the different rules to be checked specific to IIS such as whether ASP.NET is installed, if Windows authentication is enabled, and so on. Clicking the Verify button (as explained in the previous step) will run the troubleshooter tool and you will notice the status against each rule (such as Configured, Not Configured, Unknown).
Hotfix - If you are using Windows Server 2008, you may encounter an error as described in this article. To overcome this, you need to install a hotfix. If you have done this already, you will see the result of this configuration as Configured. If you are using any other versions of Windows server, the result of this step will display as Unknown.
Choose an environment - You can choose an environment from the drop down to view the status of configuration. When you run the troubleshooter, it will by default run the tool on all configured environments.
Permissions Check - This section contains all the rules that are related to checking the permissions for all the accounts (IIS, monitoring, analytics)
SQL select permission check - This section contains all the rules that are related to checking the SQL select permissions on the database

Was this article helpful?