Updating Repo Package on Host Side

1.0
Warning

This section assumes that a BlueField DPU has already been installed in a server according to the instructions detailed in the DPU's hardware user guide.

The following procedure instructs users on upgrading DOCA local repo package for host.

Ubuntu

Copy
Copied!
            

dpkg --list | grep doca sudo apt remove --purge <doca> -y sudo apt-get autoremove

CentOS/RHEL

Copy
Copied!
            

yum remove doca-runtime yum remove doca-sdk yum remove doca-tools sudo rpm -qa | grep -i doca yum remove <doca> yum autoremove yum makecache

  1. Installation of MFT and RShim for managing and flashing the BlueField DPU.

    OS

    Procedure

    Ubuntu/Debian

    1. Download the DOCA Tools package from Downloading DOCA Runtime Packages section for the host.

    2. Unpack the deb repo. Run:

      Copy
      Copied!
                  

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

    3. Perform apt update. Run:

      Copy
      Copied!
                  

      host# sudo apt-get update

    4. Run apt install for DOCA Tools.

      For DPU

      From the host, run:

      Copy
      Copied!
                  

      host# sudo apt install doca-tools

      For ConnectX on Ubuntu 20.04

      From the host, run:

      Copy
      Copied!
                  

      host# sudo apt install doca-cx-tools

    CentOS/RHEL

    1. Download the DOCA Tools package from Downloading DOCA Runtime Packages section for the x86 host.

    2. Unpack the RPM repo. Run:

      Copy
      Copied!
                  

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

    3. Run yum install to install DOCA Tools.

      Copy
      Copied!
                  

      host# sudo yum install doca-tools

    Warning

    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:

    OS

    Procedure

    Ubuntu

    1. Download the DOCA SDK and DOCA Runtime packages from Downloading DOCA Runtime Packages section for the host.

    2. Unpack the deb repo. Run:

      Copy
      Copied!
                  

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

    3. Perform apt update. Run:

      Copy
      Copied!
                  

      host# sudo apt-get update

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

      For DPU

      From the host, run:

      Copy
      Copied!
                  

      host# sudo apt install -y doca-runtime doca-sdk

      For ConnectX on Ubuntu 20.04

      From the host, run:

      Copy
      Copied!
                  

      host# sudo apt install -y doca-cx-runtime doca-cx-sdk

    CentOS

    1. Download the DOCA SDK and DOCA Runtime packages from Downloading DOCA Runtime Packages section for the x86 host.

    2. Install the following software dependencies. Run:

      Copy
      Copied!
                  

      host# sudo yum install -y epel-release

    3. For CentOS 8.2 only, also run:

      Copy
      Copied!
                  

      host# yum config-manager --set-enabled PowerTools

    4. Unpack the RPM repo. Run:

      Copy
      Copied!
                  

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

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

      Copy
      Copied!
                  

      host# sudo yum install -y doca-runtime doca-sdk

    RHEL

    1. Open a RedHat account.

      1. Log into RedHat website via the developers tab.

      2. Create a developer user.

    2. Run:

      Copy
      Copied!
                  

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

      To extract pool ID:

      Copy
      Copied!
                  

      host# 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:

      Copy
      Copied!
                  

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

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

      Copy
      Copied!
                  

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

    5. Sign out from your RHEL account. Run:

      Copy
      Copied!
                  

      host# subscription-manager remove --all host# subscription-manager unregister

  3. A ssign a dynamic IP to tmfifo_net0 interface (RShim host interface).

    Copy
    Copied!
                

    host# ifconfig tmfifo_net0 192.168.100.1 netmask 255.255.255.252 up

  4. Verify that RShim is active.

    Copy
    Copied!
                

    host# sudo systemctl status rshim

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

    Copy
    Copied!
                

    host# sudo systemctl enable rshim host# sudo systemctl start rshim

© Copyright 2023, NVIDIA. Last updated on Jan 3, 2024.