rocksDB 安装教程

rocksDB是一个嵌入式的数据库，这里不要把它想象成MySQL这样的数据库服务了，它类似于sqlLite。我们这里是安装教程，所以对其概念以及特点不做过多概述。下面开始进入安装教程：

1. 环境准备：

服务器：CentOS Linux release 7.3.1611 (Core) 64位
g++版本：g++ (GCC) 4.8.5 20150623 (Red Hat 4.8.5-39)
cmake版本：version 3.12.0-rc1
rocksDB版本：6.4.6

2. 相关依赖：

命令行参数解析工具：gflags
这里从源码编译，如果没有安装git，需要去 https://github.com/gflags/gflags.git 下载gflags的源码包。
如果有git则直接 git clone https://github.com/gflags/gflags.git

// 1
cd gflags/src/
// 2
make && make install

压缩和解压缩的开发包：snappy

yum install snappy snappy-devel

压缩和解压缩的开发包：zlib

yum install zlib zlib-devel

基于Burrows-Wheeler 变换的无损压缩软件：bzip2

yum install bzip2 bzip2-devel

lz4压缩工具：lz4

yum install lz4-devel

Linux下内存检测工具：asan

yum install libasan

压缩工具：zstandard
获取其源码安装包，wget https://github.com/facebook/zstd/archive/v1.1.3.tar.gz 到指定目录下，然后执行如下命令：

// 1
mv v1.1.3.tar.gz zstd-1.1.3.tar.gz
// 2
tar zxvf zstd-1.1.3.tar.gz
// 3
cd zstd-1.1.3
// 4
make && make install

3. 安装rocksDB

3.1 如果已经有了rocksDB的静态库，动态库，操作如下

我们此文档中编译好的rocksDB包路径：/data/disk2/blockchain/rocksdb-6.4.6
执行如下三个操作：

// 1
cp librocksdb.so.6.4.6 /usr/local/lib
// 2
ln -s librocksdb.so.6.4.6 /usr/local/lib/librocksdb.so.6
// 3
ln -s librocksdb.so.6.4.6 /usr/local/lib/librocksdb.so

执行以上三步，就OK了。

image.png

3.2 源码安装部署rocskDB

编译过程如下：

// 1，解压rocksDB
tar -zxvf rocksdb-6.4.6.tar.gz
// 2 进入解压后的目录
cd rocksdb-6.4.6/
// 3，编译静态库，获得 librocksdb.a
make static_lib
// 4，编译动态库，获得 lbrocksdb.so
make shared_lib

然后将动态库文件copy到系统库目录下：

// 1
cp librocksdb.so.6.4.6 /usr/local/lib
// 2
ln -s librocksdb.so.6.4.6 /usr/local/lib/librocksdb.so.6
// 3
ln -s librocksdb.so.6.4.6 /usr/local/lib/librocksdb.so

4. 配置环境变量：

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib

我们最好在环境变量中添加：export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib

image.png

至此，安装完成。

5，验证安装

下面检查下是否安装成功：
rocksdbtest.cpp 测试用例如下：

#include 
#include 

#include "rocksdb/db.h"
#include "rocksdb/slice.h"
#include "rocksdb/options.h"

using namespace std;
using namespace rocksdb;

const std::string PATH = "/data/disk2/blockchain/rocksdbTemp"; //rocksDB的数据存储目录绝对路径

int main(){
    DB* db;
    Options options;
    options.create_if_missing = true;
    Status status = DB::Open(options, PATH, &db);
    assert(status.ok());
    Slice key("test01");
    Slice value("success");
    
    std::string get_value;
    status = db->Put(WriteOptions(), key, value);
    if(status.ok()){
        status = db->Get(ReadOptions(), key, &get_value);
        if(status.ok()){
            printf("value is %s\n", get_value.c_str());
        }else{
            printf("get failed\n"); 
        }
    }else{
        printf("put failed\n");
    }

    delete db;
}

编译rocksdbtest.cpp：

// 1
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib:/data/disk2/blockchain/rocksdb-6.4.6

// 2
g++ -std=c++11 -o rocksdbtest2 rocksdbtest.cpp -I /data/disk2/blockchain/rocksdb-6.4.6/include -L/data/disk2/blockchain/rocksdb-6.4.6 -lrocksdb -ldl

编译好测试用例cpp文件后，执行：./rocksdbtest
打印：value is success 说明rocksDB安装成功。