stack-istack
Skill2 starsChanged 3 months agoMITView on GitHub
This skill should be used when the user asks to configure or troubleshoot Huawei S-series switch stacking (iStack). Covers stack establishment via stack-port or service-port mode, master/slave/standby election, member join/leave, dual-active detection (DAD/MAD), stack split & merge, in-service upgrade, and stack troubleshooting. Applicable platforms S/CE switches S1720/S2700/S5700/S6720 V200R011C10+ (iStack) and CloudEngine 5800-9800 V200R022C00+ (Stack).
In this repository16 other files it gives its agents.
- aaa-auth-configSkill
- attack-defenseSkill
- bgp-configSkill
- ha-hrpSkill
- health-checkSkill
- interface-configSkill
- ipsec-vpnSkill
- mirrorSkill
- nat-configSkill
- ospf-configSkill
- security-policySkill
- ssl-vpnSkill
- static-routeSkill
- vlan-configSkill
- vrrpSkill
- wlan-ac-configSkill
The file
Files
华为 S 系列堆叠 iStack 配置技能 (stack-istack)
适用平台 S1720/S2700/S5700/S6720 V200R011C10+ 文档来源 华为产品文档 dc_cfg_istack_*
iStack 把多台物理交换机虚拟成一台逻辑设备 统一管理 跨设备链路聚合 提带宽和冗余
触发场景
- 新建堆叠 / 加堆叠成员
- 堆叠成员上下线
- 堆叠主备倒换
- 堆叠分裂 / 多主检测 MAD
- 堆叠合并
- 跨设备链路聚合配置
- 堆叠升级
- 堆叠口异常 link DOWN
堆叠基本概念
| 角色 | 说明 |
| Master | 主 唯一 控制整个堆叠 |
| Standby | 备 主故障时升主 |
| Slave | 从 转发数据 多个 |
| Stack-Port / Service-Port | 堆叠口 |
| Stack ID | 堆叠成员编号 1-9 |
| Stack Priority | 优先级 数值大优先 默认 100 |
堆叠模式
1 Stack-Port 模式（专用堆叠口）
某些高端机型有专用堆叠卡或端口（如 S6720 后端口）
2 Service-Port 模式（业务口转堆叠）
常用 把业务口物理光口转为堆叠口 适合 S5700/S6720 等
配置六步走（Service-Port 模式）
1 配置堆叠 ID 与优先级
# 第一台 计划做 Master
system-view
stack
stack member 1 priority 200 # 优先级高 当 Master
stack member 1 renumber 1 # 设 ID 为 1（如有需要）
# 第二台
stack
stack member 1 renumber 2 # 设 ID 为 2
stack member 2 priority 1502 配置堆叠口
# 第一台
interface stack-port 1/1
quit
interface 10GE 1/0/1
shutdown
stack-port 1/1
undo shutdown
quit
# 第二台
interface stack-port 2/1
quit
interface 10GE 1/0/1
shutdown
stack-port 2/1
undo shutdown3 保存配置并重启
save
reboot重启后两台设备会建立堆叠 编号统一
4 验证堆叠
display stack
display stack configuration
display stack peers
display device5 配置 MAD（多主检测 防分裂双主）
方式 A 直连模式（DAD）
两台堆叠成员之间用直连线（MAD 检测口）单独跑 MAD
interface GigabitEthernet 1/0/24
mad detect mode direct
quit
interface GigabitEthernet 2/0/24
mad detect mode direct方式 B 中继模式（通过聚合口）
通过 Eth-Trunk 上的 mad 协议跨堆叠检测
interface Eth-Trunk 1
mad detect mode relay方式 C 代理模式
通过外部交换机做 MAD 代理
6 配置跨设备链路聚合
interface Eth-Trunk 10
mode lacp-static
quit
# 一个成员口在堆叠成员 1 上
interface 10GE 1/0/2
eth-trunk 10
# 另一个成员口在堆叠成员 2 上
interface 10GE 2/0/2
eth-trunk 10对下游表现为一个聚合 实现跨框冗余
命令体系
堆叠管理
| 命令 | 视图 | 说明 |
| stack | system | 进入堆叠视图 |
stack member <id> priority <num> | stack | 优先级 数值大优先 |
stack member <old-id> renumber <new-id> | stack | 改 ID |
stack member <id> domain <num> | stack | 堆叠域（多个堆叠隔离用） |
stack slot <id> | system | 单板视图（CE 系列） |
堆叠口
| 命令 | 视图 | 说明 |
interface stack-port <member-id>/<port-id> | system | 进入堆叠口 |
stack-port <member-id>/<port-id> | interface | 业务口转堆叠口 |
| undo stack-port | interface | 转回业务口 |
MAD
| 命令 | 视图 | 说明 |
| mad detect mode { direct | relay | proxy } | interface | MAD 模式 |
mad domain <num> | system | MAD 域 |
| mad enable | system | 全局启用 MAD |
mad reserve interface <if> | system | 故障保留口（恢复期用） |
查看
| 命令 | 说明 |
| display stack | 堆叠总览 |
| display stack configuration | 堆叠配置 |
| display stack peers | 邻居成员 |
| display stack neighbor | 堆叠口邻居 |
| display stack mad | MAD 状态 |
| display device | 物理设备 |
| display interface stack-port | 堆叠口状态 |
升级与维护
| 命令 | 说明 |
stack slot <id> reboot | 重启指定成员 |
| stack master switchover | 主备倒换 |
| stack upgrade fast | 快速升级（启 ISSU） |
完整范式 两台 S5720 堆叠 + MAD 直连 + 跨框聚合上联
# 设备 1（计划做 Master）
system-view
sysname Stack-1
stack
stack member 1 priority 200
quit
interface 10GE 0/0/1
shutdown
stack-port 1/1
undo shutdown
quit
interface 10GE 0/0/2
shutdown
stack-port 1/2
undo shutdown
quit
# MAD 直连
interface GigabitEthernet 0/0/24
mad detect mode direct
quit
mad enable
# 跨框聚合
interface Eth-Trunk 10
mode lacp-static
quit
interface 10GE 0/0/5 # 成员 1 的 10GE 5
eth-trunk 10
# 设备 2 同步 设 ID 2 优先级 100 完成堆叠口与 MAD 直连
# 重启后两台合并 配置共享 跨框聚合自动建立常见陷阱
- 堆叠口加错（业务口没转为 stack-port）→ 堆叠建不起来
- 堆叠 ID 冲突 → 一台堆叠不能加入
- 没配 MAD → 堆叠分裂时双主 业务严重异常
- 优先级写反 → 期望的主反成备
- 堆叠版本不一致 → ISSU 失败 强制升级才能合并
- 跨框聚合成员都在同一物理框 → 失去跨框冗余意义
- 业务口转堆叠口前没 shutdown → 转换失败
排查流程
堆叠建不起来
display stack看每个成员是否识别到对端display interface stack-port看堆叠口物理状态- 版本一致？
display version - ID 冲突？检查每台 sysview 下
stack member配置
堆叠分裂（脑裂）
display stack mad看 MAD 状态- 物理：堆叠线是否好
- 紧急：手动让一台进 recovery 模式 防双主
相关文件
- references/stack-commands.md 完整命令
- references/stack-troubleshooting.md 分裂/合并/升级
⚠️ S 系列 iStack vs CE 系列 Stack 重要差异
S 系列和 CE 系列堆叠概念相同但命令视图和语法有差别，务必按平台选用。
关键差异对照
| 项 | S 系列 (iStack) | CE 系列 (Stack) |
| 进入堆叠视图 | stack 进入堆叠视图后操作 | 同：stack |
| 堆叠成员配置 | stack member <id> priority <num>（系统视图直接配） | 在堆叠视图下：stack member <id> priority <num> |
| 堆叠域 | stack member <id> domain <num> | 同 |
| 物理口转堆叠口 | 接口下 shutdown → stack-port <m>/<port> → undo shutdown | 接口下 port mode stack → 再用 stack-port 接口聚合 |
| 多口绑定堆叠口 | 单口逐个绑 | interface stack-port 1/1 → port member-group interface 10ge 1/0/1 to 1/0/4（一次绑多个） |
| 修改成员 ID | stack member <old> renumber <new> | stack member <old> renumber <new> inherit-config |
| 配置提交 | save 后重启 | commit 提交，再 save，再重启 |
| 端口自动配置 | 转 stack 后保留默认 | 转后自动加 port crc-statistics trigger error-down |
CE Stack 完整配置范式
< HUAWEI > system-view
[~HUAWEI] sysname SwitchA
[*HUAWEI] commit # CE 必须 commit
[~SwitchA] stack
[~SwitchA-stack] stack member 1 priority 150
[*SwitchA-stack] stack member 1 domain 10
[*SwitchA-stack] quit
[*SwitchA] commit
# 转换业务口为堆叠口
[~SwitchA] interface stack-port 1/1
[*SwitchA-Stack-Port1/1] port member-group interface 10ge 1/0/1 to 1/0/4
[*SwitchA-Stack-Port1/1] commitCE 验证命令
display stack # 查角色 优先级 MAC
display stack configuration # 配置详情
display stack topology # 拓扑（环/链式）CE 输出格式略不同（含 Oper/Conf 区分实际生效与配置）
通用结论
本技能 SKILL.md 默认描述的是 S 系列 iStack 范式。如果你在用 CE 系列，重点关注：
- 所有配置改动后必须
commit - 物理口转堆叠口：先
port mode stack再stack-port <id> - 多个物理口可批量绑入同一堆叠口（
port member-group）
MAD 多主检测（S/CE 通用）
两系列 MAD 命令一致：mad detect mode { direct | relay | proxy }、mad enable、mad domain <num>
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.