Troubleshooting Installation Issues

Write IIS7 ConfigChanges

If the installation/upgrade of BizTalk360 fails, you might find the below exception in the installation log file.

If the above exception exists in the installation log, follow the below mentioned instructions in order to overcome the challenge.

Solution:

1. Open IIS server manager from BizTalk360 server, go to Bindings section of BizTalk360 site.

2. If the bindings have domain name as host name either for HTTP or for HTTPS, Replace the host name for both HTTP and HTTPS bindings with *

3. Once it is done, Reset IIS and then proceed with the installation/upgrade.

Default to HTTP Binding while upgrading

After performing the above suggestion still the Installation does not work means, remove the HTTPS binding and have the HTTP binding alone configured for Default Web site and BizTalk360 site, then reset the IIS and proceed with upgrading BizTalk360.

Once the upgrade is successful, you can configure HTTPS binding back in IIS.

Supplied username/password is invalid

If you are installing BizTalk360 as a fresh installation in your server, you might get stuck in validating your password as shown below:

Solution:

1. The first step you need to do is to ensure that you have logged into the BizTalk360 server with the BizTalk360 service account. If not, please do log in with the BizTalk360 service account and then proceed with installation.

2. If the first step did not work, follow the silent installation document

Login failed for user “Domain\UserName“

During the upgrade, when the BizTalk360 service account is restricted with log on access, an admin account is used to log into the server to perform the upgrade. In this scenario, the upgrade may fail at times and resulting in the following error in the installation log file:

MSI (c) (C0!58) [15:43:52:743]: PROPERTY CHANGE: Modifying B360_SERVICES_UPGRADE_INDICATION_MSG_LINE_1 property. Its current value is 'Empty'. Its new value: 'Error occured in HA Upgrade Installation Indication : System.Data.SqlClient.SqlException (0x80131904): Login failed for user “Domain\UserName“

The upgrade fails because the installer considers the logged in admin user account to log into BizTalk360 database, instead of BizTalk360 service account.

Solution:

To overcome this challenge and complete the upgrade, please follow the below instructions:

1. Log into your BizTalk360 server using your Admin account

2. Open Command Prompt as a normal user and run the below command:

runas /user:desktop-Domain\Username "powershell -Command Start-Process cmd -Verb runAs"

Note: Enter your Domain Name and BizTalk360 service account name in place of Domain\Username respectively.

3. It will prompt to enter the password for your BizTalk360 Service account. Please enter the same and it will open a new Administrator Command Prompt.

4. Then Navigate to the folder where v11.3 MSI is available and run it to perform upgrade.

Note:

This RunAs method is not applicable for GMSA accounts, as they do not support password authentication. For GMSA accounts, we recommend using a silent installation script as mentioned here: https://docs.biztalk360.com/v12/docs/silent-installation

Installer fails, Error: 'CREATE DATABASE failed':

If you are installing BizTalk360 and having SQL server with Mount Points, you will receive this exception at the Create database step.

This can occur, in spite of having all the permissions for the service account.

Solution:

The workaround is to create the BizTalk360 database prior to the installation and then run the installer which would ask to overwrite the database, and then continue the installation process with no errors.

The error you will get in SQL when logged in as the service account and call CREATE DATABASE [BizTalk360] is:

“CREATE DATABASE failed. Some file names listed could not be created. Check related errors. “

This is because you are using SQL with Mount Points and are required to pass in the FILENAME parameter when using Mount Point.

However, if we call it this way, the database is created and we do not get any errors:

CREATE DATABASE [BizTalk360]ON  PRIMARY ( NAME = N'BizTalk360', FILENAME = N'D:\Data01\BizTalk360\BizTalk360.mdf'  )LOG ON ( NAME = N'BizTalk360_log', FILENAME = N'D:\Log01\BizTalk360\BizTalk360_log.ldf' )

Failed to create SQL database; BizTalk360, error detail: unknown error

During the installation of BizTalk360, you may face the below error. This error usually appears in the Multiserver environment due to the TLS version mismatch.

Solution:

When you are installing the BizTalk360 in a multiserver environment, please check if the same version of the TLS has been enabled in all the machines. Example:

- The BizTalk Server 1 and BizTalk Server 2 are enabled with TLS Version 1.2

- On the SQL Server TLS Versions 1.1, 1.2 and 1.3 are enabled.

In the above case, the installation will fail, to overcome this case you have to disable the TLS versions 1.1 and 1.3 on the SQL Server, only Version 1.2 should be enabled. Either one version of the TLS should be enabled in all the servers or all should be disabled.

Once the same version of the TLS enabled in all the machines, try installing the BizTalk360, and you will succeed.

During upgrade BizTalk360 Monitor Service could not be deleted

While upgrading to the latest version and running on "deleting services* for a few minutes then displays the error "Service 'BizTalk360 Monitor' (BizTalk360.Monitor.exe) could not be deleted.

Solution:

This can be a cache issue or the services were running for a long time. You can select Ignore and proceed with the upgrade/installation.

Note: Before upgrading to the latest version, it's important to check the health of the BizTalk360 services. To check the health, just restart/kill and start the services.