For the complete documentation index, see llms.txt. This page is also available as Markdown.

节点诊断指南

VergeOS 节点诊断工具综合参考,包括 IPMI 命令、SMART 测试、网络诊断、Fabric 配置和硬件故障排查。

概述

节点诊断工具为单个 VergeOS 节点提供全面的硬件和系统级故障排查能力。这些诊断命令使系统管理员能够直接从 VergeOS 界面执行详细的硬件分析、监控系统性能,并排查特定节点的问题。

你将学到什么

  • 如何访问和使用节点诊断工具

  • 了解每个诊断命令及其关注的硬件范围

  • 节点级故障排查最佳实践

  • 何时针对硬件问题使用特定诊断命令

前提条件

  • 具有节点管理权限的 VergeOS 界面访问权限

  • 对服务器硬件组件的基本了解

  • 了解网络和存储概念

节点访问

节点诊断提供深层硬件级访问,应由有经验的系统管理员使用。

访问节点诊断

  1. 导航到节点诊断:

    • 选择 基础架构 > 节点 从顶部菜单。

    • 选择所需的 节点 从列表中

    • 单击 诊断 在左侧菜单中

  2. 使用诊断命令:

    • 查询 下拉菜单中选择所需命令

    • 在右侧配置可用参数

    • 单击 发送 → 以执行该命令

诊断命令参考

ARP 扫描

用途: 使用 ARP 数据包发现节点网络接口上的活动设备。

何时使用:

  • 从节点视角验证网络连通性

  • 识别节点本地网络段上的设备

  • 排查节点网络配置问题

参数:

  • 接口: 要扫描的网络接口

CLI 语法:


ARP 表

用途: 显示节点的 ARP 缓存,展示 IP 到 MAC 地址的映射。

何时使用:

  • 排查节点网络连通性

  • 验证网络邻居发现

  • 检查影响该节点的 ARP 冲突

CLI 语法:


桥接地址

用途: 显示节点上网络桥的 MAC 地址表。

何时使用:

  • 排查网络桥配置问题

  • 验证虚拟交换机上的 MAC 学习

  • 网络拓扑分析

CLI 语法:


清除持久存储

用途: 清除节点上的持久存储缓存和临时数据。

何时使用:

  • 解决与存储相关的性能问题

  • 清除损坏的缓存数据

  • 为存储重新配置做准备

CLI 语法:


DMI 表

用途: 显示桌面管理接口(DMI)信息,包括硬件详细信息。

何时使用:

  • 硬件清单和识别

  • 验证系统规格

  • 排查硬件兼容性问题

CLI 语法:


DNS 查询

用途: 从节点视角测试 DNS 解析。

何时使用:

  • 排查节点 DNS 配置问题

  • 验证节点到外部的连通性

  • 测试名称解析服务

参数:

  • 主机名: 要解析的目标主机名

  • DNS 服务器: 要查询的特定 DNS 服务器

CLI 语法:


以太网工具

用途: 提供详细的以太网接口信息和配置。

何时使用:

  • 诊断网络接口问题

  • 检查链路速度和双工设置

  • 排查物理网络连通性问题

参数:

  • 接口: 要检查的网络接口

CLI 语法:


Fabric 配置

用途: 显示节点的 VergeOS fabric 网络配置。

何时使用:

  • 排查节点间通信问题

  • 验证 fabric 网络设置

  • 诊断集群连通性问题

CLI 语法:


IP

用途: 用于接口和路由诊断的高级 IP 命令访问。

何时使用:

  • 详细的网络接口分析

  • 路由表检查

  • 高级网络故障排查

参数:

  • 命令: IP 命令选项(route、addr、link 等)

CLI 语法:


IPMI BMC 信息

用途: 显示基板管理控制器信息。

何时使用:

  • 硬件管理故障排查

  • 验证 IPMI 配置

  • 远程管理诊断

CLI 语法:


IPMI 机箱状态

用途: 显示物理机箱状态和电源信息。

何时使用:

  • 电源管理故障排查

  • 硬件状态验证

  • 物理系统诊断

CLI 语法:


IPMI FRU 信息

用途: 显示来自 IPMI 的可更换现场单元(FRU)信息。

何时使用:

  • 硬件清单管理

  • 组件识别

  • 保修和支持信息

CLI 语法:


IPMI LAN 信息

用途: 显示 IPMI 网络配置详细信息。

何时使用:

  • IPMI 网络故障排查

  • 远程管理连通性问题

  • BMC 网络配置验证

CLI 语法:


IPMI MC 重置

用途: 重置管理控制器(BMC)。

何时使用:

  • 解决 IPMI 通信问题

  • BMC 故障排查

  • 管理接口恢复

CLI 语法:


IPMI 传感器数据仓库

用途: 显示全面的传感器数据仓库信息。

何时使用:

  • 详细硬件监控

  • 传感器配置验证

  • 硬件诊断和分析

CLI 语法:


IPMI 传感器

用途: 显示当前传感器读数(温度、电压、风扇等)。

何时使用:

  • 硬件健康监控

  • 温度和电源诊断

  • 环境故障排查

CLI 语法:


IPMI 系统事件日志

用途: 显示来自 IPMI 的系统事件日志。

何时使用:

  • 硬件错误分析

  • 系统事件故障排查

  • 历史硬件问题调查

CLI 语法:


LED 控制(驱动器)

用途: 控制存储驱动器上的 LED 指示灯,用于物理识别。

何时使用:

  • 物理驱动器识别

  • 驱动器更换流程

  • 硬件维护任务

