RShim Over USB

By default, the BMC and NVIDIA® BlueField® interfaces are configured as follows (static IPs and MACs):

1. Disable RShim on the host. Run the following on the host:

   Copy

   Copied!

               
   
               
   systemctl stop rshim
   systemctl disable rshim
           

   Info

   If the RShim driver is not installed on the host, this step can be skipped.

2. Enable RShim on the BMC using the Redfish interface:

   Copy

   Copied!

               
   
               
   curl -k -u root:'<password>' -H "Content-Type: application/json" -X PATCH -d '{
         "BmcRShim": {
           "BmcRShimEnabled": true
         }
   }' https://<bmc_ip>/redfish/v1/Managers/Bluefield_BMC/Oem/Nvidia
           

   Note

   RShim can be force enabled on BMC even it is started on host. The previous steps are not necessary in this case:

   Copy

   Copied!

               
   
               
   curl -k -u root:'<password>' -H "Content-Type: application/json" -X POST -d '{"Rshim": "Forced"}' https://<bmc_ip>/redfish/v1/Managers/Bluefield_BMC/Actions/Oem/NvidiaManager.SetRshim
           

   Info

   After force enable is performed, the RShim will be in drop mode if it is enabled on host. The host can regain RShim using systemctl restart rshim after the BMC disables RShim.

3. Check the current BmcRShimEnabled value and wait until it changes to true:

   Copy

   Copied!

               
   
               
   curl -k -u root:'<password>' -H "Content-Type: application/json" -X GET https://<bmc_ip>/redfish/v1/Managers/Bluefield_BMC/Oem/Nvidia
           

   Info

   This may take up to 8 seconds. If the BmcRShimEnabled value does not change, disable BMC RShim by setting the value to false then repeating steps 1-3.