Command References
The /usr/sbin/kbox is an internal command used for starting the kbox service. The users must not use this command.
Starting the Kbox Service
systemctl start kbox
Restarting the Kbox Service
systemctl restart kbox
Viewing the Kbox State
systemctl status kbox
Viewing the Valid Configuration Information, Name of the Temporary Storage Region, and Registered Storage Devices
kboxstatus
If the kbox service is not started, the current temporary storage regions and registered storage devices are not displayed.
Exporting Log Information
The os_kbox_config command is used to export the logs in the non-volatile storage devices.
Because the CloudEdge is not equipped with any non-volatile storage device, this command does not have an actual effect in the current CloudEdge environment.
os_kbox_config -o dev=[Storage device name],type=[Type of exported logs],index=[SN of the log] | -h | -v
For details about the parameters, see Table 9-8.
Parameter Name |
Description |
|---|---|
dev=[Storage device name] |
Name of the storage device (BIOS NVRAM, HMEM, or PCI) registered in the current system, used to save exception information. |
type=[Type of the exported log] |
Type of the exported logs. It is the same as the region name and can be set to oom/console/message/die. |
index=[SN of the log] |
The SN of the log. The value ranges from 1 to 32. 1 indicates the latest log. Up to 32 logs can be recorded. |
-h |
View the help information. |
-v |
View the kbox version information. |
Parsing Log Files
Because the general server is not equipped with the non-volatile storage system, the kbox saves logs only in the common memory. When the system crashes, the kdump saves the common memory as a mirroring memory file. The kbox parses the mirroring memory file using export_kbox_img_to_txt and outputs log files in the text format.
export_kbox_img_to_txt -i kbox file
- By default, the kbox files are compressed using the gzip. Before parsing the files, run the gunzip xxx-xxx.img.gz command to decompress the files.
- This command is only used to parse the kbox log files on the general server.
