1. 概述
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V2.6.0 | - |
1.2 应用场景
在部署新项目时，由于前期准备不充足，或环境配置无法支撑部署，可能会导致部署失败。
因此，在「部署新项目」过程中，运维平台提供「环境检测」功能，对项目部署环境进行检测。
本文提供各检测项的说明与解决方案。
2. 强制检测项
本节列出的检测项，均为强制检测项，如检测不通过，则无法开始部署。
2.1 节点缺少tar命令
| 说明 | |
|---|---|
| 检测原因 | 在服务器中，tar命令是一个用于打包和压缩文件的常用命令行工具 运维平台需要使用该命令进行文件解压 |
| 解决方案 | 请根据提示，自行前往相关服务器安装tar命令 具体步骤可能因操作系统版本和配置差异而有所不同，帆软不提供相关资料和指导，请自行百度 |
2.2 节点缺少sed命令
| 说明 | |
|---|---|
| 检测原因 | 在服务器中，sed命令是一个用于处理文本的工具 运维平台需要使用该命令进行文本处理 |
| 解决方案 | 请根据提示，自行前往相关服务器安装sed命令 具体步骤可能因操作系统版本和配置差异而有所不同，帆软不提供相关资料和指导，请自行自行查阅资料配置 |
2.3 用户缺少sudo权限
| 说明 | |
|---|---|
| 检测原因 | 用于部署项目的服务器用户，必须具备相关sudo权限，否则无法正常完成文件上传、配置修改等操作 |
| 解决方案 | 1）优先推荐使用root超管用户进行项目部署和运行 2）如需使用非超管root用户进行项目的部署和运行 请参考文档：用户权限说明 |
2.4 节点时间相差超过5秒
| 说明 | |
|---|---|
| 检测原因 | 单个项目可能涉及多个服务器 这些服务器时间不一致，可能会导致定时任务执行错误、日志记录混乱、数据不一致等多种问题 |
| 调整建议 | 推荐使用网络时间协议（NTP），确保多个服务器时间的准确性和自动同步。 具体步骤可能因操作系统版本和配置差异而有所不同，帆软不提供相关资料和指导，请自行自行查阅资料配置 |
2.5 节点时区不一致
| 说明 | |
|---|---|
| 检测原因 | 单个项目可能涉及多个服务器 这些服务器时区不一致，可能会导致定时任务执行错误、日志记录混乱、数据不一致等多种问题 |
| 调整建议 | 请参考文档：Linux系统时区调整 对各个服务器的时区进行调整，确保完全一致 |
2.6 节点端口被占用
| 说明 | |
|---|---|
| 检测原因 | 在服务器上部署组件，组件需要占用一些端口 如提示节点端口被占用，说明该节点上其他应用进程，已占用了目标端口 |
| 调整建议 | 请点击返回上一步，在「部署列表」中调整相关组件的端口配置，改用其他空闲端口即可
|
2.7 节点监听端口失败
| 说明 | |
|---|---|
| 检测原因 | 在服务器上部署组件，组件需要占用一些端口 如提示节点监听端口失败，说明已排除其他进程占用了该端口，但仍然无法成功监听 |
| 调整建议 | 1）请点击返回上一步，在「部署列表」中调整相关组件的端口配置，再次尝试
2）请参考文档：端口占用检查与防火墙配置，对防火墙进行放开 |
2.8 非root用户无法使用1024以下端口
| 说明 | |
|---|---|
| 检测原因 | Linux限制非root超管用户，无法使用1024以下端口 因此如果在「节点配置」步骤中，使用了非root服务器用户，那么在部署列表中无法使用1024以下端口作为组件端口 |
| 调整建议 | 请点击返回上一步，在「部署列表」中调整相关组件的端口配置，使用1024以上端口再次尝试
|
2.9 节点无法访问ops地址
| 说明 | |
|---|---|
| 检测原因 | 项目节点无法正常访问运维平台 这将导致运维平台的基础功能无法对该节点生效，功能使用存在异常 |
| 调整建议 | 请对运维平台所在服务器，开放目标节点的访问白名单 由于服务器类型和配置各不相同，帆软仅提供最基础的防火墙开放配置：端口占用检查与防火墙配置 更多操作请联系服务器运维人员或厂商确认 |
2.10 节点无法访问镜像仓库地址
| 说明 | |
|---|---|
| 检测原因 | 节点无法正常连接到运维平台的镜像仓库 这将导致无法从仓库中拉取部署所需的镜像文件，进而无法完成部署 |
| 调整建议 | 请确认好运维平台的镜像仓库地址，然后对镜像仓库所在服务器，开放目标节点的访问白名单 1）如何查看镜像仓库地址 管理员登录运维平台，点击「维护中心>镜像管理>设置」，即可查看镜像仓库地址 默认地址为运维平台所在服务器，端口5000
2）如何开放访问 由于服务器类型和配置各不相同，帆软仅提供最基础的防火墙开放配置：端口占用检查与防火墙配置 更多操作请联系服务器运维人员或厂商确认 |
2.11 节点无法访问xxx端口
| 说明 | |
|---|---|
| 检测原因 | 节点无法正常访问xxx端口 这将导致服务间的正常通行和使用，甚至导致功能无法使用或部署失败 |
| 调整建议 | 请对提示中的端口，开放目标节点的访问白名单 由于服务器类型和配置各不相同，帆软仅提供最基础的防火墙开放配置：端口占用检查与防火墙配置 更多操作请联系服务器运维人员或厂商确认 |
2.12 目录驱动格式要求使用xfs格式
| 说明 | |
|---|---|
| 检测原因 | 对于FineBI6.1的数据存储组件，如需使用运维平台部署的minio，磁盘类型必须是XFS 如不使用XFS，会出现磁盘未满，但无法写入数据的情况 |
| 报错示例 | The driver format of the [/root/data] of the minio deployment node 192.168.1.34 is [ext4], and xfs format is required. |
| 调整建议 | 该操作可能涉及格式化磁盘，帆软不提供相关指导，请在服务器厂商指导下谨慎进行。 |
2.13 Nas的工作目录必须是一个共享路径
| 说明 | |
|---|---|
| 检测原因 | 对于FineBI6.1的数据存储组件，如需使用自备的NAS，所提供的工作目录必须是一个共享路径 这能确保多用户和多设备可以访问和管理存储的数据 |
| 调整建议 | 请在系统中配置文件系统的自动挂载 由于服务器类型和配置各不相同，帆软不提供相关指导，请在服务器厂商指导下谨慎进行。 |
2.14 目录对应的文件系统未配置重启自动挂载
| 说明 | |
|---|---|
| 检测原因 | 在「节点配置」环节，设定的服务器挂载目录，是用于持久化数据和访问配置文件 如果这些服务器目录对应的文件系统没有配置重启自动挂载，那么容器可能无法访问这些挂载目录，导致数据丢失或应用程序无法正常启动 |
| 调整建议 | 请在系统中配置文件系统的自动挂载 由于服务器类型和配置各不相同，帆软不提供相关指导，请在服务器厂商指导下谨慎进行。 |
2.15 挂载路径不能是一个共享路径
| 说明 | |
|---|---|
| 检测原因 | 在「节点配置」环节，设定的服务器挂载目录，不能是一个共享路径 共享文件系统可能导致性能下降、文件权限问题和数据一致性挑战，这些问题会影响容器应用程序的可靠性和速度。为了避免这些问题，通常建议使用本地文件系统进行挂载。 |
| 调整建议 | 由于服务器类型和配置各不相同，帆软不提供相关指导，请在服务器厂商指导下谨慎进行。 |
上一篇：部署运维平台异常排查
