26-GOLD配置
本章節下載: 26-GOLD配置 (215.12 KB)
目 錄
GOLD(Generic OnLine Diagnostics,通用在線診斷)通過在設備上執行診斷測試例,來發現硬件故障,並進行問題報告。GOLD檢查的硬件故障主要包括:端口、內存、芯片、連接、轉發路徑以及控製路徑是否正常等。
GOLD支持的診斷類型包括:
· 啟動診斷(Bootup Diagnostics):設備在啟動過程中或者板卡插拔時對板卡進行檢查,設備根據檢查的結果決定板卡能否運行。
· 監控診斷(Monitoring Diagnostics):設備在運行過程中按照一定的時間間隔執行測試例,來周期檢測係統中的硬件是否故障並記錄診斷結果。監控診斷隻能執行非破壞性的測試例。
· 按需診斷(On-Demand Diagnostics):在設備運行過程中,當用戶懷疑硬件故障時,可以手工啟動/停止某些測試例對設備進行診斷,這種診斷稱為按需診斷。
GOLD使用測試例來描述診斷(測試)的內容。測試例的內容(參數)包括測試的名稱、診斷的類型、描述信息、屬性(破壞性的/非破壞性的等)、缺省是否執行以及執行的時間等。設備支持哪些測試例以及測試例內容的缺省值與設備的型號以及啟動軟件包版本有關,由開發人員根據產品需求在軟件開發階段指定。測試例的部分參數用戶可以使用本文中提供的命令行修改,其它參數則不能修改。測試例壓縮在System包中,和System包一起發布、安裝。所有測試例開啟後,均在後台執行,用戶可以通過相應的display命令查看測試結果或者日誌信息來判斷設備是否出現了硬件故障。
GOLD配置任務如下:
(1) 配置診斷
請至少選擇其中一項進行配置。
¡ 配置啟動診斷
¡ 配置監控診斷
¡ 配置按需診斷
(2) (可選)模擬診斷結果
(3) (可選)配置GOLD日誌存儲參數
以下配置步驟,請根據需要選擇其中一項進行配置。
· 在用戶視圖下,配置設備下次啟動時,執行指定的啟動診斷測試例。
diagnostic bootup enable slot slot-number-list test test-name [ para parameters ]
缺省情況下,係統在啟動時不執行啟動測試例。
· 在係統視圖下,配置設備下次啟動時,執行所有啟動診斷測試例。
a. system-view
b. diagnostic bootup level complete
缺省情況下,係統在啟動時不執行啟動測試例。
· 在係統視圖下,配置設備下次啟動時,所有啟動診斷測試例均不執行。
a. system-view
b. diagnostic bootup level bypass
缺省情況下,係統在啟動時不執行啟動測試例。
對於缺省開啟的監控診斷測試例,在設備啟動後會自動執行;對於缺省沒有開啟的監控診斷測試例,需通過diagnostic monitor enable命令開啟監控診斷功能。
開啟監控診斷測試例後,測試例會按照指定的時間間隔執行。
(1) 進入係統視圖。
system-view
(2) 開啟監控診斷功能。
diagnostic monitor enable slot slot-number-list [ test test-name ]
diagnostic monitor enable命令的缺省情況與設備的型號以及版本有關,請以設備的實際情況為準。
(3) 配置監控診斷測試例的執行時間間隔。
diagnostic monitor interval slot slot-number-list [ test test-name ] time interval
缺省情況下,不同測試例的執行時間間隔不同,請使用display diagnostic content命令查看。
interval的值不能小於監控診斷測試例要求的最小值。執行攜帶verbose參數的display diagnostic content命令,通過顯示信息中的Min interval字段可獲知監控診斷測試例要求的最小值。
(4) 配置監控診斷測試例的糾錯動作。
diagnostic monitor action slot slot-number-list [ test test-name ] mode { none | self-reboot | service-restart | switchover | system-reboot }
缺省情況下,不同監控診斷測試例的糾錯動作不同,請使用display diagnostic content verbose命令查看,對於不支持糾錯動作的測試例,顯示為-NA-。
按需診斷由設備管理維護人員根據設備當前狀態開始或者停止運行。
按需診斷測試例啟動後,何時停止執行,受三條命令的限製:
· 使用diagnostic ondemand stop命令可立即停止執行該測試例。
· 如果某測試例的執行次數達到diagnostic ondemand repeating命令中指定的值,則係統會自動停止執行該測試例。
· 如果某測試例累計失敗的執行次數已達到diagnostic ondemand failure命令中指定的值,則係統會自動停止執行該測試例。
所有配置的diagnostic ondemand關鍵字開頭的命令行隻在設備的本次運行過程中生效,設備重啟後這些命令將恢複到缺省情況。
請在用戶視圖下,進行如下配置:
(1) 配置按需診斷的重複執行次數。
diagnostic ondemand repeating repeating-number
缺省情況下,按需類型診斷測試例重複執行的次數為1次,表示執行一次就結束。
本命令對當前已經啟動、執行的按需診斷測試例不生效,隻對後續啟動的測試例生效。
(2) 配置按需診斷的累計失敗執行次數。
diagnostic ondemand failure failure-number
缺省情況下,不限製按需測試例的累計失敗執行次數的最大值。
配置時,failure-number的值必須小於等於repeating-number的值。
本命令對當前已經啟動、執行的按需診斷測試例不生效,隻對後續啟動的測試例生效。
(3) 啟動按需類型診斷。
diagnostic ondemand start slot slot-number-list test { test-name | non-disruptive } [ para parameters ]
若沒有進行前兩個配置操作,啟動時按缺省配置啟動。
(4) (可選)手工停止按需類型診斷。
diagnostic ondemand stop slot slot-number-list test { test-name | non-disruptive }
用戶可以手動停止所有的按需類型測試例。
設備出廠時,會攜帶一些和腳本綁定的測試例。用戶執行這樣的測試例,係統會自動執行對應的腳本,目前支持Tcl腳本和Shell腳本,例如通過調用Tcl腳本來檢測設備上電後芯片或端口的基本信息。執行一次命令,和腳本綁定的測試例就執行一次,檢測結果會直接輸出到命令行輸入界麵供用戶查看。
請在用戶視圖下執行以下命令,來執行和腳本綁定的診斷。
diagnostic start test test-name [ parameters ]
用戶可通過將監控診斷測試例或者按需診斷測試例的執行方式設置為模擬方式來判斷GOLD模塊框架功能是否正常。在該方式下,當測試例滿足執行條件時,係統會執行測試例的部分代碼並生成測試結果,但是不會進行硬件糾錯操作,例如重啟或者主備倒換。
請在用戶視圖下執行以下命令,設置診斷的執行方式為模擬方式。
diagnostic simulation slot slot-number-list test test-name { failure | random-failure | success }
缺省情況下,診斷為非模擬方式。即啟動測試例後,係統會真正執行該測試例。
GOLD會自動生成日誌,用於記錄測試例的執行結果等信息。用戶可以通過display diagnostic event-log命令查看這些日誌。
(1) 進入係統視圖。
system-view
(2) 配置可存儲的GOLD日誌的最大條數。
diagnostic event-log size number
缺省情況下,可存儲的GOLD日誌的最大條數為512條。
當產生的日誌條數超過用戶配置的最大條數時,GOLD會自動刪除最老日誌。
在完成上述配置後,在任意視圖下執行display命令可以顯示配置後GOLD的運行情況,通過查看顯示信息驗證配置的效果。
在用戶視圖下執行reset命令可以清除GOLD日誌信息和診斷測試結果。
表1-1 GOLD顯示和維護
操作 |
命令 |
顯示啟動診斷測試例的信息 |
display diagnostic bootup [ slot slot-number ] [ test test-name ] |
顯示設備本次啟動時生效的啟動診斷的級別 |
display diagnostic bootup level |
顯示測試例的內容 |
display diagnostic content [ slot slot-number ] [ verbose ] |
顯示GOLD日誌的信息 |
display diagnostic event-log [ error | info ] |
顯示按需診斷的配置信息 |
display diagnostic ondemand configuration |
顯示測試例的執行結果 |
display diagnostic result [ slot slot-number [ test test-name ] ] [ verbose ] |
顯示與報文相關的測試例的統計信息 |
display diagnostic result [ slot slot-number [ test test-name ] ] statistics |
顯示模擬診斷的配置信息 |
display diagnostic simulation [ slot slot-number ] |
清除GOLD日誌 |
reset diagnostic event-log |
清除診斷測試結果 |
reset diagnostic result [ slot slot-number [ test test-name ] ] |
不同款型規格的資料略有差異, 詳細信息請向具體銷售和400谘詢。H3C保留在沒有任何通知或提示的情況下對資料內容進行修改的權利!