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保留在没有任何通知或提示的情况下对资料内容进行修改的权利!