文档是排障时的第一现场
存储网络的文档不是给审计看的：故障时刻能不能迅速判断某台主机应当看到哪些目标、某条路径属于哪个 fabric，直接决定恢复速度。完整的文档通常包括拓扑图、端口对应表、设备名称台账（WWN 或 IQN）、分区与激活配置、版本与许可证信息，以及每次变更的记录。文档失效的典型原因是「先改配置，事后补文档」——补的记录往往缺少当时的判断依据。
基本信息
| 台账内容 | 主机名称、端口标识、交换机端口、配线架与阵列前端端口 |
|---|---|
| 配置记录 | 分区集与激活配置、别名集、版本与许可证 |
| 变更要素 | 时间、执行人、内容、影响范围、验证结果、回滚情况 |
| 更新时机 | 变更完成即更新，季度做一次全量核对 |
| 权限要求 | 存放位置需访问控制，敏感信息限定范围 |
典型使用场景
- 新设备上线与端口调整后的台账更新
- 故障排查时快速确认主机与目标的可见性关系
- 人员交接与轮换期的知识传递
- 审计或安全检查提供配置与变更证据
- 容量与扩容规划时评估端口与路径余量
台账建议字段
台账建议字段
# 主机侧：主机名、业务系统、HBA 端口标识、所属 fabric
# fabric 侧：交换机名称、端口号、对应配线架端口、速率
# 阵列侧：控制器、前端端口、主机组、映射的存储单元
# 配置侧：分区集名称、成员、激活时间、版本
# 变更侧：变更单号、内容摘要、验证结果与遗留问题文档类型与更新时机
| 文档类型 | 内容 | 更新时机 |
|---|---|---|
| 拓扑图 | 设备与链路关系 | 新增或迁移设备后 |
| 端口对应表 | 主机、交换机、配线架与阵列端口 | 任何接线变化后 |
| 名称台账 | WW 标识与主机业务对应关系 | 更换适配器或重装系统后 |
| 分区记录 | 分区集、成员与激活状态 | 每次分区变更后 |
| 版本记录 | 固件、驱动与许可证信息 | 升级或替换后 |
| 变更记录 | 操作、影响与验证结果 | 每次变更完成后 |
变更记录除了写做了什么，更要写为什么这么做以及当时的判断依据；三个月后回看时，缺少原因的记录几乎无法用于复盘。
拓扑与名称台账包含设备标识等敏感信息，应按最小必要范围控制访问与分发，避免在公共位置长期存放大范围可读的副本。