diff --git a/README.txt b/README.txt index 0fc7c4a068f7cf3b9c7718e7f98cc4fe84d6c7ba..fc1a9d17b3eec20810aa79183cb9bb8cc9137346 100644 --- a/README.txt +++ b/README.txt @@ -12,22 +12,23 @@ These are the broad steps you need to take in order to use this software. Order is important. -1. Install the memcached binaries on your server. See - -http://www.lullabot.com/articles/how_install_memcache_debian_etch - -2. Install the PECL memcache extension for PHP. This must be version 2.2.1 or - higher or you will experience errors. -3. Put your site into offline mode. -4. Download and install the memcache module. -5. If you have previously been running the memcache module, run update.php. -6. Start at least one instance of memcached on your server. -7. Edit settings.php to configure the servers, clusters and bins that memcache - is supposed to use. -8. Edit settings.php to mke memcache the default cache class, for example: - $conf['cache_backends'][] = 'sites/all/modules/memcache/memcache.inc'; - $conf['cache_default_class'] = 'MemCacheDrupal'; -9. Bring your site back online. + 1. Install the memcached binaries on your server. See for instance: + http://www.lullabot.com/articles/how_install_memcache_debian_etch + 2. Install the PECL memcache extension for PHP. This must be version 2.2.1 or + higher or you will experience errors. + 3. Put your site into offline mode. + 4. Download and install the memcache module. + 5. If you have previously been running the memcache module, run update.php. + 6. Start at least one instance of memcached on your server. + 7. Edit settings.php to configure the servers, clusters and bins that memcache + is supposed to use. + 8. Edit settings.php to make memcache the default cache class, for example: + $conf['cache_backends'][] = 'sites/all/modules/memcache/memcache.inc'; + $conf['cache_default_class'] = 'MemCacheDrupal'; + 9. Make sure the following line also exists, to protect the special cache_form + bin from being assigned to a volatile cache storage implementation: + $conf['cache_class_form'] = 'DrupalDatabaseCache'; +10. Bring your site back online. For instructions on 1 and 2 above, please see the INSTALLATION.txt file that comes with the memcache module download. @@ -64,7 +65,7 @@ The bin/cluster/server model can be described as follows: - Servers are memcached instances identified by host:port. - Bins are groups of data that get cached together and map 1:1 to the $table - param in cache_set(). Examples from Drupal core are cache_filter, + parameter of cache_set(). Examples from Drupal core are cache_filter, cache_menu. The default is 'cache'. - Clusters are groups of servers that act as a memory pool. @@ -91,11 +92,12 @@ $conf = array( Here is an example configuration that has two clusters, 'default' and 'cluster2'. Five memcached instances are divided up between the two -clusters. 'cache_filter' and 'cache_menu' bins goe to 'cluster2'. All other +clusters. 'cache_filter' and 'cache_menu' bins go to 'cluster2'. All other bins go to 'default'. $conf['cache_backends'][] = 'sites/all/modules/memcache/memcache.inc'; $conf['cache_default_class'] = 'MemCacheDrupal'; +$conf['cache_class_form'] = 'DrupalDatabaseCache'; $conf = array( 'cache_default_class' = 'MemCacheDrupal', 'memcache_servers' => array('localhost:11211' => 'default', @@ -129,6 +131,7 @@ NOTE: Session.inc is not yet ported to Drupal 7. $conf['cache_backends'][] = 'sites/all/modules/memcache/memcache.inc'; $conf['cache_default_class'] = 'MemCacheDrupal'; +$conf['cache_class_form'] = 'DrupalDatabaseCache'; $conf = array( 'cache_default_class' = 'MemCacheDrupal', 'session_inc' => './sites/all/modules/memcache/memcache-session.inc',