安装阶段常见问题

安装阶段常见问题通常集中在以下几类。

1 时间不同步

现象：

登录失败

鉴权异常

服务调用异常

处理要求：

先检查所有节点时间偏差

修复 NTP / 时间同步服务后，再继续安装或验收

排查命令：

timedatectl status
date

2 数据盘路径配置错误

现象：

安装成功后磁盘迅速占满

数据写入失败

持久化目录落在系统盘

处理要求：

持久化目录必须明确指向数据盘

业务数据不存放在系统盘目录

排查命令：

findmnt -n -o TARGET -T /data
df -Th|egrep -v "overlay|tmpfs"

3 依赖服务连接失败

现象：

安装过程中服务巡检不通过

数据库、缓存、消息队列、对象存储连接失败

处理要求：

先检查地址、端口、账号、密码是否填写正确

再检查网络连通性与安全策略

最后检查目标服务本身是否可用

排查命令：

nc -zv <MYSQL_HOST> 3306
nc -zv <REDIS_HOST> 6379
nc -zv <MONGO_HOST> 27017
nc -zv <KAFKA_HOST> 9092

4 离线包不匹配

现象：

镜像加载失败

安装过程报版本不匹配

安装包与离线镜像包无法对应

处理要求：

确认安装包、离线镜像包、产品版本一致

确认 CPU 架构一致

确认未混用不同项目或不同日期的物料

5 安装器页面无法打开

现象：

Web UI 页面无法访问

18080 端口无监听

安装器进程已退出

排查命令：

ps -ef | grep mdp-linux | grep -v grep
ss -lntp | grep 18080
tail -n 100 /root/nohup.out

6. 建议排查顺序

安装问题按以下顺序排查：

先确认是否为环境问题：系统、时间、磁盘、端口、网络

再确认是否为配置问题：域名、目录、依赖地址、账号密码

再确认是否为物料问题：安装包、离线包、架构是否匹配

最后再看安装器日志与服务运行状态

说明：

前置条件不满足时，不重复执行安装

同一个明确失败原因的命令，不重复执行

7. 什么时候应停止继续安装

出现以下情况时，先停止安装，修复基础问题后再继续：

所有节点时间不同步

数据盘未独立挂载

外部依赖服务不可达

离线物料版本不一致

安装器服务未正常启动

1 时间不同步#

2 数据盘路径配置错误#

3 依赖服务连接失败#

4 离线包不匹配#

5 安装器页面无法打开#

6. 建议排查顺序#

7. 什么时候应停止继续安装#

1 时间不同步

2 数据盘路径配置错误

3 依赖服务连接失败

4 离线包不匹配

5 安装器页面无法打开

6. 建议排查顺序

7. 什么时候应停止继续安装