【StoneDB Class】入门第三课：StoneDB的编译安装

本课程主要介绍 StoneDB-5.6 在 Ubuntu 20.04 LTS 下的手动编译，在 CentOS 和 RedHat 的编译详见官方文档。
如果想快速部署，详见官方文档
https://stonedb.io/zh/docs/getting-started/quick-deployment
编译工具以及第三方库的版本要求如下。
编译工具及第三方库版本要求gcc9.4.0make3.82cmake3.7.2marisa0.77rocksdb6.12.6boost1.66第一步：安装依赖包

注：依赖包必须都装上，否则后面有很多报错。

1. sudo apt install -y gcc
2. sudo apt install -y g++
3. sudo apt install -y make
4. sudo apt install -y cmake
5. sudo apt install -y build-essential
6. sudo apt install -y autoconf
7. sudo apt install -y tree
8. sudo apt install -y bison
9. sudo apt install -y git
10. sudo apt install -y libtool
11. sudo apt install -y numactl
12. sudo apt install -y python3-dev
13. sudo apt install -y openssl
14. sudo apt install -y perl
15. sudo apt install -y binutils
16. sudo apt install -y libgmp-dev
17. sudo apt install -y libmpfr-dev
18. sudo apt install -y libmpc-dev
19. sudo apt install -y libisl-dev
20. sudo apt install -y zlib1g-dev
21. sudo apt install -y liblz4-dev
22. sudo apt install -y libbz2-dev
23. sudo apt install -y libzstd-dev
24. sudo apt install -y zstd
25. sudo apt install -y lz4
26. sudo apt install -y ncurses-dev
27. sudo apt install -y libsnappy-dev
28. sudo apt install -y libedit-dev
29. sudo apt install -y libaio-dev
30. sudo apt install -y libncurses5-dev
31. sudo apt install -y libreadline-dev
32. sudo apt install -y libpam0g-dev
33. sudo apt install -y zlib1g-dev
34. sudo apt install -y libicu-dev
35. sudo apt install -y libboost-dev
36. sudo apt install -y libgflags-dev
37. sudo apt install -y libjemalloc-dev
38. sudo apt install -y libssl-dev
39. sudo apt install -y pkg-config

复制代码

第二步：安装第三方库

安装第三库前需要确认 cmake 版本是3.7.2以上，make 版本是3.82以上，如果低于这两个版本，需要进行安装。StoneDB 依赖 marisa、rocksdb、boost，在编译 marisa、rocksdb、boost 时，建议指定安装路径。示例中我们指定了 marisa、rocksdb、boost 的安装路径。
1. 安装 cmake

1. wget https://cmake.org/files/v3.7/cmake-3.7.2.tar.gz
2. tar -zxvf cmake-3.7.2.tar.gz
3. cd cmake-3.7.2
4. ./bootstrap && make && make install
5. /usr/local/bin/cmake --version
6. apt remove cmake -y
7. ln -s /usr/local/bin/cmake /usr/bin/
8. cmake --version

复制代码

2. 安装 make

1. wget http://mirrors.ustc.edu.cn/gnu/make/make-3.82.tar.gz
2. tar -zxvf make-3.82.tar.gz
3. cd make-3.82
4. ./configure  --prefix=/usr/local/make
5. make && make install
6. rm -rf /usr/local/bin/make
7. ln -s /usr/local/make/bin/make /usr/local/bin/make
8. make --version

复制代码

3. 安装 marisa

1. git clone https://github.com/s-yata/marisa-trie.git
2. cd marisa-trie
3. autoreconf -i
4. ./configure --enable-native-code --prefix=/usr/local/stonedb-marisa
5. sudo make && make install

复制代码

marisa 的安装路径可以根据实际情况指定，示例中的安装路径是 /usr/local/stonedb-marisa。此步骤会在 /usr/local/stonedb-marisa/lib 下生成如下目录和文件。

4. 安装 rocksdb

1. wget https://github.com/facebook/rocksdb/archive/refs/tags/v6.12.6.tar.gz
2. tar -zxvf v6.12.6.tar.gz
3. cd rocksdb-6.12.6
5. sudo cmake ./ \
6.   -DCMAKE_BUILD_TYPE=Release \
7.   -DCMAKE_INSTALL_PREFIX=/usr/local/stonedb-gcc-rocksdb \
8.   -DCMAKE_INSTALL_LIBDIR=/usr/local/stonedb-gcc-rocksdb \
9.   -DWITH_JEMALLOC=ON \
10.   -DWITH_SNAPPY=ON \
11.   -DWITH_LZ4=ON \
12.   -DWITH_ZLIB=ON \
13.   -DWITH_ZSTD=ON \
14.   -DUSE_RTTI=ON \
15.   -DROCKSDB_BUILD_SHARED=ON \
16.   -DWITH_GFLAGS=OFF \
17.   -DWITH_TOOLS=OFF \
18.   -DWITH_BENCHMARK_TOOLS=OFF \
19.   -DWITH_CORE_TOOLS=OFF
21. sudo make -j`nproc`
22. sudo make install -j`nproc`

复制代码

rocksdb 的安装路径可以根据实际情况指定，示例中的安装路径是 /usr/local/stonedb-gcc-rocksdb。此步骤会在 /usr/local/stonedb-gcc-rocksdb 下生成如下目录和文件。

5. 安装 boost

1. wget https://sourceforge.net/projects/boost/files/boost/1.66.0/boost_1_66_0.tar.gz/download
2. tar -zxvf boost_1_66_0.tar.gz
3. cd boost_1_66_0
4. ./bootstrap.sh --prefix=/usr/local/stonedb-boost
5. ./b2 install --with=all

