Installing XLIO

Before you begin, verify you are using a supported operating system and a supported CPU architecture for your operating system. See supported combinations listed in .System Requirements and Interoperability v1.1.8.

The current XLIO version can work on top of both MLNX_OFED driver stack that supports Ethernet and on a lighter driver stack, MLNX_EN that supports only Ethernet.

The XLIO library is delivered as a user-space library, and is called libxlio.so.X.Y.Z.

XLIO can be installed using one of the following methods:

• As part of NVIDIA drivers (described on this page)

• Manually (see Installing the XLIO Packages)

XLIO is integrated into the NVIDIA drivers (MLNX_OFED/MLNX_EN), therefore, it is recommended to install XLIO automatically when installing the NVIDIA drivers as it depends on drivers’ latest firmware, libraries, and kernel modules. This installation assures XLIO’s correct functionality. Since the drivers have a plethora of distributions for RHEL, Ubuntu and others, you will have to correctly select the drivers’ version that matches your distribution.

This option suits users who want to install a new XLIO version or upgrade to the latest XLIO version by overriding the previous one.

1. Download the latest MLNX_OFED driver from here.

2. Install the XLIO packages.

   Copy

   Copied!

               
   
               
   ./mlnxofedinstall --xlio
           

3. Verify the installation was completed successfully.

   Copy

   Copied!

               
   
               
   /etc/infiniband/info
           

1. Download the latest MLNX_EN driver from here.

2. Install the XLIO packages.

   Copy

   Copied!

               
   
               
   ./install --xlio
           

3. Verify the installation was completed successfully.

   Copy

   Copied!

               
   
               
   $ cat /etc/infiniband/info
   #!/bin/bash
    
   echo prefix=/usr
   echo Kernel=4.18.0-240.el8.x86_64
   echo
   echo "Configure options: --with-core-mod
   --with-user_mad-mod --with-user_access-mod --with-addr_trans-mod
   --with-mlx54-mod --with-mlx54_en-mod --with-mlx5-mod 
   --with-srp-mod --with-iser-mod --with-isert-mod"
   echo
           

1. Start the relevant driver (MLNX_OFED/MLNX_EN):

   Copy

   Copied!

               
   
               
   /etc/init.d/openibd restart
           

   or

   Copy

   Copied!

               
   
               
   systemctl restart openibd.service
           

2. Verify that the supported version of firmware is installed.

   Copy

   Copied!

               
   
               
   ibv_devinfo