Help Center> > FAQs> Image Optimization> How Do I Set NIC Multi-queue Feature of an Image?

How Do I Set NIC Multi-queue Feature of an Image?

Updated at: Jun 25, 2019 19:56

Scenarios

Single-core CPU performance cannot meet the requirement of processing NIC interruptions incurred with the increase of network I/O bandwidth. Multiple NIC queuing enables multiple CPUs to process ECS NIC interruptions, thereby improving network PPS and I/O performance.

To enable the NIC multi-queue feature for an ECS, the following conditions must be met:

  1. A NIC multi-queue tag has been added to the image.
    • A NIC multi-queue tag has been added to the public images in Table 1 by default.
    • A NIC multi-queue tag needs to be added to private images imported on the IMS console. For details, see later parts in this section.
  2. The configuration script is run on the ECS to automatically enable the NIC multi-queue feature.

This section describes how to add a NIC multi-queue tag to an image on the console or using the API.

Precautions

  • Xen ECSs do not support NIC multi-queue.
  • KVM ECSs created using the images listed in Table 1 support NIC multi-queue.
Table 1 Support of NIC multi-queue for KVM ECSs

OS

Image

Status

Windows

Windows Server 2008 WEB R2 64bit

Supported using private images

Windows Server 2008 Enterprise SP2 64bit

Supported using private images

Windows Server 2008 R2 Standard/Datacenter/Enterprise 64bit

Supported using private images

Windows Server 2008 R2 Enterprise 64bit_WithGPUdriver

Supported using private images

Windows Server 2012 R2 Standard 64bit_WithGPUdriver

Supported using private images

Windows Server 2012 R2 Standard/Datacenter 64bit

Supported using private images

Linux

Ubuntu 14.04 server 32bit

Supported

Ubuntu 14.04/16.04 server 64bit

Supported

OpenSUSE 13.2/42.2 64bit

Supported

SUSE Enterprise 12 SP1/SP2/SP3 64bit

Supported

CentOS 6.3/6.5/6.8/6.9/7.0/7.1/7.2/7.3/7.4/7.5 64bit

Supported

Red Hat 6.10/7.5 64bit

Supported

Debian 8.2.0/8.8.0/9.0.0 64bit

Supported

Fedora 24/25 64bit

Supported

EulerOS 2.2 64bit

Supported

NOTE:

Windows OSs do not support the NIC multi-queue function. If you add multi-queue tags to Windows OS images and enable the multi-queue function, the startup speed of ECS OSs may become slow.

Add the NIC Multi-Queue Tag to an Image on the Console

Use either of the following methods to set the NIC multi-queue attribute.

Method 1:
  1. Log in to the management console.
  2. Under Computing, click Image Management Service.
  3. Click Private Images to display the image list.
  4. Locate the row that contains the image and click Modify in the Operation column.
  5. 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 Private Images to display the image list.
  4. On the image list, click the name of the target image.
  5. On the image details page, click Modify in the upper right corner. In the displayed Modify Image dialog box, set the NIC multi-queue attribute.

Add NIC Multi-Queue Tag hw_vif_multiqueue_enabled to an Image Using the API

  1. Obtain the token. For details, see API Calling > Token Authentication in the Image Management Service API Reference.
  2. Update the image information. For details, see Image > Updating Image Information (Native OpenStack API)" in the 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 changing the NIC multi-queue attribute.

    Figure 1 Example request body

Follow-Up Procedure

After adding the NIC multi-queue tag to an image, you can use the image to create an ECS. After the ECS is created, run the configuration script on it to enable the NIC multi-queue function.

For details about how to run the configuration script, see Enabling NIC Multi-Queue.

Did you find this page helpful?

Submit successfully!

Thank you for your feedback. Your feedback helps make our documentation better.

Failed to submit the feedback. Please try again later.

Which of the following issues have you encountered?







Please complete at least one feedback item.

Content most length 200 character

Content is empty.

OK Cancel