RShim Over USB

Network Connection from BMC to BlueField

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

Enabling RShim on BlueField BMC

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

   systemctl stop rshim
   systemctl disable rshim
   

   
   

   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:

   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
   

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

   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
   

   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:

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

   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.

Last updated: May 27, 2026