目  錄

1 GOLD

1.1 GOLD簡介

1.1.1 診斷類型

1.1.2 測試例

1.2 GOLD配置任務簡介

1.3 配置監控診斷

1.4 模擬診斷結果

1.5 配置GOLD日誌存儲參數

1.6 GOLD顯示和維護

1.7 GOLD典型配置舉例

1.7.1 GOLD基本配置舉例（獨立運行模式）

1.7.2 GOLD基本配置舉例（IRF模式）

 

1 GOLD

1.1  GOLD簡介

GOLD（Generic OnLine Diagnostics，通用在線診斷）通過在設備上執行診斷測試例，來發現硬件故障，並進行問題報告。GOLD檢查的硬件故障主要包括：端口、內存、芯片、連接、轉發路徑以及控製路徑是否正常等。

1.1.1  診斷類型

GOLD目前僅支持監控診斷。

監控診斷（Monitoring Diagnostics）：設備在運行過程中按照一定的時間間隔執行測試例，來周期檢測係統中的硬件是否故障並記錄診斷結果。監控診斷隻能執行非破壞性的測試例。

1.1.2  測試例

GOLD使用測試例來描述診斷（測試）的內容。測試例的內容（參數）包括測試的名稱、診斷的類型、描述信息、屬性（破壞性的/非破壞性的等）、缺省是否執行以及執行的時間等。設備支持哪些測試例以及測試例內容的缺省值與設備的型號以及啟動軟件包版本有關，由開發人員根據產品需求在軟件開發階段指定。測試例的部分參數用戶可以使用本文中提供的命令行修改，其它參數則不能修改。測試例壓縮在System包中，和System包一起發布、安裝。所有測試例開啟後，均在後台執行，用戶可以通過相應的display命令查看測試結果或者日誌信息來判斷設備是否出現了硬件故障。

1.2  GOLD配置任務簡介

GOLD配置任務如下：

(1)     配置監控診斷

¡     配置監控診斷

(2)     （可選）模擬診斷結果

(3)     （可選）配置GOLD日誌存儲參數

1.3  配置監控診斷

1. 功能簡介

對於缺省開啟的監控診斷測試例，在設備啟動後會自動執行；對於缺省沒有開啟的監控診斷測試例，需通過diagnostic monitor enable命令開啟監控診斷功能。

開啟監控診斷測試例後，測試例會按照指定的時間間隔執行。

2. 配置步驟

(1)     進入係統視圖。

system-view

(2)     開啟監控診斷功能。

（獨立運行模式）

diagnostic monitor enable [ test test-name ]

（IRF模式）

diagnostic monitor enable slot slot-number-list [ test test-name ]

缺省情況下，監控診斷功能處於開啟狀態。

(3)     配置監控診斷測試例的執行時間間隔。

（獨立運行模式）

diagnostic monitor interval [ test test-name ] time interval

（IRF模式）

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 [ test test-name ] mode { none | self-reboot | service-restart | switchover | system-reboot }

（IRF模式）

diagnostic monitor action slot slot-number-list [ test test-name ] mode { none | self-reboot | service-restart | switchover | system-reboot }

缺省情況下，不同監控診斷測試例的糾錯動作不同，請使用display diagnostic content verbose命令查看，對於不支持糾錯動作的測試例，顯示為-NA-。

1.4  模擬診斷結果

1. 功能簡介

用戶可通過將監控診斷測試例的執行方式設置為模擬方式來判斷GOLD模塊框架功能是否正常。在該方式下，當測試例滿足執行條件時，係統會執行測試例的部分代碼並生成測試結果，但是不會進行硬件糾錯操作，例如重啟或者主備倒換。

2. 配置步驟

請在用戶視圖下執行以下命令，設置診斷的執行方式為模擬方式。

（獨立運行模式）

diagnostic simulation test test-name { failure | random-failure | success }

（IRF模式）

diagnostic simulation slot slot-number-list test test-name { failure | random-failure | success }

缺省情況下，診斷為非模擬方式。即啟動測試例後，係統會真正執行該測試例。

1.5  配置GOLD日誌存儲參數

1. 功能簡介

