单机安装及部署Doris3.0.2（最新最全超级详细图文解说）

已于 2025-04-15 23:10:48 修改
阅读量1.3k 收藏 26
点赞数 32
分类专栏： 大数据 文章标签： 数据库 大数据
于 2025-03-20 20:44:25 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_36467887/article/details/146401005
版权

官网手动部署 - Apache Doris

一、安装包下载

官方下载链接地址：Release 3.0.2 - Apache Doris

二、环境准备

（命令是在root用户下执行，如果不是root用户请在命令前面加上sudo）

1、系统要求

配置要求

  •  centos7.0及以上

  • 推荐配置：4核CPU / 8GB内存 / 100GB硬盘（我用了这个配置FB启动没成功，后来改成8核16g就没问题）

  • 确保已安装 wget, tar, java,mysql等基础工具

安装java

Doris 的所有进程都依赖 Java。

在 2.1（含）版本之前，请使用 Java 8，推荐版本：openjdk-8u352-b08-linux-x64。

从 3.0（含）版本之后，请使用 Java 17，推荐版本：jdk-17.0.10_linux-x64_bin.tar.gz。

  • 在线下载java17
yum -y install wget
#下载java
wget https://download.oracle.com/java/17/archive/jdk-17.0.10_linux-x64_bin.tar.gz
  • 解压jdk
tar -xzf jdk-17.0.10_linux-x64_bin.tar.gz
#移动到合适的位置
mv jdk-17.0.10 /data/java
  • 设置JAVA_HOME环境变量
vi /etc/profile

 添加

export JAVA_HOME=/data/java/jdk-17.0.10

export PATH=$JAVA_HOME/bin:$PATH

export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

  •    更新profile文件使命令生效
source /etc/profile
  • 验证安装是否成功
java -version

安装MySQL

参考文档：【MySQL】在CentOS7环境下----手把手教你安装MySQL详细教程(附带图例详解！！)_centos7 mysql-CSDN博客

2、系统检查

关闭 swap 分区​

在部署 Doris 时，建议关闭 swap 分区。swap 分区是内核发现内存紧张时，会按照自己的策略将部分内存数据移动到配置的 swap 分区，由于内核策略不能充分了解应用的行为，会对数据库性能造成较大影响。所以建议关闭。

通过以下命令可以临时或者永久关闭。

临时关闭，下次机器启动时，swap 还会被打开。

swapoff -a

永久关闭，使用 Linux root 账户，注释掉 /etc/fstab 中的 swap 分区，然后重启即可彻底关闭 swap 分区。

sed -i '/swap/s/^/#/' /etc/fstab
# /etc/fstab
# <file system>        <dir>         <type>    <options>             <dump> <pass>
tmpfs                  /tmp          tmpfs     nodev,nosuid          0      0
/dev/sda1              /             ext4      defaults,noatime      0      1
# /dev/sda2              none          swap      defaults              0      0
/dev/sda3              /home         ext4      defaults,noatime      0      2

警告：不建议使用设置 vm.swappiness = 0 的方式，因为这个参数在不同的 Linux 内核版本会有不同的语义，很多情况下不能完全关闭 swap。

检测和关闭系统防火墙​

如果发现端口不通，可以试着关闭防火墙，确认是否是本机防火墙造成。如果是防火墙造成，可以根据配置的 Doris 各组件端口打开相应的端口通信。

#关闭防火墙
systemctl stop firewalld.service
#开机关闭防火墙
systemctl disable firewalld.service
#重启网络
systemctl restart network.service
#查看防火墙状态
systemctl status firewalld.service

配置 NTP 服务​

Doris 的元数据要求时间精度要小于 5000ms，所以所有集群所有机器要进行时钟同步，避免因为时钟问题引发的元数据不一致导致服务出现异常。

通常情况下，可以通过配置 NTP 服务保证各节点时钟同步。

#如果没有安装ntp 则 yum -y install ntp
systemctl start ntpd.service
systemctl enable ntpd.service

设置系统最大打开文件句柄数​

Doris 由于依赖大量文件来管理表数据，所以需要将系统对程序打开文件数的限制调高。

