VK Cloud logo

Collecting diagnostic data with hw-bundle-util

The hw-bundle-util utility is used to collect diagnostic data from a Bare Metal server.

  1. Install the missing packages with the auxiliary utilities that hw-bundle-util uses:

    sudo dnf install -y dmidecode ethtool bind-utils smartmontools rasdaemon edac-utils
  2. Download and unpack the archive with the utility, and then make the file executable. Select the command for your server architecture:

    curl -fLO https://bm-hw-testing-util-art.hb.ru-msk.vkcloud-storage.ru/hw-bundle-util/latest/hw-bundle-util_linux_amd64.tar.gz && \tar -xvf ./hw-bundle-util_linux_amd64.tar.gz && \chmod +x ./hw-bundle-util
  3. Run hw-bundle-util with the required parameters. If it is run without additional parameters, the bmaas-bundle.tar.gz archive is created next to the hw-bundle-util executable file. If such a file already exists, it is overwritten.

    To get the most complete diagnostic data, it is recommended to run hw-bundle-util with superuser privileges using the sudo command:

    sudo ./hw-bundle-util
  4. Wait for hw-bundle-util to finish.

  5. Check the return code:

    echo $?

    If all data is collected successfully, the output contains the code 0.

  6. Check the resulting report. To do this, unpack the report archive:

    tar -xvf bmaas-bundle.tar.gz
  7. Check the required files. For detailed information about the report contents, see Report contents.

Was this article helpful?