Troubleshooting

Common BetrFS Setup Problems and Solutions

In general, when you have problems with BetrFS, it is helpful to look at the output of dmesg.

Failed to create the TokuDB environment, errno -100016

This message is because your kernel is configured to use Transparent Huge Pages. This is an inherited limitation from the TokuDB code. We may remove this restriction in the future.

One reason this error can arise is if your kernel is compiled to use the kconfig option CONFIG_TRANSPARENT_HUGEPAGE_ALWAYS set.

For now, you may set trannsparent huge pages to madvise or never. The MongoDB project has a good guide on doing this with an init script if you don't want to mess with your kernel config.