1. Install Ethernet Switch 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

  1. From the Step 01 Development Environment window, select the following:

    • From the Product Category panel, select Ethernet Switch.

    • From the Hardware Configuration panel, select the host machine and target hardware.

    • From the Target Operating System panel, select the operating system and DOCA software version.

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

     Note: 

    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. 

  2. Click Continue to proceed to the next step.

Step 2: Review Components and Accept Licenses

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

  2. To review the licenses, click on the license agreements hyperlink at the bottom of the page.

  3. Enable the checkbox to accept the terms and conditions of the license agreements.

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

  5. Select Continue to proceed to the next step.

Step 3: Installation

  1. Before the installation begins, SDK Manager prompts you to enter your sudo password.

  2. The display shows the progress of the download and installation of the software.

    Select Pause / Resume to toggle the download and installation process.

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

  4. On the Terminal tab, you can use the Filter text field to filter and search for specific information.

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

     Note: 

    The instructions in the flashing dialog vary based on your host and target environment settings.  

     Note: 

    IPv4 connectivity between the host running SDK Manager and the target system is required.   

  6. After SDK Manager completes the flashing process, the monitor connected to your Switch system will show a prompt for initial setup.

  7. SDK components' installation on your Switch system is only available for Ethernet Switch minor version releases.

    • As part of the initial setup process, select a username and password for the Switch system.

    • After the initial setup process is complete, the Switch system boots to the Linux desktop.

    • Enter the same username and password you created during the Switch configuration into SDK Manager's post-flash installation dialog.

  8. SDK Manager will now complete the installation of the software libraries. Skipping this step will not install any SDK components on your target hardware, and will keep a clean operating system on your device.

Step 4: Finalize Setup

  1. From Step 04 Summary Finalization, there is a summary of the components that were installed, along with any warnings or errors that were encountered.

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

  3. Consult the Error Messages for information about any errors you may encounter.

  4. Click Finish and Exit to complete the installation.

Repair and Uninstall

To update or uninstall an SDK on your system, launch SDK Manager again.

  1. On Step 1, under the installation step numbers, click the Repair/Uninstall hyperlink.

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

  1. Review the summary table to identify which component failed.

    1. Expand the group with the "Error" status.

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

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

  3. Retrying the installation is also available in two other ways:

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

  4. At STEP 01, select the required SDK and run through the installation again.

  5. Finally, try to uninstall and reinstall the relevant SDK.

 

Previous | Next

  Previous Topics     Next Topics  

Home    

System Requirements    

Release Notes    

Download and Run SDK Manager    

Command-Line Install    

Offline Install    

 

Notices

Notice

THE INFORMATION IN THIS GUIDE AND ALL OTHER INFORMATION CONTAINED IN NVIDIA DOCUMENTATION REFERENCED IN THIS GUIDE IS PROVIDED “AS IS.” NVIDIA MAKES NO WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO THE INFORMATION FOR THE PRODUCT, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE. Notwithstanding any damages that customer might incur for any reason whatsoever, NVIDIA’s aggregate and cumulative liability towards customer for the product described in this guide shall be limited in accordance with the NVIDIA terms and conditions of sale for the product.

THE NVIDIA PRODUCT DESCRIBED IN THIS GUIDE IS NOT FAULT TOLERANT AND IS NOT DESIGNED, MANUFACTURED OR INTENDED FOR USE IN CONNECTION WITH THE DESIGN, CONSTRUCTION, MAINTENANCE, AND/OR OPERATION OF ANY SYSTEM WHERE THE USE OR A FAILURE OF SUCH SYSTEM COULD RESULT IN A SITUATION THAT THREATENS THE SAFETY OF HUMAN LIFE OR SEVERE PHYSICAL HARM OR PROPERTY DAMAGE (INCLUDING, FOR EXAMPLE, USE IN CONNECTION WITH ANY NUCLEAR, AVIONICS, LIFE SUPPORT OR OTHER LIFE CRITICAL APPLICATION). NVIDIA EXPRESSLY DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY OF FITNESS FOR SUCH HIGH RISK USES. NVIDIA SHALL NOT BE LIABLE TO CUSTOMER OR ANY THIRD PARTY, IN WHOLE OR IN PART, FOR ANY CLAIMS OR DAMAGES ARISING FROM SUCH HIGH RISK USES.

NVIDIA makes no representation or warranty that the product described in this guide will be suitable for any specified use without further testing or modification. Testing of all parameters of each product is not necessarily performed by NVIDIA. It is customer’s sole responsibility to ensure the product is suitable and fit for the application planned by customer and to do the necessary testing for the application in order to avoid a default of the application or the product. Weaknesses in customer’s product designs may affect the quality and reliability of the NVIDIA product and may result in additional or different conditions and/or requirements beyond those contained in this guide. NVIDIA does not accept any liability related to any default, damage, costs or problem which may be based on or attributable to: (i) the use of the NVIDIA product in any manner that is contrary to this guide, or (ii) customer product designs.

Other than the right for customer to use the information in this guide with the product, no other license, either expressed or implied, is hereby granted by NVIDIA under this guide. Reproduction of information in this guide is permissible only if reproduction is approved by NVIDIA in writing, is reproduced without alteration, and is accompanied by all associated conditions, limitations, and notices.

Trademarks

NVIDIA, the NVIDIA logo, Bluefield-2, CLARA, NVIDIA CLARA AGX SDK, cuBLAS, CUDA, CUDA-GDB, CUDA-MEMCHECK, cuDNN, cuFFT, cuSPARSE, DIGITS, DGX, DGX-1, DGX Station, NVIDIA DOCA SDK, NVIDIA DRIVE, NVIDIA DRIVE AGX, NVIDIA DRIVE Software, NVIDIA DRIVE OS, NVIDIA Developer Zone (aka "DevZone"), NVIDIA DOCA SDK, NVIDIA Ethernet Switch, NVIDIA Ethernet Switch SDK, GRID, Jetson, NVIDIA Jetson Nano, NVIDIA Jetson AGX Xavier, NVIDIA Jetson TX2, NVIDIA Jetson TX2i, NVIDIA Jetson TX1, NVIDIA Jetson TK1, Kepler, NGX, NVIDIA GPU Cloud, Maxwell, Multimedia API, NCCL, NVIDIA Nsight Compute, NVIDIA Nsight Eclipse Edition, NVIDIA Nsight Graphics, NVIDIA Nsight Systems, NVLink, nvprof, Pascal, NVIDIA Rivermax SDK, NVIDIA SDK Manager, Tegra, TensorRT, Tesla, Visual Profiler, VisionWorks and Volta are trademarks and/or registered trademarks of NVIDIA Corporation in the United States and other countries. Other company and product names may be trademarks of the respective companies with which they are associated.