NVIDIA Accelerated IO (XLIO) Documentation Rev 1.1.8
1.0

Installing XLIO Binary Manually

XLIO can be installed from a dedicated XLIO RPM or a Debian package. In this case, please make sure that the MLXN Driver is already installed and that MLNX Driver and XLIO versions match so that XLIO functions correctly.

This option is suitable for users who receive an OEM XLIO version, or a Fast Update Release XLIO version which is newer than the installed XLIO version.

This section addresses both RPM and DEB (Ubuntu OS) installations.

XLIO includes the following packages which should be saved on your local drive:

  • The libxlio package which contains the binary library shared object file (.so), configuration and documentation files

  • The libxlio-utils package which contains utilities such as xlio_stats to monitor xlio traffic and statistics

  • The libxlio-devel package which contains XLIO’s extra API header files, for extra functionality not provided by the socket API

Before you begin, please verify the following prerequisites:

  • Check whether XLIO is installed:
    For RPM packages, run:

    Copy
    Copied!
                

    #rpm -qil libxlio

For DEB packages, run:

Copy
Copied!
            

#dpkg –s libxlio

If the XLIO packages are not installed, an appropriate message is displayed.

If the XLIO packages are installed, the RPM or the DEB logs the XLIO package information and the installed file list.

  • Uninstall the current XLIO:
    For RPM packages, run:

    Copy
    Copied!
                

    #rpm -e libxlio

For DEB packages:

Copy
Copied!
            

#apt-get remove libxlio

Installing the XLIO Binary Package

  1. Go to the location where the libxlio package was saved.

  2. Run the command below to start installation:
    For RPM packages:

    Copy
    Copied!
                

    #rpm -i libxlio-X.Y.Z-R.<arch>.rpm

Warning

An example for libxlio-X.Y.Z-R.<arch>.rpm: libxlio-1.0.6-1.x86_64.rpm

  • For DEB packages:

    Copy
    Copied!
                

    #dpkg -i libxlio_X.Y.Z-R_<arch>.deb

    Warning

    An example for libxlio_X.Y.Z-R_<arch>.deb: libxlio_1.0.6-1_amd64.deb

During the installation process the:
• XLIO library is copied to standard library location (e.g. /usr/lib64/libxlio.so). In addition XLIO debug library is copied under the same location (e.g. /usr/lib64/libxlio-debug.so)
• README is installed at /usr/share/doc/libxlio-X.Y.Z/
• XLIO installs its configuration file, libxlio.conf, to the following location: /etc/libxlio.conf
• The xliod service utility is copied into /sbin
• The script xlio is installed under /etc/init.d/ for systems with SysV. This script can be used to load and unload the XLIO service utility.

Install the XLIO utils Package

  1. Go to the location where the utils package was saved.

  2. Run the command below to start installation:
    For RPM packages:

    Copy
    Copied!
                

    #rpm -i libxlio-utils-X.Y.Z-R.<arch>.rpm

  • For DEB packages:

    Copy
    Copied!
                

    #dpkg -i libxlio-utils_X.Y.Z-R_<arch>.deb

During the installation process, the XLIO monitoring utility is installed at /usr/bin/xlio_stats.

Installing the XLIO devel Package

  1. Go to the location where the devel package was saved.

  2. Run the command below to start installation:
    For RPM packages:

    Copy
    Copied!
                

    #rpm -i libxlio-devel-X.Y.Z-R.<arch>.rpm

  • For DEB packages:

    Copy
    Copied!
                

    #dpkg -i libxlio-dev_X.Y.Z-R_<arch>.deb

During the installation process the XLIO extra header file is installed at /usr/include/mellanox/xlio_extra.h.

For further information, please refer to Running XLIO.

© Copyright 2023, NVIDIA. Last updated on May 23, 2023.