...

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

Software Prerequisites

Removing Previously Installed DOCA Runtime Packages

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

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

Anchor
Downloading DOCA Runtime Packages Downloading DOCA Runtime Packages

Downloading DOCA Runtime Packages

Installing Local Repo Package for Host Dependencies

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

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

Upgrade Procedure

For Ubuntu

1. Download the appropriate local repo package for host for your Ubuntu OS from "Updating Repo Package on Host SideDownloading DOCA Runtime Packages".

   Code Block
   language text
   wget <Download Link>

2. Unpack the deb repo. Run: 

   Code Block
   language text
   dpkg -i <repo_file>

3. Perform apt update. Run: 

   Code Block
   language text
   apt-get update

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

   Code Block
   language text
   sudo apt install doca-runtime sudo apt install doca-sdk sudo apt install doca-tools

5. (Optional) If you choose not to install DOCA Runtime, you must install RShim.

   Code Block
   language text
   sudo dpkg --force-all -i rshim-<version>.deb

   Note
   Download the .deb RShim package from the URL provided in the BlueField Drivers for Host downloader under the "Download/Documentation" column on this page.

For CentOS/RHEL

1. Download the appropriate local repo package for host for your OS from "Updating Repo Package on Host SideDownloading DOCA Runtime Packages".

   Code Block
   language text
   wget <Download Link>

2. Run: 

   Code Block
   language text
   yum autoremove

3. Unpack the deb repo. Run: 

   Code Block
   language text
   rpm -Uvh <repo_file>.rpm

4. Run: 

   Code Block
   language text
   yum makecache

5. Run apt-install for DOCA SDK, DOCA runtime, DOCA tools:

   Code Block
   language text
   sudo yum install doca-runtime sudo yum install doca-sdk sudo yum install doca-tools

6. (Optional) If you choose not to install DOCA Runtime, you must install RShim.

   Code Block
   language text
   sudo rpm -Uhv rshim-<version>.rpm

   Note
   Download the .rpm RShim package from the URL provided in the BlueField Drivers for Host downloader under the "Download/Documentation" column on this page.

7. Assign a static IP to tmfifo_net0 (RShim host interface) on the x86 host.

   Ubuntu	Edit the file /etc/netplan/01-netcfg.yaml by adding the last 3 lines presented in the following example: Code Block language text 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: false Note tmfifo_net0 is not supported by NetworkManager. Interface configuration must be rendered with networkd.
   Debian	Create the file /etc/network/interfaces.d/tmfifo. Set the following lines:  Code Block language text auto tmfifo_net0 iface tmfifo_net0 inet static address 192.168.100.1/24
   CentOS/RHEL	Create the file /etc/sysconfig/network-scripts/ifcfg-tmfifo_net0. Set the following lines:  Code Block language text DEVICE=tmfifo_net0 BOOTPROTO=none ONBOOT=yes PREFIX=24 IPADDR=192.168.100.1 NM_CONTROLLED=no

8. Load network configuration.

   Ubuntu	Code Block language text sudo netplan apply
   Debian	Code Block language text sudo systemctl restart networking
   CentOS/RHEL	Code Block language text systemctl restart NetworkManager.service

   If the network configuration restart does not load the new interface, try rebooting the host.

9. Verify that RShim is active.

   Code Block
   language text
   sudo systemctl status rshim

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

   Code Block
   language text
   sudo systemctl enable rshim sudo systemctl start rshim