vi /etc/security/limits.conf 
* soft nofile 1000000
* hard nofile 1000000

修改虚拟内存区域数量为​

修改虚拟内存区域至少 2000000

sysctl -w vm.max_map_count=2000000

关闭透明大页​

在部署 Doris 时，建议关闭透明大页。

echo never > /sys/kernel/mm/transparent_hugepage/enabled
echo never > /sys/kernel/mm/transparent_hugepage/defrag

执行生效 

sysctl -p

三、部署doris

1、解压安装包

用xshell把下载下来的安装包放到/data/doris（自己创建的目录下）

cd /data/doris
tar -xzf apache-doris-3.0.2-bin-x64.tar.gz

2、部署FE

修改FE配置文件

vi /data/doris/apache-doris-3.0.2-bin-x64/fe/conf/fe.conf

增加内容如下：

#java_home java的路径

JAVA_HOME=/opt/java/jdk-17.0.10

#网段按照实际情况，如服务器的IP是192.168.3.36，那么网关就是192.168.3.0

priority_networks = 192.168.3.0/24

#元数据存储目录（自己创建 mkdir/data/doris/doris-meta）
meta_dir = /data/doris/doris-meta

启动FE

加上--daemon 后台启动

/data/doris/apache-doris-3.0.2-bin-x64/fe/bin/start_fe.sh --daemon

############备注：首次启动可先在当前目录下启动

cd /data/doris/apache-doris-3.0.2-bin-x64/fe/bin
./start_be.sh

 #####################

验证 FE 状态

# 通过 MySQL 客户端连接 看是否能连接成功
mysql -h 127.0.0.1 -P 9030 -uroot

3、部署BE

修改BE配置文件

vi /data/doris/apache-doris-3.0.2-bin-x64/be/conf/be.conf
storage_root_path是数据存储目录（需自己创建 mkdir /data/doris/doris-storage）

JAVA_HOME=/opt/java/jdk-17.0.10
priority_networks = 192.168.3.0/24
storage_root_path = /data/doris/doris-storage

启动BE

cd /data/doris/apache-doris-3.0.2-bin-x64/be/bin
./start_be.sh --daemon

四、集群管理

1、将BE添加到FE

# 使用 MySQL 客户端连接 FE
mysql -h 127.0.0.1 -P 9030 -uroot

# 添加 BE 节点
ALTER SYSTEM ADD BACKEND "127.0.0.1:9050";

2、验证节点状态 

SHOW PROC '/backends'\G
-- 检查 `Alive` 字段为 `true`

五、验证部署

1、创建测试库和表

CREATE DATABASE test_db;
USE test_db;

CREATE TABLE example_table (
    id INT,
    name VARCHAR(50)
) ENGINE=OLAP
DUPLICATE KEY(id)
DISTRIBUTED BY HASH(id) BUCKETS 10
PROPERTIES (
    "replication_num" = "1"  -- 关键：因为是单机部署只有一个副本，设置副本数为1
);


INSERT INTO example_table VALUES (1, 'Doris');
SELECT * FROM example_table;

2、检查服务状态

# 查看 FE 和 BE 进程
jps  # 应看到 PaloFe 和 PaloBe 进程

以上单机部署doris服务成功

3、修改密码

mysql> SET PASSWORD FOR 'root' = PASSWORD('doris-root-password');    
#doris-root-password  这个是自己要设置的密码

4、停止服务

cd /data/doris/apache-doris-3.0.2-bin-x64
#停掉fe
./fe/bin/stop_fe.sh
#停掉be
./be/bin/stop_be.sh

六、部署fs_broker

Broker 以插件的形式，独立于 Doris 部署。如果需要从第三方存储系统导入数据，需要部署相应的 Broker，例如读取 HDFS。

cd /data/doris/
#重命名
mv apache-doris-3.0.2-bin-x64 apache-doris
#到 extensions目录下
cd /data/doris/apache-doris/extensions
#把apache_hdfs_broker移动到fe目录下
mv apache_hdfs_broker/ /data/doris/apache-doris/fe/
启动broker
/data/doris/apache-doris/fe/apache_hdfs_broker/bin/start_broker.sh --daemon

