Share via


The number of Distributed Cache hosts in the farm exceeds the recommended value (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: The number of Distributed Cache hosts in the farm exceeds the recommended value.

Summary: On a farm with four or more servers, you must not start the Distributed Cache service on all servers on the farm. You can only run Distributed cache on SharePoint Server 2016 servers that are configured as Distributed cache role in MInRole. If you configure all servers as cache hosts, you may experience reliability and performance problems in the farm. For more information, see Overview of MinRole Server Roles in SharePoint Server 2016.

Cause: The Distributed Cache service is started on every server on this farm.

Resolution: Reduce the number of cache hosts 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 Microsoft 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. Remove one or more servers from the cache cluster. On each server that you want to remove from the cache cluster, run the following cmdlet:

    Remove-SPDistributedCacheServiceInstance

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

See also

Concepts

Manage the Distributed Cache service in SharePoint Server

Plan for feeds and the Distributed Cache service in SharePoint Server

Other Resources

Add-SPDistributedCacheServiceInstance

Planning and using the Distributed Cache service