TokuDB Installation

Percona Server is technically compatible with the separately available TokuDB storage engine package. TokuDB engine is not packaged with any Percona Server 5.6 download. The TokuDB engine must be separately downloaded and then enabled as a plug-in component.  This package can be installed alongside with standard Percona Server 5.6 releases starting with 5.6.19-67.0 and does not require any specially adapted version of Percona Server.

The TokuDB storage engine is a scalable, ACID and MVCC compliant storage engine that provides indexing-based query improvements, offers online schema modifications, and reduces slave lag for both hard disk drives and flash memory. This storage engine is specifically designed for high performance on write-intensive workloads which is achieved with Fractal Tree indexing. To learn more about Fractal Tree indexing, you can visit the following Wikipedia page.

Only the Percona supplied TokuDB engine should be used with Percona Server 5.6. A TokuDB engine downloaded from other sources may not be compatible.

The TokuDB engine is released by Tokutek Inc. under a modified form of the GNU GPL v2 license. You can view a copy of the modified license here.

TokuDB Hot Backup is a proprietary, commercial product available for download only from It is not available for download from Percona.

TokuDB is currently supported only for 64-bit Linux distributions. It is not available for Debian 6.0 (squeeze) and Ubuntu 10.04 (lucid) due to conflicts with the gcc version required by TokuDB.


libjemalloc library

TokuDB storage engine requires libjemalloc library 3.3.0 or greater. If the version in the distribution repository is lower than that you can use one from Percona Software Repositories or download it from somewhere else.

If the libjemalloc wasn’t installed and enabled before it will be automatically installed when installing the TokuDB storage engine package by using the apt or yum package manager, but Percona Server instance should be restarted for libjemalloc to be loaded. This way libjemalloc will be loaded with LD_PRELOAD. You can also enable libjemalloc by specifying malloc-lib variable in the [mysqld_safe] section of the my.cnf file:

malloc-lib= /path/to/jemalloc

Transparent huge pages

TokuDB won’t be able to start if the transparent huge pages are enabled. Transparent huge pages is feature available in the newer kernel versions. You can check if the Transparent huge pages are enabled with:

$ cat /sys/kernel/mm/transparent_hugepage/enabled

 [always] madvise never

If transparent huge pages are enabled and you try to start the TokuDB engine you’ll get the following message in you error.log:

Transparent huge pages are enabled, according to /sys/kernel/mm/redhat_transparent_hugepage/enabled
Transparent huge pages are enabled, according to /sys/kernel/mm/transparent_hugepage/enabled

You can disable transparent huge pages permanently by passing transparent_hugepage=never to the kernel in your bootloader (NOTE: For this change to take an effect you’ll need to reboot your server).

You can disable the transparent huge pages by running the following command as root (NOTE: Setting this will last only until the server is rebooted):

echo never > /sys/kernel/mm/transparent_hugepage/enabled
echo never > /sys/kernel/mm/transparent_hugepage/defrag


TokuDB storage engine for Percona Server is currently available in our apt and yum repositories.

You can install the Percona Server with TokuDB engine by using the apt/yum commands:

[root@centos ~]# yum install Percona-Server-tokudb-56.x86_64


root@wheezy:~# apt-get install percona-server-tokudb-5.6

Enabling the TokuDB Storage Engine

This storage engine requires manual installation if there is a root password already set up during the new installation or upgrade.

INSTALL PLUGIN tokudb_file_map SONAME '';
INSTALL PLUGIN tokudb_fractal_tree_info SONAME '';
INSTALL PLUGIN tokudb_fractal_tree_block_map SONAME '';
INSTALL PLUGIN tokudb_locks SONAME '';
INSTALL PLUGIN tokudb_lock_waits SONAME '';

After the engine has been installed it should be present in the engines list. To check if the engine has been correctly installed and active:

| TokuDB | YES | Tokutek TokuDB Storage Engine with Fractal Tree(tm) Technology | YES | YES | YES |

To check if all the TokuDB plugins have been installed correctly you should run:

| TokuDB                        | ACTIVE   | STORAGE ENGINE     | | GPL     |
| TokuDB_file_map               | ACTIVE   | INFORMATION SCHEMA | | GPL     |
| TokuDB_fractal_tree_info      | ACTIVE   | INFORMATION SCHEMA | | GPL     |
| TokuDB_fractal_tree_block_map | ACTIVE   | INFORMATION SCHEMA | | GPL     |
| TokuDB_trx                    | ACTIVE   | INFORMATION SCHEMA | | GPL     |
| TokuDB_locks                  | ACTIVE   | INFORMATION SCHEMA | | GPL     |
| TokuDB_lock_waits             | ACTIVE   | INFORMATION SCHEMA | | GPL     |

TokuDB Version

TokuDB storage engine version can be checked with:

mysql> SELECT @@tokudb_version;
| @@tokudb_version |
| tokudb-7.1.7-rc7 |
1 row in set (0.00 sec)


Installing the TokuDB package is compatible with existing server setup and databases.

Version Specific Information

  • 5.6.17-66.0

    TokuDB storage engine available as a separate Percona Server package.

  • 5.6.19-67.0

    TokuDB storage engine is considered GA quality.

© Copyright Percona LLC and/or its affiliates 2009-2015.
Except where otherwise noted, this documentation is licensed under the following license:
CC Attribution-ShareAlike 2.0 Generic
Created using Sphinx 1.2.2.
This documentation is developed in Launchpad as part of the Percona Server source code.
If you spotted innacuracies, errors, don't understood it or you think something is missing or should be improved, please file a bug.