PerconaFT is a high-performance, transactional key-value store
C++ CMake Other
Switch branches/tags
tokumxse-1.0.0-rc.6 tokumxse-1.0.0-rc.5 tokumxse-1.0.0-rc.4 tokumxse-1.0.0-rc.2 tokumxse-1.0.0-rc.1 tokumxse-1.0.0-rc.0 tokumx-2.0.2 tokumx-2.0.1 tokumx-2.0.1-rc.2 tokumx-2.0.1-rc.1 tokumx-2.0.1-rc.0 tokumx-2.0.0 tokumx-2.0.0-rc.1 tokumx-2.0.0-rc.0 tokumx-1.5.1 tokumx-1.5.1-rc.0 tokumx-1.5.0 tokumx-1.5.0-rc.2 tokumx-1.5.0-rc.1 tokumx-1.5.0-rc.0 tokumx-1.5.0-alpha.1 tokumx-1.5.0-alpha.0 tokumx-1.4.3 tokumx-1.4.2 tokumx-1.4.2-rc.0 tokumx-1.4.2-alpha.1 tokumx-1.4.2-alpha.0 tokumx-1.4.1 tokumx-1.4.1-rc.4 tokumx-1.4.1-rc.3 tokumx-1.4.1-rc.2 tokumx-1.4.1-rc.1 tokumx-1.4.1-rc.0 tokumx-1.4.1-2 tokumx-1.4.0 tokumx-1.4.0+hotfix.0 tokumx-1.4.0-rc.1 tokumx-1.4.0-rc.0 tokumx-1.4.0-alpha.0 tokumx-1.3.3 tokumx-1.3.3-rc.2 tokumx-1.3.3-rc.1 tokumx-1.3.3-rc.0 tokumx-1.3.2 tokumx-1.3.2-rc.1 tokumx-1.3.2-rc.0 tokumx-1.3.1 tokumx-1.3.1-rc.0 tokumx-1.3.0 tokumx-1.3.0-rc.1 tokumx-1.3.0-rc.0 tokumx-1.2.1 tokumx-1.2.1-rc.1 tokumx-1.2.1-rc.0 tokumx-1.2.0 tokumx-1.2.0-rc.2 tokumx-1.2.0-rc.0 tokumx-1.1.2 tokumx-1.1.2-rc.0 tokumx-1.1.1 tokumx-1.1.1-rc.0 tokumx-1.1.0 tokumx-1.1.0-rc.0 tokumx-1.0.4 tokumx-1.0.4-rc.2 tokumx-1.0.4-rc.1 tokumx-1.0.4-rc.0 tokumx-1.0.3 tokumx-1.0.3-rc.0 tokumx-1.0.2 tokumx-1.0.2-rc.2 tokumx-1.0.2-rc.1 tokumx-1.0.2-rc.0 tokumx-1.0.1 tokumx-1.0.1-rc.0 tokumx-1.0.0 tokumx-1.0.0-rc.7 tokumx-1.0.0-rc.6 tokumx-1.0.0-rc.5 tokumx-1.0.0-rc.4 tokumx-1.0.0-rc.3 tokumx-1.0.0-rc.2 tokumx-1.0.0-rc.1 tokumx-1.0.0-rc.0 tokudb-snappy-1 tokudb-ps-2 tokudb-ps-1 tokudb-7.5.8 tokudb-7.5.7 tokudb-7.5.7-rc3 tokudb-7.5.7-rc2 tokudb-7.5.7-rc1 tokudb-7.5.7-ft656a tokudb-7.5.6 tokudb-7.5.6-rc4 tokudb-7.5.6-rc3 tokudb-7.5.6-rc2 tokudb-7.5.6-rc1 tokudb-7.5.5 tokudb-7.5.5-rc3
Nothing to show
Clone or download
georgelorchpercona Merge pull request #413 from prohaska7/cachetable_simple_test_failures
the cachetable-simple-pin-nonblocking-cheap test occasionally fails due to a locking conflict with the cachetable evictor.
Latest commit 8ff18ff May 10, 2018
Permalink
Failed to load latest commit information.
buildbot add buildbot compiler suppressions file Jul 10, 2013
buildheader Merge branch 'laur-pfs-instrumentation-rebased' Aug 18, 2017
cmake fixed cmake warnings for 3.0.0 Oct 6, 2014
cmake_modules TDB-118 : PerconaFT needs -fexceptions flag for ftcxx to compile unde… Mar 29, 2018
ft The cachetable-simple-pin-noblocking-cheap test occasionally fails du… May 9, 2018
ftcxx TDB-84 : Fix -Werror=undef Mar 29, 2018
locktree TDB-75: PerconaFT does not build standalone or with -DBUILD_TESTING=ON Aug 24, 2017
portability PS-3950: gcc-8 compilation warnings Apr 16, 2018
scripts Removed tokutek email addresses and reverences in run.stress-tests.py Mar 7, 2016
src The address sanitizer detected a variable use out of scope problem in… May 4, 2018
third_party Update config.guess in bundled xz library. Jun 28, 2016
tools TDB-172 : PerconaFT needs different libraries to link to 8.0 debug sy… Mar 29, 2018
util PS-3950: gcc-8 compilation warnings Apr 16, 2018
.clang-format Add .clang_format file to FT repo. This file defines our code format … Jan 23, 2018
.gitignore Add common cmake build directory names to .gitignore Aug 21, 2014
CMakeLists.txt TDB-85 : PerconaFT fails to build in 8.0 due use of MYSQL_VERSION_* t… Mar 29, 2018
COPYING.AGPLv3 FT-688 : Licensing and name changes changes for ft-index Jul 29, 2015
COPYING.GPLv2 FT-688 : Licensing and name changes changes for ft-index Jul 29, 2015
CTestConfig.cmake refs #4871 use lex1:8080 to submit results to, lets us use /etc/hosts… Apr 17, 2013
CTestCustom.cmake.in Contributed fixes from bugs #1510085 and #1510092 Oct 29, 2015
DartConfig.cmake closes #5784 don't run valgrind on tdb-recover because it's staticall… Apr 17, 2013
PATENTS FT-688 : Licensing and name changes changes for ft-index Jul 29, 2015
README.md Update README.md Jan 22, 2018
bash.suppressions [t:4814] merging cmake work to mainline Apr 17, 2013

