agentsclimarketplace

Interface config

Skill nanxiaoyao/network-huawei-skills/interface-config

This skill should be used when the user asks to configure or troubleshoot physical interfaces and link aggregation (Eth-Trunk) on Huawei CloudEngine / S series switches. Covers interface attributes (speed, duplex, MTU, jumbo frame, flow control, PoE, error packets), Eth-Trunk in manual and LACP modes, M-LAG/iStack cross-device aggregation, and interface fault diagnosis. Applicable platforms S/CE switches (V200R011C10+/V200R022C00+) and USG firewalls (V500R005C20+/V600R007C20+).From its SKILL.md

Install
npx -y skills add nanxiaoyao/network-huawei-skills --skill interface-config

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

8.7 KB, ~3.1k tokens by cl100k_base, as published. Nobody here has run it

华为交换机接口与链路聚合配置技能 (interface-config)

适用平台 S 系列 V200R011C10+ | CE 系列 V200R022C00+ 文档来源 华为产品文档 dc_cfg_int_* / dc_cfg_eth-trunk_*

接口是所有协议的物理底座 出问题先看接口 Eth-Trunk 链路聚合是接口的逻辑形态 提带宽+冗余

触发场景

  • 接口配置 IP / 描述 / 速率 / 双工
  • 接口物理 down 不通
  • 大量错包 CRC 错 入向丢包
  • 配 MTU / 巨帧 jumbo frame
  • PoE 供电
  • 配置 Eth-Trunk 链路聚合(手工 / LACP)
  • LACP 不协商 / 成员口不上线
  • 跨设备聚合(M-LAG 堆叠跨设备聚合)
  • Trunk 链路两端速率不匹配

物理接口配置

基础属性

interface GigabitEthernet 0/0/1
 description To-CoreSW
 speed 1000              # 速率 10/100/1000
 duplex full             # 双工
 negotiation disable     # 关闭自协商(双方都关或都开 否则速率不匹配)
 mtu 9216                # 巨帧(默认 1500)
 jumboframe enable 9216
 flow-control            # 流控
 undo shutdown

接口三层化

interface GigabitEthernet 0/0/1
 undo portswitch         # 转为三层口(仅部分款支持)
 ip address 10.1.1.1 24

PoE 供电(S 系列接入交换机)

interface GigabitEthernet 0/0/1
 poe enable
 poe power max 30000     # 30W 最大功率(mW)
 poe priority { critical | high | low }
display poe interface     # 查 PoE 状态
display poe power         # 查总功耗

错包诊断

display interface GigabitEthernet 0/0/1
# 看 Input/Output errors、CRC、Frames、Drops 等计数
clear counters interface GigabitEthernet 0/0/1

Eth-Trunk 链路聚合

两种模式

模式适用协商
手工 manual简单 不要协商无 LACP
LACP(lacp-static)推荐 自动协商 故障检测LACP 报文

配置 手工模式

interface Eth-Trunk 1
 mode manual load-balance       # 手工模式 默认就是
 quit

interface GigabitEthernet 0/0/1
 eth-trunk 1
 quit
interface GigabitEthernet 0/0/2
 eth-trunk 1
 quit

配置 LACP 模式(推荐)

interface Eth-Trunk 1
 mode lacp-static
 lacp preempt enable
 lacp preempt delay 30
 max active-linknumber 4
 min active-linknumber 1
 quit

interface GigabitEthernet 0/0/1
 eth-trunk 1
interface GigabitEthernet 0/0/2
 eth-trunk 1

LACP 系统优先级与接口优先级

# 系统优先级 决定谁是 Actor 哪边的接口优先级生效
lacp priority 100               # 系统级 默认 32768

# 接口优先级 决定哪些接口为活动接口
interface GigabitEthernet 0/0/1
 lacp priority 100              # 接口级

两端比较:系统优先级数值小的胜 然后比较 MAC 接口优先级数值小为活动

负载均衡算法

interface Eth-Trunk 1
 load-balance src-dst-mac        # 源目 MAC
 load-balance src-dst-ip         # 源目 IP
 load-balance src-dst-ip-l4port  # 五元组 推荐

验证

display eth-trunk 1
display eth-trunk 1 brief
display lacp statistics eth-trunk 1
display interface eth-trunk 1

正常时:

  • Status: Selected(活动)
  • Number of UP port in Trunk: ≥ min active-linknumber
  • LACP 模式下 PartnerKey 与本端 LacpKey 一致

跨设备聚合

堆叠跨设备聚合(S 系列 iStack)

两台设备做 iStack 后 成员口分散在不同物理框 → 普通 Eth-Trunk 即可跨设备

M-LAG(CE 系列)

两台独立设备做 M-LAG → 对下游表现为一个聚合组 详见 stack-istack 技能 + 单独 m-lag

接口命令速查

命名

类型示例
千兆GigabitEthernet 0/0/1
万兆10GE 0/0/1
40G40GE 0/0/1
100G100GE 0/0/1
Eth-TrunkEth-Trunk 1
VLANIFVlanif 10
LoopbackLoopBack 0