参数:

  • 驱动器: 目标驱动器标识符

  • 操作: LED 开/关/闪烁

CLI 语法:


日志

用途: 显示节点系统日志和 journal 条目。

何时使用:

  • 系统故障排查

  • 错误分析

  • 性能问题调查

CLI 语法:


网络绑定

用途: 显示网络绑定配置和状态。

何时使用:

  • 网络冗余故障排查

  • 绑定接口诊断

  • 链路聚合验证

CLI 语法:


OpenSSL 速度测试

用途: 测试节点 CPU 的加密性能。

何时使用:

  • 性能基准测试

  • 加密能力测试

  • 硬件加速验证

CLI 语法:


Ping

用途: 测试来自节点的网络连通性。

何时使用:

  • 基本连接测试

  • 网络路径验证

  • 延迟测量

参数:

  • 目标: 目标 IP 或主机名

  • 数量: Ping 数据包数量

CLI 语法:


RAS 查询

用途: 查询可靠性、可用性和可维护性信息。

何时使用:

  • 硬件可靠性评估

  • 错误更正状态

  • 内存和处理器诊断

CLI 语法:


S.M.A.R.T. 诊断测试

用途: 对存储驱动器启动 SMART 诊断测试。

何时使用:

  • 主动驱动器健康测试

  • 存储故障排查

  • 预防性维护

参数:

  • 驱动器: 要测试的目标驱动器

  • 测试类型: 短测试、长测试或传输测试

CLI 语法:

测试时长

SMART 测试可能需要相当长的时间才能完成,尤其是长测试。


S.M.A.R.T. 信息

用途: 显示驱动器的 SMART 属性和健康信息。

何时使用:

  • 驱动器健康评估

  • 预测性故障分析

  • 存储性能监控

参数:

  • 驱动器: 目标驱动器标识符

CLI 语法:


显示块设备

用途: 列出节点可见的所有块设备。

何时使用:

  • 存储设备清单

  • 驱动器识别故障排查

  • 存储配置验证

CLI 语法:


TCP 连接测试

用途: 测试到远程主机和端口的 TCP 连通性。

何时使用:

  • 服务连通性验证

  • 防火墙规则测试

  • 网络故障排查

参数:

  • 主机: 目标主机名或 IP

  • 端口: TCP 端口号

CLI 语法:


TCP 抓包

用途: 捕获网络数据包以进行详细流量分析。

何时使用:

  • 网络故障排查

  • 安全分析

  • 协议调试

参数:

  • 接口: 要监控的网络接口

  • 过滤器: 数据包过滤表达式

CLI 语法:


CPU 占用最高

用途: 显示占用最多 CPU 资源的进程。

何时使用:

  • 性能故障排查

  • 资源利用分析

  • 进程监控

CLI 语法:


网络占用最高

用途: 显示网络利用率最高的进程。

何时使用:

  • 网络性能分析

  • 带宽利用故障排查

  • 网络密集型进程识别

CLI 语法:


路由跟踪

用途: 跟踪从节点到目标的网络路径。

何时使用:

  • 网络路由故障排查

  • 路径分析

  • 连接问题诊断

参数:

  • 目标: 目标 IP 或主机名

CLI 语法:


我的 IP 是什么

用途: 显示节点的外部 IP 地址。

何时使用:

  • 外部连接验证

  • NAT 配置故障排查

  • 网络配置验证

CLI 语法:

最佳实践

硬件诊断工作流程

  1. 系统概览: 从 DMI 表和 IPMI 机箱状态开始

  2. 健康检查: 查看 IPMI 传感器和系统事件日志

  3. 存储分析: 使用 S.M.A.R.T. 信息和测试

  4. 网络验证: 检查网络绑定和接口状态

  5. 性能评估: 监控 CPU 和网络使用情况

预防性维护

  • 定期健康检查: 监控 IPMI 传感器和 SMART 数据

  • 日志审查: 定期检查系统事件日志

  • 性能监控: 跟踪 CPU 和网络利用率趋势

  • 驱动器健康: 安排定期 SMART 诊断测试

安全注意事项

  • 影响评估: 考虑诊断命令对生产系统的影响

  • 支持协调: 在复杂硬件问题上联系 VergeOS 支持

  • 文档记录: 保留诊断结果记录,以便进行趋势分析

  • 变更控制: 对硬件修改遵循变更管理流程

排查常见节点问题

硬件问题

  1. 检查 IPMI 传感器 用于温度、电压和风扇问题

  2. 查看 IPMI 系统事件日志 用于硬件错误

  3. 使用 S.M.A.R.T. 信息 用于评估驱动器健康状况

网络问题

  1. 验证 网络绑定 状态和配置

  2. 使用 以太网工具 检查接口设置

  3. 测试连通性,使用 Ping路由跟踪

性能问题

  1. 监控 CPU 占用最高 以了解资源限制

  2. 检查 网络占用最高 以了解带宽利用率

  3. 查看 日志 用于性能相关错误

存储问题

  1. 使用 显示块设备 验证驱动器识别

  2. 运行 S.M.A.R.T. 诊断测试 用于全面的驱动器测试

  3. 检查 RAS 查询 用于内存和存储错误信息

下一步

在掌握节点诊断后,可考虑进一步探索:

  • 高级硬件监控和告警

  • 自动化诊断脚本

  • 与外部监控系统集成

  • 预防性维护计划

对于复杂的硬件问题或异常的诊断结果,请联系 VergeOS 支持 并提供详细的诊断输出和系统信息。

最后更新于

这有帮助吗?