Installing Repo Package on Host Side

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.

Removing Previously Installed DOCA Runtime Packages

If an older DOCA software version is installed on your host, make sure to uninstall it before proceeding with the installation of the new version:

Ubuntu	`host# for f in $( dpkg --list \| grep doca \| awk '{print $2}' ); do echo $f ; apt remove --purge $f -y ; done host# sudo apt-get autoremove`
CentOS/RHEL	`host# for f in $(rpm -qa \|grep -i doca ) ; do yum -y remove $f; done host# yum autoremove host# yum makecache`

Ubuntu

host# for f in $( dpkg --list | grep doca | awk '{print $2}' ); do echo $f ; apt remove --purge $f -y ; done
host# sudo apt-get autoremove

CentOS/RHEL

host# for f in $(rpm -qa |grep -i doca ) ; do yum -y remove $f; done
host# yum autoremove
host# yum makecache

Downloading DOCA Runtime Packages

The following table provides links to DOCA Runtime packages depending on the OS running on your host.

We don't have a way to export this macro.

Installing Local Repo Package for Host Dependencies

Install DOCA local repo package for host:

OS	Procedure
Ubuntu	Download the DOCA SDK and DOCA Runtime packages from Installing Repo Package on Host Side \| id (4.7.0)InstallingRepoPackageonHostSide DownloadingDOCARuntimePackages section for the host. Unpack the deb repo. Run: `host# sudo dpkg -i doca-host-repo-ubuntu<version>_amd64.deb` Perform apt update. Run: `host# sudo apt-get update` Run `apt install` for DOCA runtime, tools, and SDK: `host# sudo apt install -y doca-runtime doca-sdk`
CentOS	Download the DOCA SDK and DOCA Runtime packages from Installing Repo Package on Host Side \| id (4.7.0)InstallingRepoPackageonHostSide DownloadingDOCARuntimePackages section for the x86 host. Install the following software dependencies. Run: `host# sudo yum install -y epel-release` For CentOS 8.2 only, also run: `host# yum config-manager --set-enabled PowerTools` Unpack the RPM repo. Run: `host# sudo rpm -Uvh doca-host-repo-rhel<version>.x86_64.rpm` Run `yum install` for DOCA runtime, tools, and SDK. `host# sudo yum install -y doca-runtime doca-sdk`
RHEL	Open a RedHat account. Log into RedHat website via the developers tab. Create a developer user. Run: `host# subscription-manager register --username=<username> --password=PASSWORD` To extract pool ID: `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`. Run: `host# subscription-manager attach --pool=<pool-id> host# subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms host# yum makecache` Install the DOCA local repo package for host. Run: `host# rpm -Uvh doca-host-repo-rhel<version>.x86_64.rpm host# sudo yum install -y doca-runtime doca-sdk` Sign out from your RHEL account. Run: `host# subscription-manager remove --all host# subscription-manager unregister`

Assign a dynamic IP to tmfifo_net0 interface (RShim host interface).

host# ifconfig tmfifo_net0 192.168.100.1 netmask 255.255.255.252 up

Verify that RShim is active.
```
host# sudo systemctl status rshim
```
This command is expected to display "active (running)". If RShim service does not launch automatically, run:
```
host# sudo systemctl enable rshim
host# sudo systemctl start rshim
```

Last updated: July 08, 2024