// $Id: INSTALLATION.txt,v 1.4 2008-01-29 23:43:34 slantview Exp $

For instructions on how to compile memcached on Debian Etch, see here:
http://www.lullabot.com/articles/how_install_memcache_debian_etch


Fedora memcache + drupal walkthrough

1) Have a look at the background reading

  A - http://www.danga.com/memcached/	  (cache daemon)

  B - http://pecl.php.net/package/memcache  (PHP integration for memcache)

  C - http://drupal.org/project/memcache    (Drupal Module to use memcache)

2) Fedora RPMs are available for A and B above

  http://dag.wieers.com/rpm/packages/memcached/
  http://dag.wieers.com/rpm/packages/php-pecl-memcache/

  I downloaded the SRPMs and rebuilt them.  This may require installing some
  extra RPMs into your system - rpm will tell you.

 1003  wget http://dag.wieers.com/rpm/packages/memcached/memcached-1.2.1-4.rf.src.rpm
 1004  rpmbuild --rebuild memcached-1.2.1-4.rf.src.rpm
 1005  yum install libevent-devel
 1006  rpmbuild --rebuild memcached-1.2.1-4.rf.src.rpm

 1008  wget http://dag.wieers.com/rpm/packages/php-pecl-memcache/php-pecl-memcache-2.0.4-1.rf.src.rpm
 1009  rpmbuild --rebuild php-pecl-memcache-2.0.4-1.rf.src.rpm
 1010  yum install php-devel
 1011  rpmbuild --rebuild php-pecl-memcache-2.0.4-1.rf.src.rpm

3) Installed RPMS

[root@yoursite ~]# rpm -Uvh /usr/src/redhat/RPMS/x86_64/memcached-1.2.1-4.rf.x86_64.rpm /usr/src/redhat/RPMS/x86_64/php-pecl-memcache-2.0.4-1.rf.x86_64.rpm
Preparing...                ########################################### [100%]
   1:php-pecl-memcache      ########################################### [ 50%]
   2:memcached              ########################################### [100%]
[root@yoursite ~]#

4) Verify configuration. Change if required.

[root@yoursite ~]# cat /etc/sysconfig/memcached
PORT="11211"
USER="nobody"
MAXCONN="1024"
CACHESIZE="64"
OPTIONS=""
[root@yoursite ~]#

5) Activate memcache

[root@yoursite ~]# service memcached start
Starting Distributed memory caching (memcached):           [  OK  ]
[root@yoursite ~]# service httpd restart
Stopping httpd:                                            [  OK  ]
Starting httpd:                                            [  OK  ]
[root@yoursite ~]#

  Check phpinfo() for memcached status. Mine said

      memcache
      memcache support	enabled
      Active persistent connections 	0
      Revision 	$Revision: 1.4 $

6) Optional. Install and enable 'devel' module. Configure it to show SQL
queries being executed.  Log in, and check out / and /admin - see how many
SQL queries are run.  In my case / took 156 queries, and /admin took 91.
Once you've patched Drupal as described below, even enabling and disabling
the Memcache module won't disable the use of memcache.

7) Download, install, follow steps in README.txt (move include file,
configure settings.php)

    [simon@yoursite ~]$ cd /home/WHOEVER/www/SOMEWEBSITE.com/html/modules/
    [simon@yoursite modules]$ wget -q http://ftp.osuosl.org/pub/drupal/files/projects/memcache-5.x-1.x-dev.tar.gz
    [simon@yoursite modules]$ tar xfz memcache-5.x-1.x-dev.tar.gz
    [simon@yoursite modules]$ cd memcache
    [simon@yoursite memcache]$ mv memcache.inc ../../includes/
    [simon@yoursite modules]$

Apply the default configuration to the bottom of your
DRUPAL/sites/default/settings.php file.  If you have already configured
$cfg, you will need to add the element to the array instead of appending the
whole $cfg.  The example below uses the default localhost:11211 server.

    [simon@yoursite memcache]$ tail -3 ../../sites/default/settings.php
    $conf = array(
      'cache_inc' => './sites/all/modules/memcache/memcache.inc',
    );
    [simon@yoursite memcache]$

8) Enable the drupal module from /admin/build/modules (it's in the "Other"
section) Note that the memcache module only provides some debug output for
administrators to help you see what memcache is doing. It is non-essential
to the functioning of your site, and can be turned off on a production site.

It is, however, *vital* that you enable the module at least once because it runs
hook_install and adds the serialized column to all of your cache tables.

9) Also see the memcache_admin module (distributed with this package) to monitor
memcache statistics.