Doris Mac 开发调试准备
安装环境依赖
brew install automake autoconf libtool pkg-config texinfo coreutils gnu-getopt \
python@3 cmake ninja ccache bison byacc gettext wget pcre maven llvm@16 openjdk@17 npm
使用 brew 安装的 jdk 版本为 17,因为在 macOS 上,arm64 版本的 brew 默认没有 8 版本的 jdk Doris 目前只支持 jdk8 和 jdk17 两个版本
依赖说明:
- Java、Maven 等可以单独下载,方便管理
- Mac 推荐 Zulu JDK8
- Maven 从 Maven 官网下载即可
- 自行下载的 Java 与 Maven 需要配置环境变量
- 其他依赖的环境变量 (示例为 Apple Silicon 芯片 Mac)
- llvm:
export PATH="/opt/homebrew/opt/llvm/bin:$PATH"
- bison:
export PATH = "/opt/homebrew/opt/bison/bin:$PATH
- texinfo:
export PATH = "/opt/homebrew/opt/texinfo/bin:$PATH
- python:
ln -s -f /opt/homebrew/bin/python3 /opt/homebrew/bin/python
- llvm:
安装 thrift
注意: 仅在只调试 FE 的情况下需要安装 thrift,同时调试 BE 和 FE 时,BE 的三方库包含 thrift
MacOS:
1. 下载:`brew install thrift@0.16.0`
2. 建立软链接:
`mkdir -p ./thirdparty/installed/bin`
# Apple Silicon 芯片 macOS
`ln -s /opt/homebrew/Cellar/thrift@0.16.0/0.16.0/bin/thrift ./thirdparty/installed/bin/thrift`
# Intel 芯片 macOS
`ln -s /usr/local/Cellar/thrift@0.16.0/0.16.0/bin/thrift ./thirdparty/installed/bin/thrift`
注:macOS 执行 `brew install thrift@0.16.0` 可能会报找不到版本的错误,解决方法如下,在终端执行:
1. `brew tap homebrew/core --force`
2. `brew tap-new $USER/local-tap`
3. `brew extract --version='0.16.0' thrift $USER/local-tap`
4. `brew install thrift@0.16.0`
参考链接: `https://gist.github.com/tonydeng/02e571f273d6cce4230dc8d5f394493c`
拉取自己的代码
-
拉取代码
cd ~
mkdir DorisDev
cd DorisDev
git clone https://github.com/GitHubID/doris.git -
设置环境变量
export DORIS_HOME=~/DorisDev/doris
export PATH=$DORIS_HOME/bin:$PATH
下载 Doris 编译依赖
-
Apache Doris Third Party Prebuilt页面有所有第三方库的源码,可以直接下载doris-thirdparty-source.tgz获得。
-
可以在Apache Doris Third Party Prebuilt页面直接下载预编译好的第三方库,省去编译第三方库的过程,参考下面的命令。
cd thirdparty
rm -rf installed
# Intel 芯片
curl -L https://github.com/apache/doris-thirdparty/releases/download/automation/doris-thirdparty-prebuilt-darwin-x86_64.tar.xz \
-o - | tar -Jxf -
# Apple Silicon 芯片
curl -L https://github.com/apache/doris-thirdparty/releases/download/automation/doris-thirdparty-prebuilt-darwin-arm64.tar.xz \
-o - | tar -Jxf -
# 保证 protoc 和 thrift 能够正常运行
cd installed/bin
./protoc --version
./thrift --version -
运行
protoc
和thrift
的时候可能会遇到无法打开,因为无法验证开发者的问题,可以到前往安全性与隐私
。点按通用
面板中的仍要打开
按钮,以确认打算打开该二进制。参考https://support.apple.com/zh-cn/HT202491。
修改系统最大文件句柄数
# bash
echo 'ulimit -n 65536' >>~/.bashrc
# zsh
echo 'ulimit -n 65536' >>~/.zshrc
编译 Doris
cd $DORIS_HOME
sh build.sh
编译过程中可能会遇到高版本的 Node.js 导致的错误
opensslErrorStack: ['error:03000086:digital envelope routines::initialization error'] library: 'digital envelope routines' reason: 'unsupported' code: 'ERR_OSSL_EVP_UNSUPPORTED' 以下命令解决问题。参考https://stackoverflow.com/questions/74726224/opensslerrorstack-error03000086digital-envelope-routinesinitialization-e
#指示Node.js使用旧版的OpenSSL提供程序
export NODE_OPTIONS=--openssl-legacy-provider
配置 Debug 环境
# 将编译好的包cp出来
cp -r output ../doris-run
# 配置FE/BE的conf
1、IP、目录
2、BE 额外配置 min_file_descriptor_number = 10000