Name: bittern
Owner: Twitter, Inc.
Owner: Twitter Archive
Description: Bittern Cache uses nvdimm to speed up block io operations
Created: 2015-02-06 17:15:35.0
Updated: 2018-03-31 01:00:52.0
Pushed: 2015-10-06 22:34:50.0
Size: 3057
Language: C
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
To get started with Bittern, you will need the following:
Use Linux Kernel 3.14.8 or later if you want to test block device only. There are no specific configuration requirements for this kernel.
Use Linux Kernel 4.0 or later if you want to test block device and DAX. For this kernel you will to compile BRD driver (aka ramdisk) as a module and with DAX support enabled. BRD allows to simulate NVDIMM hardware (minus crash recovery) and needs to be a loadable module.
Once all the above is setup and the OS is running the desired kernel, do the following:
pwd $ cd bittern-cache
bittern-cache $ cd src/
bittern-cache/src $ make distclean
bittern-cache/src $ make devconfig
bittern-cache/src $ make
bittern-cache/src $ cd bittern_cache_kmod
bittern-cache/src/bittern_cache_kmod $ make doxygen.docs
bittern-cache/src/bittern_cache_kmod $ firefox doxygen.docs/html/index.html
At this point you will have all the binaries built and doxygen documentation available.
The doxygen documentation contains both Release Notes as well as the Getting Started guide. The use of doxygen 1.8.9.1 or later is required in order to generate documentation correctly.