You are here

INSTALLATION.txt in Memcache API and Integration 5.2

Same filename and directory in other branches
  1. 5 INSTALLATION.txt
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$

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(
      'memcache_inc' => './includes/memcache.inc',
    );
    [simon@yoursite memcache]$   

8) Enable the drupal module from /admin/build/modules (it's in the "Other"
section)

File

INSTALLATION.txt
View source
  1. Fedora memcache + drupal walkthrough
  2. 1) Have a look at the background reading
  3. A - http://www.danga.com/memcached/ (cache daemon)
  4. B - http://pecl.php.net/package/memcache (PHP integration for memcache)
  5. C - http://drupal.org/project/memcache (Drupal Module to use memcache)
  6. 2) Fedora RPMs are available for A and B above
  7. http://dag.wieers.com/rpm/packages/memcached/
  8. http://dag.wieers.com/rpm/packages/php-pecl-memcache/
  9. I downloaded the SRPMs and rebuilt them. This may require installing some
  10. extra RPMs into your system - rpm will tell you.
  11. 1003 wget http://dag.wieers.com/rpm/packages/memcached/memcached-1.2.1-4.rf.src.rpm
  12. 1004 rpmbuild --rebuild memcached-1.2.1-4.rf.src.rpm
  13. 1005 yum install libevent-devel
  14. 1006 rpmbuild --rebuild memcached-1.2.1-4.rf.src.rpm
  15. 1008 wget http://dag.wieers.com/rpm/packages/php-pecl-memcache/php-pecl-memcache-2.0.4-1.rf.src.rpm
  16. 1009 rpmbuild --rebuild php-pecl-memcache-2.0.4-1.rf.src.rpm
  17. 1010 yum install php-devel
  18. 1011 rpmbuild --rebuild php-pecl-memcache-2.0.4-1.rf.src.rpm
  19. 3) Installed RPMS
  20. [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
  21. Preparing... ########################################### [100%]
  22. 1:php-pecl-memcache ########################################### [ 50%]
  23. 2:memcached ########################################### [100%]
  24. [root@yoursite ~]#
  25. 4) Verify configuration. Change if required.
  26. [root@yoursite ~]# cat /etc/sysconfig/memcached
  27. PORT="11211"
  28. USER="nobody"
  29. MAXCONN="1024"
  30. CACHESIZE="64"
  31. OPTIONS=""
  32. [root@yoursite ~]#
  33. 5) Activate memcache
  34. [root@yoursite ~]# service memcached start
  35. Starting Distributed memory caching (memcached): [ OK ]
  36. [root@yoursite ~]# service httpd restart
  37. Stopping httpd: [ OK ]
  38. Starting httpd: [ OK ]
  39. [root@yoursite ~]#
  40. Check phpinfo() for memcached status. Mine said
  41. memcache
  42. memcache support enabled
  43. Active persistent connections 0
  44. Revision $Revision$
  45. 6) Optional. Install and enable 'devel' module. Configure it to show SQL
  46. queries being executed. Log in, and check out / and /admin - see how many
  47. SQL queries are run. In my case / took 156 queries, and /admin took 91.
  48. Once you've patched Drupal as described below, even enabling and disabling
  49. the Memcache module won't disable the use of memcache.
  50. 7) Download, install, follow steps in README.txt (move include file,
  51. configure settings.php)
  52. [simon@yoursite ~]$ cd /home/WHOEVER/www/SOMEWEBSITE.com/html/modules/
  53. [simon@yoursite modules]$ wget -q http://ftp.osuosl.org/pub/drupal/files/projects/memcache-5.x-1.x-dev.tar.gz
  54. [simon@yoursite modules]$ tar xfz memcache-5.x-1.x-dev.tar.gz
  55. [simon@yoursite modules]$ cd memcache
  56. [simon@yoursite memcache]$ mv memcache.inc ../../includes/
  57. [simon@yoursite modules]$
  58. Apply the default configuration to the bottom of your
  59. DRUPAL/sites/default/settings.php file. If you have already configured
  60. $cfg, you will need to add the element to the array instead of appending the
  61. whole $cfg. The example below uses the default localhost:11211 server.
  62. [simon@yoursite memcache]$ tail -3 ../../sites/default/settings.php
  63. $conf = array(
  64. 'memcache_inc' => './includes/memcache.inc',
  65. );
  66. [simon@yoursite memcache]$
  67. 8) Enable the drupal module from /admin/build/modules (it's in the "Other"
  68. section)