目  录

1 GOLD

1.1 GOLD配置命令

1.1.1 diagnostic event-log size

1.1.2 diagnostic monitor action

1.1.3 diagnostic monitor enable

1.1.4 diagnostic monitor interval

1.1.5 diagnostic simulation

1.1.6 display diagnostic content

1.1.7 display diagnostic event-log

1.1.8 display diagnostic result

1.1.9 display diagnostic simulation

1.1.10 reset diagnostic event-log

1.1.11 reset diagnostic result

1 GOLD

测试例的支持情况与设备的型号有关，请以设备的实际情况为准。GOLD配置命令举例中使用的测试例仅为示例，可在命令行中输入测试例名称位置输入“？”来获取设备支持的测试例的名称。

1.1  GOLD配置命令

1.1.1  diagnostic event-log size

diagnostic event-log size命令用来配置可存储的GOLD日志的最大条数。

undo diagnostic event-log size命令用来恢复缺省情况。

【命令】

diagnostic event-log size number

undo diagnostic event-log size

【缺省情况】

可存储的GOLD日志的最大条数为512条。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

number：可存储的GOLD日志的最大条数，取值范围为0～1024。

【使用指导】

执行该命令时，如果指定的number值小于当前已存储的GOLD日志的条数，则系统会自动删除最旧的GOLD日志，直到当前GOLD日志的条数为number。

当设备当前已存储的GOLD日志的条数达到最大值，同时还有新的GOLD日志需要存储时，系统会删除最旧的日志来存储新的日志。

【举例】

# 配置可存储的GOLD日志的最大条数为600条。

<Sysname> system-view

[Sysname] diagnostic event-log size 600

1.1.2  diagnostic monitor action

diagnostic monitor action命令用来配置监控诊断测试例的纠错动作。

undo diagnostic monitor action命令用来恢复缺省情况。

【命令】

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

undo diagnostic monitor action [ test test-name ]

【缺省情况】

不同监控诊断测试例的纠错动作不同，请使用display diagnostic content verbose命令查看，对于不支持纠错动作的测试例，对应项显示为-NA-。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

test test-name：指定监控诊断测试例的名称，区分大小写。具体取值可通过在test参数后输入问号来获取。不指定该参数时，表示所有监控诊断测试例。

none：表示当测试例检测到本板的特性功能异常时，如果本板的测试项的纠错动作配置了该参数，不触发动作。

self-reboot：表示当测试例检测到本板的特性功能异常时，如果测试项的纠错动作配置了该参数，触发本板重启的动作。

service-restart：表示当测试例检测到特性功能异常时，会自动重启该特性。

switchover：表示当测试例检测到特性功能异常时，会触发主用主控板和备用主控板之间倒换的动作。

system-reboot：表示当测试例检测到本板的特性功能异常时，如果测试项的纠错动作配置了该参数，触发整机重启的动作。

【举例】

# 配置测试例MonitorTest的纠错动作为self-reboot。

<Sysname> system-view

[Sysname] diagnostic monitor action test MonitorTest mode self-reboot

1.1.3  diagnostic monitor enable

diagnostic monitor enable命令用来开启监控诊断功能。

undo diagnostic monitor enable命令用来关闭监控诊断功能。

【命令】

diagnostic monitor enable [ test test-name ]

undo diagnostic monitor enable [ test test-name ]

【缺省情况】

监控诊断功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

test test-name：指定测试例的名称，区分大小写。具体取值可通过在test参数后输入问号来获取。不指定该参数时，表示所有监控诊断测试例。

【使用指导】

监控诊断是指系统在运行过程中按照一定的时间间隔定时执行测试例，来检测系统中的硬件故障并记录诊断结果。监控诊断只能执行非破坏性的测试例。

破坏性和非破坏性是测试例的一个属性，由开发人员在设计测试例的时候指定。其中：

·     破坏性测试例在执行过程中会对设备当前正常运行的业务产生影响或导致业务无法运行，如内存耗尽测试例。

·     非破坏性测试例在执行过程中不会对设备当前正常运行的业务产生影响。

对于缺省启动的监控诊断测试例，在设备启动后会自动执行；对于缺省关闭的监控诊断测试例，须使用本命令才能执行。

【举例】

# 使能测试例MonitorTest。

<Sysname> system-view

[Sysname] diagnostic monitor enable test MonitorTest

【相关命令】

·     diagnostic monitor interval

1.1.4  diagnostic monitor interval

diagnostic monitor interval命令用来配置监控诊断测试例的执行时间间隔。

undo diagnostic monitor interval命令用来恢复缺省情况。

【命令】

diagnostic monitor interval [ test test-name ] time interval

undo diagnostic monitor interval [ test test-name ]

【缺省情况】

不同测试例的执行时间间隔不同，请使用display diagnostic content命令查看。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

test test-name：指定测试例的名称，区分大小写。具体取值可通过在test参数后输入问号来获取。不指定该参数时，表示所有监控诊断测试例。

interval：监控诊断测试例的执行时间间隔，格式为hh:mm:ss（小时:分钟:秒）。其中hh取值范围为0～23，mm取值范围为0～59，ss取值范围为0～59。如果要设置成整分，则可以不输入秒；如果要设置成整时，则可以不输入分和秒。比如将interval参数设置为1表示执行时间间隔为1小时。

【使用指导】

使能监控诊断测试例后，测试例会按照一定的执行时间间隔周期执行，这个执行时间间隔可用该命令配置。

用户配置的执行时间间隔不能小于监控诊断测试例要求的最小值。监控诊断测试例要求的最小值可使用携带verbose参数的display diagnostic content命令查看。

【举例】

