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

The operating system supported on the BlueField DPU is Ubuntu 20.04.

1. If you wish to continue without the DOCA local repo package for host, install the minimal tools needed on the host to allow managing and flashing new firmware on the BlueField.

   For Ubuntu/Debian

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

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

   3. Perform apt update. Run:

      sudo apt-get update

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

      sudo apt install doca-tools

   For CentOS/RHEL

   1. Download the DOCA Tools package from Installation Files section for the x86 host.
   2. Unpack the RPM repo. Run:

      sudo rpm -Uvh doca-host-repo-rhel<version>.x86_64.rpm

   3. Run yum install for DOCA runtime, tools, and SDK.

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

   Note: Skip the following step to proceed without the DOCA local repo package for host.
2. Alternatively, to continue with the DOCA local repo package for host installation:

   Installing DOCA Local Repo Package 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:

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

   3. Perform apt update. Run:

      sudo apt-get update

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

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

   Installing DOCA Local Repo Package 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 following software dependencies. Run:

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

   3. Unpack the RPM repo. Run:

      sudo rpm -Uvh doca-host-repo-rhel<version>.x86_64.rpm

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

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

   Installing DOCA Local Repo Package on RHEL Host

   1. Open a RedHat account.
      1. Log into RedHat website via the developers tab.
      2. Create a developer user.
   2. Run:

      subscription-manager register --username=<username> --password=PASSWORD

      To extract pool ID:

      subscription-manager list --available --all
      ...
      Subscription Name:   Red Hat Developer Subscription for Individuals
      Provides:            Red Hat Developer Tools (for RHEL Server for ARM)
                           ...
                           Red Hat CodeReady Linux Builder for x86_64
      ...
      Pool ID:             <pool-id>
      ...

      And use the pool ID for the Subscription Name and Provides that include Red Hat CodeReady Linux Builder for x86_64.

   3. Run:

      subscription-manager attach --pool=<pool-id>
      subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms

   4. Install the DOCA local repo package for host. Run:

      rpm -Uvh doca-host-repo-rhel<version>.x86_64.rpm
      yum makecache
      sudo yum install doca-runtime
      sudo yum install doca-tools
      sudo yum install doca-sdk

   5. Sign out from your RHEL account. Run:

      subscription-manager remove --all
      subscription-manager unregister

      The upgrade takes effect only after mlxfwreset which is performed in later steps.

3. Initialize MST. Run:

   sudo mst start

4. Reset the nvconfig params to their default values:

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

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/mt41686_pciconf0 -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 /dev/mst/mt41686_pciconf0 s LINK_TYPE_P1=2 LINK_TYPE_P2=2

6. Assign a dynamic IP to tmfifo_net0 interface (RShim host interface).
   Note: Skip this step if you are installing the DOCA image on multiple DPUs.

   ifconfig tmfifo_net0 192.168.100.1 netmask 255.255.255.252 up

7. 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

1. Restart the driver. Run:

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

2. Configure the physical function (PF) interfaces.

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

   For example:

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

   Pings between the source and destination should now be operational.