• Image Management Service

ims
  1. Help Center
  2. Image Management Service
  3. User Guide
  4. FAQs
  5. Image Optimization
  6. How Do I Set NIC Multi-queue Feature of an Image?

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

NIC multi-queue can route NIC interrupt requests among multiple vCPUs to achieve higher network performance.

Both the management console and API allow you to easily set the NIC multi-queue attribute.

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 R2 Standard/Datacenter/Enterprise 64bit

Supported using private images

Windows Server 2012 R2 Standard/Datacenter 64bit

Supported using private images

Windows Server 2016 Standard/Datacenter 64bit

Supported using private images

Linux

Ubuntu 14.04 server 32bit

Supported

Ubuntu 14.04/16.04 server 64bit

Supported

OpenSUSE 42.2 64bit

Supported

SUSE Enterprise 12 SP1/SP2 64bit

Supported

CentOS 6.8/6.9/7.0/7.1/7.2/7.3/7.4 64bit

Supported

Red Hat 7.2/7.3/7.4 64bit

Supported

Debian 8.0.0/9.0.0 64bit

Supported

Fedora 24 64bit

Supported

Fedora 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.

Using the Management 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.

Making an API Call

  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