mq_mng

You configure Multi-Queue on the command line in one of these shells:

  • In the Expert mode

  • In Gaia Clish

Multi-Queue Configuration in the Expert mode

Description

The mq_mng utility shows and configures the Multi-Queue on supported interfaces.

Syntax

Important:

  • In a Cluster, you must configure all the Cluster Members in the same way.

  • You must run these commands in the Expert mode.

  • Change in the Multi-Queue mode can cause short packet loss.

  • To see the built-in help

    mq_mng {-h | --help}

  • To show the existing Multi-Queue configuration:

    mq_mng {-o | --show} [{-v | -vv}] [-a]

  • To configure the Multi-Queue for the specified driver:

    mq_mng {-s | --set-mode}

          auto

          manual

                {-i | --interface} <Names of Interfaces>

                {-c | --core} <IDs of CPU Cores>

          off

                [{-i | --interface} <Names of Interfaces>]

  • To apply the existing Multi-Queue policy:

    mq_mng {-r | --reconf}

Parameters

Parameter

Description

-h | --help

Shows built-in help.

-o | --show

Shows the existing Multi-Queue configuration.

-v | -vv

Verbose output.

-a

Shows all interfaces in the output.

-s | --set-mode

Configures the Multi-Queue mode:

  • auto - Automatic mode (this is the default). Multi-Queue automatically configures the affinity of all supported interfaces to CPU cores that run CoreXL SND Instances.

  • manual - Manual mode. Administrator configures the affinity of interfaces to CPU cores that run CoreXL SND Instances. In this mode, you can specify interfaces, CPU cores, or both.

  • off - Disables the Multi-Queue on all or specified supported interfaces.

Important - Change in the Multi-Queue mode can cause short packet loss.

 

Notes:

  • To specify interfaces:

    • Use this syntax:

      {-i | --interface} <Names of Interfaces>

    • If you do not specify interfaces, then the configuration applies to all supported interfaces.

    • To specify a specific interface, enter its name (for example: -i eth2).

    • To specify several interfaces, enter their names separates with spaces (for example: -i eth2 eth4).

  • To specify CPU cores:

    • Use this syntax:

      {-c | --core} <IDs of CPU Cores that run CoreXL SND Instances>

    • To specify a specific CPU core, enter its ID number (for example: -c 1).

    • To specify several nonconsecutive CPU cores, enter their ID numbers separated with spaces (for example: -c 1 3) or commas (for example: -c 1,3).

    • To specify several consecutive CPU cores, enter their first and last ID numbers separated with a hyphen (for example: -c 3-6).

  • To see the current CoreXL affinity configuration, run the fw ctl affinity command (with applicable parameters).

  • To see the CoreXL Firewall Instances and which CPU cores they use, run the fw ctl multik stat command.

  • To see all available CPU cores, run:

    cat /proc/cpuinfo | grep processor

-r | --reconf

Applies the existing Multi-Queue policy.

Examples

[Expert@MyGW:0]# mq_mng --show

Total 8 cores. Multiqueue 2
cores i/f       type            state           config          cores
--------------------------------------------------------------------------
eth1            igb             Up              Auto            0,4
eth2            igb             Up              Auto            0,4
eth2-01         igb             Up              Auto            0,4
[Expert@MyGW:0]#
 
[Expert@MyGW:0]# mq_mng --show -v

Total 8 cores. Multiqueue 2 cores: 0,4
i/f             type            state           config          cores
--------------------------------------------------------------------------
eth1            igb             Up              Auto            0(58),4(78)
eth2            igb             Up              Auto            4(62),0(79)
eth2-01         igb             Up              Auto            0(42),4(86)

core            interfaces      queue                irq        rx packets      tx packets
-------------------------------------------------------------------------------------------
0               eth1            eth1-TxRx-0          58         2350            3012
                eth2            eth2-TxRx-1          79         0               0
                eth2-01         eth2-01-TxRx-0       42         0               45
4               eth1            eth1-TxRx-1          78         652             764
                eth2            eth2-TxRx-0          62         0               0
                eth2-01         eth2-01-TxRx-1       86         0               12
[Expert@MyGW:0]#
 
[Expert@MyGW:0]# mq_mng --show -v -i eth2

Total 8 cores. Multiqueue 2 cores: 0,4
i/f             type            state           config          cores
--------------------------------------------------------------------------------------
eth2            igb             Up              Auto            4(62),0(79) 
--------------------------------------------------------------------------------------
eth2 <igb> max 8 cur 2 
06:00.2 Ethernet controller: Intel Corporation 82580 Gigabit Network Connection (rev 01)
core            interfaces      queue                irq        rx packets      tx packets
-------------------------------------------------------------------------------------------
0               eth2            eth2-TxRx-1          79         4212            3965
4               eth2            eth2-TxRx-0          62         0               0
[Expert@MyGW:0]#
 
mq_mng --set-mode auto
 
mq_mng -s manual -i eth1 eth2 -c 0-2 4-6

Multi-Queue Configuration in Gaia Clish

Syntax

Important:

  • In a Cluster, you must configure all the Cluster Members in the same way.

  • You must run these commands in Gaia Clish.

  • Change in the Multi-Queue mode can cause short packet loss.

  • To show the existing Multi-Queue configuration for the specified interface:

    show interface <Name of Interface> multi-queue [verbose]

  • To configure the Multi-Queue for the specified interface:

    set interface <Name of Interface> multi-queue

          auto

          manual core <IDs of CPU Cores that run CoreXL SND Instances>

          off

Parameters

Parameter

Description

<Name of Interface>

Specifies the interface.

verbose

Verbose output that also includes:

  • IRQ numbers for traffic queues

  • Total number of RX and TX packets in traffic queues

auto

Configures the automatic Multi-Queue mode (this is the default).

Multi-Queue automatically configures the affinity of the specified interface to CPU cores that run CoreXL SND Instances.

manual core <IDs of CPU Cores>

Configures the manual Multi-Queue mode.

Administrator configures the affinity of the specified interface to CPU cores that run CoreXL SND Instances.

Notes:

  • To specify a specific CPU core, enter its ID number (for example: manual core 1).

  • To specify several nonconsecutive CPU cores, enter their ID numbers separated with commas and without spaces (for example: manual core 1,3).

  • To specify several consecutive CPU cores, enter their first and last ID numbers separated with a hyphen (for example: manual core 3-6).

  • To see the current CoreXL affinity configuration, run the fw ctl affinity command (with applicable parameters).

  • To see the CoreXL Firewall Instances and which CPU cores they use, run the fw ctl multik stat command.

  • To see all available CPU cores, run:

    cat /proc/cpuinfo | grep processor

off

Disables the Multi-Queue on the specified interface.

Examples

MyGW> show interface eth2 multi-queue

Total 8 cores. Multiqueue 2 cores
i/f             type            state           config          cores
--------------------------------------------------------------------------
eth2            igb             Up              Auto            4,0

Note: The output does not include network interfaces that are currently in the down state.
MyGW>
 
MyGW> show interface eth2 multi-queue verbose

Total 8 cores. Multiqueue 2 cores: 0,4
i/f             type            state           config          cores
--------------------------------------------------------------------------
eth2            igb             Up              Auto            4(62),0(79)

core            interfaces      queue                irq        rx packets      tx packets
-------------------------------------------------------------------------------------------
0               eth2            eth2-TxRx-1          79         212             80
4               eth2            eth2-TxRx-0          62         16232           18901
MyGW>
 
set interface eth2 multi-queue auto
 
set interface eth2 multi-queue manual core 0-2,4-6