GOLD會自動生成日誌，用於記錄測試例的執行結果等信息。用戶可以通過display diagnostic event-log命令查看這些日誌。

2. 配置步驟

(1)     進入係統視圖。

system-view

(2)     配置可存儲的GOLD日誌的最大條數。

diagnostic event-log size number

缺省情況下，可存儲的GOLD日誌的最大條數為512條。

當產生的日誌條數超過用戶配置的最大條數時，GOLD會自動刪除最老日誌。

1.6  GOLD顯示和維護

在完成上述配置後，在任意視圖下執行display命令可以顯示配置後GOLD的運行情況，通過查看顯示信息驗證配置的效果。

在用戶視圖下執行reset命令可以清除GOLD日誌信息和診斷測試結果。

表1-1 GOLD顯示和維護

操作	命令
顯示測試例的內容	（獨立運行模式） display diagnostic content [ verbose ] （IRF模式） display diagnostic content [ slot slot-number ] [ verbose ]
顯示GOLD日誌的信息	display diagnostic event-log [ error | info ]
顯示測試例的執行結果	（獨立運行模式） display diagnostic result [ test test-name ] [ verbose ] （IRF模式） display diagnostic result [ slot slot-number [ test test-name ] ] [ verbose ]
顯示模擬診斷的配置信息	（獨立運行模式） display diagnostic simulation （IRF模式） display diagnostic simulation [ slot slot-number ]
清除GOLD日誌	reset diagnostic event-log
清除診斷測試結果	（獨立運行模式） reset diagnostic result [ test test-name ] （IRF模式） reset diagnostic result [ slot slot-number [ test test-name ] ]

 

1.7  GOLD典型配置舉例

1.7.1  GOLD基本配置舉例（獨立運行模式）

1. 組網需求

開啟監控診斷測試例LIPCMonitor並配置測試例的時間間隔為1分鍾。

2. 配置步驟

# 查看監控診斷測試例的缺省開啟狀態和時間間隔。

<Sysname> display diagnostic content verbose

Diagnostic test suite attributes:

#B/*: Bootup test/NA

#O/*: Ondemand test/NA

#M/*: Monitoring test/NA

#D/*: Disruptive test/Non-disruptive test

#P/*: Per port test/NA

#A/I/*: Monitoring test is active/Monitoring test is inactive/NA

 

Test name        : DBMMonitor

Test attributes  : **M**A

Test interval    : -NA-

Min interval     : -NA-

Correct-action   : self-reboot

Description      : This is a global monitor test.

Exec             : -NA-

 

Test name        : LIPCMonitor

Test attributes  : **M**A

Test interval    : 00:02:10

Min interval     : 00:01:00

Correct-action   : -NA-

Description      : This is a real-time test.

Exec             : -NA-

# 因測試例LIPCMonitor缺省已開啟，故本步驟可選。如未開啟則可通過本配置開啟監控診斷測試例LIPCMonitor。

<Sysname> system-view

[Sysname] diagnostic monitor enable test LIPCMonitor

# 配置監控診斷測試例LIPCMonitor的時間間隔為1分鍾。

[Sysname] diagnostic monitor interval test LIPCMonitor time 0:1:0

3. 驗證配置

# 查看配置的結果。

[Sysname] display diagnostic content verbose

Diagnostic test suite attributes:

#B/*: Bootup test/NA

#O/*: Ondemand test/NA

#M/*: Monitoring test/NA

#D/*: Disruptive test/Non-disruptive test

#P/*: Per port test/NA

#A/I/*: Monitoring test is active/Monitoring test is inactive/NA

 

Test name        : DBMMonitor

Test attributes  : **M**A

Test interval    : -NA-

Min interval     : -NA-

Correct-action   : self-reboot

Description      : This is a global monitor test.

Exec             : -NA-

 

Test name        : LIPCMonitor

Test attributes  : **M**A

Test interval    : 00:01:00

Min interval     : 00:01:00

Correct-action   : -NA-

Description      : This is a real-time test.

Exec             : -NA-

# 查看監控診斷測試例的執行結果。

[Sysname] display diagnostic result verbose

