Skip to content

Latest commit

 

History

History
executable file
·
79 lines (44 loc) · 1.95 KB

README.pmem.rst

File metadata and controls

executable file
·
79 lines (44 loc) · 1.95 KB
Raw

Copyright and License

Copyright 2018 Lenovo

Licensed under the BSD-3 license. see LICENSE.Lenovo.txt for full text

Description

This project provides a sample of persistent memory support in memcached. It enables memcached to use persistent memory for data caching. For more information on memcached and persistent memory, visit http://www.memcached.org and http://pmem.io

Installing

  • To install memcached with persistent memory support:
    1. Clone the project
    2. 'cd' to the directory where the project is cloned and invoke the 'configure' scripts:
     ./configure --enable-pslab

3. Invoke the 'make' program:
     make

4. If 'make' succeeds, you can install the program:
make install

Requirements

Besides the libraries depended on by memcached, persistent memory enhancement needs the Persistent Memory Development Kit (PMDK) to build. PMDK is available from https://github.com/pmem/pmdk

Usage

Start memcached with persistent memory

Assuming that the persistent memory device is '/dev/pmem0', format it with ext4 file system type:

mkfs -t ext4 /dev/pmem0

Then mount it in dax mode:

mount -o dax /dev/pmem0 /mnt/pmfs

Finnaly start memcached:

memcached -u root -o pslab_file=/mnt/pmfs/pool,pslab_force

To use persistent memory caching all the data:

memcached -u root -m 0 -o pslab_file=/mnt/pmfs/pool,pslab_force

Restart memcached with data recovery

With persistent memory support enabled, memcached can recover the data stored in persistent memory back from abrupt termination caused by system panic or application crash.

memcached -u root -o pslab_file=/mnt/pmfs/pool,pslab_force,pslab_recover