兼容性矩陣、發行說明與固件變更

「支援」是關於一個三元組的陳述：這個模組、在這個平台上、運行這個軟件版本。廠商在兼容性矩陣和發行說明中發佈這個三元組，並且會不斷變化——新光模組出現，舊的退出，檢查變得更嚴格。購買前閱讀矩陣、升級前重新閱讀矩陣，是成本最低的兼容性工作。本頁說明這些資訊存放在哪裏、如何閱讀，以及如何管理機隊，使軟件升級不會變成光模組故障。

廠商在哪裏發佈支援資訊

廠商	資源	列出的內容
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，即可。