• 全部
  • 经验案例
  • 典型配置
  • 技术公告
  • FAQ
  • 漏洞说明
  • 全部
  • 全部
  • 大数据引擎
  • 知了引擎
产品线
搜索
取消
案例类型
发布者
是否解决
是否官方
时间
搜索引擎
匹配模式
高级搜索

数字底盘

2026-05-25提问
  • 0关注
  • 0收藏,121浏览
粉丝:0人 关注:0人

问题描述:

Matrix部署时出现报错 K8SINSTALL-ERROR,是什么原因,如何解决

3 个回答

需要看日志定位  

可以先用Matrix自带的巡检脚本./env_check.sh (位于/opt/matrix/tools/目录下)巡检一下,排查一下节点间的连通性。 没异常的话建议打400看一下

暂无评论

粉丝:116人 关注:11人

排查思路

1、节点存在两个及以上网卡且都为UP状态,若业务场景需要多张网卡,在部署,升级/重建集群前,请通过ifconfig命令查看网卡的排序,在Matix集群使用的节点!P所在网卡前的所有物理网卡均已配置IP地址或配置为OnBOOT=n0,否则会导致集群部署失败。

2、集群中不应存在未接线但配置文件中OnBOOT=yes,未配置IP地址OnBOOT=yes等异常配置。

3、如果集群采用bond作为Matix主网卡,请确保在Matrix集群中的所有非bond成员的物理网卡均已配置!P地址或者配置为OnBOOT=no.

4、查看/etc/hosts文件,配置是否正确。

排查发现/etc/hosts文件中localhost被手工删除,原因是一线修改主机名后误把localhost配置删除

现场/etc/hosts文件:


解决方法

将/etc/hosts文件中localhost手工补齐

暂无评论

粉丝:17人 关注:1人

Matrix 部署时出现 K8SINSTALL-ERROR 报错,通常是由于服务器底层的网卡配置、系统环境或配置文件异常导致的。你可以按照以下常见原因逐一进行排查和解决:

1. 检查网卡配置(最常见原因)

节点存在多张网卡时,如果配置不当极易导致集群部署失败。
  • 网卡状态排查:如果节点有两张及以上网卡且都处于 UP 状态,在部署前请使用 ifconfig 命令查看网卡排序。确保在 Matrix 集群使用的节点 IP 所在网卡之前的所有物理网卡,均已正确配置 IP 地址,或者在配置文件中将其设置为 OnBOOT=no
  • 异常配置排查:检查集群中是否存在未接线但配置文件中 OnBOOT=yes,或者未配置 IP 地址但 OnBOOT=yes 等异常网卡配置。
  • Bond 网卡排查:如果集群采用 bond 作为 Matrix 主网卡,请确保集群中所有非 bond 成员的物理网卡均已配置 IP 地址,或者配置为 OnBOOT=no

2. 检查 /etc/hosts 文件

/etc/hosts 文件的配置错误也会直接引发安装失败。
  • 重点检查:查看 /etc/hosts 文件中的配置是否正确,特别是 localhost 是否被误删。如果一线人员在修改主机名时误删了 localhost 的相关配置,会导致集群部署失败。
  • 解决方法:如果缺失,请手工将 localhost 补齐到 /etc/hosts 文件中。

3. 检查 Swap 分区状态

Matrix 服务在启动时,为了保证 K8s 系统的整体性能,会强制停用 Swap 分区。
  • 现象说明:安装后执行 lsblk 命令发现 Swap 分区没有挂载,或者系统日志中出现 Deactivated successfully,这属于 Matrix 部署的正常机制,并非报错原因。但建议在部署前确认 Swap 分区的规划符合操作系统安装要求。

4. 检查安装权限与部署用户

虽然权限不足通常会报 Insufficient user permissions,但权限或用户环境的异常也可能间接导致 K8s 组件安装失败。
  • Root 权限:安装 Matrix 时必须使用 root 权限执行安装脚本。如果当前用户权限不足,请切换至 root 用户(su root)或使用 sudo 提权后重新运行安装脚本。
  • 部署用户一致性:确认安装和部署集群的用户环境。例如,如果之前使用 admin 账户安装系统,后续却在 root 用户下运行部署,可能会导致冲突。建议在卸载 Matrix 后,统一使用同一个具备 sudo 权限的用户(如 admin)重新安装和部署集群。

暂无评论

编辑答案

你正在编辑答案

如果你要对问题或其他回答进行点评或询问,请使用评论功能。

分享扩散:

提出建议

    +

亲~登录后才可以操作哦!

确定

亲~检测到您登陆的账号未在http://hclhub.h3c.com进行注册

注册后可访问此模块

跳转hclhub

你的邮箱还未认证,请认证邮箱或绑定手机后进行当前操作

举报

×

侵犯我的权益 >
对根叔社区有害的内容 >
辱骂、歧视、挑衅等(不友善)

侵犯我的权益

×

泄露了我的隐私 >
侵犯了我企业的权益 >
抄袭了我的内容 >
诽谤我 >
辱骂、歧视、挑衅等(不友善)
骚扰我

泄露了我的隐私

×

您好,当您发现根叔知了上有泄漏您隐私的内容时,您可以向根叔知了进行举报。 请您把以下内容通过邮件发送到pub.zhiliao@h3c.com 邮箱,我们会尽快处理。
  • 1. 您认为哪些内容泄露了您的隐私?(请在邮件中列出您举报的内容、链接地址,并给出简短的说明)
  • 2. 您是谁?(身份证明材料,可以是身份证或护照等证件)

侵犯了我企业的权益

×

您好,当您发现根叔知了上有关于您企业的造谣与诽谤、商业侵权等内容时,您可以向根叔知了进行举报。 请您把以下内容通过邮件发送到 pub.zhiliao@h3c.com 邮箱,我们会在审核后尽快给您答复。
  • 1. 您举报的内容是什么?(请在邮件中列出您举报的内容和链接地址)
  • 2. 您是谁?(身份证明材料,可以是身份证或护照等证件)
  • 3. 是哪家企业?(营业执照,单位登记证明等证件)
  • 4. 您与该企业的关系是?(您是企业法人或被授权人,需提供企业委托授权书)
我们认为知名企业应该坦然接受公众讨论,对于答案中不准确的部分,我们欢迎您以正式或非正式身份在根叔知了上进行澄清。

抄袭了我的内容

×

原文链接或出处

诽谤我

×

您好,当您发现根叔知了上有诽谤您的内容时,您可以向根叔知了进行举报。 请您把以下内容通过邮件发送到pub.zhiliao@h3c.com 邮箱,我们会尽快处理。
  • 1. 您举报的内容以及侵犯了您什么权益?(请在邮件中列出您举报的内容、链接地址,并给出简短的说明)
  • 2. 您是谁?(身份证明材料,可以是身份证或护照等证件)
我们认为知名企业应该坦然接受公众讨论,对于答案中不准确的部分,我们欢迎您以正式或非正式身份在根叔知了上进行澄清。

对根叔社区有害的内容

×

垃圾广告信息
色情、暴力、血腥等违反法律法规的内容
政治敏感
不规范转载 >
辱骂、歧视、挑衅等(不友善)
骚扰我
诱导投票

不规范转载

×

举报说明