# 使用 MySQL 客户端连接 FE （前提已启动FE）

mysql -h 127.0.0.1 -P 9030 -uroot -p123456
# 添加 borker 节点
ALTER SYSTEM ADD BROKER broker_name "127.0.0.1:8000";
mysql> SHOW PROC "/brokers";

 

查看服务进程 jps

七、客户端连接doris

能连接mysql的客户端都可以

下图是datagrip连接

八、修改主机名并重启服务

1、修改虚拟机主机名

hostnamectl set-hostname doris01

修改hosts文件 

vi /etc/hosts

#末端添加一行
192.168.111.32 doris01

然后重启系统，使其生效

reboot

2、修改主机C盘的hosts文件
默认位置C:\Windows\System32\drivers\etc\hosts     

末尾加上一行

192.168.111.32 doris01

修改关闭文件后，需要刷新DNS缓存才能使新的映射关系生效。

在Windows系统中，可以按下Win+R键，打开运行窗口，输入命令“ipconfig /flushdns”并回车执行。

ipconfig /flushdns

以上ip设置完毕！

3、修改Doris配置并重启服务

开启doris服务并通过mysql客户端进入FE

#进入doris的fe
mysql -h doris01 -P 9030 -uroot -p123456


下线BE节点

#下线BE节点
ALTER SYSTEM DECOMMISSION BACKEND "127.0.0.1:9050";

停止BE服务和broker服务

cd /data/doris/apache-doris
./be/bin/stop_be.sh
./fe/apache_hdfs_broker/bin/stop_broker.sh

从 FE 节点移除 BE 信息和broker信息‌，避免重启后自动注册，然后再添加新的BE节点和broker节点

mysql -h doris01 -P 9030 -uroot -p123456

#删除旧BE节点
ALTER SYSTEM DROPP BACKEND "127.0.0.1:9050"; 
#添加新BE节点
ALTER SYSTEM ADD BACKEND "doris01:9050"; 
#查看BE节点情况
SHOW PROC '/backends'\G;

#删除旧broker
ALTER SYSTEM DROP BROKER broker_name "127.0.0.1:8000"; 
#添加新的borker节点
ALTER SYSTEM ADD BROKER broker01 "doris01:8000"; 
#查看borker节点情况
SHOW PROC "/brokers" \G;

清理 BE 节点文件

#BE存储文件(如果有重要数据记得备份)
cd /data/doris/doris-storage
#删除
rm -rf *

重启服务！

