Share via


Cached objects have been evicted (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: Cached objects have been evicted

Summary: When the memory consumption of the cache service on a cache host exceeds the low watermark threshold, objects that have already expired are evicted. When memory consumption exceeds the high watermark threshold, objects are evicted from memory, whether they have expired or not, until memory consumption returns to the low watermark. Subsequently cached objects may be rerouted to other hosts to maintain an optimal distribution of memory.

Cause: There is not sufficient memory in the cache cluster.

Resolution: Add more RAM to the server

  • You can add more RAM to the server to increase the memory. To identify the failing server: in the SharePoint Central Administration website, in the Monitoring section, click Review problems and solutions, and then find the name of the server in the Failing Servers list. If there are multiple failing servers in a server farm, you must repeat this resolution on each failing server.

Resolution: Increase the memory allocation of the distributed cache

  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. Check the current distributed cache settings from usage. To do this, run the following command:

    Get-SPDistributedCacheClientSetting

    For more information, see Get-SPDistributedCacheClientSetting

  3. Stop the Distributed Cache service on all cache hosts in the farm. To do this, run the following command on each cache host:

    Stop-SPDistributedCacheServiceInstance -Graceful

    For more information, see "Perform a graceful shutdown of the Distributed Cache service" in Manage the Distributed Cache service in SharePoint Server.

  4. To increase the cache size of the Distributed Cache service, run the following command one time only on any cache host at the PowerShell command prompt:

    Update-SPDistributedCacheSize -CacheSizeInMB CacheSize

    Where:

  • CacheSize is the cache size's memory allocation assignment in megabytes (MB). The default value is 5 percent of total system RAM. This value should not be more than 40 percent of total system RAM with a maximum limit of 16 gigabytes (GB).
  1. Start the Distributed Cache service on all cache hosts. To start the Distributed Cache service, go to the Services on Server page in Central Administration, and start the Distributed Cache service on all cache hosts in the farm.

See also

Concepts

Manage the Distributed Cache service in SharePoint Server

Plan for feeds and the Distributed Cache service in SharePoint Server

Other Resources

Update-SPDistributedCacheSize

Planning and using the Distributed Cache service