Enabling NIC Multi-Queue

Scenarios

Support of NIC Multi-Queue

• For details about the ECS specifications that support NIC multi-queue, see ECS Specifications.
  Note

  If the number of NIC queues is greater than 1, NIC multi-queue is supported.

• The virtualization type must be KVM.
• The Linux public images listed in Table 2 support NIC multi-queue.
  Note

  • The PV driver of a Windows ECS dynamically adjusts the number of NIC queues based on the number of vCPUs of the ECS, and you do not need to set the number of Windows NIC multi-queues.
  • Public images that contain Windows Server 2008 are no longer available. However, you can still use private images that contain Windows Server 2008.
  • It is a good practice to upgrade the kernel version of the Linux ECS to 2.6.35 or later. Otherwise, NIC multi-queue is not supported.

    Run the uname -r command to obtain the kernel version. If the kernel version is earlier than 2.6.35, contact customer service to upgrade the kernel.

Importing the External Image File to the IMS Console

Setting NIC Multi-Queue for the Image

Method 1:

1. Log in to the management console.
2. Under Computing, click Image Management Service.
3. Click the Private Images tab, locate the row containing the target image, click Modify in the Operation column.
4. Set the NIC multi-queue attribute of the image.

Method 2:

1. Log in to the management console.
2. Under Computing, click Image Management Service.
3. Click the Private Images tab. In the image list, click the name of the target image to switch to the page providing details about the image.
4. Click Modify in the upper right corner. In the displayed Modify Image dialog box, set the NIC multi-queue attribute.

1. For instructions about how to obtain the token, see Calling APIs > Authentication in Image Management Service API Reference.
2. For instructions about how to call an API to update image information, see "Updating Image Information (Native OpenStack API)" in Image Management Service API Reference.
3. Add X-Auth-Token to the request header.

   The value of X-Auth-Token is the token obtained in step 1.

4. Add Content-Type to the request header.

   The value of Content-Type is application/openstack-images-v2.1-json-patch.

   The request URI is in the following format:

   PATCH /v2/images/{image_id}

   The request body is as follows:

   [       
            { 
             "op":"add",
             "path":"/hw_vif_multiqueue_enabled", 
             "value": "true" 
            } 
    ]
   
   

   Figure 1 shows an example request body for modifying the NIC multi-queue attribute.

   Figure 1 Example request body

   
   

Creating an ECS Using a Private Image

You can create an ECS using a registered private image. For details, see Creating an ECS. Note the following when setting the parameters:

• Region: Select the region where the private image is located.
• Image: Click Private image and then select the desired image from the drop-down list.

Running the Script for Configuring NIC Multi-Queue

1. Run the following command to download the configuration script "multi-queue-hw":

   wget URL to download the script

   URL: https://ecs-instance-driver.obs.ru-moscow-1.hc.sbercloud.ru/multi-queue-hw

2. Run the following command to assign execution permissions to the script:

   chmod +x multi-queue-hw

3. Run the following command to move the multi-queue-hw script to the /etc/init.d directory:

   mv multi-queue-hw /etc/init.d

4. Run the following command to run the script:

   /etc/init.d/multi-queue-hw start

   The script takes effect immediately after being executed. However, after the ECS is stopped, NIC multi-queue disables automatically.

5. Add startup configuration for each OS so that NIC multi-queue automatically enables upon the ECS startup.
   • For CentOS, Red Hat, Fedora, EulerOS, SUSE, and OpenSUSE, run the following command:

     chkconfig multi-queue-hw on

   • For Ubuntu, run the following command:

     update-rc.d multi-queue-hw defaults 90 10

   • For Debian, run the following command:

     systemctl enable multi-queue-hw

Viewing the Number of NIC Queues

1. Log in to the ECS.
2. Run the following command to obtain the number of queues supported by the NIC and the number of queues with NIC multi-queue enabled:

   ethtool -l NIC

[root@localhost ~]# ethtool -l eth0  #View the number of queues used by NIC eth0.
Channel parameters for eth0:
Pre-set maximums:
RX:               0
TX:               0
Other:                  0
Combined: 4  #Indicates that a maximum of four queues can be enabled for the NIC.
Current hardware settings:
RX:               0
TX:               0
Other:                  0
Combined: 1 #Indicates that four queues have been enabled.