Documentation
Rate This Document
Findability
Accuracy
Completeness
Readability
SubmitClose

kspect

Command Function

Collects and displays all information or the information specific to a single module, and identifies and recommends the memory insertion configuration. After collecting all information, 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 ./kspect and a subcommand (except cpu) to view all information about the subcommand module.

Syntax

1
./kspect [-h] [-L {0,1,2,3,4}] [-l {0,1}] [--remote] [-s] [-c COMMAND] {system,os,bios,software,cpu,numa,memory,network,storage,pcie,ascend,bmc,config,cluster,server_config,all,report} ...

Parameter Description

Table 1 Parameters of the kspect command

Parameter

Option

Description

-h/--help

-

Obtains help information.

-L

0/1/2/3/4
Log level, which defaults to 1.
  • 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.

  • 0: English
  • 1: Chinese

--remote

-

Indicates whether to collect remote node information.

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.

  • If you enter an incorrect user name or password, the tool will stop collection.
  • During data collection, a working directory named in the format of kspect-report-IP_address-Time is generated on the remote server. After the collection is complete, the collected data is packaged and saved to the output directory under the tool directory on the tool node.
  • The collection duration may increase due to network problems. If the network is disconnected during the collection, the working directory on the remote server will not be automatically deleted.

-s/--skip-bmc

-

Skips the step of configuring BMC information. By default, ipmitool is used to collect information.

-c/--bmc-command

-

Runs the user-defined BMC information collection command.

Example

Collect remote server information.
1
./kspect -l 0 -s --remote all
Parent topic: Commands and Parameters