This topic describes how to troubleshoot and resolve the issue where a 3rd-generation instance fails to start because the Virtio driver is not installed or its version does not meet the requirements.

Prerequisites

Before you install the driver, install kernel-headers and kernel-devel, and make sure that they match the kernel version. Otherwise, the driver installation may fail. If the kernel is upgraded, restart the instance before you install the driver. You can also compile the driver source code or submit a ticket to resolve the compatibility issue between the driver and your system environment.

Procedure

Use a script to detect whether the Virtio driver version of the virtual machine meets the requirements.

Execute the following command to download the detection script file via the public network.

wget -O virtio_tool https://virtio11-drivers.tos-cn-beijing.volces.com/virtio_tool_1.1.2

Execute the following command to grant the execute permission on the script file.

chmod +x ./virtio_tool

In the directory where the script file is stored, execute the following command to check whether the Virtio driver version meets the requirements.

./virtio_tool -check

If the following output is displayed, the required Virtio driver is installed on your virtual machine. Skip the next step.

If the following output is displayed, the required Virtio driver is not installed on your virtual machine. Proceed to the next step.

Install the Virtio1.1 driver. For details, refer to Installing the Virtio1.1 driver using virtio_tool.

Last updated: 2026.06.18 17:49:51

Public security network record in Beijing: No. 11010802032137