This quick start guide assumes that an NVIDIA® BlueField®-2 DPU has been installed in a server according to the instructions detailed in your DPU's hardware user guide.

1. Download the following packages listed in the table under section Installation Files depending on the OS of the host you are using:
   • BlueField OS image
   • MFT
   • DOCA metapackages for host
     Note: Alternatively, you may choose not to install the DOCA metapackage for the host (step 2). In this case, you must download the RShim package separately:

     • MFT
     • RShim
2. To continue with the DOCA metapackage installation:
   1. Uninstall the driver if it is already installed. Run:

      ofed_uninstall.sh

   2. Perform the instructions in the following DOCA installation on host sections.

   Installing DOCA Metapackages on Ubuntu Host

   1. Download the DOCA SDK, DOCA Runtime, and DOCA Tools package from Installation Files section for the host.
   2. Unpack the deb repo. Run:

      dpkg -i <repo_file>.deb

      For example:

      sudo dpkg -i doca-host-repo-ubuntu2004_<version>_amd64.deb

   3. Perform apt update. Run:

      apt-get update

   4. Run apt install for DOCA SDK, DOCA runtime, DOCA tools.

      sudo apt install doca-sdk
      sudo apt install doca-runtime
      sudo apt install doca-tools

   Installing DOCA Metapackages on CentOS Host

   1. Download the DOCA SDK, DOCA Runtime, and DOCA Tools package from Installation Files section for the x86 host.
   2. Install the required software dependencies.
      • If you are working on a CentOS 7.6 host, run:

        yum install -y epel-release
        yum install -y uriparser-devel
        yum install -y meson
        yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
        yum-config-manager --add-repo http://mirror.centos.org/centos/7/os/x86_64
        yum-config-manager --add-repo http://mirror.centos.org/centos/7/extras/x86_64
        yum-config-manager --save --setopt=mirror.centos.org_centos_7_os_x86_64.exclude='pciutils* libnl3*'
        rpm --import http://mirror.centos.org/centos/7/os/x86_64/RPM-GPG-KEY-CentOS-7
        yum makecache
        yum install python3

      • If you are working on a CentOS 8.x host, run:

        yum install -y epel-release
        yum install -y uriparser-devel
        yum install -y 'dnf-command(config-manager)'
        dnf -y install dnf-plugins-core
        dnf config-manager --set-enabled PowerTools
        yum install -y meson

   3. Unpack the RPM repo. Run:

      rpm -Uvh <repo_file>

      For example:

      rpm -Uvh doca-host-repo-rhel82-<version>.x86_64.rpm

   4. Run yum install for DOCA SDK, DOCA runtime, DOCA tools.

      sudo yum install doca-sdk
      sudo yum install doca-runtime
      sudo yum install doca-tools

3. To continue without the DOCA metapackages:
   1. Install RShim.
      • For Ubuntu, run:

        sudo dpkg --force-all -i rshim-<version>.deb
        sudo dpkg --force-all -i mft-<version>.deb

      • For CentOS, run:

        sudo rpm -Uhv rshim-<version>.rpm
        sudo rpm -Uhv mft-<version>.rpm

   2. Install MFT.
      • For Ubuntu
        Uninstall the previous MFT package if it exists. Run:

        sudo apt remove --purge mft  mft-oem mft-pcap mft-repo-amd64-ubuntu2004-local mft kernel-mft-dkms -y
        sudo apt-get autoremove

        Then reinstall MFT. Run:

        sudo dpkg -i mft-repo-amd64-ubuntu2004-local_<version>_amd64.deb
        apt-get update
        apt install mft-meta

      • For CentOS, run:

        rpm -Uvh mft-repo-4.16.3-12.x86_64.rpm
        yum install mft-meta

4. Reset the nvconfig params to their default values:

   sudo mlxconfig -d /dev/mst/<device> -y reset
   
   Reset configuration for device /dev/mst/<device>? (y/n) [n] : y
   Applying... Done!
   -I- Please reboot machine to load new configurations.

   Note: You may retrieve the <device> parameter by using the command sudo mst status –v.
5. Skip this step if your BlueField DPU is Ethernet only. Please refer to Supported Platforms to learn your DPU type.
   If you have a VPI DPU, the default link type of the ports will be configured to IB. To verify your link type, run:

   sudo mst start
   sudo mlxconfig -d /dev/mst/<device> -e q | grep -i link_type
   Configurations:                              Default         Current         Next Boot
   *        LINK_TYPE_P1                        IB(1)           ETH(2)          IB(1)
   *        LINK_TYPE_P2                        IB(1)           ETH(2)          IB(1)

   Note: If your DPU is Ethernet capable only, then the sudo mlxconfig -d <device> command will not provide an output.

   If the current link type is set to IB, run the following command to change it to Ethernet:

   sudo mlxconfig -d <device> s LINK_TYPE_P1=2 LINK_TYPE_P2=2

6. Assign a static IP to tmfifo_net0 (RShim host interface).
   • For Ubuntu, edit the file /etc/netplan/01-netcfg.yaml by adding the following lines:

     tmfifo_net0:
       addresses: [192.168.100.1/24]
       dhcp4: false

     Example:

     sudo cat /etc/netplan/01-netcfg.yaml
     # This file describes the network interfaces available on your system
     # For more information, see netplan(5).
     network:
       version: 2
       renderer: networkd
       ethernets:
         eno1:
           dhcp4: yes
         tmfifo_net0:
           addresses: [192.168.100.1/24]
           dhcp4: no

   • For CentOS, create the file /etc/sysconfig/network-scripts/ifcfg-tmfifo_net0 and set the following lines:

     DEVICE=tmfifo_net0
     BOOTPROTO=none
     ONBOOT=yes
     PREFIX=24
     IPADDR=192.168.100.1
     NM_CONTROLLED=no

7. Execute network restart for implemented tmfifo_net0 static configuration.
   • For CentOS:

     /etc/init.d/network restart

   • For Ubuntu:

     /etc/init.d/networking restart

8. Verify that RShim is active.

   sudo systemctl status rshim

   This command is expected to display active (running). If RShim service does not launch automatically, run:

   sudo systemctl enable rshim
   sudo systemctl start rshim

Ubuntu users are required to provide a unique password that will be applied at the end of the BlueField OS image installation. This password needs to be defined in a bf.cfg configuration file.

1. Restart the driver. Run:

   sudo /etc/init.d/openibd restart
   Unloading HCA driver:                                      [  OK  ]
   Loading HCA driver and Access Layer:                       [  OK  ]

2. Configure the physical function (PF) interfaces.

   sudo ifconfig <interface-1> <network-1/mask> up
   sudo ifconfig <interface-2> <network-2/mask> up

   For example:

   sudo ifconfig p2p1 192.168.200.32/24 up
   sudo ifconfig p2p2 192.168.201.32/24 up

   Pings between the source and destination should now be operational.