Drupal websites have three levels of caching to improve performance (the time it takes to download and render a page).
- The user’s web browser will cache pages, based on the user’s settings.
- The Drupal application will cache pages for a set amount of time, usually 6-12 hours. Note: Do not change this setting. Changing this setting will negatively impact the site's performance.
- Varnish, a caching system in between Drupal and the network, will cache pages for some set amount of time.
Varnish and Acquia Purge
Acquia Cloud uses a module called Acquia Purge to watch for certain changes, like when a node is changed and published, and adds those nodes to a queue for clearing from Varnish. The purging process runs hourly. However, cache rules can be somewhat complex, and other settings may prevent a specific item from being purged from Varnish when expected.
Sometimes, when you edit and publish content, then go look at the page, you won’t immediately see the change you made. This is usually because the content is cached. Don't panic, caching is a good thing for your site's performance.
Please note, urgent issues are defined as those that convey critical information to the campus community such as emergency notifications or significant system or building outages. Due to the workload demands, we ask that non-urgent issues observe the 6-12 hour cache purging processes.
However, if you can't wait for the change to take effect for all site visitors, here are some things to try.
First, try this:
- Clear your browser cache and reload.
- Try a different browser (Chrome, Firefox, Safari, Edge, etc.).
- Clear the Drupal cache, then clear your browser cache and reload.
If that does not resolve the problem, determine which protocol is not getting the current content.
- Non-SSL - Visit the page using http
- Anonymous SSL - Visit the page using https, but not logged into Drupal
- Authenticated SSL - Visit the page using https, while logged into Drupal
If the problem is only on Non-SSL, and the issue is urgent:
- Login to the Drupal site.
- Navigate to Manage > Configuration > Performance > Manual Purge.
- In the Paths to be purged field, enter the path of the page you want to purge. If it is the front page of the site, use <front> for the path.
- Click Refresh.
- Wait up to 1 hour for the process to run.
If the problem is only on Anonymous SSL, and the issue is urgent:
- Currently, Content Leads can not clear the Varnish cache for Anonymous SSL. Wait for the hourly process to run, then clear your browser cache and reload the page.
- If the current version of the page is still not displayed, report the incident to the Web Office.
How to report a Website Caching Issue to the Web Office
- Click the Get IT Help button at the bottom of the navigation section of the IT website, or go to https://help.sonoma.edu/support/login and click Report an issue.
- In the ticket, include:
- "Drupal Website Cache Issue" as the subject
- the URL of the page with the issue
- a portion or example of the content on the page that is changed but not displayed (so we can verify where the problem is and when it is fixed)
- the reason why the page must be cleared on an urgent basis, instead of waiting for Drupal and Varnish to clear automatically.
Allow 4 hours for a response to urgent issues during normal business hours. For all other issues, allow 24-48 hours for a response.