Doris单机安装
gaojingsong的专栏
08-12 1029
取消priority_networks的注释，修改参数。# 取消priority_networks的注释，修改参数。export DORIS_HOME=Doris目录。# 配置FE-Config。# 配置BE-Config。
【云原生】docker 部署 Doris 数据库使用详解
热门推荐
congge
09-08 1万+
docker 部署 Doris 数据库使用详解
Apache Doris单机快速安装（已踩坑）
core815的专栏
06-13 3744
环境：操作系统：CentOS7.6 X86_64。
datasophon1.2.1集成Doris3.0.2版本升级手册
m0_37834192的博客
11-26 1144
基于Rocky Linux 系统对DataSophon集成高版本Doris3.0.2
Doris单机安装部署
少说，多做
07-12 4948
Apache Doris 是一个基于 MPP 架构的高性能、实时的分析型数据库，以极速易用的特点被人们所熟知，仅需亚秒级响应时间即可返回海量数据下的查询结果，不仅可以支持高并发的点查询场景，也能支持高吞吐的复杂分析场景。基于此，Apache Doris 能够较好的满足报表分析、即席查询、统一数仓构建、数据湖联邦查询加速等使用场景，用户可以在此之上构建用户行为分析、AB 实验平台、日志检索分析、用户画像分析、订单分析等应用。
Doris的单机部署与安装
mmdewhite的博客
04-11 4088
单节点的doris安装部署
Apache-Doris单机部署
CCH2024的专栏
05-28 1814
Apache-Doris单机部署
Docker单机部署Doris超详细图文教程
shy的博客
11-15 2596
Docker部署Doris超详细图文教程
docker部署单机版doris
xgysimida的博客
11-26 1035
应项目测试需求，需使用docker部署单机版doris。
doris5.0安装教程
04-14
由于doris5.0.3的版本问题过多，使用非常不方便，没有doris5.0版本稳定，故推荐安装5.0版本
Apache Doris系列之：安装与部署详细步骤
zhengzaifeidelushang的博客
07-29 1982
使用mysql-client连接启动的FE，执行以下命令ALTERSYSTEMADDBROKERbroker_name“broker_host1broker_ipc_port1”,“broker_host2broker_ipc_port2”,…当BE在汇报任务完成信息时，会携带自己的IP地址。如果不在[min_file_descriptor_number,max_file_descriptor_number]区间内，BE进程启动会出错，可以使用ulimit进行设置。...
doris的单节点安装部署(详细)
qq_43688472的博客
10-25 3049
官网网址：https://doris.apache.org/zh-CN/docs/dev/get-starting/quick-start。这个参数我们在安装的时候是必须要配置的，特别是当一台机器拥有多个IP地址的时候，我们要为 FE 指定唯一的IP地址。进入doris下的fe目录，修改其中conf目录下的fe.conf文件。进入doris下的be目录，修改其中conf目录下的be.conf文件。在 FE 安装目录下执行下面的命令，来完成 FE 的启动。Doris FE 的停止可以通过下面的命令完成。
Doris--基础--2.3--部署--单机部署
zhou920786312的博客
03-05 1481
单机部署Doris创建数据库、数据表、导入数据及查询。
Doris单机部署——2.0.1.1版本
雷神乐乐的博客
11-26 4279
Doris单机部署——2.0.1.1版本
抛弃Docker：十分钟完成单机部署大数据实时数仓数据库Doris
最新发布
遇码开源社区
03-11 973
事情是这样的，当我写了一篇《五分钟部署Doris的极简部署流程》后，有很多同学向我反馈说Docker无法访问。怎么说呢，这是一个无法言说的事实（科学上网可以减少信息差）。但是对于同学们无限的求知欲，怎么可以让一个小小的Docker给难倒呢。本文将给大家介绍不依赖Docker，如何单机完成部署Doris。
Doris简介及单机部署(超详细)
bacawa的博客
01-30 4075
Doris简介及单机部署教程，超级详细，希望能帮助到各位coder
doris（一）单节点部署
Interest1_wyt的博客
10-16 4537
doris单节点FE BE快速部署
doris安装部署单机版
01-18
### Doris 单机版安装部署教程 #### 准备工作 为了成功完成 Apache Doris 的单机版本安装，环境需准备好 MySQL、JDK 和 Doris 安装包。MySQL 和 JDK 的安装过程在此不作赘述[^1]。 #### 下载并解压安装包 前往官方页面获取最新稳定版的 Apache Doris 安装文件，并将其下载到本地计算机上[^3]。接着，对下载好的压缩文件进行解压操作。对于 Linux 用户来说，这通常意味着使用 `tar` 或者 `unzip` 工具来解开 tarball 文件或是 ZIP 归档文件。 ```bash tar -zxvf apache-doris-x.x.x-bin.tar.gz cd apache-doris-x.x.x/ ``` #### 配置与启动服务 进入解压后的目录后，按照官方文档中的指导配置必要的参数设置。由于这是针对单节点测试用途的简易搭建方式，大多数情况下默认配置已经足够满足需求。完成后即可依次启动 FE (Frontend) 及 BE (Backend) 组件： ```bash # 启动 Frontend 节点 bin/start_fe.sh --daemon # 启动 Backend 节点 bin/start_be.sh --daemon ``` 等待一段时间让各组件初始化完毕之后，可以通过访问日志确认它们是否正常运行。 #### 使用客户端连接至 Doris 当所有必要组件均已就绪，便能通过之前提到的方法利用 MySQL 客户端尝试建立连接了。确保路径指向正确的 MySQL 客户端可执行程序位置，并指定好目标主机地址及监听端口等信息[^4]。 ```bash mysql -uroot -P9030 -h127.0.0.1 ``` 此时应该能够顺利接入到刚设立起来的 Apache Doris 实例当中去。
评论 4
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

木芫

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值