Subcommands and Parameters

The tool can collect and display all information or the information specific to a single module, and can also identify and recommend the memory insertion method. The tool provides symptom description and diagnosis suggestions for possible problems in a report. If multiple reports are available, the tool can compare and analyze them.

You can run KunpengHealthChecker and a subcommand (except cpu) to view all information about the subcommand module.

**Table 1** Subcommands
Subcommand	Description
system	Displays all system information, including the server, vendor, and mainboard information.
os	Displays OS information, including the OS name, system version, kernel version, and boot parameters.
bios	Displays BIOS information, including the boot type, cache mode, and PCIe rate. This feature requires the permission to run ipmitool. Alternatively, configure the BMC information (user name and password) to obtain the complete system information.
software	Displays software information, including the BIOS, OS, and software versions.
cpu	Displays CPU information, including the CPU model and list.
numa	Displays NUMA information, including CPU, memory, PCIe, network, and NVMe information.
memory	Displays memory information, including common memory information and DIMM information.
network	Displays network information, including the network driver and interrupt information.
storage	Displays storage information, including drive and partition information.
pcie	Displays PCIe information, including the PCIe driver and IRQ information.
ascend	Displays Ascend NPU information, including npu-smi and ascend-dmi.
bmc	Displays information obtained using the BMC. This feature requires the permission to run ipmitool. Alternatively, configure the BMC information (BMC IP address, user name, and password) to obtain the information. If you do not enter the BMC information, SEL logs will not be collected.
config	Checks and displays dependencies between modules.
all	Displays all system information, including all hardware and software information. (Some information can be collected only when using the BMC.)
report	Displays historical reports or analyzes report differences.

**Table 2** **KunpengHealthChecker** command parameters
Parameter	Option	Description
-h/--help/-H	-	Obtains help information. This parameter is optional.
-L	0/1/2/3/4	Log level, which defaults to 4. This parameter is optional. 0: DEBUG 1: INFO 2: WARNING 3: ERROR 4: NOTSET
-l/--language	0/1	Report language, which defaults to 1. If the environment does not support Chinese, the 0 option (English) is used. This parameter is optional. 0: English 1: Chinese
--remote	-	Indicates whether to collect remote node information. This parameter is optional. The tool will be transferred to the /tmp directory on the remote node. After the collection is complete, the tool is deleted. To enable this option, obtain the SSH login information of the remote node, including the IP address and port (IP_address:port, port defaulting to 22), user name, and password.
-s/--skip-bmc	-	Skips the step of configuring BMC information. By default, ipmitool is used to collect information. This parameter is optional.
-c/--bmc-command	-	Runs the user-defined BMC information collection command. This parameter is optional.

**Table 3** **system** subcommand parameters
Parameter	Option	Description
-h/--help/-H	-	Obtains help information. This parameter is optional.
-o/--host	-	Displays the host name, server time, OS, mainboard, and chassis information. This parameter is optional.
-p/--product	-	Displays the product name, version, serial number, and UUID. This parameter is optional.
-b/--baseboard	-	Displays the mainboard manufacturer, product name, version, and serial number. This parameter is optional.

**Table 4** **software** subcommand parameters
Parameter	Option	Description
-h/--help/-H	-	Obtains help information. This parameter is optional.
-s/--software_version	-	Displays the software version. This parameter is optional.
-k/--kvm	-	Displays KVM information. This parameter is optional.
-d/--docker	-	Displays Docker information. This parameter is optional.

**Table 5** **cpu** subcommand parameters
Parameter	Option	Description
-h/--help/-H	-	Obtains help information. This parameter is optional.
-G/--general	-	Displays the overall CPU information. This parameter is mandatory. This parameter cannot be used along with the -c parameter.
-c/--cpu	n\|n,m\|n-m\|all	Displays detailed information about a specified CPU core. The number of CPU cores is dynamically displayed based on the actual environment. This parameter is mandatory. Collecting all CPU core information requires the BMC information (IP address, user name, and password). If the BMC information is not provided, ipmitool is used to collect the information. This parameter cannot be used along with the -G parameter.

**Table 6** **memory** subcommand parameters
Parameter	Option	Description
-h/--help/-H	-	Obtains help information. This parameter is optional.
-G/--general	-	Displays the overall memory information. This parameter is optional.
-D/--DIMM	-	Displays the memory information of all sockets (SOCKET, CHANNEL, and DIMM), including the memory socket topology and the recommended insertion mode. This parameter is optional.

**Table 7** **network** subcommand parameters
Parameter	Option	Description
-h/--help/-H	-	Obtains help information. This parameter is optional.
-n/--nic	-	Displays NIC information. This parameter is optional.
-i/--irq	-	Displays network IRQ mapping information. This parameter is optional.
-T/--tuner	-	Displays NIC tuning information. This parameter is optional.
-r/--route	-	Displays route information. This parameter is optional.
-a/--arp	-	Displays ARP information. This parameter is optional.

**Table 8** **storage** subcommand parameters
Parameter	Option	Description
-h/--help/-H	-	Obtains help information. This parameter is optional.
-d/--disk	-	Displays drive information. This parameter is optional.
-f/--filesystem	-	Displays the file system version. This parameter is optional.
-b/--bmc	-	Displays drive information recorded in the BMC. This parameter is optional.
-s/--smart	-	Displays drive health information. This parameter is optional.

**Table 9** **ascend** subcommand parameters
Parameter	Option	Description
-h/--help/-H	-	Obtains help information. This parameter is optional.
-n/--npu	-	Displays NPU topology information. This parameter is optional.
-d/--dmi	-	Displays basic ascend-dmi information. This parameter is optional.
-b/--band	-	Displays ascend-dmi bandwidth information. This parameter is optional.

**Table 10** **report** subcommand parameters
Parameter	Option	Description
-h/--help/-H	-	Obtains help information and displays historical reports. This parameter is optional.
-r/--report	Report No.	Select a report to display or enter a report path. Only the latest 10 reports can be displayed. This parameter is optional.
-d/--diff	0/N/N,M/<INPUT_PATH>/<INPUT_PATH_A>,<INPUT_PATH_B>	Select the two reports that you want to compare. This parameter is optional. 0: generates a report and compares it with the previous report. N: generates a new report and compares it with historical report <N>. N,M: compares historical report <N> with historical report <M>. <INPUT_PATH>: generates a new report and compares it with the input report. <INPUT_PATH_A>,<INPUT_PATH_B>: compares input reports <A> and <B>.
--brief	-	The comparison report simplifies the comparison content and does not display the details of each module. This parameter is optional.

Parent topic: Kunpeng Health Inspector