兼容性矩阵、发行说明与固件变更

"支持"是关于一个三元组的陈述：这个模块、在这个平台上、运行这个软件版本。厂商在兼容性矩阵和发行说明中发布这个三元组，并且会不断变化——新光模块出现，旧的退出，检查变得更严格。购买前阅读矩阵、升级前重新阅读矩阵，是成本最低的兼容性工作。本页说明这些信息存放在哪里、如何阅读，以及如何管理机队，使软件升级不会变成光模块故障。

厂商在哪里发布支持信息

厂商	资源	列出的内容
Cisco	Transceiver Module Group (TMG) Compatibility Matrix；各平台数据手册	PN ↔ 平台 ↔ 最低软件版本；端口限制
Juniper	Hardware Compatibility Tool (HCT)	光模块 PN ↔ 平台 ↔ Junos 版本、速率、DDM 支持
Arista	Transceiver and Cable Guide（PDF/在线）	PN、PMD、传输距离、各 EOS 版本支持的平台
Huawei	Hardware Center / 产品兼容性列表	各交换机型号对应的光模块代码
H3C	Transceiver Module Compatibility Matrix	按产品系列划分
HPE Aruba	Transceiver Guide、QuickSpecs	各交换机系列和固件对应的 J/R 编号
Dell	Networking Optics/Cables support matrix	SKU ↔ 平台 ↔ OS10 版本
Nvidia/Mellanox	LinkX 产品页面、Cumulus/Onyx 发行说明、InfiniBand 固件说明	线缆/光模块 PN ↔ 交换机/HCA ↔ 固件
Extreme、Ruckus	光模块兼容性指南	按平台划分
Brocade（SAN）	FOS 发行说明、支持的光模块列表	各 FOS 版本对应的品牌 SFP PN
SONiC / 白牌	平台厂商的硬件兼容性列表、社区 wiki	各平台已测试的光模块；通常由社区维护
网卡厂商	Intel/Broadcom/Mellanox 适配器兼容性列表	支持的模块和驱动版本

也要阅读所运行 NOS 版本的发行说明：光模块相关的变化常常藏在"已解决问题""行为变更"和"新硬件支持"这些条目下。

解读矩阵条目

列	含义	注意事项
部件号	交换机期望在模块中看到的精确字符串（部件编号）	等级后缀（`-S`、`-I`、版本字母）被视为不同的 PN
平台 / 端口	哪个机箱、线卡或端口范围	仅上联口、"仅 49–52 端口"、不适用于拆分端口
最低软件版本	首个支持该模块的版本	较新的 PN 用在较旧的版本上＝即使品牌相符也不受支持
速率 / 模式	该 PN 在此端口上支持的速率和拆分方式	4×25G 拆分仅部分平台支持
DDM / DOM	是否暴露诊断信息	某些组合下"DOM not supported"
备注	温度、传输距离、FEC 要求、EOL	停售日期和后继 PN

软件变化带来的影响

变化	对光模块的影响	表现为
新增或更严格的身份校验	之前可容忍的第三方或改码模块被拒绝	升级后端口 errdisabled（各 NOS 如何校验模块）
隐藏的绕过命令被移除或改名	`service unsupported-transceiver` 不再被接受	配置加载失败，端口 down
CMIS 处理逻辑改进或变化	之前需要变通方案的 400G+ 模块现在可以正常工作，或反之	模块卡在 LowPwr（CMIS 问题）
FEC/AN 默认值变化	依赖旧默认值的链路失效	光功率正常但链路 down（FEC 与 AN）
DDM 轮询或阈值处理变化	告警出现或消失	syslog 出现新噪声或变安静
光模块 PN 到达支持终止期	仍可工作，但不再列在列表中	后续工单以"unsupported"关闭
捆绑的模块固件更新	原厂品牌模块获得新固件	模块侧行为发生变化（控制器与固件）

避免意外的机队管理实践

清点 — 在 CMDB 中记录每个端口上每个模块的厂商、PN、序列号、版本和固件（来自交换机或台架测试）。
锁定版本 — 把 NOS 版本当作兼容性三元组的一部分；不要在同一天升级接入层和核心层。
阅读发行说明 — 每次升级前查看光模块相关条目。
在实验室或金丝雀交换机上测试 — 覆盖正在使用的每一种光模块类型，优先测试第三方和改码模块。
保留上一版本镜像 并准备回滚方案；清楚哪些端口容易 errdisable。
升级前后建立 DDM 基线，以便看清监控行为的变化（监测）。
跟踪光模块 PN 的 EOL 及其后继型号，使替换件与矩阵保持一致。

本文视角下的第三方与改码光模块

改码为某个 OEM PN 的模块，会被按照与原厂模块相同的矩阵条目来判断——如果改码做得完整，平台无法分辨区别——但厂商的支持声明并不覆盖它，新版本中更严格的检查可能会将其暴露出来。在清点记录中保留改码模块的可识别信息（真实厂商和序列号），升级时优先测试它们，并为某个版本关闭这条路的情况做好预案（第三方光模块、厂商锁定）。

网卡与服务器侧

服务器适配器有自己的矩阵（适配器 ↔ 模块 ↔ 驱动/固件）和自己的策略——部分 Intel 系列会拒绝未列出的 SFP，除非驱动参数允许；Mellanox/Nvidia 适配器会为 InfiniBand 校验线缆。驱动和固件更新会像 NOS 升级一样改变这些规则（端口配置速查）。

在 CodingBox 中

这是机队管理实践中台架端的工作：在来料检验时把每个模块的身份信息和固件版本读入 Code database，在 Check transceiver 中把可疑模块的字节与矩阵条目对比，并在数据库备注中保留改码/原厂的区分，这样升级当天出现的拒绝几秒钟内就能追溯到具体模块。

网卡驱动和固件策略的详细说明，按厂商和操作系统分类：网卡上的光模块兼容性。

把机队管理实践变成开通检查单——先升级后配置、金丝雀测试、DDM 基线、验收测试：选型与开通。

如果您发现本资料中有不准确之处或错误，请选中相应片段并按 Ctrl+Enter，即可。