本课程次要介绍 StoneDB-5.6 在 Ubuntu 20.04 LTS 下的手动编译，在 CentOS 和 RedHat 的编译详见官网文档。
如果想疾速部署，详见官网文档
https://stonedb.io/zh/docs/getting-started/quick-deployment
编译工具以及第三方库的版本要求如下。
| 编译工具及第三方库 | 版本要求 |
|---|---|
| gcc | 9.4.0 |
| make | 3.82 |
| cmake | 3.7.2 |
| marisa | 0.77 |
| rocksdb | 6.12.6 |
| boost | 1.66 |
第一步：装置依赖包
注：依赖包必须都装上，否则前面有很多报错。
sudo apt install -y gccsudo apt install -y g++sudo apt install -y makesudo apt install -y cmakesudo apt install -y build-essentialsudo apt install -y autoconfsudo apt install -y treesudo apt install -y bisonsudo apt install -y gitsudo apt install -y libtoolsudo apt install -y numactlsudo apt install -y python3-devsudo apt install -y opensslsudo apt install -y perlsudo apt install -y binutilssudo apt install -y libgmp-devsudo apt install -y libmpfr-devsudo apt install -y libmpc-devsudo apt install -y libisl-devsudo apt install -y zlib1g-devsudo apt install -y liblz4-devsudo apt install -y libbz2-devsudo apt install -y libzstd-devsudo apt install -y zstdsudo apt install -y lz4sudo apt install -y ncurses-devsudo apt install -y libsnappy-devsudo apt install -y libedit-devsudo apt install -y libaio-devsudo apt install -y libncurses5-dev sudo apt install -y libreadline-devsudo apt install -y libpam0g-devsudo apt install -y zlib1g-devsudo apt install -y libicu-devsudo apt install -y libboost-devsudo apt install -y libgflags-devsudo apt install -y libjemalloc-devsudo apt install -y libssl-devsudo apt install -y pkg-config第二步：装置第三方库
装置第三库前须要确认 cmake 版本是3.7.2以上，make 版本是3.82以上，如果低于这两个版本，须要进行装置。StoneDB 依赖 marisa、rocksdb、boost，在编译 marisa、rocksdb、boost 时，倡议指定装置门路。示例中咱们指定了 marisa、rocksdb、boost 的装置门路。
1. 装置 cmake
wget https://cmake.org/files/v3.7/cmake-3.7.2.tar.gztar -zxvf cmake-3.7.2.tar.gzcd cmake-3.7.2./bootstrap && make && make install/usr/local/bin/cmake --versionapt remove cmake -yln -s /usr/local/bin/cmake /usr/bin/cmake --version2. 装置 make
wget http://mirrors.ustc.edu.cn/gnu/make/make-3.82.tar.gztar -zxvf make-3.82.tar.gzcd make-3.82./configure --prefix=/usr/local/makemake && make installrm -rf /usr/local/bin/makeln -s /usr/local/make/bin/make /usr/local/bin/makemake --version3. 装置 marisa
git clone https://github.com/s-yata/marisa-trie.gitcd marisa-trieautoreconf -i./configure --enable-native-code --prefix=/usr/local/stonedb-marisasudo make && make installmarisa 的装置门路能够依据理论状况指定，示例中的装置门路是 /usr/local/stonedb-marisa。此步骤会在 /usr/local/stonedb-marisa/lib 下生成如下目录和文件。
4. 装置 rocksdb
wget https://github.com/facebook/rocksdb/archive/refs/tags/v6.12.6.tar.gz tar -zxvf v6.12.6.tar.gzcd rocksdb-6.12.6sudo cmake ./ \ -DCMAKE_BUILD_TYPE=Release \ -DCMAKE_INSTALL_PREFIX=/usr/local/stonedb-gcc-rocksdb \ -DCMAKE_INSTALL_LIBDIR=/usr/local/stonedb-gcc-rocksdb \ -DWITH_JEMALLOC=ON \ -DWITH_SNAPPY=ON \ -DWITH_LZ4=ON \ -DWITH_ZLIB=ON \ -DWITH_ZSTD=ON \ -DUSE_RTTI=ON \ -DROCKSDB_BUILD_SHARED=ON \ -DWITH_GFLAGS=OFF \ -DWITH_TOOLS=OFF \ -DWITH_BENCHMARK_TOOLS=OFF \ -DWITH_CORE_TOOLS=OFF sudo make -j`nproc`sudo make install -j`nproc`rocksdb 的装置门路能够依据理论状况指定，示例中的装置门路是 /usr/local/stonedb-gcc-rocksdb。此步骤会在 /usr/local/stonedb-gcc-rocksdb 下生成如下目录和文件。
5. 装置 boost
wget https://sourceforge.net/projects/boost/files/boost/1.66.0/boost_1_66_0.tar.gz/downloadtar -zxvf boost_1_66_0.tar.gzcd boost_1_66_0./bootstrap.sh --prefix=/usr/local/stonedb-boost./b2 install --with=allboost 的装置门路能够依据理论状况指定，示例中的装置门路是 /usr/local/stonedb-boost。此步骤会在 /usr/local/stonedb-boost/lib 下生成如下目录和文件。
...
注：在编译过程中，除非有关键字 "error" 报错主动退出，否则呈现关键字 "warning"、"failed"是失常的，装置 boost 大略须要25分钟左右。
第三步：执行编译
StoneDB 现有 5.6 和 5.7 两个分支，下载的源码包默认是 5.7 分支。下载的源码包寄存门路可依据理论状况指定，示例中的源码包寄存门路是在根目录下，并且是切换为 5.6 分支的编译装置。
cd /git clone https://github.com/stoneatom/stonedb.gitcd stonedbgit checkout remotes/origin/stonedb-5.6在执行编译脚本前，须要批改编译脚本的两处内容：
1）StoneDB 装置目录，可依据理论状况批改，示例中的装置目录是 /stonedb56/install；
2）marisa、rocksdb、boost 的理论装置门路，必须与上文装置 marisa、rocksdb、boost 的门路保持一致。
###批改编译脚本cd /stonedb/scriptsvim stonedb_build.sh...install_target=/stonedb56/install...-DDOWNLOAD_BOOST=0 \-DWITH_BOOST=/usr/local/stonedb-boost/ \-DWITH_MARISA=/usr/local/stonedb-marisa \-DWITH_ROCKSDB=/usr/local/stonedb-gcc-rocksdb \2>&1 | tee -a ${build_log}###执行编译脚本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. 创立用户
groupadd mysqluseradd -g mysql mysqlpasswd mysql2. 手动装置
编译实现后，如果 StoneDB 装置目录不是 /stonedb56，不会主动生成 reinstall.sh、install.sh 和 my.cnf 文件，须要手动创立目录、初始化和启动实例。还须要配置 my.cnf 文件，如装置目录，端口等参数。
###创立目录mkdir -p /data/stonedb56/install/data/innodbmkdir -p /data/stonedb56/install/binlogmkdir -p /data/stonedb56/install/logmkdir -p /data/stonedb56/install/tmpchown -R mysql:mysql /data###配置my.cnf[mysqld]vim /data/stonedb56/install/my.cnfport = 3306socket = /data/stonedb56/install/tmp/mysql.sockdatadir = /data/stonedb56/install/datapid-file = /data/stonedb56/install/data/mysqld.pidlog-error = /data/stonedb56/install/log/mysqld.logchown -R mysql:mysql /data/stonedb56/install/my.cnf###初始化实例/data/stonedb56/install/scripts/mysql_install_db --datadir=/data/stonedb56/install/data --basedir=/data/stonedb56/install --user=mysql###启动实例/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 就是创立目录、初始化实例和启动实例的过程。
cd /stonedb56/install./reinstall.sh注：reinstall.sh 与 install.sh 的区别？
reinstall.sh 是自动化装置脚本，执行脚本的过程是创立目录、初始化实例和启动实例的过程，只在第一次应用，其余任何时候应用都会删除整个目录，从新初始化数据库。install.sh 是手动装置提供的示例脚本，用户可依据自定义的装置目录批改门路，而后执行脚本，执行脚本的过程也是创立目录、初始化实例和启动实例。以上两个脚本都只能在第一次应用。
4. 执行登录
/stonedb56/install/bin/mysql -uroot -p -S /stonedb56/install/tmp/mysql.sockEnter password: Welcome to the MySQL monitor. Commands end with ; or \g.Your MySQL connection id is 2Server version: 5.6.24-StoneDB-debug build-Copyright (c) 2000, 2022 StoneAtom Group Holding LimitedType 'help;' or '\h' for help. Type '\c' to clear the current input statement.mysql> show databases;+--------------------+| Database |+--------------------+| information_schema || cache || innodb || mysql || performance_schema || sys_stonedb || test |+--------------------+7 rows in set (0.00 sec)大家也能够看B站视频学习残缺的装置流程：【StoneDB Class】入门第三课：StoneDB的编译装置
对于StoneDB的任何问题，都能够加我V征询：StoneDB_2022 。