# Stack Istack

> 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).

- Skill: `nanxiaoyao/stack-istack` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add nanxiaoyao/stack-istack`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nanxiaoyao/stack-istack/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: nanxiaoyao (https://skillmd.com/u/nanxiaoyao)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nanxiaoyao/stack-istack

---


# 华为 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 150
```

### 2 配置堆叠口
```
# 第一台
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 shutdown
```

### 3 保存配置并重启
```
save
reboot
```
重启后两台设备会建立堆叠 编号统一

### 4 验证堆叠
```
display stack
display stack configuration
display stack peers
display device
```

### 5 配置 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 → 转换失败

## 排查流程

### 堆叠建不起来
1. `display stack` 看每个成员是否识别到对端
2. `display interface stack-port` 看堆叠口物理状态
3. 版本一致？`display version`
4. ID 冲突？检查每台 sysview 下 `stack member` 配置

### 堆叠分裂（脑裂）
1. `display stack mad` 看 MAD 状态
2. 物理：堆叠线是否好
3. 紧急：手动让一台进 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] commit
```

### CE 验证命令
```
display stack                  # 查角色 优先级 MAC
display stack configuration    # 配置详情
display stack topology         # 拓扑（环/链式）
```
CE 输出格式略不同（含 Oper/Conf 区分实际生效与配置）

### 通用结论
本技能 SKILL.md 默认描述的是 **S 系列 iStack** 范式。如果你在用 CE 系列，重点关注：
1. 所有配置改动后必须 `commit`
2. 物理口转堆叠口：先 `port mode stack` 再 `stack-port <id>`
3. 多个物理口可批量绑入同一堆叠口（`port member-group`）

### MAD 多主检测（S/CE 通用）
两系列 MAD 命令一致：`mad detect mode { direct | relay | proxy }`、`mad enable`、`mad domain <num>`