# 配置测试例MonitorTest的执行时间间隔为1分钟。

<Sysname> system-view

[Sysname] diagnostic monitor interval test MonitorTest time 00:01:00

【相关命令】

·     diagnostic monitor enable

·     display diagnostic content

1.1.5  diagnostic simulation

diagnostic simulation命令用来设置诊断的执行方式为模拟方式。

undo diagnostic simulation命令用来恢复缺省情况。

【命令】

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

undo diagnostic simulation test test-name

【缺省情况】

诊断为非模拟方式。即启动测试例后，系统会真正执行该测试例。

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

test-name：指定进行模拟诊断的测试例名称，区分大小写。具体取值可通过在test参数后输入问号来获取。

failure：假设模拟执行测试例失败，此时将输出测试失败的结果。

random-failure：表示随机选择模拟执行测试例的结果是成功还是失败。

success：假设模拟执行测试例成功，此时将输出测试成功的结果。

【使用指导】

配置该命令后，当测试例满足执行条件时，在执行测试例的时候就直接生成测试结果，并不真正执行测试例，也不会触发硬件纠正行为。该功能用于判断GOLD模块框架功能是否正常。

【举例】

# 配置MonitorTest模拟诊断失败。

<Sysname> diagnostic simulation test MonitorTest failure

【相关命令】

·     display diagnostic simulation

1.1.6  display diagnostic content

display diagnostic content命令用来显示测试例的内容。

【命令】

display diagnostic content [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

verbose：显示测试例的详细信息；不指定该参数时，显示测试例的简要信息。

【举例】

# 显示诊断测试例的简要信息。

<Sysname> display diagnostic content

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

Name                            Attributes             Interval                

MonitorTest                     **M*PA                 01:00:00                

# 显示诊断测试例的详细信息。

<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        : MonitorTest                                          

Test attributes  : **M*PA                                                      

Test interval    : 01:00:00                                                    

Min interval     : 00:00:06                                                     

Correct-action   : -NA-                                                        

Description      : A Real-time test, enabled by default that checks board status

 between local master and other local boards.                                   

Exec             : -NA-                                                        

表1-1 display diagnostic content命令显示信息描述表

1.1.7  display diagnostic event-log

display diagnostic event-log命令用来显示GOLD日志的信息。

【命令】

display diagnostic event-log [ error | info ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

error：显示所有错误相关的GOLD日志信息。

info：显示所有非错误的GOLD日志信息

【使用指导】

不指定error和info参数时，显示所有GOLD日志的信息。

系统在执行完诊断测试例后，会产生GOLD日志用于记录测试例相关执行情况，日志内容包括测试例的名称、执行时间、执行结果、失败原因等信息。由于所有测试例在执行过程都会产生日志，因此GOLD日志会较多，为了不影响信息中心的性能，GOLD日志独立存储和显示，不会发往信息中心统一处理。

设备重启后，GOLD日志会全部被清除。

【举例】

# 显示所有GOLD日志的信息。

<Sysname> display diagnostic event-log

Event: E_INFO, Wed Jan  7 11:39:53:314 2017, TestName->IPCMonitor, Event_INFO: Result->Success.

1.1.8  display diagnostic result

display diagnostic result命令用来显示测试例的执行结果。

【命令】

display diagnostic result [ test test-name ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

test test-name：指定测试例的名称，区分大小写。具体取值可通过在test参数后输入问号来获取。不指定该参数时，表示所有测试例。

verbose：显示当前处于使能状态的测试例或者累计执行次数大于0的测试例执行结果的详细信息，不包括统计信息。不指定该参数时，只显示累计执行次数大于0的测试例执行结果的简要信息。

【举例】

# 显示所有测试例的简要诊断结果。

<Sysname> display diagnostic result

  Name                            Run count    Failure count    Last result    

  MonitorTest                     386          0                Success        

# 显示所有测试例的详细诊断结果。

<Sysname> display diagnostic result verbose

  Test name                : MonitorTest                                

  Total run count          : 386                                               

  Total failure count      : 0                                                 

  Consecutive failure count: 0                                                 

  Last execution time      : Fri Nov 21 23:00:01 2014                          

  First failure time       : -NA-                                              

  Last failure time        : -NA-                                              

  Last pass time           : Fri Nov 21 23:00:01 2014                          

  Last execution result    : Success                                           

  Last failure reason      : -NA-                                               

  Next execution time      : Sat Nov 22 00:00:07 2014                          

  Slot  check status : Normal

表1-2 display diagnostic result命令显示信息描述表

1.1.9  display diagnostic simulation

display diagnostic simulation命令用来显示模拟诊断的配置信息。

【命令】

display diagnostic simulation

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示模拟诊断配置信息。

<Sysname> display diagnostic simulation

  Name                            Mode

  MonitorTest                     failure

【相关命令】

·     diagnostic simulation

1.1.10  reset diagnostic event-log

reset diagnostic event-log命令用来清除GOLD日志。

【命令】

reset diagnostic event-log

【视图】

用户视图

【缺省用户角色】

network-admin

【举例】

# 清除GOLD日志。

<Sysname> reset diagnostic event-log

【相关命令】

·     display diagnostic event-log

1.1.11  reset diagnostic result

reset diagnostic result命令用来清除诊断测试结果。

【命令】

reset diagnostic result [ test test-name ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

test test-name：指定测试例的名称，区分大小写。具体取值可通过在test参数后输入问号来获取。不指定该参数时，表示所有测试例。

【使用指导】

本命令清除测试结果时，不会清除下次诊断执行时间。

【举例】

# 清除MonitorTest的测试结果。

<Sysname> reset diagnostic result test MonitorTest

【相关命令】

·     display diagnostic result