NVIDIA Accelerated IO (XLIO) Documentation Rev 3.10.5
NVIDIA Accelerated IO (XLIO) Documentation Rev 3.10.5

Basic Performance Tuning

The VMA Tuning Guide can be used in the XLIO case for detailed instructions on how to optimally tune your machines for XLIO performance.

Parameter

Description

Example

XLIO_SPEC

The optimized performance can easily be measured by XLIO predefined specification profiles for different scenarios.

As an example for latency:

· latency profile spec – optimized for latency.

Copy
Copied!
            

LD_PRELOAD=libxlio.so XLIO_SPEC=latency sockperf ping-pong -t 10 -i 11.4.3.1

XLIO_RX_POLL

For blocking sockets only. It controls the number of times the ready packets can be polled on the RX path before they go to sleep (wait for interrupt in blocked mode). The recommended value for best latency is -1 (unlimited).

· For best latency, use -1 for infinite polling

· For low CPU usage use 1 for single poll

· Default value is 100000

· Server:

Copy
Copied!
            

XLIO_RX_POLL=-1 LD_PRELOAD=libxlio.so taskset -c 15 sockperf sr -i 17.209.13.142

· Client:

Copy
Copied!
            

XLIO_RX_POLL=-1  LD_PRELOAD=libxlio.so taskset -c 15  sockperf pp -i 17.209.13.142 -t 5

XLIO_INTERNAL_THREAD_AFFINITY

Controls which CPU core(s) the XLIO internal thread is serviced on. The recommended configuration is to run XLIO internal thread on a different core than the application but on the same NUMA node.

· Server:

Copy
Copied!
            

XLIO_INTERNAL_THREAD_AFFINITY=14 XLIO_RX_POLL=-1  LD_PRELOAD=libxlio.so taskset -c 15   sockperf sr -i 17.209.13.142

· Client:

Copy
Copied!
            

XLIO_INTERNAL_THREAD_AFFINITY= 14 XLIO_RX_POLL=-1  LD_PRELOAD=libxlio.so taskset -c 15  sockperf pp -i 17.209.13.142 -t 5

  1. Check which NUMA is related to your interface.

    Copy
    Copied!
                

    cat /sys/class/net/<interface_name>/device/numa_node

    Example:

    Copy
    Copied!
                

    [root@r-host142 ~]# cat /sys/class/net/ens5/device/numa_node 1

    The output above shows that your device is installed next to NUMA

  2. Check which CPU is related to the specific NUMA.
    The output above shows that:
    • CPUs 0-13 & 28-41 are related to NUMA 0• CPUs 14-27 & 42-55 are related to NUMA 1
    Since we want to use NUMA 1, one of the following CPUs should be used: 14-27 & 42-55

  3. Use the "taskset" command to run the XLIO process on a specific CPU.

    • Server-Side:

      Copy
      Copied!
                  

      LD_PRELOAD=libxlio.so taskset -c 15 sockperf sr -i < IP of FIRST machine MLX interface >

    • Client-Side:

      Copy
      Copied!
                  

      LD_PRELOAD=libxlio.so taskset -c 15 sockperf pp -i < IP of FIRST machine MLX interface >

    In this example, we use CPU 15 that belongs to NUMA 1. You can also use "numactl - -hardware".

Warning

Each machine has its own BIOS parameters. It is important to implement any server manufacturer and Linux distribution tuning recommendations for lowest latency.

When configuring the BIOS, please pay attention to the following:

  1. Enable Max performance mode.

  2. Enable Turbo mode.

  3. Power modes – disable C-states and P-states, do not let the CPU sleep on idle.

  4. Hyperthreading – there is no right answer if you should have it ON or OFF.

    • ON means more CPU to handle kernel tasks, so the amortized cost will be smaller for each CPU
    OFF means do not share cache with other CPUs, so cache utilization is better
    If all of your system jitter is under control, it is recommended to turn is OFF, if not keep it ON.

  5. Disable SMI interrupts.
    Look for "Processor Power and Utilization Monitoring" and "Memory Pre-Failure Notification" SMIs.
    The OS is not aware of these interrupts, so the only way you might be able to notice them is by reading the CPU msr register.

Please make sure to carefully read your vendor BIOS tuning guide as the configuration options differ per vendor.

© Copyright 2023, NVIDIA. Last updated on Sep 8, 2023.