README.md

PerconaFT

PerconaFT is a high-performance, transactional key-value store, used in the TokuDB storage engine for Percona Server and MySQL, and in TokuMX, the high-performance MongoDB distribution.

PerconaFT is provided as a shared library with an interface similar to Berkeley DB.

To build the full MySQL product, see the instructions for Percona/percona-server. This document covers PerconaFT only.

Building

PerconaFT is built using CMake >= 2.8.9. Out-of-source builds are recommended. You need a C++11 compiler, though only some versions of GCC >= 4.7 and Clang are tested. You also need zlib development packages (yum install zlib-devel or apt-get install zlib1g-dev).

You will also need the source code for jemalloc, checked out in third_party/.

git clone git://github.com/Percona/PerconaFT.git percona-ft
cd percona-ft
git clone git://github.com/Percona/jemalloc.git third_party/jemalloc
mkdir build
cd build
CC=gcc47 CXX=g++47 cmake \
    -D CMAKE_BUILD_TYPE=Debug \
    -D BUILD_TESTING=OFF \
    -D USE_VALGRIND=OFF \
    -D CMAKE_INSTALL_PREFIX=../prefix/ \
    ..
cmake --build . --target install

This will build libft.so and libtokuportability.so and install it, some header files, and some examples to percona-ft/prefix/. It will also build jemalloc and install it alongside these libraries, you should link to that if you are planning to run benchmarks or in production.

Platforms

PerconaFT is supported on 64-bit Centos, Debian, and Ubuntu and should work on other 64-bit linux distributions, and may work on OSX 10.8 and FreeBSD. PerconaFT is not supported on 32-bit systems.

Transparent hugepages is a feature in newer linux kernel versions that causes problems for the memory usage tracking calculations in PerconaFT and can lead to memory overcommit. If you have this feature enabled, PerconaFT will not start, and you should turn it off. If you want to run with transparent hugepages on, you can set an environment variable TOKU_HUGE_PAGES_OK=1, but only do this for testing, and only with a small cache size.

Testing

PerconaFT uses CTest for testing. The CDash testing dashboard is not currently public, but you can run the tests without submitting them.

There are some large data files not stored in the git repository, that will be made available soon. For now, the tests that use these files will not run.

In the build directory from above:

cmake -D BUILD_TESTING=ON ..
ctest -D ExperimentalStart \
      -D ExperimentalConfigure \
      -D ExperimentalBuild \
      -D ExperimentalTest

Contributing

Please report bugs in PerconaFT to the issue tracker.

We have two publicly accessible mailing lists for TokuDB:

All source code and test contributions must be provided under a BSD 2-Clause license. For any small change set, the license text may be contained within the commit comment and the pull request. For larger contributions, the license must be presented in a COPYING.<feature_name> file in the root of the PerconaFT project. Please see the BSD 2-Clause license template for the content of the license text.

License

PerconaFT is available under the GPL version 2, and AGPL version 3. See COPYING.AGPLv3, COPYING.GPLv2, and PATENTS.