display diagnostic-information
Function
The display diagnostic-information command displays diagnostic information about the current system.
Format
display diagnostic-information [ level level_value ] [ module-name ] &<1-8> [ slot slot-id ] [ key key-string ] [ force ]
display diagnostic-information [ level level_value ] [ module-name ] &<1-8> [ slot slot-id ] [ key key-string ] [ force ] file-name
display diagnostic-information [ level level_value ] [ module-name ] &<1-8> file-name [ slot slot-id ] [ key key-string ] [ force ]
Parameters
| Parameter | Description | Value |
|---|---|---|
| level level_value |
Specifies the level of the diagnostic information. |
The value is an enumerated type, which can be:
|
| module-name |
Displays diagnostic file information for the specified module. |
The value displayed on the device prevails. |
| slot slot-id |
Displays diagnostic file information on a specified board. |
The value displayed on the device prevails. |
| key key-string |
Specifies the keyword of the diagnostic information. |
Enumerated type:
|
| force |
Forcibly collects diagnostic command information with one-click. |
- |
| file-name |
Specifies the name of the file that stores diagnostic information. |
The value is a string of 5 to 64 characters. By default, the file path is cfcard:/, and the extension of the file must be .txt or .zip. |
Usage Guidelines
Usage Scenario
When a fault occurs in the system, if it is difficult to determine the module that causes the fault, you can use the display diagnostic-information command to collect diagnostics information for locating the fault. To collect diagnostic information about the historical information or board, run the display diagnostic-information key command. If history is specified for key, information about diagnostic commands containing history is collected. If slot is specified for key, information about diagnostic commands containing slot is collected.
Configuration Impact
The display diagnostic-information command combines the functions of multiple common display commands, such as the display clock, display version, and display current-configuration commands. Running this command equals to the running of these display commands.
Precautions
When using this command, note the following points:
- If no parameter is specified, diagnostics information is only displayed.
- If the file-name parameter is specified, diagnostic information is saved to a specified file.
- If level is specified, diagnostics information is displayed by level.
- If key is specified, only information about diagnostic commands containing the specified keyword is displayed. The keyword is fully matched.
- If force is specified, diagnostic command information is forcibly collected with one-click.
- The troubleshooting aspect varies with the device. Therefore, the collected information varies when the same command is used on different devices.
- If force is not contained in the command, collecting diagnostic information is restricted by the CPU:
- Before the information is collected, if the CPU usage exceeds 60%, the command is not performed, and an error message is displayed.
- During information collecting, if the CPU usage exceeds 80% at the interval of performing two commands, the running of the command is stopped, and the system waits for 300 seconds. If the CPU usage falls below 70% in 300 seconds, the running of the command restores. Otherwise, an error message is displayed.
- The display diagnostic-information <file-name> command sets the command level for saving diagnostic information to a specified file to 3 (management level).
- When the display diagnostic-information command is used to view diagnostic information on the terminal screen, you are advised to execute the command as the management-level user. Otherwise, the collected diagnostic information will be incomplete due to the insufficient user level.
Example
The actual command output varies according to the device. The command output here is only an example.
<HUAWEI> display diagnostic-information level high smp
===============================================================================
display version
===============================================================================
===============================================================================
display patch-information
===============================================================================
Info: No patch exists.
The current state is: Idle
===============================================================================
display alarm active verbose
===============================================================================
===============================================================================
display current-configuration
===============================================================================
!Software Version V800R011C00B001
!Last configuration was updated at 2015-05-07 10:18:40+00:00
<HUAWEI> display diagnostic-information key history a.txt
Now saving the diagnostic information to the device
10%