Redis Plugin

NOTE: This plugin is compatible with FarCry 7.1.0 and over.

Redis is available under LGPL and compatible with the open source and commercial licenses of FarCry Core

Redis replaces the default object and webskin caching mechanism in Core with an external redis server. This is an excellent approach for moving memory load out of ColdFusion and off the application server. A key benefit for sites running in high availability environments is that all the application servers in the cluster can be made to share a central cache.

This plugin also works with Amazon ElastiCache.

Setup

1. Install redis
2. Add this plugin to the project
3. Restart your application
4. Open the "Redis" config
5. Copy in your server details
6. Save the config
7. Restart the application
8. Test

Testing / Debugging

Logging

The plugin logs status and errors to "redis.log" using cflog. This will sometimes have information pertaining to the plugin's ability to access the redis server.

Reports

The redis reports are accessible in the Webtop under Admin -> General Admin -> Application Settings -> Redis Summary.

The main screen has information about the general health of the redis servers (or clusters, in the case of ElastiCache). You can drill down to a specific server or application by clicking "overview" or "this application".

NOTE: the information provided on the drill-down pages is aquired via an undocumented feature of redis which the developers are planning to deprecate.

NOTE: generating the drill-down reports can have a performance impact on the application and redis servers. If you have more than 100 000 items in your cache, you may find that the reports time out.

Cache Invalidation

Updating or restarting the application does not clear the cache. See the following sections for the different ways to invalidate cache data.

COAPI deployments

Content type data is cache keys include the last schema change date for that type. Deploying schema updates automatically causes the app to stop using previous cache items.

NOTE: other servers will conetinue to use the old cache items until you update the application to refresh the schema change dates. This allows you to deploy changes on one server without breaking the site on another unupdated server.

Rebuild Site

This option, in the Tray, invalidates every key used by the site, and will affect every server using the same Redis server.

Fine Grained

The Redis page in the webtop (Admin -> General Admin -> Application Settings -> Redis Summary) has options for manually triggering invalidation either across the entire application or for specific sections of the cache.

Support for cache warming functionality

• application.fc.lib.objectbroker.prepareCacheVersion and application.fc.lib.objectbroker.finalizeCacheVersion allow a developer to access the next cache version (see invalidation above), populate that cache, then update the app to use that version. This allows the developer to clear the current cache without flooding the app with uncached requests.
• A new config (Access Key), and support for URL parameters in the form cacheversion_[type]_[accesskey]=N allows a developer to make a request that populates a specific cache version.