GitHub - dkrotx/memcached-dd: memcached (with dump-to-disk feature) development tree

dkrotx / memcached-dd Public

forked from memcached/memcached

Notifications You must be signed in to change notification settings
Fork 4
Star 13

memcached (with dump-to-disk feature) development tree

BSD-3-Clause, BSD-3-Clause licenses found

Licenses found

13 stars 3.3k forks Branches Tags Activity

Star

Notifications

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 988 Commits
devtools		devtools
doc		doc
m4		m4
scripts		scripts
t		t
.gitignore		.gitignore
.shipit		.shipit
AUTHORS		AUTHORS
BUILD		BUILD
CONTRIBUTING		CONTRIBUTING
COPYING		COPYING
ChangeLog		ChangeLog
Doxyfile		Doxyfile
HACKING		HACKING
LICENSE		LICENSE
Makefile.am		Makefile.am
NEWS		NEWS
README		README
assoc.c		assoc.c
assoc.h		assoc.h
autogen.sh		autogen.sh
cache.c		cache.c
cache.h		cache.h
configure.ac		configure.ac
daemon.c		daemon.c
dd.c		dd.c
dd.h		dd.h
globals.c		globals.c
hash.c		hash.c
hash.h		hash.h
items.c		items.c
items.h		items.h
memcached.c		memcached.c
memcached.h		memcached.h
memcached.spec.in		memcached.spec.in
memcached_dtrace.d		memcached_dtrace.d
protocol_binary.h		protocol_binary.h
sasl_defs.c		sasl_defs.c
sasl_defs.h		sasl_defs.h
sizes.c		sizes.c
slabs.c		slabs.c
slabs.h		slabs.h
solaris_priv.c		solaris_priv.c
stats.c		stats.c
stats.h		stats.h
testapp.c		testapp.c
thread.c		thread.c
timedrun.c		timedrun.c
trace.h		trace.h
util.c		util.c
util.h		util.h
version.pl		version.pl
version.sh		version.sh

Repository files navigation

-------------------------------------------------------------------------------
Memcached-dd
-------------------------------------------------------------------------------

Fork of memcached providing dump to disk feature.
Comparing to other solution(s) you may heard about, it's pure memcached with only patch. Not noSQL wich just support memcached protocol (Tarantool or MemBase).

Usage is straightforward: just add `-F file' option to command-line. Memcached will read this `file' at start and write to file.tmp when SIGUSR2 received. Then (after successfull write), it will rename file.tmp -> file. So, `file' should be never truncated.
Dump performs in separate thread, so it doesn't affect memcached itself.
For example:
$ memcached -F /tmp/memcache.dump -m 64 -p 11211 -l 127.0.0.1 


-------------------------------------------------------------------------------
INSTALLATION:
-------------------------------------------------------------------------------
./version.sh
autoreconf -fiv
./configure
make
sudo make install

-------------------------------------------------------------------------------
Original README:
-------------------------------------------------------------------------------

Dependencies:
# Memcached

## Dependencies

* libevent, http://www.monkey.org/~provos/libevent/ (libevent-dev)

## Environment

### Linux

If using Linux, you need a kernel with epoll.  Sure, libevent will
work with normal select, but it sucks.

epoll isn't in Linux 2.4, but there's a backport at:

    http://www.xmailserver.org/linux-patches/nio-improve.html

You want the epoll-lt patch (level-triggered).

### Mac OS X

If you're using MacOS, you'll want libevent 1.1 or higher to deal with
a kqueue bug.

Also, be warned that the -k (mlockall) option to memcached might be
dangerous when using a large cache.  Just make sure the memcached machines
don't swap.  memcached does non-blocking network I/O, but not disk.  (it
should never go to disk, or you've lost the whole point of it)

## Website

* http://www.memcached.org

## Contributing

Want to contribute?  Up-to-date pointers should be at:

* http://contributing.appspot.com/memcached