How To Install Repcached (Memcached Replication) For High-Availability Over 2 Nodes On Ubuntu 11.04

This is a short tutorial based on MarcusSpiegel's howto found here. This how to will cover the missing parts for installing Repcached on Ubuntu server 11.04. This is a copy/paste friendly tutorial so using putty will make this a lot easier.

This how to will show you how to install and build memcached with replication, create a startup script and configure PHP to use memcache for sessions rather than storing them as files. This tutorial assumes you have set up 2 servers to replicate the information over.


1. My Setup

In this demo I will be setting up repcache on 2 hosts, they will have both lighttpd and repcache installed on them.

  • Web Server 1:, IP Address:; This will be refered to as server1.
  • Web Server 2:, IP Address:; This will be refered to as server2.


2. Installing repcache

First you need to visit and download the lastest version (latest at time of writing: 2.2-1.2.8). After downloading the tar file, we will need to install some extra packages. Do this on both nodes.

apt-get install libevent-dev g++ make

From here we can continue the installation.

tar xvf memcached-1.2.8-repcached-2.2.tar
cd memcached-1.2.8-repcached-2.2/
./configure --enable-replication
make install


3. Configuring repcache

Repcache is now installed, binary location is /usr/local/bin/memcached. From here we will create the config file and startup script. Config file and init script are the ones found on MarcusSpiegel's howto. Do this on both nodes.

First open the file with vi:

vi /etc/memcachedrep

Then enter the following, remember to change the IP address at the end. This IP will be the other server you wish to replicate to.

## extra commandline options to start memcached in replicated mode
# -x < ip_addr > hostname or IP address of the master replication server
# -X < num > TCP port number of the master (default: 11212)
DAEMON_ARGS="-m 64 -p 11211 -u root -P /var/run/ -d -x"

Once the file is saved we need to create the init script. Once again this is the script found on MarcusSpiegel's howto with some minor changes for config location only.

vi /etc/init.d/memcachedrep

#! /bin/sh
# Provides:             memcached
# Required-Start:       $syslog
# Required-Stop:        $syslog
# Should-Start:         $local_fs
# Should-Stop:          $local_fs
# Default-Start:        2 3 4 5
# Default-Stop:         0 1 6
# Short-Description:    memcached - Memory caching daemon replicated
# Description:          memcached - Memory caching daemon replicated
# Author: Michael 
# Please remove the "Author" lines above and replace them
# with your own name if you copy and modify this script.
# Do NOT "set -e"
# PATH should only include /usr/* if it runs after the script
DAEMON_ARGS="--options args"
# Exit if the package is not installed
[ -x "$DAEMON" ] || exit 0
# Read configuration variable file if it is present
[ -r /etc/$DESC ] && . /etc/$DESC
# Load the VERBOSE setting and other rcS variables
. /lib/init/
# Define LSB log_* functions.
# Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
. /lib/lsb/init-functions
# Function that starts the daemon/service
	# Return
	#   0 if daemon has been started
	#   1 if daemon was already running
	#   2 if daemon could not be started
	start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON --test > /dev/null \
		|| return 1
	start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON -- \
		|| return 2
	# Add code here, if necessary, that waits for the process to be ready
	# to handle requests from services started subsequently which depend
	# on this one.  As a last resort, sleep for some time.
# Function that stops the daemon/service
	# Return
	#   0 if daemon has been stopped
	#   1 if daemon was already stopped
	#   2 if daemon could not be stopped
	#   other if a failure occurred
    start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --pidfile $PIDFILE --name $NAME
    [ "$RETVAL" = 2 ] && return 2
	# Wait for children to finish too if this is a daemon that forks
	# and if the daemon is only ever run from this initscript.
	# If the above conditions are not satisfied then add some other code
	# that waits for the process to drop all resources that could be
	# needed by services started subsequently.  A last resort is to
	# sleep for some time.
	start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON
	[ "$?" = 2 ] && return 2
	# Many daemons don't delete their pidfiles when they exit.
	rm -f $PIDFILE
	return "$RETVAL"
# Function that sends a SIGHUP to the daemon/service
do_reload() {
	# If the daemon can reload its configuration without
	# restarting (for example, when it is sent a SIGHUP),
	# then implement that here.
	start-stop-daemon --stop --signal 1 --quiet --pidfile $PIDFILE --name $NAME
	return 0
case "$1" in
	[ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
	case "$?" in
		0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
		2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
	[ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
	case "$?" in
		0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
		2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
	# If do_reload() is not implemented then leave this commented out
	# and leave 'force-reload' as an alias for 'restart'.
	#log_daemon_msg "Reloading $DESC" "$NAME"
	#log_end_msg $?
	# If the "reload" option is implemented then remove the
	# 'force-reload' alias
	log_daemon_msg "Restarting $DESC" "$NAME"
	case "$?" in
		case "$?" in
			0) log_end_msg 0 ;;
			1) log_end_msg 1 ;; # Old process is still running
			*) log_end_msg 1 ;; # Failed to start
	  	# Failed to stop
		log_end_msg 1
	#echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
	echo "Usage: $SCRIPTNAME {start|stop|restart|force-reload}" >&2
	exit 3

Save this then type in the following.

chmod +x /etc/init.d/memcacherep
update-rc.d memcachedrep defaults

This will make sure repcache is started everytime the server is restarted.


4. Testing

Before we move on we will test that the 2 nodes are replicating.


telnet 11211

Then type in

set foo 0 0 3

You should see the word STORED appear under it. Type in


and it will return to the console. Go to your other server and type in the following.


telnet 11211

Then type in

get foo

and it should return the value you entered on the first server. If it has then the replication is working.


5. Setting up PHP

Here I will show you how to setup PHP to use memcache. Because I am using lighttpd the directories may be different to those using apache2 or nginx. Type the following into the console and repeat for the secondary server.

vi /etc/php5/cgi/php.ini

Search down the file till you find the following:

; Handler used to store/retrieve data.
session.save_handler = files

You will need to change these to look like this:

; Handler used to store/retrieve data.
extension =
session.save_handler = memcache
session.save_path = "tcp://"

Once these have been saved simply type in (remember to change this to the software you are using for the hosting):

/etc/init.d/lighttpd force-reload

Or simply reboot both servers. You can now test out that php is using them correctly by creating a session on one and reading that session from the other.

Share this page:

Suggested articles

1 Comment(s)

Add comment


From: Vishnu


I'm trying to install repcached on a local virtual machine. When I do the "make install" step, I'm getting the following error: 

In function ‘add_iov’:

memcached.c:696:30: error: ‘IOV_MAX’ undeclared (first use in this function)

         if (m->msg_iovlen == IOV_MAX ||


memcached.c:696:30: note: each undeclared identifier is reported only once for each function it appears in

memcached.c: In function ‘complete_nread’:

memcached.c:834:13: warning: implicit declaration of function ‘replication_call_rep’ [-Wimplicit-function-declaration]

             replication_call_rep(ITEM_key(it), it->nkey);




Does this happen? If not, please help me to resolve this issue. Thank you.