Troubleshoot your local development cluster setup
If you run into an issue while interacting with your local Azure Service Fabric development cluster, review the following suggestions for potential solutions.
Cluster setup failures
Cannot clean up Service Fabric logs
Problem
While running the DevClusterSetup script, you see the following error:
Cannot clean up C:\SfDevCluster\Log fully as references are likely being held to items in it. Please remove those and run this script again.
At line:1 char:1 + .\DevClusterSetup.ps1
+ ~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : NotSpecified: (:) [Write-Error], WriteErrorException
+ FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException,DevClusterSetup.ps1
Solution
Close the current PowerShell window and open a new PowerShell window as an administrator. You can now successfully run the script.
Cluster connection failures
Type Initialization exception
Problem
When you are connecting to the cluster in PowerShell, you see the error TypeInitializationException for System.Fabric.Common.AppTrace.
Solution
Your path variable was not correctly set during installation. Sign out of Windows and sign back in. This refreshes your path.
Cluster connection fails with "Object is closed"
Problem
A call to Connect-ServiceFabricCluster fails with an error like this:
Connect-ServiceFabricCluster : The object is closed.
At line:1 char:1
+ Connect-ServiceFabricCluster
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : InvalidOperation: (:) [Connect-ServiceFabricCluster], FabricObjectClosedException
+ FullyQualifiedErrorId : CreateClusterConnectionErrorId,Microsoft.ServiceFabric.Powershell.ConnectCluster
Solution
Close the current PowerShell window and open a new PowerShell window as an administrator.
Fabric Connection Denied exception
Problem
When debugging from Visual Studio, you get a FabricConnectionDeniedException error.
Solution
This error usually occurs when you try to start a service host process manually.
Ensure that you do not have any service projects set as startup projects in your solution. Only Service Fabric application projects should be set as startup projects.
Tip
If, following setup, your local cluster begins to behave abnormally, you can reset it using the local cluster manager system tray application. This removes the existing cluster and set up a new one. Note that all deployed applications and associated data is removed.