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.

Next steps