This gives an overview of how to kick-off the Work Cache update which processes the Work Cache update queue, and how to perfom a full refresh of the caches, namely Work Cache, Project Cache and Project Status Report Cache for the entire site collection.
Reasons for performing a Refresh of a Cache:
The Work Cache has two timer jobs that maintain it and ensure that the content is as current as possible. The Project Cache and Project Status Report Cache have one timer job each to refresh their content. Updates are carried out in real-time.
If these have run recently, running them manually might not be needed so details on their frequency and last run time are displayed on the page.
To manually run any of these actions:
Note: You need to be a Site Collection Administrator or a member of the BrightWork Cache Administrator's user group to perform this task.
Update pushes any recent changes to the cache while refresh does a full rebuild of the cache.
Tip! Update is much faster than refresh and should be used to update the Work Cache unless one of the reasons listed above necessitates a full Refresh.
To run an Update of the Cache click the link to Apply the queued updates for this site collection to the work cache and then click OK to confirm.
You can also run the Refresh Project, Project Status Report, or Work Cache for the site at the site level. This will ensure that all changes in that site and below are accounted for.
Last updated refers to when the Work Cache was last updated by the update timer job.
Tip! The quickest way to Refresh Project Data including the Work Cache is using the Project Ribbon.
Refreshing all the contents of the entire Work Cache may take some time depending on the size of the Work Cache and site collection.
To start the Refresh of the Cache click the link to Perform a full work cache refresh for this site collection and then click OK to confirm.
Refreshing all the contents of the entire Project Cache may take some time depending on the size of the Project Cache and site collection.
To start the Refresh of the Cache click the link to Perform a full project cache refresh for this site collection and then click OK to confirm.
Refreshing all the contents of the entire Project Status Report Cache may take some time depending on the size of the site collection.
To start the Refresh of the Project Status Report Cache click the link to Perform a full project status report cache refresh for this site collection and then click OK to confirm.
The Project Cache, Project Status Report Cache, and Work Cache are all maintained by timer jobs.
If a large number of items are getting added to the Work Cache the page might time out. The page will time out after 2 hours, if this happens you should re-run the Refresh or use the timer job.
Project Status Report Cache
Data Not Added To a Cache
If a project site's data is not added to a cache, check if it or any of the sites above it in the site hierarchy are marked as either Archived or Completed. For example, this circumstance could occur if a Project Office is marked as Completed when it still has project sites under it that are not Completed.
Page Time Out
If the page times out, contact your SharePoint administrator as they can run the refresh using the timer job on the server (though this will run on all BrightWork Site collections not just your one). Alternatively your SharePoint administrator can use PowerShell to run refreshes of the Work, Project, or Project Status Report caches targeting specific site collections using the commands below:
Refresh-BWProjectCache [-Identity] <SPSitePipeBind>
Refresh-BWWorkCache [-Identity] <SPSitePipeBind>
Refresh-BWPSRCache [-Identity] <SPSitePipeBind>
For example these commands will refresh the specified caches:
These commands will refresh the specified caches and also write the details to the SharePoint logs:
Refresh-BWProjectCache https://myserver/sites/my-bw-sitecollection -verbose
Refresh-BWWorkCache https://myserver/sites/my-bw-sitecollection -verbose
Refresh-BWPSRCache https://myserver/sites/my-bw-sitecollection -verbose