How to install memcached on CentOS with memcached PHP extension on CentOS
Published: Wed, 08/29/2012 - 8:46am
Updated: Wed, 06/19/2013 - 12:22am
We'll need the following:
- memcached ( http://memcached.org/ ) Current Version at time of writing: memcached v1.4.15 date: 2012-9-3
- libevent ( http://libevent.org/ ) Current Version at time of writing: libevent-2.0.21 date: 2012-11-18 **If we're going to build memcached from source, we'll need this
- pecl/memcached ( http://pecl.php.net/package/memcached ) Current version at time of writing: pecl/memcached 2.1.0 date: 2012-08-07
- libmemcached ( http://libmemcached.org ; needed by pecl/memcached) Current version at time of writing: libmemcached 1.0.10 date:2012-07-31
** NOTE: we'll be installing this using yum , since doing from source failed for me as it required other dependencies **
- libmemcached ( http://libmemcached.org ; needed by pecl/memcached) Current version at time of writing: libmemcached 1.0.10 date:2012-07-31
Let's head over to our setup directory--this is where we'll be downloading and installing everything from.
cd /usr/local/src
Fix yum, so it only shows the packages made for our system
vi /etc/yum.conf
Add the following line:
multilib_policy=best
Basically, what this does is, if you're on x86_64 it will only show the x86_64 packages; and vice-versa.
Install memcached using yum
We need to get the latest memcached from yum, however all the regular repos have the oudated version... So we install the PowerStack repository which has the latest version memcached 1.4.14
rpm -Uvh http://powerstack.org/powerstack-release.rpm
yum update
yum install memcached
Install memcached from source
This is an alternative step. Yum way works great--everything is setup for you. However, If you want to do this manually, then continue here:
We'll first need to install libevent. Let's see if it's installed already
whereis libevent
*** Installing via yum will install an older libevent 1.4.13 ***
yum install gcc libevent libevent-devel
OR we can install libevent from source. You can get latest version here: http://libevent.org/ . However, the latest version of libevent may be too new for the latest version of memcached, so if something goes wrong, try a lower version.
wget https://github.com/downloads/libevent/libevent/libevent-2.0.21-stable.tar.gz
tar xvfz libevent-2.0.21-stable.tar.gz
cd libevent-2.0.21-stable
./configure
make
make install
#create a symbolic link to libevent since it's not made by default in the location that memcached is expecting it to be
ln -s /usr/local/lib/libevent-2.0.so.5 /lib64/
Now with libevent installed, we can install memcached from source.
wget http://memcached.org/latest
tar -zxvf memcached-1.x.x.tar.gz
cd memcached-1.x.x
./configure
make
make install
If memcached can't start complaing about :
memcached: error while loading shared libraries: libevent-2.0.so.5: cannot open shared object file: No such file or directory
We need to see where it's looking for the libevent library and crate a symbolic link to it.
LD_DEBUG=libs memcached - v 2>&1 > /dev/null I less
#Example: for me memcached was looking for libevent in /lib64
ln -s /usr/local/lib/libevent-2.0.so.5 /lib64/
Configure memcached
vi /etc/sysconfig/memcached
We set the CACHESIZE. Normally this is pretty low, so we up it to 2048MB
PORT="11211"
USER="memcached"
MAXCONN="2048"
CACHESIZE="2048"
OPTIONS="-l 127.0.0.1"
Next we make sure memcached starts automatically.
chkconfig memcached on
service memcached start
*** If you get an error saying memcached is missing when trying 'chconfig memcached on' do the following (this will likely not happen if you've installed memcached using Yum):
vi /etc/rc.d/init.d/memcached
Paste this:
#!/bin/bash
#
# memcached This shell script takes care of starting and stopping
# standalone memcached.
#
# chkconfig: - 80 12
# description: memcached is a high-performance, distributed memory
# object caching system, generic in nature, but
# intended for use in speeding up dynamic web
# applications by alleviating database load.
# processname: memcached
# config: /etc/memcached.conf
# Source function library.
. /etc/rc.d/init.d/functions
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
DAEMON=/usr/local/bin/memcached
DAEMONBOOTSTRAP=/usr/local/bin/start-memcached
DAEMONCONF=/etc/memcached.conf
NAME=memcached
DESC=memcached
PIDFILE=/var/run/$NAME.pid
[ -x $DAEMON ] || exit 0
[ -x $DAEMONBOOTSTRAP ] || exit 0
RETVAL=0
start() {
echo -n $"Starting $DESC: "
daemon $DAEMONBOOTSTRAP $DAEMONCONF
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
echo
return $RETVAL
}
stop() {
echo -n $"Shutting down $DESC: "
killproc $NAME
RETVAL=$?
echo
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
return $RETVAL
}
# See how we were called.
case "$1" in
start)
start
;;
stop)
stop
;;
restart|reload)
stop
start
RETVAL=$?
;;
status)
status $prog
RETVAL=$?
;;
*)
echo $"Usage: $0 {start|stop|restart|status}"
exit 1
esac
exit $RETVAL
Now make it executable
chmod 755 /etc/rc.d/init.d/memcached
Create the script
vi /usr/local/bin/start-memcached
chmod 755 /usr/local/bin/start-memcached
#!/usr/bin/perl -w
# start-memcached
# 2003/2004 - Jay Bonci <[email protected]>
# This script handles the parsing of the /etc/memcached.conf file
# and was originally created for the Debian distribution.
# Anyone may use this little script under the same terms as
# memcached itself.
use strict;
if ($> != 0 and $< != 0) {
print STDERR "Only root wants to run start-memcached.\n";
exit;
}
my $etcfile = shift || "/etc/memcached.conf";
my $params = [];
my $etchandle;
# This script assumes that memcached is located at /usr/bin/memcached, and
# that the pidfile is writable at /var/run/memcached.pid
my $memcached = "/usr/local/bin/memcached";
my $pidfile = "/var/run/memcached.pid";
# If we don't get a valid logfile parameter in the /etc/memcached.conf file,
# we'll just throw away all of our in-daemon output. We need to re-tie it so
# that non-bash shells will not hang on logout. Thanks to Michael Renner for
# the tip
my $fd_reopened = "/dev/null";
sub handle_logfile {
my ($logfile) = @_;
$fd_reopened = $logfile;
}
sub reopen_logfile {
my ($logfile) = @_;
open *STDERR, ">>$logfile";
open *STDOUT, ">>$logfile";
open *STDIN, ">>/dev/null";
$fd_reopened = $logfile;
}
# This is set up in place here to support other non -[a-z] directives
my $conf_directives = {
"logfile" => \&handle_logfile
};
if (open $etchandle, $etcfile) {
foreach my $line (<$etchandle>) {
$line =~ s/\#.*//go;
$line = join ' ', split ' ', $line;
next unless $line;
next if $line =~ /^\-[dh]/o;
if ($line =~ /^[^\-]/o) {
my ($directive, $arg) = $line =~ /^(.*?)\s+(.*)/;
$conf_directives->{$directive}->($arg);
next;
}
push @$params, $line;
}
}
unshift @$params, "-u root" unless (grep $_ eq '-u', @$params);
$params = join " ", @$params;
if (-e $pidfile) {
open PIDHANDLE, "$pidfile";
my $localpid = <PIDHANDLE>;
close PIDHANDLE;
chomp $localpid;
if (-d "/proc/$localpid") {
print STDERR "memcached is already running.\n";
exit;
} else {
`rm -f $localpid`;
}
}
my $pid = fork();
if ($pid == 0) {
reopen_logfile($fd_reopened);
exec "$memcached $params";
exit(0);
} elsif (open PIDHANDLE,">$pidfile") {
print PIDHANDLE $pid;
close PIDHANDLE;
} else {
print STDERR "Can't write pidfile to $pidfile.\n";
}
Now we try to add it as a service again...
chkconfig memcached on
service memcached start
Cool! we now have the latest version of memcached installed.
Let's check to make sure it's working:
echo stats | nc localhost 11211
This will show something like
STAT pid 10412
STAT uptime 6353
STAT time 1346136470
STAT version 1.4.14
STAT libevent 1.4.13-stable
STAT pointer_size 64
STAT rusage_user 0.000000
STAT rusage_system 0.001999
STAT curr_connections 10
STAT total_connections 14
STAT connection_structures 11
STAT reserved_fds 20
STAT cmd_get 1
STAT cmd_set 0
STAT cmd_flush 0
STAT cmd_touch 0
STAT get_hits 0
STAT get_misses 1
STAT delete_misses 0
STAT delete_hits 0
STAT incr_misses 0
STAT incr_hits 0
STAT decr_misses 0
STAT decr_hits 0
STAT cas_misses 0
STAT cas_hits 0
STAT cas_badval 0
STAT touch_hits 0
STAT touch_misses 0
STAT auth_cmds 0
STAT auth_errors 0
STAT bytes_read 33
STAT bytes_written 2059
STAT limit_maxbytes 536870912
STAT accepting_conns 1
STAT listen_disabled_num 0
STAT threads 4
STAT conn_yields 0
STAT hash_power_level 16
STAT hash_bytes 524288
STAT hash_is_expanding 0
STAT expired_unfetched 0
STAT evicted_unfetched 0
STAT bytes 0
STAT curr_items 0
STAT total_items 0
STAT evictions 0
STAT reclaimed 0
END
Ok it works.
If you get an error saying nc: command not found, then simply do
yum install rc
Install libmemcached
This is needed for pecl/memcached PHP extension. We install the yum repo that has libmemcached and install it with all it's dependencies:
libmemcached
libmemcached-devel
cyrus-sasl-devel
Let's install libmemcached and it's dependencies.
pecl/memcached needs libmemcached 0.39+, and the regular yum repositories probably will install an older version, which won't work
For CentOS 6.x use the following
wget http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
wget http://rpms.famillecollet.com/enterprise/remi-release-6.rpm
rpm -Uvh remi-release-6*.rpm epel-release-6*.rpm
yum --enablerepo=remi install libmemcached\*
For CentOS 5.x use the following
wget http://dl.fedoraproject.org/pub/epel/5/x86_64/epel-release-5-4.noarch.rpm
wget http://rpms.famillecollet.com/enterprise/remi-release-5.rpm
rpm -Uvh remi-release-5*.rpm epel-release-5*.rpm
yum --enablerepo=remi install libmemcached\*
If you want to permantely enable the remi repo, then do the following:
vi /etc/yum.repos.d/remi.repo
Now enable the first/top repo (only) by changing enabled=0 to:
enabled=1
Ok... libmemcached should now be installed, and we can move on to the next step.
Install pecl/memcached
We're almost done... We just now need to install the memcached PHP extension.
wget http://pecl.php.net/get/memcached # this will get the latest version.
tar -zxvf memcached-x.x.x.tgz #fill in whatever version you just download; e.g. memcached-2.1.0.tgz
cd memcached-x.x.x
phpize
./configure
make
make install
Note the extension installation directory, because we will need it in the next step. e.g. /usr/local/lib/php/extensions/no-debug-non-zts-20100525/
locate php.ini # in centos it's located at /usr/local/lib/php.ini
vi /usr/local/lib/php.ini
now add the following line near the bottom of php.ini
extension_dir = "/usr/local/lib/php/extensions/no-debug-non-zts-20100525/"
extension=memcached.so
Example: This is what your php.ini may look like with APC and memcached installed
extension_dir = "/usr/local/lib/php/extensions/no-debug-non-zts-20100525/"
extension = apc.so
apc.enabled=1
apc.shm_size=256M
; or if you have less than 4GB memory try:
; apc.shm_size=128M
apc.ttl = 0
apc.mmap_file_mask=/tmp/apc.XXXXXX
extension_dir = "/usr/local/lib/php/extensions/no-debug-non-zts-20100525/"
extension=memcached.so
Restart Apache.
service httpd restart
Okie dokie... Done! (I think I'm delirious writing this) Let's check to make sure it's working:
php -i | grep memcached
You should see a few lines detailing your setup. Cool! And.... One final step...
Open memcached port 11211 on your firewall
*** UPDATE: You can skip this step for security reasons, and manually add the IPs of your server farm to your firewall if needed. For CSF:
vi /etc/csf/csf.allow
Then add your IPs to the list. **** If you're using a server farm (load balancing) and you have a firewall installed, you'll need to open port 11211 so memcached can share resources across all servers.
vi /etc/sysconfig/iptables
add the below INPUT line:
-A INPUT -m state --state NEW -m tcp -p tcp --dport 11211 -j ACCEPT
Restart iptables
service iptables restart
For CSF use:
vi /etc/csf/csf.conf
under "TCP_IN" and "TCP_OUT" add port: 11211 so it looks something like this:
# Allow incoming TCP ports
TCP_IN = "20,21,22,25,53,80,110,143,443,465,587,993,995,2222,11211"
# Allow outgoing TCP ports
TCP_OUT = "20,21,22,25,53,80,110,113,443,2222,11211"
once done restart CSF
service csf restart
So that's it and that's that...