复制代码

boost 的安装路径可以根据实际情况指定，示例中的安装路径是 /usr/local/stonedb-boost。此步骤会在 /usr/local/stonedb-boost/lib 下生成如下目录和文件。

...
注：在编译过程中，除非有关键字 "error" 报错自动退出，否则出现关键字 "warning"、"failed"是正常的，安装 boost 大概需要25分钟左右。
第三步：执行编译

StoneDB 现有 5.6 和 5.7 两个分支，下载的源码包默认是 5.7 分支。下载的源码包存放路径可根据实际情况指定，示例中的源码包存放路径是在根目录下，并且是切换为 5.6 分支的编译安装。

1. cd /
2. git clone https://github.com/stoneatom/stonedb.git
3. cd stonedb
4. git checkout remotes/origin/stonedb-5.6

复制代码

在执行编译脚本前，需要修改编译脚本的两处内容：
1）StoneDB 安装目录，可根据实际情况修改，示例中的安装目录是 /stonedb56/install；
2）marisa、rocksdb、boost 的实际安装路径，必须与上文安装 marisa、rocksdb、boost 的路径保持一致。

1. ###修改编译脚本
2. cd /stonedb/scripts
3. vim stonedb_build.sh
4. ...
5. install_target=/stonedb56/install
6. ...
7. -DDOWNLOAD_BOOST=0 \
8. -DWITH_BOOST=/usr/local/stonedb-boost/ \
9. -DWITH_MARISA=/usr/local/stonedb-marisa \
10. -DWITH_ROCKSDB=/usr/local/stonedb-gcc-rocksdb \
11. 2>&1 | tee -a ${build_log}
13. ###执行编译脚本
14. sh stonedb_build.sh

复制代码

注：如果是 CentOS/RedHat ，需要注释 os_dist 和 os_dist_release，并且修改 build_tag ，这是因为 "lsb_release -a" 返回的结果中，Distributor、Release、Codename 显示的是 n/a。注释 os_dist 和 os_dist_release 只会影响产生的日志名和 tar 包名，不会影响编译结果。
第四步：启动实例

按照以下步骤启动 StoneDB。
1. 创建用户

1. groupadd mysql
2. useradd -g mysql mysql
3. passwd mysql

复制代码

2. 手动安装

编译完成后，如果 StoneDB 安装目录不是 /stonedb56，不会自动生成 reinstall.sh、install.sh 和 my.cnf 文件，需要手动创建目录、初始化和启动实例。还需要配置 my.cnf 文件，如安装目录，端口等参数。

1. ###创建目录
2. mkdir -p /data/stonedb56/install/data/innodb
3. mkdir -p /data/stonedb56/install/binlog
4. mkdir -p /data/stonedb56/install/log
5. mkdir -p /data/stonedb56/install/tmp
6. chown -R mysql:mysql /data
8. ###配置my.cnf
9. [mysqld]
10. vim /data/stonedb56/install/my.cnf
11. port      = 3306
12. socket    = /data/stonedb56/install/tmp/mysql.sock
13. datadir   = /data/stonedb56/install/data
14. pid-file  = /data/stonedb56/install/data/mysqld.pid
15. log-error = /data/stonedb56/install/log/mysqld.log
17. chown -R mysql:mysql /data/stonedb56/install/my.cnf
19. ###初始化实例
20. /data/stonedb56/install/scripts/mysql_install_db --datadir=/data/stonedb56/install/data --basedir=/data/stonedb56/install --user=mysql
22. ###启动实例
23. /data/stonedb56/install/bin/mysqld_safe --defaults-file=/data/stonedb56/install/my.cnf --user=mysql &

复制代码

3. 自动安装

编译完成后，如果 StoneDB 安装目录是 /stonedb56，会自动生成 reinstall.sh、install.sh 和 my.cnf 文件，执行 reinstall.sh 就是创建目录、初始化实例和启动实例的过程。

1. cd /stonedb56/install
2. ./reinstall.sh

复制代码

注：reinstall.sh 与 install.sh 的区别？
reinstall.sh 是自动化安装脚本，执行脚本的过程是创建目录、初始化实例和启动实例的过程，只在第一次使用，其他任何时候使用都会删除整个目录，重新初始化数据库。install.sh 是手动安装提供的示例脚本，用户可根据自定义的安装目录修改路径，然后执行脚本，执行脚本的过程也是创建目录、初始化实例和启动实例。以上两个脚本都只能在第一次使用。
4. 执行登录

1. /stonedb56/install/bin/mysql -uroot -p -S /stonedb56/install/tmp/mysql.sock
2. Enter password:
3. Welcome to the MySQL monitor.  Commands end with ; or \g.
4. Your MySQL connection id is 2
5. Server version: 5.6.24-StoneDB-debug build-
7. Copyright (c) 2000, 2022 StoneAtom Group Holding Limited
8. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
10. mysql> show databases;
11. +--------------------+
12. | Database           |
13. +--------------------+
14. | information_schema |
15. | cache              |
16. | innodb             |
17. | mysql              |
18. | performance_schema |
19. | sys_stonedb        |
20. | test               |
21. +--------------------+
22. 7 rows in set (0.00 sec)

复制代码

大家也可以看B站视频学习完整的安装流程：【StoneDB Class】入门第三课：StoneDB的编译安装
关于StoneDB的任何问题，都可以加我V咨询：StoneDB_2022 。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！