当前位置：首页 > news >正文

Ubuntu 22 安装 Apache Doris 3.0.3 笔记

news 2025/7/13 0:50:09

Ubuntu 22 安装 Apache Doris 3.0.3 笔记

1. 环境准备

Doris 需要 Java 17 作为运行环境，所以首先需要安装 Java 17。

sudo apt-get install openjdk-17-jdk -y
sudo update-alternatives --config java

在安装 Java 17 后，可以通过 sudo update-alternatives --config java 命令选择 Java 版本并查看 JAVA_HOME 环境变量的路径。我们需要记下这个路径，因为后面配置 Doris 时会用到。

2. 下载 Apache Doris 文件

接下来，我们需要下载 Doris 的二进制文件。可以使用以下命令进行下载和解压：

# 下载 Apache Doris 二进制安装包
wget https://apache-doris-releases.oss-accelerate.aliyuncs.com/apache-doris-3.0.2-bin-x64.tar.gz# 解压安装包
tar zxf apache-doris-3.0.2-bin-x64.tar.gz# 重命名目录为更为简单的 apache-doris
mv apache-doris-3.0.2-bin-x64 apache-doris

3. 配置与启动 Frontend (FE) 和 Backend (BE)

修改 FE 配置并启动

首先，我们需要修改 FE 的配置文件，以确保其可以正常运行。FE 的配置文件位于 conf/fe.conf。

修改默认的 JVM 内存参数：
FE 的默认 JVM 配置可能过大，导致内存不足而无法启动。因此可以适当调整 -Xmx 和 -Xms 参数，比如：

JAVA_OPTS_FOR_JDK_17="-Dfile.encoding=UTF-8 -Djavax.security.auth.useSubjectCredsOnly=false -Xmx2048m -Xms1024m -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=$LOG_DIR -Xlog:gc*:$LOG_DIR/fe.gc.log.$CUR_DATE:time,uptime:filecount=10,filesize=50M --add-opens=java.base/java.nio=ALL-UNNAMED --add-opens java.base/jdk.internal.ref=ALL-UNNAMED"

增加 JAVA_HOME 配置：
在 fe.conf 中设置 JAVA_HOME 路径，指向 JDK 17 的安装位置。假如 JDK 17 位于 /usr/lib/jvm/java-17-openjdk-amd64，则设置如下：
```
# Set your own JAVA_HOME
JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
```
修改 FE 监听的网段：
如果 FE 有多个网段，可以在 fe.conf 中设置 priority_networks，例如：
```
priority_networks = 192.168.1.0/16
```
启动 FE：
进入 apache-doris/fe/bin 目录，运行以下命令启动 FE：
```
./start_fe.sh --daemon
```
FE 启动后，可以查看日志确认是否启动成功：
```
tail -f ../log/fe.log
```

修改 BE 配置并启动

接下来是 BE 的配置。BE 的配置文件位于 conf/be.conf，需要进行以下修改：

和 FE 一样，增加 JAVA_HOME 配置：

# Set your own JAVA_HOME
JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64

修改 BE 的 JVM 配置：
同样地，适当调整 -Xmx 和 -Xms 参数：
```
JAVA_OPTS="-Xmx2048m -Xms1024m"
```
启动 BE：
进入 apache-doris/be/bin 目录，运行以下命令启动 BE：
```
./start_be.sh --daemon
```
同样可以通过查看日志来确认 BE 是否启动成功：
```
tail -f ../log/be.out
```

4. 安装 MySQL 客户端

为了连接和操作 Doris，我们需要安装 MySQL 客户端。可以使用以下命令进行安装：

sudo apt install mysql-client-core-8.0

5. 连接 FE 并添加 BE

安装好 MySQL 客户端后，我们可以连接到 FE，并将 BE 添加到集群中，以完成 Doris 集群的基础配置。使用以下命令进行连接：

mysql -h <fe_host> -P 9030 -u root

在进入 MySQL 客户端后，可以执行相应的 SQL 命令来添加 BE 节点：

ALTER SYSTEM ADD BACKEND "be_host_ip:heartbeat_service_port";

be_host_ip：要添加 BE 的 IP 地址

heartbeat_service_port：要添加 BE 的心跳上报端口，可以查看 be.conf 里的 heartbeat_service_port，默认是 9050。

通过 show backends; 语句可以查看新添加的 BE 节点。

6. 修改账号密码

为了安全起见，建议修改 Doris 默认的 root 账号密码。可以使用以下 SQL 语句来完成：

mysql> SET PASSWORD FOR 'root' = PASSWORD('doris-root-password');
Query OK, 0 rows affected (0.01 sec)
mysql> SET PASSWORD FOR 'admin' = PASSWORD('doris-admin-password');
Query OK, 0 rows affected (0.00 sec)

Root 用户和 Admin 用户的区别

Root 用户和 Admin 用户都属于 Apache Doris 安装完默认存在的 2 个账户。其中 Root 用户拥有整个集群的超级权限，可以对集群完成各种管理操作，比如添加节点，去除节点。Admin 用户没有管理权限，是集群中的 Superuser，拥有除集群管理相关以外的所有权限。建议只有在需要对集群进行运维管理超级权限时才使用 Root 权限。