首先下载包,有源码和预编译两种包 。我这用的预编译
我的架构是3FE+7BE
首先操作系统安装要求
#设置系统最大打开文件句柄数
- vi /etc/security/limits.conf
- * soft nofile 65536
- * hard nofile 65536
时钟同步
Doris 的元数据要求时间精度要小于5000ms,所以所有集群所有机器要进行时钟同步,避免因为时钟问题引发的元数据不一致导致服务出现异常。
#关闭交换分区(swap)
Linux交换分区会给Doris带来很严重的性能问题,需要在安装之前禁用交换分区
#Liunx文件系统
推荐使用ext4文件系统,在安装操作系统的时候,请选择ext4文件系统。
- 一些FE的注意事项
-
- 1、FE 的磁盘空间主要用于存储元数据,包括日志和 image。通常从几百 MB 到几个 GB 不等。
- 2、BE 的磁盘空间主要用于存放用户数据,总磁盘空间按用户总数据量 * 3(3副本)计算,然后再预留额外 40% 的空间用作后台 compaction 以及一些中间数据的存放。
- 3、一台机器上可以部署多个 BE 实例,但是只能部署一个 FE。如果需要 3 副本数据,那么至少需要 3 台机器各部署一个 BE 实例(而不是1台机器部署3个BE实例)。多个FE所在服务器的时钟必须保持一致(允许最多5秒的时钟偏差)
- 4、FE 角色分为 Follower 和 Observer,(Leader 为 Follower 组中选举出来的一种角色,以下统称 Follower)。
- 5、FE 节点数据至少为1(1 个 Follower)。当部署 1 个 Follower 和 1 个 Observer 时,可以实现读高可用。当部署 3 个 Follower 时,可以实现读写高可用(HA)。
- 6、Follower 的数量必须为奇数,Observer 数量随意。
- 7、根据以往经验,当集群可用性要求很高时(比如提供在线业务),可以部署 3 个 Follower 和 1-3 个 Observer。如果是离线业务,建议部署 1 个 Follower 和 1-3 个 Observer。
开始部署
解压缩预编译包
- /data/apache-doris-1.0.0-incubating-bin
- ├── apache_hdfs_broker
- ├── be
- ├── CHANGE-LOG.txt
- ├── DISCLAIMER
- ├── fe
- ├── LICENSE-dist.txt
- ├── licenses
- ├── NOTICE-dist.txt
- ├── README
- └── udf
将 fe文件夹拷贝到 FE 的节点指定部署路径下并进入该目录。
FE 的配置文件 fe.conf
通常存放在 FE 部署路径的 conf/
目录下。 而在 0.14 版本中会引入另一个配置文件 fe_custom.conf
。该配置文件用于记录用户在运行是动态配置并持久化的配置项。
FE 进程启动后,会先读取 fe.conf
中的配置项,之后再读取 fe_custom.conf
中的配置项。fe_custom.conf
中的配置项会覆盖 fe.conf
中相同的配置项。
fe_custom.conf
文件的位置可以在 fe.conf
通过 custom_config_dir
配置项配置。
配置 FE
配置文件为 conf/fe.conf。其中注意:meta_dir
是元数据存放位置。默认值为 ${DORIS_HOME}/doris-meta
。需手动创建该目录。- meta_dir = /data/doris-meta
- LOG_DIR = /data/logs/doris-log
- 这里取0可以自动匹配自身ip 方便集群里都是一样的配置
- priority_networks = 172.16.99.0/24
- 增大一些连接数
- qe_max_connection = 2048
- max_conn_per_user = 1000
- qe_query_timeout_second = 600
- JAVA_OPTS="-Xmx32768m -XX:+UseMembar -XX:SurvivorRatio=8 -XX:MaxTenuringThreshold=7 -XX:+PrintGCDateStamps -XX:+PrintGCDetails -XX:+UseConcMa
- rkSweepGC -XX:+UseParNewGC -XX:+CMSClassUnloadingEnabled -XX:-CMSParallelRemarkEnabled -XX:CMSInitiatingOccupancyFraction=80 -XX:SoftRefLRUPo
- licyMSPerMB=0 -Xloggc:$DORIS_HOME/log/fe.gc.log.$DATE"
-
- 改成32g
创建日志和元数据目录
- mkdir /data/logs/doris-log
- mkdir /data/doris-meta
启动FE
- bin/start_fe.sh --daemon
- 后台启动
- 启动后可以通过
- curl http://127.0.0.1:8030/api/bootstrap
- 来查看状态
- {"msg":"success","code":0,
- 就是成功了
-
- 也可以通过数据库查询
- show proc '/frontends';
- 查看fe的状态
FE进程启动进入后台执行。日志默认存放在 log/ 目录下。如启动失败,可以通过查看 log/fe.log 或者 log/fe.out 查看错误信息。
添加两个follwoer形成HA
FE 分为 Leader,Follower 和 Observer 三种角色。 默认一个集群,只能有一个 Leader,可以有多个 Follower 和 Observer。其中 Leader 和 Follower 组成一个 Paxos 选择组,如果 Leader 宕机,则剩下的 Follower 会自动选出新的 Leader,保证写入高可用。Observer 同步 Leader 的数据,但是不参加选举。如果只部署一个 FE,则 FE 默认就是 Leader。
第一个启动的 FE 自动成为 Leader。在此基础上,可以添加若干 Follower 和 Observer。
添加 Follower 或 Observer。使用 mysql-client 连接到已启动的 FE,并执行:
- ALTER SYSTEM ADD FOLLOWER "follower_host:edit_log_port";
- 例子
- ALTER SYSTEM ADD FOLLOWER "172.16.99.80:9010";
-
- 如果添加的是Observer的话
- ALTER SYSTEM ADD OBSERVER "observer_host:edit_log_port";
- 例子
- ALTER SYSTEM ADD OBSERVER "172.16.99.80:9010";
添加完需要注意的是,第一次启动必须使用这个命令
- bin/start_fe.sh --helper leader_fe_host:edit_log_port --daemon
- 例子
- bin/start_fe.sh --helper 172.16.99.79:9010 --daemon
- 172.16.99.79就是主节点的ip
--helper 参数仅在 follower 和 observer 第一次启动时才需要。
之后就是正常的启动
bin/start_fe.sh --daemon
使用以下命令删除对应的 FE 节点:
ALTER SYSTEM DROP FOLLOWER[OBSERVER] "fe_host:edit_log_port";
FE 缩容注意事项:
- 删除 Follower FE 时,确保最终剩余的 Follower(包括 Leader)节点为奇数。
拷贝 BE 部署文件到所有要部署 BE 的节点
将源码编译生成的 output 下的 be 文件夹拷贝到 BE 的节点的指定部署路径下。
修改所有 BE 的配置
修改 be/conf/be.conf。主要是配置 storage_root_path
:数据存放目录。默认在be/storage下,需要手动创建该目录。多个路径之间使用英文状态的分号 ;
分隔(最后一个目录后不要加 ;
)。可以通过路径区别存储目录的介质,HDD或SSD。可以添加容量限制在每个路径的末尾,通过英文状态逗号,
隔开。
注意:如果是SSD磁盘要在目录后面加上.SSD
,HDD磁盘在目录后面加.HDD
- storage_root_path=/home/disk1/doris.HDD,50;/home/disk2/doris.SSD,10;/home/disk2/doris
- 说明
-
- /home/disk1/doris.HDD,50,表示存储限制为50GB,HDD;
- /home/disk2/doris.SSD,10,存储限制为10GB,SSD;
- /home/disk2/doris,存储限制为磁盘最大容量,默认为HDD
- 例子
- storage_root_path = /data/doris.SSD
- 修改日志位置
- PPROF_TMPDIR="/data/logs/belog"
- 创建目录
- mkdir /data/doris.SSD
- mkdir /data/logs/belog
修改be ip
- priority_networks = 172.16.99.0/24
- 这里取0可以自动匹配自身ip 方便集群里都是一样的配置
在 FE 中添加所有 BE 节点
BE 节点需要先在 FE 中添加,才可加入集群。可以使用 mysql-clien 连接到 FE:
- mysql -h fe_host -P query_port -uroot
- 例子
-
- mysql -uroot -P 9030 -h127.0.0.1
其中 fe_host 为 FE 所在节点 ip;query_port 在 fe/conf/fe.conf 中的;默认使用 root 账户,无密码登录。
登录后,执行以下命令来添加每一个 BE:
- ALTER SYSTEM ADD BACKEND "be_host:heartbeat-service_port";
- 举例
- ALTER SYSTEM ADD BACKEND "172.16.99.80:9050" ;
- 如果是扩容也是这样操作的
- BE 扩容后,Doris 会自动根据负载情况,进行数据均衡,期间不影响使用。
其中 be_host 为 BE 所在节点 ip;heartbeat_service_port 在 be/conf/be.conf 中。
启动 BE
bin/start_be.sh --daemon
BE 进程将启动并进入后台执行。日志默认存放在 be/log/ 目录下。如启动失败,可以通过查看 be/log/be.log 或者 be/log/be.out 查看错误信息。
查看BE状态
使用 mysql-client 连接到 FE,并执行
SHOW PROC '/backends';
查看 BE 运行情况。如一切正常,Alive
列应为 true
。
如果需要删除BE节点 则需要登录FE节点的数据库操作
- ALTER SYSTEM DROPP BACKEND "be_host:be_heartbeat_service_port";
- 例子
- ALTER SYSTEM DROPP BACKEND "172.16.99.80:9050";
- 需要注意的是DROPP 多了一个P 。为了防止误操作
此操作会立即删除节点下所有的数据,慎重!!!
可以使用安全删除
- ALTER SYSTEM DECOMMISSION BACKEND "be_host:be_heartbeat_service_port";
- 例子
- ALTER SYSTEM DECOMMISSION BACKEND "172.16.99.82:9050";
SHOW PROC '/backends';
看到该 BE 节点的 isDecommission 状态为 true。表示该节点正在进行下线。SHOW PROC '/backends';
中的 TabletNum 查看,如果正在进行,TabletNum 将不断减少。CANCEL DECOMMISSION BACKEND "be_host:be_heartbeat_service_port";
Broker 以插件的形式,独立于 Doris 部署。如果需要从第三方存储系统导入数据,需要部署相应的 Broker,默认提供了读取 HDFS 、百度云 BOS 及 Amazon S3 的 fs_broker。fs_broker 是无状态的,建议每一个 FE 和 BE 节点都部署一个 Broker。
进入apache_hdfs_broker目录
修改相应 Broker 配置
在相应 broker/conf/ 目录下对应的配置文件中,可以修改相应配置。没什么需要配置的
连接hdfs的话。需要替换一下hdfs-site.xml文件
启动 Broker
bin/start_broker.sh --daemon
添加 Broker
要让 Doris 的 FE 和 BE 知道 Broker 在哪些节点上,通过 sql 命令添加 Broker 节点列表。
使用 mysql-client 连接启动的 FE,执行以下命令:
- ALTER SYSTEM ADD BROKER broker_name "broker_host1:broker_ipc_port1","broker_host2:broker_ipc_port2",...;
-
-
- 举个例子
- ALTER SYSTEM ADD BROKER broker_name "172.16.99.79:8000","172.16.99.80:8000","172.16.99.81:8000","172.16.99.82:8000","172.16.99.83:8000";
其中 broker_host 为 Broker 所在节点 ip;broker_ipc_port 在 Broker 配置文件中的conf/apache_hdfs_broker.conf。
查看 Broker 状态
使用 mysql-client 连接任一已启动的 FE,执行以下命令查看 Broker 状态:
- SHOW PROC "/brokers";
-
-
- mysql> SHOW PROC "/brokers";
- +-------------+--------------+----------+------+-------+---------------------+---------------------+--------+
- | Name | IP | HostName | Port | Alive | LastStartTime | LastUpdateTime | ErrMsg |
- +-------------+--------------+----------+------+-------+---------------------+---------------------+--------+
- | broker_name | 172.16.99.79 | doris1 | 8000 | true | 2022-06-23 18:00:02 | 2022-06-23 18:00:28 | |
在生产环境中,所有实例都应使用守护进程启动,以保证进程退出后,会被自动拉起,如 Supervisor (opens new window)。如需使用守护进程启动,在 0.9.0 及之前版本中,需要修改各个 start_xx.sh 脚本,去掉最后的 & 符号。从 0.10.0 版本开始,直接调用 sh start_xx.sh
启动即可
默认使用 Http 协议进行 WebUI 访问,在浏览器输入以下格式地址访问
- http://FE_IP:FE_HTTP_PORT(默认8030)
- 默认账号:root
- 默认密码:空
负载均衡有3种方式
代码实现
自己在应用层代码进行重试和负载均衡。比如发现一个连接挂掉,就自动在其他连接上进行重试。应用层代码重试需要应用自己配置多个 doris 前端节点地址。
jdbc connector
如果使用 mysql jdbc connector 来连接 Doris,可以使用 jdbc 的自动重试机制:
jdbc:mysql:loadbalance://[host:port],[host:port].../[database][?propertyName1][=propertyValue1][&propertyName2][=propertyValue
proxy sql
Doris 的 FE 进程负责接收用户连接和查询请求,其本身是可以横向扩展且高可用的,但是需要用户在多个 FE 上架设一层 proxy,来实现自动的连接负载均衡。(配置起来比较复杂)
nginx反向代理
我这儿就选了这个 。比较方便也比较简单
这里是新建了一个配置文件
vim /usr/local/nginx/conf/default.conf
然后在里面加上下面的内容
- events {
- worker_connections 1024;
- }
- stream {
- upstream mysqld {
- hash $remote_addr consistent;
- server 172.31.7.119:9030 weight=1 max_fails=2 fail_timeout=60s;
- ##注意这里如果是多个FE,加载这里就行了
- }
- ###这里是配置代理的端口,超时时间等
- server {
- listen 6030;
- proxy_connect_timeout 30s;
- proxy_timeout 30s;
- proxy_pass mysqld;
- }
- }
- mysql -uroot -P6030 -h172.31.7.119
-
- 参数解释:-u 指定Doris用户名-p 指定Doris密码,我这里密码是空,所以没有-h 指定Nginx代理服务器IP-P 指定端口