Jaa


This Distributed Cache host may cause cache reliability problems (SharePoint Server)

APPLIES TO: yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

Rule Name: This Distributed Cache host may cause cache reliability problems.

Summary: The Distributed Cache service on this cache host has been stopped but has not been unregistered from the farm. To avoid reliability issues, we recommend that you either start the Distributed Cache service on the server, or remove the cache host from the cache cluster.

Cause: The Distributed Cache service on this Distributed Cache host has been stopped but not unregistered from the farm.

Resolution: Start the Distributed Cache service on the server by using Microsoft PowerShell.

  1. Verify that you have the following memberships:
  • securityadmin fixed server role on the SQL Server instance.

  • db_owner fixed database role on all databases that are to be updated.

  • Administrators group on the server on which you are running the PowerShell cmdlets.

  • Farm Administrators group.

    An administrator can use the Add-SPShellAdmin cmdlet to grant permissions to use SharePoint Server cmdlets.

    Note

    If you do not have permissions, contact your Setup administrator or SQL Server administrator to request permissions. For additional information about PowerShell permissions, see Add-SPShellAdmin.

  1. Start the SharePoint Management Shell.

  2. On the server on which you want to start the Distributed Cache service, type the following command at the PowerShell command prompt:

Add-SPDistributedCacheServiceInstance
  1. In the SharePoint Central Administration website, click Application Management. In the Service Applications section, click Manage services on server.

  2. On the Services on Server page, verify that the Distributed Cache service is listed and the status is Started.

Resolution: Remove the cache host from the cache cluster by using Windows PowerShell.

  1. Verify that you have the following memberships:
  • securityadmin fixed server role on the SQL Server instance.

  • db_owner fixed database role on all databases that are to be updated.

  • Administrators group on the server on which you are running the PowerShell cmdlets.

  • Farm Administrators group.

    An administrator can use the Add-SPShellAdmin cmdlet to grant permissions to use SharePoint Server cmdlets.

    Note

    If you do not have permissions, contact your Setup administrator or SQL Server administrator to request permissions. For additional information about PowerShell permissions, see Add-SPShellAdmin.

  1. Start the SharePoint Management Shell.

  2. Type the following command at the PowerShell command prompt:

Remove-SPDistributedCacheServiceInstance

Note

This command stops the cache service and nonpersisted cached data will be lost. If you want to keep the cached data, use the graceful shutdown procedure that is described in Manage the Distributed Cache service in SharePoint Server, and then run the Remove-SPDistributedCacheServiceInstance cmdlet. The Remove-SPDistributedCacheServiceInstance cmdlet involves stopping and disabling the underlying AppFabric Caching service. Do not restart the AppFabric Caching service other than by running the Add-SPDistributedCacheServiceInstance cmdlet.

For more information, see Remove-SPDistributedCacheServiceInstance.

  1. Verify that the server is removed from the cache cluster. To do this, in Central Administration, click Manage services on server, and then, on the Services on Server page, make sure that the Distributed Cache service is not listed.

See also

Concepts

Plan for feeds and the Distributed Cache service in SharePoint Server

Other Resources

Planning and using the Distributed Cache service