本課程主要介紹 StoneDB-5.6 在 Ubuntu 20.04 LTS 下的手動編譯,在 CentOS 和 RedHat 的編譯詳見官方文檔。 如果想快速部署,詳見官方文檔 https://stonedb.io/zh/docs/getting-started/quick-deployment ...
本課程主要介紹 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 gcc
sudo apt install -y g++
sudo apt install -y make
sudo apt install -y cmake
sudo apt install -y build-essential
sudo apt install -y autoconf
sudo apt install -y tree
sudo apt install -y bison
sudo apt install -y git
sudo apt install -y libtool
sudo apt install -y numactl
sudo apt install -y python3-dev
sudo apt install -y openssl
sudo apt install -y perl
sudo apt install -y binutils
sudo apt install -y libgmp-dev
sudo apt install -y libmpfr-dev
sudo apt install -y libmpc-dev
sudo apt install -y libisl-dev
sudo apt install -y zlib1g-dev
sudo apt install -y liblz4-dev
sudo apt install -y libbz2-dev
sudo apt install -y libzstd-dev
sudo apt install -y zstd
sudo apt install -y lz4
sudo apt install -y ncurses-dev
sudo apt install -y libsnappy-dev
sudo apt install -y libedit-dev
sudo apt install -y libaio-dev
sudo apt install -y libncurses5-dev
sudo apt install -y libreadline-dev
sudo apt install -y libpam0g-dev
sudo apt install -y zlib1g-dev
sudo apt install -y libicu-dev
sudo apt install -y libboost-dev
sudo apt install -y libgflags-dev
sudo apt install -y libjemalloc-dev
sudo apt install -y libssl-dev
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
wget https://cmake.org/files/v3.7/cmake-3.7.2.tar.gz
tar -zxvf cmake-3.7.2.tar.gz
cd cmake-3.7.2
./bootstrap && make && make install
/usr/local/bin/cmake --version
apt remove cmake -y
ln -s /usr/local/bin/cmake /usr/bin/
cmake --version
2. 安裝 make
wget http://mirrors.ustc.edu.cn/gnu/make/make-3.82.tar.gz
tar -zxvf make-3.82.tar.gz
cd make-3.82
./configure --prefix=/usr/local/make
make && make install
rm -rf /usr/local/bin/make
ln -s /usr/local/make/bin/make /usr/local/bin/make
make --version
3. 安裝 marisa
git clone https://github.com/s-yata/marisa-trie.git
cd marisa-trie
autoreconf -i
./configure --enable-native-code --prefix=/usr/local/stonedb-marisa
sudo make && make install
marisa 的安裝路徑可以根據實際情況指定,示例中的安裝路徑是 /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.gz
cd rocksdb-6.12.6
sudo 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/download
tar -zxvf boost_1_66_0.tar.gz
cd boost_1_66_0
./bootstrap.sh --prefix=/usr/local/stonedb-boost
./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 分支的編譯安裝。
cd /
git clone https://github.com/stoneatom/stonedb.git
cd stonedb
git checkout remotes/origin/stonedb-5.6
在執行編譯腳本前,需要修改編譯腳本的兩處內容:
1)StoneDB 安裝目錄,可根據實際情況修改,示例中的安裝目錄是 /stonedb56/install;
2)marisa、rocksdb、boost 的實際安裝路徑,必須與上文安裝 marisa、rocksdb、boost 的路徑保持一致。
###修改編譯腳本
cd /stonedb/scripts
vim 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 mysql
useradd -g mysql mysql
passwd mysql
2. 手動安裝
編譯完成後,如果 StoneDB 安裝目錄不是 /stonedb56,不會自動生成 reinstall.sh、install.sh 和 my.cnf 文件,需要手動創建目錄、初始化和啟動實例。還需要配置 my.cnf 文件,如安裝目錄,埠等參數。
###創建目錄
mkdir -p /data/stonedb56/install/data/innodb
mkdir -p /data/stonedb56/install/binlog
mkdir -p /data/stonedb56/install/log
mkdir -p /data/stonedb56/install/tmp
chown -R mysql:mysql /data
###配置my.cnf
[mysqld]
vim /data/stonedb56/install/my.cnf
port = 3306
socket = /data/stonedb56/install/tmp/mysql.sock
datadir = /data/stonedb56/install/data
pid-file = /data/stonedb56/install/data/mysqld.pid
log-error = /data/stonedb56/install/log/mysqld.log
chown -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.sock
Enter password:
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 2
Server version: 5.6.24-StoneDB-debug build-
Copyright (c) 2000, 2022 StoneAtom Group Holding Limited
Type '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 。