Test name                : DBMMonitor

  Total run count          : 0

  Total failure count      : 0

  Consecutive failure count: 0

  Last execution time      : -NA-

  First failure time       : -NA-

  Last failure time        : -NA-

  Last pass time           : -NA-

  Last execution result    : -NA-

  Last failure reason      : -NA-

  Next execution time      : -NA-

 

  Test name                : LIPCMonitor

  Total run count          : 6

  Total failure count      : 0

  Consecutive failure count: 0

  Last execution time      : Mon Sep 13 19:05:12 2021

  First failure time       : -NA-

  Last failure time        : -NA-

  Last pass time           : Mon Sep 13 19:05:12 2021

  Last execution result    : Success

  Last failure reason      : -NA-

  Next execution time      : Mon Sep 13 19:07:48 2021

1.7.2  GOLD基本配置舉例（IRF模式）

1. 組網需求

在slot 1上，開啟監控診斷測試例LIPCMonitor並配置測試例的時間間隔為1分鍾。

2. 配置步驟

# 查看slot 1上監控診斷測試例的缺省開啟狀態和時間間隔。

<Sysname> display diagnostic content slot 1 verbose

Diagnostic test suite attributes:

#B/*: Bootup test/NA

#O/*: Ondemand test/NA

#M/*: Monitoring test/NA

#D/*: Disruptive test/Non-disruptive test

#P/*: Per port test/NA

#A/I/*: Monitoring test is active/Monitoring test is inactive/NA

 

slot 1:

Test name        : DBMMonitor

Test attributes  : **M**A

Test interval    : -NA-

Min interval     : -NA-

Correct-action   : self-reboot

Description      : This is a global monitor test.

Exec             : -NA-

 

Test name        : LIPCMonitor

Test attributes  : **M**A

Test interval    : 00:02:10

Min interval     : 00:01:00

Correct-action   : -NA-

Description      : This is a real-time test.

Exec             : -NA-

# 因測試例LIPCMonitor缺省已開啟，故本步驟可選。如未開啟則可通過本配置開啟slot 1上的監控診斷測試例LIPCMonitor。

<Sysname> system-view

[Sysname] diagnostic monitor enable slot 1 test LIPCMonitor

# 配置slot 1上的監控診斷測試例LIPCMonitor的時間間隔為1分鍾。

[Sysname] diagnostic monitor interval slot 1 test LIPCMonitor time 0:1:0

3. 驗證配置

# 查看配置的結果。

[Sysname] display diagnostic content slot 1 verbose

Diagnostic test suite attributes:

#B/*: Bootup test/NA

#O/*: Ondemand test/NA

#M/*: Monitoring test/NA

#D/*: Disruptive test/Non-disruptive test

#P/*: Per port test/NA

#A/I/*: Monitoring test is active/Monitoring test is inactive/NA

 

slot 1:

Test name        : DBMMonitor

Test attributes  : **M**A

Test interval    : -NA-

Min interval     : -NA-

Correct-action   : self-reboot

Description      : This is a global monitor test.

Exec             : -NA-

 

Test name        : LIPCMonitor

Test attributes  : **M**A

Test interval    : 00:01:00

Min interval     : 00:01:00

Correct-action   : -NA-

Description      : This is a real-time test.

Exec             : -NA-

# 查看slot 1上監控診斷測試例的執行結果。

[Sysname] display diagnostic result slot 1 verbose

slot 1:

Test name                : DBMMonitor

  Total run count          : 0

  Total failure count      : 0

  Consecutive failure count: 0

  Last execution time      : -NA-

  First failure time       : -NA-

  Last failure time        : -NA-

  Last pass time           : -NA-

  Last execution result    : -NA-

  Last failure reason      : -NA-

  Next execution time      : -NA-

 

  Test name                : LIPCMonitor

  Total run count          : 6

  Total failure count      : 0

  Consecutive failure count: 0

  Last execution time      : Mon Sep 13 19:05:12 2021

  First failure time       : -NA-

  Last failure time        : -NA-

  Last pass time           : Mon Sep 13 19:05:12 2021

  Last execution result    : Success

  Last failure reason      : -NA-

  Next execution time      : Mon Sep 13 19:07:48 2021