This article will detail potential causes for Service Fabric install errors. This article is broken up into two sections:
- Troubleshooting Techniques
- Errors During Install
- Errors Post Install
Since Service Fabric issues can be quite complex, if this article does not resolve your issue, please submit a support ticket.
Before going into detail about troubleshooting Service Fabric install issues, it is important to understand the install process and some terminology. The Service Fabric application you are installing is a combination of two installers
- Part 1 of the install process is to install Microsoft's standard Service Fabric installer, referred to as "the cluster".
- Part 2 of the install process is to install Solver, Inc's applications that sit on top (installed) of the cluster.
In this article, the acronym SF is used to refer to Service Fabric.
The following are useful in troubleshooting SF. These are accessible only from the Service Fabric server
|Service Fabric Explorer||View the state of your SF install||http://localhost:19080|
|Connection Info||View the connection info provided during install of SF||http://localhost:19081/SolverFabricConnection/DatabaseConnectionService/connectionStrings/jobsscheduler|
How to verify if there is more than one SF server
Check the registry key in the following registry location that the key is pointing to the correct Repository database. You should only see one of the following keys depending on the bitness of the machine.
Then verify the IP/server name referenced in the below keys in dbo.MasterSettings in the Repository db are referencing the correct Service Fabric server.
Error During Install
The following are common errors during install
|Installer fails during the install of the Cluster and rolls back||
This can happen for multiple reasons
|Installer successfully installs the Cluster but fails to install the applications||
In this case, if you are following the progress window, you will see that the cluster has successfully been installed, but it fails during the install of the application.
The causes here are similar to the above, but are typically more related to computer performance than anything else.
|Installer fails with an error referencing AdaptiveServer and rolls back||
There are typically two causes for this error
|Databases moved to new SQL server||
This causes SF connection to fail and jobs and events would error out.
|Need to re-install PrepareSF and installation again for SF pointing to new SQL server.|
Errors Post Install
|Jobs, Rules and/or Integrations page Page does not load||There is something wrong with the service fabric install, either it is not running or an application is not working||
|Connector Marketplace does not load||The marketplace is internet resource that is being blocked by the organizations firewall||