12-GOLD命令
本章节下载: 12-GOLD命令 (159.17 KB)
目 录
1.1.1 diagnostic event-log size
1.1.2 diagnostic monitor enable
1.1.3 diagnostic monitor interval
1.1.4 diagnostic ondemand failure
1.1.5 diagnostic ondemand repeating
1.1.6 diagnostic ondemand start
1.1.7 diagnostic ondemand stop
1.1.9 display diagnostic content
1.1.10 display diagnostic event-log
1.1.11 display diagnostic ondemand configuration
1.1.12 display diagnostic result
1.1.13 display diagnostic result statistics
1.1.14 display diagnostic simulation
1.1.15 reset diagnostic event-log
1.1.16 reset diagnostic result
diagnostic event-log size命令用来配置可存储的GOLD日志的最大条数。
undo diagnostic event-log size命令用来恢复缺省情况。
diagnostic event-log size number
undo diagnostic event-log size
可存储的GOLD日志的最大条数为512条。
number:可存储的GOLD日志的最大条数,取值范围为0~1024,单位为条。
执行该命令时,如果指定的number值小于当前已存储的GOLD日志的条数,则系统会自动删除最旧的GOLD日志,直到当前GOLD日志的条数为number。
当设备当前已存储的GOLD日志的条数达到最大值,同时还有新的GOLD日志需要存储时,系统会删除最旧的日志来存储新的日志。
# 配置可存储的GOLD日志的最大条数为600条。
[Sysname] diagnostic event-log size 600
diagnostic monitor enable命令用来开启监控诊断功能。
undo diagnostic monitor enable命令用来关闭监控诊断功能。
diagnostic monitor enable slot slot-number-list [ test test-name ]
undo diagnostic monitor enable slot slot-number-list [ test test-name ]
不同监控诊断测试例的功能开启情况不尽相同,请以在设备通过命令display diagnostic content显示的具体监控诊断测试例的开启情况为准。
slot slot-number-list:成员编号/PEX虚拟槽位号列表。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中,slot-number表示设备在IRF中的成员编号或者PEX的虚拟槽位号,&<1-7>表示前面的参数最多可以输入7次。
test test-name:指定测试例的名称,为1~31个字符的字符串,不区分大小写。不指定该参数时,表示使能指定成员设备上的所有监控诊断测试例。
系统在运行过程中按照一定的时间间隔定时执行测试例,来检测系统中的硬件故障并记录诊断结果的过程,称为监控诊断。监控诊断只能执行非破坏性的测试例。
破坏性和非破坏性是测试例的一个属性,由开发人员在设计测试例的时候指定。其中:
· 破坏性测试例在执行过程中会对设备当前正常运行的业务产生影响或导致业务无法运行,如内存耗尽测试例。
· 非破坏性测试例在执行过程中不会对设备当前正常运行的业务产生影响。
对于缺省启动的监控诊断测试例,在设备启动后会自动执行;对于缺省关闭的监控诊断测试例,须使用本命令才能执行。
# 使能指定slot上的测试例HGMonitor。
[Sysname] diagnostic monitor enable slot 1 test HGMonitor
diagnostic monitor interval命令用来配置监控诊断测试例的执行时间间隔。
undo diagnostic monitor interval命令用来恢复缺省情况。
diagnostic monitor interval slot slot-number-list [ test test-name ] time time
undo diagnostic monitor interval slot slot-number-list [ test test-name ]
不同监控诊断测试例时间间隔不尽相同,请以在设备通过命令display diagnostic content显示的具体监控诊断测试例的时间间隔为准。
slot slot-number-list:成员编号/PEX虚拟槽位号列表。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中,slot-number表示需要配置的设备在IRF中的成员编号或者PEX的虚拟槽位号。&<1-7>表示前面的参数最多可以输入7次。
test test-name:指定测试例的名称,为1~31个字符的字符串,不区分大小写。不指定该参数时,表示指定成员设备上的所有监控诊断测试例。
time:指定监控诊断测试例的执行时间间隔,格式为hh:mm:ss(小时:分钟:秒)。其中hh取值范围为0~23,mm取值范围为0~59,ss取值范围为0~59。如果要设置成整分,则可以不输入秒;如果要设置成整时,则可以不输入分和秒。比如将time参数设置为1表示时间间隔为1小时。
使能监控诊断测试例后,测试例会按照一定的时间间隔周期执行,这个时间间隔可用该命令配置。
用户配置的时间间隔不能小于监控诊断测试例要求的最小值。监控诊断测试例要求的最小值可使用携带verbose参数的display diagnostic content命令查看。
# 配置指定slot上测试例HGMonitor的执行时间间隔为1分钟。
[Sysname] diagnostic monitor interval slot 1 test HGMonitor time 00:01:00
diagnostic ondemand failure命令用来配置按需诊断测试例的累计失败执行次数的最大值。
undo diagnostic ondemand failure命令用来恢复缺省情况。
diagnostic ondemand failure failure-number
undo diagnostic ondemand failure
failure-number:指定失败的次数,取值范围为1~999。
使用diagnostic ondemand start命令启动按需诊断测试例后,这些测试例什么时候终止执行,受三条命令的限制:
· 使用diagnostic ondemand stop命令可立即停止执行该测试例。
· 如果某测试例的执行次数达到diagnostic ondemand repeating命令中指定的值,则系统会自动停止执行该测试例。
· 如果某测试例的执行次数还未达到diagnostic ondemand repeating命令中指定的值,但是测试例在启动后,累计失败的执行次数已达到diagnostic ondemand failure命令中指定的值,则系统会自动停止执行该测试例。
本命令可用来修改将要启动的按需诊断测试例的累计失败执行次数的最大值,当前已启动的按需诊断测试例仍使用修改前的值。设备重启后,本命令会恢复到缺省情况,如仍需修改,请重新配置。
# 配置按需诊断测试例的累计失败执行次数的最大值为5次。
<Sysname> diagnostic ondemand failure 5
· diagnostic ondemand repeating
· diagnostic ondemand start
· display diagnostic ondemand configuration
diagnostic ondemand repeating命令用来配置按需诊断测试例重复执行的次数。
undo diagnostic ondemand repeating命令用来恢复缺省情况。
diagnostic ondemand repeating repeating-number
undo diagnostic ondemand repeating
按需类型诊断测试例重复执行的次数为1次数,表示执行一次就结束。
repeating-number:表示按需诊断测试例重复执行的次数,取值范围为1~999。
本命令用来修改将要启动的按需诊断测试例重复执行的次数,当前已启动的按需诊断测试例仍使用修改前的值。设备重启后,本命令会恢复到缺省情况,如仍需修改,请重新配置。
按需诊断测试例重复执行的次数不能比配置的失败次数小,否则,命令执行失败。按需诊断测试例的失败次数可通过diagnostic ondemand failure命令配置。
# 配置按需类型测试例重复执行的次数为2。
<Sysname> diagnostic ondemand repeating 2
· display diagnostic configuration
diagnostic ondemand start命令用来启动按需类型诊断。
diagnostic ondemand start slot slot-number-list test { non-disruptive | test-name } [ para parameters ]
slot slot-number-list:成员编号/PEX虚拟槽位号列表。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中,slot-number表示需要执行的设备在IRF中的成员编号或者PEX的虚拟槽位号。&<1-7>表示前面的参数最多可以输入7次。
test-name:指定测试例的名称,为1~31个字符的字符串,不区分大小写。
non-disruptive:执行所有的非破坏性的测试例。
para parameters:扩展参数,暂时无意义。
在设备维护过程中,用户可以手工启动某些测试例对设备进行诊断,这种诊断称为按需诊断。用于这种诊断的测试例称为按需诊断测试例。
用户可以通过命令行配置按需诊断测试例重复执行的次数以及累计失败执行次数的最大值。当用户开启某测试例后,测试例在执行过程中,只要达到上述任意条件,则立即自动停止执行。
# 启动指定slot上非破坏性按需诊断测试例。
<Sysname> diagnostic ondemand start slot 1 test non-disruptive
· diagnostic ondemand repeating
diagnostic ondemand stop命令用来停止指定按需类型诊断。
diagnostic ondemand stop slot slot-number-list test { non-disruptive | test-name }
slot slot-number-list:成员编号/PEX虚拟槽位号列表。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中,slot-number表示需要执行的设备在IRF中的成员编号或者PEX的虚拟槽位号。&<1-7>表示前面的参数最多可以输入7次。
test-name:指定测试例的名称,为1~31个字符的字符串,不区分大小写。
non-disruptive:执行所有的非破坏性的测试例。
用户可以通过命令行配置按需诊断测试例重复执行的次数以及累计失败执行次数的最大值。当用户开启某测试例后,测试例在执行过程中,只要达到上述任意条件,则立即自动停止执行。
# 手动停止指定slot上执行的所有非破坏性测试例。
<Sysname> diagnostic ondemand stop slot 1 test non-disruptive
· diagnostic ondemand repeating
diagnostic simulation命令用来设置诊断的执行方式为模拟方式。
undo diagnostic simulation命令用来恢复缺省情况。
diagnostic simulation slot slot-number-list test test-name { failure | random-failure | success }
undo diagnostic simulation slot slot-number-list test test-name
slot slot-number-list:成员编号/PEX虚拟槽位号列表。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中,slot-number表示需要模拟的设备在IRF中的成员编号或者PEX的虚拟槽位号。&<1-7>表示前面的参数最多可以输入7次。
test-name:指定进行模拟诊断的测试例名称,为1~31个字符的字符串,不区分大小写。
failure:假设模拟执行测试例失败,此时将输出测试失败的结果。
random-failure:表示随机选择模拟执行测试例的结果是成功还是失败。
success:假设模拟执行测试例成功,此时将输出测试成功的结果。
配置该命令后,当测试例满足执行条件时,在执行测试例的时候就直接生成测试结果,并不真正执行测试例,也不会触发硬件纠正行为。该功能用于判断GOLD模块框架功能是否正常。
只有监控诊断测试例和按需诊断测试例支持该命令,启动诊断测试例不支持该命令。
# 配置指定slot上的HGMonitor模拟诊断失败。
<Sysname> diagnostic simulation slot 1 test HGMonitor failure
· display diagnostic simulation
display diagnostic content命令用来显示测试例的内容。
display diagnostic content [ slot slot-number ] [ verbose ]
slot slot-number:表示设备在IRF中的成员编号或者PEX的虚拟槽位号。不指定时,表示所有成员设备/PEX。
verbose:显示测试例的详细信息;不指定该参数时,显示测试例的简要信息。
# 显示指定slot上诊断测试例的简要信息。
<Sysname> display diagnostic content slot 1
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 :
Name Attributes Interval
HGMonitor **M*PI 00:00:10
# 显示指定slot上诊断测试例的详细信息。
<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 : HGMonitor
Test attributes : **M*PI
Test interval : 00:00:10
Min interval : 00:00:10
Correct-action : -NA-
Description : A Real-time test, disabled by default that checks link status between ports.
exec : -NA-
表1-1 display diagnostic content命令显示信息描述表
启动诊断测试例/非启动诊断测试例 |
|
按需诊断测试例/非按需诊断测试例 |
|
监控诊断测试例/非监控诊断测试例 |
|
破坏性测试例/非破坏性测试例 |
|
端口相关的测试例/不是端口相关的测试例 |
|
使能的监控诊断测试例/未使能的监控诊断测试例/非监控诊断测试例 |
|
显示指定slot上测试例的内容 |
|
测试例的属性。从左到右依次为是否为启动诊断测试例,是否为按需诊断测试例,是否为监控诊断测试例,是否是破坏性测试例,是否是端口都相关的测试例,是否使能,对于不相关的属性用“*”表示 |
|
exec |
和测试例绑定的Tcl脚本的路径。当测试例没有和Tcl脚本绑定时,显示为-NA- |
display diagnostic event-log命令用来显示GOLD日志的信息。
display diagnostic event-log [ error | info ]
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 2014, -Slot=1-Cpu=0 TestName->SystemMgmtBus, Event_INFO: Result->Success.
Event: E_ERROR, Wed Jan 7 11:39:53:314 2014, -Slot=1-Cpu=0 TestName->SystemMgmtBus, Event_INFO: Result->Failure Reason->The port 9 is offline.
display diagnostic ondemand configuration命令用来显示按需诊断的配置信息。
display diagnostic ondemand configuration
# 配置了重复执行次数与失败次数,显示按需诊断配置信息。
<Sysname> display diagnostic ondemand configuration
Maximum test-repeating times: 4
Maximum test-failure times: 1
# 只配置了重复执行次数,显示按需诊断配置信息。
<Sysname> display diagnostic ondemand configuration
Maximum test-repeating times: 4
Maximum test-failure times: Not configured
· diagnostic ondemand repeating
display diagnostic result命令用来显示测试例的执行结果。
display diagnostic result [ slot slot-number [ test test-name ] ] [ verbose ]
slot slot-number:表示设备在IRF中的成员编号或者PEX的虚拟槽位号。不指定该参数时,表示所有成员设备/PEX。
test test-name:指定测试例的名称,为1~31个字符的字符串,不区分大小写。不指定该参数时,表示所有测试例。
verbose:显示当前处于使能状态的测试例或者累计执行次数大于0的测试例执行结果的详细信息,不包括统计信息。不指定该参数时,只显示累计执行次数大于0的测试例执行结果的简要信息。
# 显示指定slot上所有测试例的简要诊断结果。
<Sysname> display diagnostic result slot 1
Slot 1 :
Name Run count Failure count Last result
HGMonitor 10 3 Failure
# 显示所有测试例的详细诊断结果
<Sysname> display diagnostic result verbose
Slot 1 :
Test name : HGMonitor
Total run count : 10
Total failure count : 3
Consecutive failure count: 3
Last execution time : Tue Oct 30 10:36:55 2012
First failure time : Tue Oct 30 10:36:25 2012
Last failure time : Tue Oct 30 10:36:55 2012
Last pass time : Tue Oct 30 10:36:15 2012
Last execution result : Failure
Last failure reason : Failed to send packets.
Next execution time : Tue Oct 30 10:37:05 2012
表1-2 display diagnostic result命令显示信息描述表
指定slot上测试例的执行结果 |
|
最近一次诊断失败的原因。当用户配置模拟失败时,此字段内容即为Simulated Test;当诊断未失败时,此字段内容即为-NA- |
|
下次诊断执行的时间。如果是监控诊断类型的测试例,下次执行时间为最后一次测试执行时间加上测试例的时间间隔;如果是按需诊断和启动诊断类型的测试例,则此字段的内容为-NA- |
display diagnostic result statistics命令用来显示与报文相关的测试例的统计信息。
display diagnostic result [ slot slot-number [ test test-name ] ] statistics
slot slot-number:表示设备在IRF中的成员编号或者PEX的虚拟槽位号。不指定该参数时,表示所有成员设备/PEX。
test test-name:指定测试例的名称,为1~31个字符的字符串,不区分大小写。不指定该参数时,表示所有测试例。
# 显示指定slot上的PortLoopback执行后的统计结果。
<Sysname> display diagnostic result slot 1 test PortLoopback statistics
Slot 1 :
Test name: PortLoopback
Port Packets sent Packets received Packets lost
1 0 0 0
2 0 0 0
3 0 0 0
4 4 4 0
5 4 4 0
6 4 4 0
7 4 4 0
8 0 0 0
表1-3 display diagnostic result statistics命令显示信息描述表
指定slot上与报文相关的测试例的统计信息 |
|
display diagnostic simulation命令用来显示模拟诊断的配置信息。
display diagnostic simulation [ slot slot-number ]
slot slot-number:表示设备在IRF中的成员编号或者PEX的虚拟槽位号,不指定时,显示所有板的模拟诊断配置。
该命令用来显示模拟诊断的配置信息。如果指定的槽号上没有配置模拟诊断,则不显示任何内容。
# 显示指定slot上配置的模拟诊断配置信息。
<Sysname> display diagnostic simulation slot 1
Slot 1 :
Name Mode
HGMonitor failure
reset diagnostic event-log命令用来清除GOLD日志。
# 清除GOLD日志。
<Sysname> reset diagnostic event-log
· display diagnostic event-log
reset diagnostic result命令用来清除诊断测试结果。
reset diagnostic result [ slot slot-number [ test test-name ] ]
slot slot-number:表示设备在IRF中的成员编号或者PEX的虚拟槽位号。不指定时,清除所有板的结果。
test test-name:指定测试例的名称,为1~31个字符的字符串,不区分大小写。不指定该参数时,表示所有测试例。
本命令清除测试结果时,不会清除详细诊断结果中的下次诊断执行时间。
# 清除指定slot上HGMonitor的测试结果。
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!