Install DOCA SDK with SDK Manager
This section is intended to help you use the NVIDIA SDK Manager GUI to configure your development environment successfully.
Step 1: Set Up the Development Environment
From the Step 01 Development Environment window, select the following:
From the Product Category panel, select DOCA.
From the System Configuration panel, select the host machine and target hardware.
If a BlueField®-2 DPU device is connected over PCIe, SDK Manager will auto-select it in the Target Hardware drop-down list. If your device is not automatically detected, click Refresh or select manually.
From the SDK Version panel, select the operating system and DOCA software version.
As of DOCA 1.5.0, DOCA supports flashing and installing multiple DPU cards in a single session.
If relevant, select any Additional SDKs that you want to install.
An ellipsis (…) in the bottom right corner of a category box indicates that more than one option is available. Click on the ellipsis to show a drop-down menu of available options.
Your display may differ from the one shown here. The information in this screen is populated from your NVIDIA user account access and permissions. If you don’t see your product category in the available selections, verify that your NVIDIA account is registered to the required programs.
Click Continue to proceed to the next step.
Step 2: Review Components and Accept Licenses
From Step 02 Details and License, you can expand the host components and target components panels to review the components that will be installed on your system.
To review the licenses, click on the license agreements hyperlink at the bottom of the page.
Enable the checkbox to accept the terms and conditions of the license agreements.
If you want SDK Manager to download all setup files to a location other than the default path, go to the Download & Install Options located at the bottom of the screen, then select the path you want to use.
For more information about the Download & Install Options, refer to Offline Install.
Select Continue to proceed to the next step.
Step 3: Installation
Before the installation begins, SDK Manager prompts you to enter your
The display shows the progress of the download and installation of the software.
Select Pause / Resume to toggle the download and installation process.
At the top, you can toggle between the Details and Terminal tabs. The Terminal tab displays detailed information about the download and installation, with any errors highlighted.
On the Terminal tab, you can use the Filter text field to filter and search for specific information.
SDK Manager opens a dialog when it is ready to flash your target device. A prompt provides instructions for preparing your device to get it ready for flashing.
As part of the initial setup process, select a password for the BlueField®-2 system.
The instructions in the flashing dialog vary based on your host and target environment settings.
After SDK Manager completes the flashing process, the monitor connected to your BlueField®-2 DPU system will show a prompt for initial setup.
After the initial setup process is complete, the BlueField®-2 system boots to the Linux desktop.
Enter the IP address, username, and password created during the BlueField®-2 configuration into SDK Manager’s post-flash installation dialog.
Before installing DOCA on the target DPU, ensure the out-of-band interface (
mgmt) is connected to the internet.
SDK Manager will now complete the installation of the software libraries. Skipping this step will not install any additional SDK components on your target hardware.
Step 4: Finalize Setup
From Step 04 Summary Finalization, there is a summary of the components that were installed, along with any warnings or errors that were encountered.
The Export Debug Logs link creates a ZIP file of all log files created during installation. This ZIP file is located in the same folder path where the SDK Manager installer downloaded all components.
Alternatively, click the menu icon in the top right corner of the window (”⋮”), and choose Export Debug Logs from the drop-down menu in the top-right corner.
Consult the Error Messages for information about any errors you may encounter.
Click Finish and Exit to complete the installation.
Repair and Uninstall
To update or uninstall an SDK on your system, launch SDK Manager again.
On Step 1, under the installation step numbers, click the Repair/Uninstall hyperlink.
The Manage NVIDIA SDKs screen shows what has been installed on your system. You can select whether to repair a broken installation, update an existing SDK, or uninstall an SDK.
Recommended Recovery Steps
There are many causes of various installation errors. Below is a checklist of common installation issues, which may help you recover from a broken installation.
Review the summary table to identify which component failed.
Expand the group with the “Error” status.
When you find the failed component, click the details icon to the right of Install Error to be redirected to the Terminal tab, which will display the exact error.
If the error is related to an environmental issue, such as a broken apt repository or missing prerequisite, try to fix it manually, then click the Retry Failed Items button.
Retrying the installation is also available in two other ways:
From STEP 01, use the Repair/Uninstall button to get to the Manage NVIDIA SDKs page. If needed, expand the SDK with the “Broken” status, then click Repair for the relevant part (Host or Target).
At STEP 01, select the required SDK and run through the installation again.
Finally, try to uninstall and reinstall the relevant SDK.