Installing Repo Package on Host Side

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

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

            

            
$ for f in $( dpkg --list | grep doca | awk '{print $2}' ); do echo $f ; apt remove --purge $f -y ; done
$ /usr/sbin/ofed_uninstall.sh --force
$ sudo apt-get autoremove
        

            

            
host# for f in $(rpm -qa | grep -i doca ) ; do yum -y remove $f; done
host# /usr/sbin/ofed_uninstall.sh --force
host# yum autoremove
host# yum makecache
        

Then perform the following steps:

1. Download NVIDIA's RPM-GPG-KEY-Mellanox-SHA256 key:

   Copy

   Copied!

               
   
               
   # wget http://www.mellanox.com/downloads/ofed/RPM-GPG-KEY-Mellanox-SHA256
   --2018-01-25 13:52:30--  http://www.mellanox.com/downloads/ofed/RPM-GPG-KEY-Mellanox-SHA256
   Resolving www.mellanox.com... 72.3.194.0
   Connecting to www.mellanox.com|72.3.194.0|:80... connected.
   HTTP request sent, awaiting response... 200 OK
   Length: 1354 (1.3K) [text/plain]
   Saving to: ?RPM-GPG-KEY-Mellanox-SHA256?
    
   100%[=================================================>] 1,354       --.-K/s   in 0s
    
   2018-01-25 13:52:30 (247 MB/s) - ?RPM-GPG-KEY-Mellanox-SHA256? saved [1354/1354]
           

2. Install the key:

   Copy

   Copied!

               
   
               
   # sudo rpm --import RPM-GPG-KEY-Mellanox-SHA256
   warning: rpmts_HdrFromFdno: Header V3 DSA/SHA1 Signature, key ID 6224c050: NOKEY
   Retrieving key from file:///repos/MLNX_OFED//RPM-GPG-KEY-Mellanox
   Importing GPG key 0x6224C050:
    Userid: "Mellanox Technologies (Mellanox Technologies - Signing Key v2) "
    From  : /repos/MLNX_OFED//RPM-GPG-KEY-Mellanox-SHA256
   Is this ok [y/N]:
           

3. Verify that the key was successfully imported:

   Copy

   Copied!

               
   
               
   # rpm -q gpg-pubkey --qf '%{NAME}-%{VERSION}-%{RELEASE}\t%{SUMMARY}\n' | grep Mellanox
   gpg-pubkey-a9e4b643-520791ba    gpg(Mellanox Technologies )
           

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

1. Install DOCA local repo package for host:

   OS	Procedure
   Ubuntu	Download the DOCA SDK and DOCA Runtime packages from Downloading DOCA Runtime Packages section for the host. Unpack the deb repo. Run: Copy Copied! host# sudo dpkg -i doca-host-repo-ubuntu<version>_amd64.deb Perform apt update. Run: Copy Copied! host# sudo apt-get update Run apt install for DOCA runtime, tools, and SDK: Copy Copied! host# sudo apt install -y doca-runtime doca-sdk
   CentOS	Download the DOCA SDK and DOCA Runtime packages from Downloading DOCA Runtime Packages section for the x86 host. Install the following software dependencies. Run: Copy Copied! host# sudo yum install -y epel-release For CentOS 8.2 only, also run: Copy Copied! host# yum config-manager --set-enabled PowerTools Unpack the RPM repo. Run: Copy Copied! host# sudo rpm -Uvh doca-host-repo-rhel<version>.x86_64.rpm Run yum install for DOCA runtime, tools, and SDK. Copy Copied! 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: 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. 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 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 Sign out from your RHEL account. Run: Copy Copied! host# subscription-manager remove --all host# subscription-manager unregister

2. Verify that RShim is active.

   Copy

   Copied!

               
   
               
   host# sudo systemctl status rshim
           

   This command is expected to display incative (dead).

   • To launch RShim service, run:

     Copy

     Copied!

                 
     
                 
     host# sudo systemctl start rshim
             

   • To allow RShim to launch automatically in future boots, run:

     Copy

     Copied!

                 
     
                 
     host# sudo systemctl enable rshim
             

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