Installing Repo Package on Host Side

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:

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

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.

Installing Local Repo Package for Host Dependencies

1. 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.5.4 LTS)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.5.4 LTS)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

   
   

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

   
   

3. 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 10, 2024