基础

interface <if>
 description <text>
 speed { 10 | 100 | 1000 | 10000 | auto }
 duplex { full | half | auto }
 negotiation disable | enable
 mtu <bytes>
 jumboframe enable [<bytes>]
 flow-control
 shutdown / undo shutdown
 undo portswitch              # 转三层口(部分款型)
 portswitch                   # 转二层口

错误处理

display interface <if>
display interface brief
display interface phy-option         # 光模块信息
display transceiver verbose interface <if>   # 详细光模块
clear counters interface <if>
loopback internal                    # 接口内环测试
loopback external                    # 外环(需配回环头)

Eth-Trunk 命令速查

命令视图说明
interface Eth-Trunk <id>system创建/进入
mode { manual load-balance | lacp-static }trunk模式
eth-trunk <id>interface接口加入 Trunk
max active-linknumber <num>trunkLACP 最大活动数
min active-linknumber <num>trunk最小活动数 低于则 trunk down
load-balance <algo>trunk负载算法
lacp preempt enabletrunk抢占
lacp preempt delay <s>trunk抢占延时
lacp timeout { fast | slow }trunkLACP 超时 fast=1s slow=30s
lacp priority <num>system / interfaceLACP 优先级
display eth-trunk [<id>]-查 trunk
display lacp statistics eth-trunk <id>-LACP 报文统计

完整范式 LACP 跨堆叠聚合上联

需求:两台 S5720 堆叠 与上联 S6720 用 2×10GE LACP 聚合上联

system-view

# 接口配置(成员口分散到不同堆叠成员)
interface 10GE 1/0/1            # 成员 1 的 10GE 1
 eth-trunk 10
 quit
interface 10GE 2/0/1            # 成员 2 的 10GE 1
 eth-trunk 10
 quit

# Trunk 配置
interface Eth-Trunk 10
 mode lacp-static
 max active-linknumber 2
 min active-linknumber 1
 load-balance src-dst-ip-l4port
 port link-type trunk
 port trunk allow-pass vlan 10 20 30
 quit

# 上联设备做相同的 Eth-Trunk 配置(mode/参数对称)

常见陷阱

  • 两端 speed/duplex 一端 auto 一端固定 → 协商可能不一致
  • 两端 mtu / jumboframe 不一致 → 大包不通 小包通
  • LACP 模式两端不同(一端 manual 一端 lacp-static)→ 一直不上线
  • 成员口数量两端不一致 → 协商成功数取较小
  • eth-trunk 已有 IP → 成员口加入失败 必须先清 IP
  • 成员口配了 VLAN/IP → 加入 trunk 失败 先清干净
  • 负载算法两端不同 → 不影响通信 但流量分布不均
  • PoE 总功率超限 → 部分端口不供电 看 display poe power-budget

排查流程

接口/聚合不通
  |
  v
[1] display interface brief → 物理 UP 否
  |
  ├─ DOWN → 走分支 A 物理层
  └─ UP
       |
       v
   [2] 是聚合口? 是 → display eth-trunk
       |
       ├─ 活动数=0 → 走分支 B 聚合协商
       └─ 活动 < 期望 → 走分支 C 部分成员异常

相关文件

  • references/interface-commands.md 完整命令
  • references/interface-troubleshooting.md 故障排查

⚠️ CE 系列差异(注意)

CE 系列虽然接口/Eth-Trunk 命令大体与 S 一致,但有几处关键差异:

1. 二阶段提交(commit)模型

CE 配置完所有命令后必须执行 commit 才生效(V200R022 起强制):

[~SwitchA] interface 10GE 1/0/1
[~SwitchA-10GE1/0/1] eth-trunk 10
[*SwitchA-10GE1/0/1] commit                    # 注意:必须 commit
  • ~ 表示已提交状态
  • * 表示有未提交修改
  • 不 commit 重启后修改丢失

2. Eth-Trunk 模式新增

CE 支持 mode lacp-dynamic(S 系列只有 manuallacp-static

3. 跨芯片/跨堆叠成员推荐

官方文档明确建议 Eth-Trunk 成员接口跨芯片/跨堆叠成员,提升可靠性

4. 接口命名差异

平台千兆万兆40G100G
S 系列GigabitEthernet10GE40GE-
CE 系列GE / 10GE10GE / 25GE40GE100GE
USG 防火墙GigabitEthernet10GE / XGigabitEthernet--

⚠️ USG 防火墙接口差异

防火墙接口与交换机的主要差异:

  1. 接口必须加入安全区域 才能转发
    firewall zone trust
     add interface GigabitEthernet 1/0/1
    
  2. 接口默认三层 不需要 undo portswitch
  3. VLAN 模式 需要 portswitch 后才能配 VLAN(交换模式)
  4. Eth-Trunk 也支持 命令与交换机一致
  5. PoE 防火墙不支持

What ships with it: 2 files

9.4 KB alongside SKILL.md

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.