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 System Configuration panel, select the host machine and target hardware.

     

   • From the SDK Version panel, select the operating system and Switch 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.