Apache Doris IP变更问题详解

一、背景

因为有多网卡的存在，或因为安装过 docker 等环境导致的虚拟网卡的存在，同一个主机可能存在多个不同的 ip。当前 Apache Doris 并不能自动识别可用 IP。所以当遇到部署主机上有多个 IP 时，必须通过 priority_networks 配置项来强制指定正确的 IP。

priority_networks 是 FE 和 BE 都有的一个配置，配置项需写在 fe.conf 和 be.conf 中。该配置项用于在 FE 或 BE 启动时，告诉进程应该绑定哪个IP。示例如下：

priority_networks=10.1.3.0/24

这是一种 CIDR 的表示方法。FE 或 BE 会根据这个配置项来寻找匹配的IP，作为自己的 localIP。

CIDR采用斜线记法，表示为：IP地址/网络ID的位数。
具体换算方法可以看下面两个例子。

1. 192.168.0.0/16，换算为32位二进制地址：11000000.10101000.00000000.00000000。其中/16表示16位网络ID，即32位二进制地址中前16位是固定不变的，对应网段为：11000000.10101000.00000000.00000000~11000000.10101000.11111111.11111111。
2. 192.168.1.2/24，换算为32位二进制地址：11000000.10101000.00000001.00000000。其中/24表示32位二进制地址中前24位是固定不变的，对应网段为：11000000.10101000.00000001.00000000~11000000.10101000.00000001.11111111

当出现如下场景时，ip会变更，从而导致fe/be异常无法正常启动运作

1. 集群迁移导致ip网段变更
2. 虚拟环境中动态地址导致ip变更
3. 重启fe/be前未正常配置priority_networks导致重启后获取的ip与元数据中的不一致

二、环境

硬件信息

1. CPU ：1C
2. CPU型号：ARM64
3. 内存 ：2GB
4. 硬盘 ：36GB SSD

软件信息

1. VM镜像版本 ：CentOS-7
2. Apahce Doris版本 ：1.2.4.1
3. 集群规模：1FE * 3BE

三、FE恢复

3.1 异常日志

查看fe.out会报如下异常，此时fe进程是无法启动的；
操作前注意备份所有fe的元数据并停止上游读